From 70e6cd23631801cf0ef733bee005dc4c8685a524 Mon Sep 17 00:00:00 2001
From: Mubin Manasia <48038715+Mubin17@users.noreply.github.com>
Date: Thu, 25 May 2023 12:21:20 -0600
Subject: [PATCH] Backport PR #25977: [Doc]: Fix navigation sidebar for
 Animation examples

---
 doc/api/animation_api.rst | 31 +++++++++++--------------------
 1 file changed, 11 insertions(+), 20 deletions(-)

diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
index d1b81e20b5c8..c7134e302d2f 100644
--- a/doc/api/animation_api.rst
+++ b/doc/api/animation_api.rst
@@ -168,18 +168,15 @@ artists and functions.  A fourth method is to create a class.
 Examples
 ~~~~~~~~
 
-.. toctree::
-   :maxdepth: 1
-
-   ../gallery/animation/animate_decay
-   ../gallery/animation/bayes_update
-   ../gallery/animation/double_pendulum
-   ../gallery/animation/animated_histogram
-   ../gallery/animation/rain
-   ../gallery/animation/random_walk
-   ../gallery/animation/simple_anim
-   ../gallery/animation/strip_chart
-   ../gallery/animation/unchained
+* :doc:`../gallery/animation/animate_decay`
+* :doc:`../gallery/animation/bayes_update`
+* :doc:`../gallery/animation/double_pendulum`
+* :doc:`../gallery/animation/animated_histogram`
+* :doc:`../gallery/animation/rain`
+* :doc:`../gallery/animation/random_walk`
+* :doc:`../gallery/animation/simple_anim`
+* :doc:`../gallery/animation/strip_chart`
+* :doc:`../gallery/animation/unchained`
 
 ``ArtistAnimation``
 -------------------
@@ -187,10 +184,7 @@ Examples
 Examples
 ~~~~~~~~
 
-.. toctree::
-   :maxdepth: 1
-
-   ../gallery/animation/dynamic_image
+* :doc:`../gallery/animation/dynamic_image`
 
 Writer Classes
 ==============
@@ -273,10 +267,7 @@ to ensure that setup and cleanup are performed as necessary.
 Examples
 --------
 
-.. toctree::
-   :maxdepth: 1
-
-   ../gallery/animation/frame_grabbing_sgskip
+* :doc:`../gallery/animation/frame_grabbing_sgskip`
 
 .. _ani_writer_classes: