From 125681e0d779975bfed0698fff8295f8d9256500 Mon Sep 17 00:00:00 2001 From: Tremain Knight <2108488+tkknight@users.noreply.github.com> Date: Fri, 9 Jan 2026 18:44:03 +0000 Subject: [PATCH 1/4] used smaller cards on homepage --- docs/src/_static/theme_override.css | 25 +++++ docs/src/index.rst | 140 ++++++++++------------------ 2 files changed, 75 insertions(+), 90 deletions(-) diff --git a/docs/src/_static/theme_override.css b/docs/src/_static/theme_override.css index 355119f8a5..2b622f918e 100644 --- a/docs/src/_static/theme_override.css +++ b/docs/src/_static/theme_override.css @@ -26,3 +26,28 @@ ul.squarelist { text-indent: 1em; padding-left: 5em; } + +/* custom css for the cards on the homepage */ +.sd-card-img-top { + width: 15% !important; + position: absolute !important; + padding-left: 10px; + min-width: 50px; + top: 50%; + transform: translateY(-50%); +} + +.sd-card-img { + height: auto; +} + +.custom-title { + font-weight: bold; + color: #1B8FB7 !important; + text-align: left; +} + +.custom-body { + text-align: left; + margin-left: max(45px, 15%); +} \ No newline at end of file diff --git a/docs/src/index.rst b/docs/src/index.rst index 139e54cee0..ceab100ad8 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -15,114 +15,74 @@ representations become unwieldy and inefficient. For more information see :ref:`why_iris`. -.. grid:: 3 - .. grid-item-card:: - :text-align: center - :img-top: _static/icon_shuttle.svg - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Information on Iris, how to install and a gallery of examples that - create plots. +.. grid:: 1 1 2 2 + :gutter: 2 - +++ - .. button-ref:: getting_started_index - :ref-type: ref - :color: primary - :outline: - :expand: + .. grid-item-card:: Getting Started + :class-title: custom-title + :class-body: custom-body + :link: getting_started_index + :link-type: ref + :img-top: _static/icon_shuttle.svg + :class-img-top: dark-light + :class-card: sd-rounded-3 - Getting Started + Installing and gallery examples. - .. grid-item-card:: - :text-align: center + .. grid-item-card:: User Guide + :class-title: custom-title + :class-body: custom-body + :link: getting_started_index + :link-type: ref :img-top: _static/icon_instructions.svg - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Learn how to use Iris, including loading, navigating, saving, - plotting and more. + :class-img-top: dark-light + :class-card: sd-rounded-3 - +++ - .. button-ref:: user_guide_index - :ref-type: ref - :color: primary - :outline: - :expand: + Learn how to use Iris. - User Guide - - .. grid-item-card:: - :text-align: center + .. grid-item-card:: Developers Guide + :class-title: custom-title + :class-body: custom-body + :link: development_where_to_start + :link-type: ref :img-top: _static/icon_development.svg - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Information on how you can contribute to Iris as a developer. - - +++ - .. button-ref:: development_where_to_start - :ref-type: ref - :color: primary - :outline: - :expand: - - Developers Guide + :class-img-top: dark-light + :class-card: sd-rounded-3 + Contribute to Iris as a developer. -.. grid:: 3 - - .. grid-item-card:: - :text-align: center + .. grid-item-card:: Iris API + :class-title: custom-title + :class-body: custom-body + :link: generated/api/iris :img-top: _static/icon_api.svg - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Browse full Iris functionality by module. + :class-img-top: dark-light + :class-card: sd-rounded-3 - +++ - .. button-ref:: generated/api/iris - :ref-type: doc - :color: primary - :outline: - :expand: + Iris functionality by module. - Iris API - - .. grid-item-card:: - :text-align: center + .. grid-item-card:: What's New + :class-title: custom-title + :class-body: custom-body + :link: iris_whatsnew + :link-type: ref :img-top: _static/icon_new_product.svg - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Find out what has recently changed in Iris. + :class-img-top: dark-light + :class-card: sd-rounded-3 - +++ - .. button-ref:: iris_whatsnew - :ref-type: ref - :color: primary - :outline: - :expand: + Recent changes in Iris. - What's New - - .. grid-item-card:: - :text-align: center + .. grid-item-card:: Voted Issues + :class-title: custom-title + :class-body: custom-body + :link: voted_issues_top + :link-type: ref :img-top: _static/icon_thumb.png - :class-img-top: w-50 m-auto px-1 py-2 dark-light - :shadow: lg - - Raise the profile of issues by voting on them. - - +++ - .. button-ref:: voted_issues_top - :ref-type: ref - :color: primary - :outline: - :expand: + :class-img-top: dark-light + :class-card: sd-rounded-3 - Voted Issues + Raise the profile of issues by voting. Icons made by FreePik from `Flaticon `_ From bc58c336f6d133960ed7e306bda75d045d784bc2 Mon Sep 17 00:00:00 2001 From: Tremain Knight <2108488+tkknight@users.noreply.github.com> Date: Mon, 12 Jan 2026 09:57:05 +0000 Subject: [PATCH 2/4] added whatsnew --- docs/src/whatsnew/latest.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/latest.rst index e0ebbdeff6..edf40999cc 100644 --- a/docs/src/whatsnew/latest.rst +++ b/docs/src/whatsnew/latest.rst @@ -81,7 +81,8 @@ This document explains the changes made to Iris for this release 📚 Documentation ================ -#. N/A +#. `@tkknight`_ reduced the space used on the documentation homepage by the quick + link cards to allow for easier reading. (:pull:`6886`) 💼 Internal From adc14c43939c54bafa8f646dee0685cda47aae7a Mon Sep 17 00:00:00 2001 From: Tremain Knight <2108488+tkknight@users.noreply.github.com> Date: Tue, 13 Jan 2026 10:53:21 +0000 Subject: [PATCH 3/4] corrected api link --- docs/src/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/index.rst b/docs/src/index.rst index ceab100ad8..b6330d5aa3 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -55,7 +55,7 @@ For more information see :ref:`why_iris`. .. grid-item-card:: Iris API :class-title: custom-title :class-body: custom-body - :link: generated/api/iris + :link: generated/api/iris.html :img-top: _static/icon_api.svg :class-img-top: dark-light :class-card: sd-rounded-3 From fe550e9252e591d50a34cb3d24251fc94ddb1174 Mon Sep 17 00:00:00 2001 From: Tremain Knight <2108488+tkknight@users.noreply.github.com> Date: Sat, 24 Jan 2026 18:34:26 +0000 Subject: [PATCH 4/4] merge tidy --- docs/src/index.rst | 5 ----- docs/src/whatsnew/latest.rst | 4 +--- 2 files changed, 1 insertion(+), 8 deletions(-) diff --git a/docs/src/index.rst b/docs/src/index.rst index 689b141eb6..2854e2e214 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -15,11 +15,6 @@ representations become unwieldy and inefficient. For more information see :ref:`why_iris`. -<<<<<<< HEAD -======= - -.. grid:: 3 ->>>>>>> upstream/main .. grid:: 1 1 2 2 :gutter: 2 diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/latest.rst index de97ba7064..730880b368 100644 --- a/docs/src/whatsnew/latest.rst +++ b/docs/src/whatsnew/latest.rst @@ -81,12 +81,10 @@ This document explains the changes made to Iris for this release 📚 Documentation ================ -<<<<<<< HEAD #. `@tkknight`_ reduced the space used on the documentation homepage by the quick link cards to allow for easier reading. (:pull:`6886`) -======= + #. `@tkknight`_ added a gallery carousel to the documentation homepage. (:pull:`6884`) ->>>>>>> upstream/main 💼 Internal