From 3305482033e63ac1d7cce4418407d11164aea612 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sun, 24 Aug 2025 08:26:54 +0200
Subject: [PATCH] Backport PR #30451: doc: factor out quick install tab for
 reuse

---
 doc/index.rst                       | 55 +++--------------------------
 doc/install/index.rst               |  7 +++-
 doc/install/quick_install.inc.rst   | 54 ++++++++++++++++++++++++++++
 doc/users/getting_started/index.rst | 21 +----------
 4 files changed, 65 insertions(+), 72 deletions(-)
 create mode 100644 doc/install/quick_install.inc.rst

diff --git a/doc/index.rst b/doc/index.rst
index 74a183d6cd7b..c5b25b6d37aa 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -14,59 +14,12 @@ and interactive visualizations.
 Install
 =======
 
-.. tab-set::
-    :class: sd-width-content-min
+.. include:: install/quick_install.inc.rst
 
-    .. tab-item:: pip
+.. toctree::
+    :hidden:
 
-        .. code-block:: bash
-
-            pip install matplotlib
-
-    .. tab-item:: conda
-
-        .. code-block:: bash
-
-            conda install -c conda-forge matplotlib
-
-    .. tab-item:: pixi
-
-        .. code-block:: bash
-
-            pixi add matplotlib
-
-    .. tab-item:: uv
-
-        .. code-block:: bash
-
-            uv add matplotlib
-
-        .. warning::
-
-           If you install Python with ``uv`` then the ``tkagg`` backend
-           will not be available because python-build-standalone (used by uv
-           to distribute Python) does not contain tk bindings that are usable by
-           Matplotlib (see `this issue`_ for details).  If you want Matplotlib
-           to be able to display plots in a window, you should install one of
-           the other :ref:`supported GUI frameworks <optional_dependencies>`,
-           e.g.
-
-           .. code-block:: bash
-
-               uv add matplotlib pyside6
-
-           .. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851
-
-    .. tab-item:: other
-
-        .. rst-class:: section-toc
-        .. toctree::
-            :maxdepth: 2
-
-            install/index
-
-For more detailed instructions, see the
-:doc:`installation guide <install/index>`.
+    install/index
 
 Learn
 =====
diff --git a/doc/install/index.rst b/doc/install/index.rst
index 2d9e724e6a73..eb5e02f98868 100644
--- a/doc/install/index.rst
+++ b/doc/install/index.rst
@@ -5,6 +5,9 @@
 Installation
 ************
 
+.. include:: quick_install.inc.rst
+
+.. _install-official:
 
 Install an official release
 ===========================
@@ -35,6 +38,7 @@ precompiled wheel for your OS and Python.
    animations and a larger selection of file formats, you can
    install :ref:`optional dependencies <optional_dependencies>`.
 
+.. _install-third-party:
 
 Third-party distributions
 =========================
@@ -81,7 +85,7 @@ you can install Matplotlib via your package manager, e.g.:
 
 .. redirect-from:: /users/installing/installing_source
 
-.. _install_from_source:
+.. _install-nightly-build:
 
 Install a nightly build
 =======================
@@ -101,6 +105,7 @@ scientific-python-nightly-wheels as the package index to query:
     --extra-index-url https://pypi.org/simple \
     matplotlib
 
+.. _install-source:
 
 Install from source
 ===================
diff --git a/doc/install/quick_install.inc.rst b/doc/install/quick_install.inc.rst
new file mode 100644
index 000000000000..2e75b332f6ed
--- /dev/null
+++ b/doc/install/quick_install.inc.rst
@@ -0,0 +1,54 @@
+.. set of quick install commands for reuse across docs
+
+.. tab-set::
+    :class: sd-width-content-min
+
+    .. tab-item:: pip
+
+        .. code-block:: bash
+
+            pip install matplotlib
+
+    .. tab-item:: conda
+
+        .. code-block:: bash
+
+            conda install -c conda-forge matplotlib
+
+    .. tab-item:: pixi
+
+        .. code-block:: bash
+
+            pixi add matplotlib
+
+    .. tab-item:: uv
+
+        .. code-block:: bash
+
+            uv add matplotlib
+
+        .. warning::
+
+           If you install Python with ``uv`` then the ``tkagg`` backend
+           will not be available because python-build-standalone (used by uv
+           to distribute Python) does not contain tk bindings that are usable by
+           Matplotlib (see `this issue`_ for details).  If you want Matplotlib
+           to be able to display plots in a window, you should install one of
+           the other :ref:`supported GUI frameworks <optional_dependencies>`,
+           e.g.
+
+           .. code-block:: bash
+
+               uv add matplotlib pyside6
+
+           .. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851
+
+    .. tab-item:: other
+
+        :ref:`install-official`
+
+        :ref:`install-third-party`
+
+        :ref:`install-nightly-build`
+
+        :ref:`install-source`
diff --git a/doc/users/getting_started/index.rst b/doc/users/getting_started/index.rst
index ac896687979d..dfbbd615b5cd 100644
--- a/doc/users/getting_started/index.rst
+++ b/doc/users/getting_started/index.rst
@@ -4,26 +4,7 @@ Getting started
 Installation quick-start
 ------------------------
 
-.. grid:: 1 1 2 2
-
-    .. grid-item::
-
-        Install using `pip <https://pypi.org/project/matplotlib>`__:
-
-        .. code-block:: bash
-
-            pip install matplotlib
-
-    .. grid-item::
-
-        Install using `conda <https://docs.continuum.io/anaconda/>`__:
-
-        .. code-block:: bash
-
-            conda install -c conda-forge matplotlib
-
-Further details are available in the :doc:`Installation Guide </install/index>`.
-
+.. include:: /install/quick_install.inc.rst
 
 Draw a first plot
 -----------------