Skip to content

DOC: tutorials follow up to guide #27769

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

DOC: tutorials follow up to guide #27769

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
97 changes: 43 additions & 54 deletions galleries/tutorials/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,32 @@
Tutorials
=========

This page contains a few tutorials for using Matplotlib. For the old tutorials, see :ref:`below <user_guide_tutorials>`.
Walk-throughs of building visualizations that incorporate multiple features of the
library.


.. attention::

We're re-organizing! Please nominate :ref:`examples <examples-index>` that you think are good
tutorials and propose new ones by opening an
:ref:`issue or pull request <contribute_documentation>`!

If you are unsure of what we consider a tutorial, see our
:ref:`content guide <content-tutorials>` and ask on our
:ref:`communication <communication-channels>`


To learn more about Matplotlib, see the :ref:`user guide <users-guide-index>` and
:ref:`community resources <resources-index>`. For examples, see the
:ref:`examples-index` gallery.

For shorter examples, see our :ref:`examples page <examples-index>`.
You can also find :ref:`external resources <resources-index>` and
a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.


.. raw:: html

<div class="sphx-glr-thumbnails">

.. pyplot tutorial

.. raw:: html

Expand All @@ -31,6 +46,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
<div class="sphx-glr-thumbnail-title">Pyplot tutorial</div>
</div>

.. images

.. raw:: html

Expand All @@ -49,6 +65,8 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
</div>


.. lifecycle

.. raw:: html

<div class="sphx-glr-thumbcontainer" tooltip="This tutorial aims to show the beginning, middle, and end of a single visualization using Matpl...">
Expand All @@ -65,6 +83,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
<div class="sphx-glr-thumbnail-title">The Lifecycle of a Plot</div>
</div>

.. artist

.. raw:: html

Expand All @@ -83,6 +102,25 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
</div>


.. annotation

.. raw:: html

<div class="sphx-glr-thumbcontainer" tooltip="Labeling pie and donut charts.">

.. only:: html

.. image:: /tutorials/images/thumb/sphx_glr_pie_and_donut_labels_thumb.png
:alt: Labeling and annotating pie and donut charts.

:ref:`sphx_glr_tutorials_pie_and_donut_labels.py`

.. raw:: html

<div class="sphx-glr-thumbnail-title">Labeling a pie and a donut</div>
</div>


.. raw:: html

</div>
Expand All @@ -95,6 +133,7 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
/tutorials/images
/tutorials/lifecycle
/tutorials/artists
/tutorials/pie_and_donut_labels

.. only:: html

Expand All @@ -107,53 +146,3 @@ a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
.. container:: sphx-glr-download sphx-glr-download-jupyter

:download:`Download all examples in Jupyter notebooks: tutorials_jupyter.zip </tutorials/tutorials_jupyter.zip>`



.. _user_guide_tutorials:

User guide tutorials
--------------------

Many of our tutorials were moved from this section to :ref:`users-guide-index`:

Introductory
^^^^^^^^^^^^

- :ref:`quick_start`
- :ref:`customizing`
- :ref:`animations`

Intermediate
^^^^^^^^^^^^

- :ref:`legend_guide`
- :ref:`color_cycle`
- :ref:`constrainedlayout_guide`
- :ref:`tight_layout_guide`
- :ref:`arranging_axes`
- :ref:`autoscale`
- :ref:`imshow_extent`

Advanced
^^^^^^^^

- :ref:`blitting`
- :ref:`paths`
- :ref:`patheffects_guide`
- :ref:`transforms_tutorial`

Colors
^^^^^^

See :ref:`tutorials-colors`.

Text
^^^^

See :ref:`tutorials-text`.

Toolkits
^^^^^^^^

See :ref:`tutorials-toolkits`.
5 changes: 5 additions & 0 deletions ..._and_polar_charts/pie_and_donut_labels.py → galleries/tutorials/pie_and_donut_labels.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
"""
.. redirect-from:: /gallery/pie_and_polar_charts/pie_and_donut_labels

.. _pie_donut_labels:

==========================
Labeling a pie and a donut
==========================
Expand Down Expand Up @@ -122,6 +126,7 @@ def func(pct, allvals):
# the ingredients would suffice for around 6 donuts - producing one huge
# donut is untested and might result in kitchen errors.

# .. tags:: plot-type: pie, component: annotation, level: beginner

# %%
#
Expand Down
Loading