Merge pull request matplotlib#30810 from rcomer/rst-ci

Fix rstcheck failures

Author: tacaswell

doc/api/toolkits/mplot3d/faq.rst

@@ -6,8 +6,7 @@ mplot3d FAQ
 
 How is mplot3d different from Mayavi?
 =====================================
-`Mayavi <https://docs.enthought.com/mayavi/mayavi/>`_
-is a very powerful and featureful 3D graphing library. For advanced
+Mayavi_ is a very powerful and featureful 3D graphing library. For advanced
 3D scenes and excellent rendering capabilities, it is highly recommended to
 use Mayavi.
 
@@ -37,8 +36,7 @@ rendered properly in matplotlib's 2D rendering engine.
 
 This problem will likely not be solved until OpenGL support is added to all of
 the backends (patches are greatly welcomed). Until then, if you need complex
-3D scenes, we recommend using
-`MayaVi <https://docs.enthought.com/mayavi/mayavi/>`_.
+3D scenes, we recommend using Mayavi_.
 
 
 I don't like how the 3D plot is laid out, how do I change that?
@@ -49,3 +47,5 @@ Work is being done to eliminate this issue. For matplotlib v1.1.0, there is
 a semi-official manner to modify these parameters. See the note in the
 :mod:`.mplot3d.axis3d` section of the mplot3d API documentation for
 more information.
+
+.. _Mayavi: https://docs.enthought.com/mayavi/mayavi/

doc/api/toolkits/mplot3d/view_angles.rst

@@ -11,8 +11,7 @@ The position of the viewport "camera" in a 3D plot is defined by three angles:
 *elevation*, *azimuth*, and *roll*. From the resulting position, it always
 points towards the center of the plot box volume. The angle direction is a
 common convention, and is shared with
-`PyVista <https://docs.pyvista.org/api/core/camera.html>`_ and
-`MATLAB <https://www.mathworks.com/help/matlab/ref/view.html>`_.
+`PyVista <https://docs.pyvista.org/api/core/camera.html>`_ and MATLAB_.
 Note that a positive roll angle rotates the
 viewing plane clockwise, so the 3d axes will appear to rotate
 counter-clockwise.
@@ -51,8 +50,7 @@ can be specified by setting :rc:`axes3d.mouserotationstyle`, see
 :doc:`/users/explain/customizing`.
 
 Prior to v3.10, the 2D mouse position corresponded directly
-to azimuth and elevation; this is also how it is done
-in `MATLAB <https://www.mathworks.com/help/matlab/ref/view.html>`_.
+to azimuth and elevation; this is also how it is done in MATLAB_.
 To keep it this way, set ``mouserotationstyle: azel``.
 This approach works fine for spherical coordinate plots, where the *z* axis is special;
 however, it leads to a kind of 'gimbal lock' when looking down the *z* axis:
@@ -131,7 +129,7 @@ Henriksen et al. [Henriksen2002]_ provide an overview. In summary:
 
 You can try out one of the various mouse rotation styles using:
 
-.. code::
+.. code-block:: python
 
     import matplotlib as mpl
     mpl.rcParams['axes3d.mouserotationstyle'] = 'trackball'  # 'azel', 'trackball', 'sphere', or 'arcball'
@@ -188,6 +186,7 @@ the arcball to the border occurs at 45°, set the border width to
 The border is a circular arc, wrapped around the arcball sphere cylindrically
 (like a doughnut), joined smoothly to the sphere, much like Bell's hyperbola.
 
+.. _MATLAB: https://www.mathworks.com/help/matlab/ref/view.html
 
 .. [Shoemake1992] Ken Shoemake, "ARCBALL: A user interface for specifying
   three-dimensional rotation using a mouse", in Proceedings of Graphics

doc/devel/contribute.rst

@@ -245,11 +245,11 @@ process works, technical questions about the code, what makes for good
 documentation or a blog post, how to get involved in community work, or get a
 "pre-review" on your PR.
 
-To join, please go to our public community_ channel, and ask to be added to
+To join, please go to our public `community gitter`_ channel, and ask to be added to
 ``#incubator``. One of our core developers will see your message and will add you.
 
 .. _gitter: https://gitter.im/matplotlib/matplotlib
-.. _community: https://gitter.im/matplotlib/community
+.. _community gitter: https://gitter.im/matplotlib/community
 
 .. _good_first_issues:
 
@@ -313,10 +313,7 @@ active contributors, many of whom felt just like you when they started out and
 are happy to welcome you and support you as you get to know how we work, and
 where things are. You can reach out on any of our :ref:`communication-channels`.
 For development questions we recommend reaching out on our development gitter_
-chat room and for community questions reach out at community_.
-
-.. _gitter: https://gitter.im/matplotlib/matplotlib
-.. _community: https://gitter.im/matplotlib/community
+chat room and for community questions reach out at `community gitter`_.
 
 .. _managing_issues_prs:
 

doc/devel/development_setup.rst

@@ -38,7 +38,7 @@ Set up development environment
 ==============================
 
 You can either work locally on your machine, or online in
-`GitHub Codespaces <github-codespaces_>`_, a cloud-based in-browser development
+`GitHub Codespaces`_, a cloud-based in-browser development
 environment.
 
 
@@ -219,7 +219,7 @@ need to be installed when working in codespaces.
 Create GitHub Codespace :octicon:`codespaces`
 ---------------------------------------------
 
-`GitHub Codespaces <github-codespaces_>`_ is a cloud-based
+`GitHub Codespaces`_ is a cloud-based
 in-browser development environment that comes with the appropriate setup to
 contribute to Matplotlib.
 
@@ -260,7 +260,7 @@ Use the "Extensions" icon in the activity bar to install the "Live Server"
 extension. Locate the ``doc/build/html`` folder in the Explorer, right click
 the file you want to open and select "Open with Live Server."
 
-.. _`github-codespaces`: https://docs.github.com/codespaces
+.. _Github Codespaces: https://docs.github.com/codespaces
 
 .. _development-install:
 

doc/install/dependencies.rst

@@ -234,7 +234,7 @@ means that the dependencies must be explicitly installed, either by :ref:`creati
 - `setuptools_scm <https://pypi.org/project/setuptools-scm/>`_ (>= 7).  Used to
   update the reported ``mpl.__version__`` based on the current git commit.
   Also a runtime dependency for editable installs.
-- `NumPy <https://numpy.org>`_ (>= 1.22).  Also a runtime dependency.
+- NumPy_ (>= 1.22).  Also a runtime dependency.
 
 
 .. _compile-build-dependencies:
@@ -473,7 +473,7 @@ Optional
 The documentation can be built without Inkscape and optipng, but the build
 process will raise various warnings.
 
-* `Inkscape <https://inkscape.org>`_
+* Inkscape_
 * `optipng <http://optipng.sourceforge.net>`_
 * the font `xkcd script <https://github.com/ipython/xkcd-font/>`_ or `Comic Neue <https://github.com/crozynski/comicneue>`_
 * the font "Times New Roman"

doc/install/index.rst

@@ -70,7 +70,7 @@ Python distributions
 
 Matplotlib is part of major Python distributions:
 
-- `Anaconda <https://www.anaconda.com/>`_
+- Anaconda_
 - `ActiveState ActivePython
   <https://www.activestate.com/products/python/downloads/>`_
 - `WinPython <https://winpython.github.io/>`_