Skip to content

Commit 400de8d

Browse files
committed
factored out quick install index tab to seperate
file and added tab set to getting started guide
1 parent 29ba27a commit 400de8d

File tree

4 files changed

+57
-67
lines changed

4 files changed

+57
-67
lines changed

doc/index.rst

Lines changed: 1 addition & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -14,56 +14,7 @@ and interactive visualizations.
1414
Install
1515
=======
1616

17-
.. tab-set::
18-
:class: sd-width-content-min
19-
20-
.. tab-item:: pip
21-
22-
.. code-block:: bash
23-
24-
pip install matplotlib
25-
26-
.. tab-item:: conda
27-
28-
.. code-block:: bash
29-
30-
conda install -c conda-forge matplotlib
31-
32-
.. tab-item:: pixi
33-
34-
.. code-block:: bash
35-
36-
pixi add matplotlib
37-
38-
.. tab-item:: uv
39-
40-
.. code-block:: bash
41-
42-
uv add matplotlib
43-
44-
.. warning::
45-
46-
If you install Python with ``uv`` then the ``tkagg`` backend
47-
will not be available because python-build-standalone (used by uv
48-
to distribute Python) does not contain tk bindings that are usable by
49-
Matplotlib (see `this issue`_ for details). If you want Matplotlib
50-
to be able to display plots in a window, you should install one of
51-
the other :ref:`supported GUI frameworks <optional_dependencies>`,
52-
e.g.
53-
54-
.. code-block:: bash
55-
56-
uv add matplotlib pyside6
57-
58-
.. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851
59-
60-
.. tab-item:: other
61-
62-
.. rst-class:: section-toc
63-
.. toctree::
64-
:maxdepth: 2
65-
66-
install/index
17+
.. include:: install/quick_install.inc.rst
6718

6819
For more detailed instructions, see the
6920
:doc:`installation guide <install/index>`.

doc/install/index.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@
77
Installation
88
************
99

10+
.. include:: quick_install.inc.rst
11+
:end-line: 45
1012

1113
Install an official release
1214
===========================

doc/install/quick_install.inc.rst

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
.. set of quick install commands for reuse across docs
2+
3+
.. tab-set::
4+
:class: sd-width-content-min
5+
6+
.. tab-item:: pip
7+
8+
.. code-block:: bash
9+
10+
pip install matplotlib
11+
12+
.. tab-item:: conda
13+
14+
.. code-block:: bash
15+
16+
conda install -c conda-forge matplotlib
17+
18+
.. tab-item:: pixi
19+
20+
.. code-block:: bash
21+
22+
pixi add matplotlib
23+
24+
.. tab-item:: uv
25+
26+
.. code-block:: bash
27+
28+
uv add matplotlib
29+
30+
.. warning::
31+
32+
If you install Python with ``uv`` then the ``tkagg`` backend
33+
will not be available because python-build-standalone (used by uv
34+
to distribute Python) does not contain tk bindings that are usable by
35+
Matplotlib (see `this issue`_ for details). If you want Matplotlib
36+
to be able to display plots in a window, you should install one of
37+
the other :ref:`supported GUI frameworks <optional_dependencies>`,
38+
e.g.
39+
40+
.. code-block:: bash
41+
42+
uv add matplotlib pyside6
43+
44+
.. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851
45+
46+
.. tab-item:: other
47+
48+
.. rst-class:: section-toc
49+
.. toctree::
50+
:maxdepth: 2
51+
52+
install/index

doc/users/getting_started/index.rst

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,8 @@ Getting started
44
Installation quick-start
55
------------------------
66

7-
.. grid:: 1 1 2 2
8-
9-
.. grid-item::
10-
11-
Install using `pip <https://pypi.org/project/matplotlib>`__:
12-
13-
.. code-block:: bash
14-
15-
pip install matplotlib
16-
17-
.. grid-item::
18-
19-
Install using `conda <https://docs.continuum.io/anaconda/>`__:
20-
21-
.. code-block:: bash
22-
23-
conda install -c conda-forge matplotlib
7+
.. include:: /install/quick_install.inc.rst
8+
:end-line: 45
249

2510
Further details are available in the :doc:`Installation Guide </install/index>`.
2611

0 commit comments

Comments
 (0)