Reword section on Third Party Themes

- No longer attempt to be the location for listing themes -- only Sphinx-RTD-Theme was listed here.
- Mention the classifier used when searching on PyPI.
- Emphasize sphinx-themes.org as a gallery of themes.
This commit is contained in:
Pradyun Gedam 2020-10-21 11:16:59 +05:30 committed by GitHub
parent e4e5ee3330
commit 18b2f2cdf2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -334,38 +334,15 @@ These themes are:
Third Party Themes Third Party Themes
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
.. cssclass:: longtable There are many third-party themes available for Sphinx. Some of these are for
general use, while others are specific to an individual project.
+--------------------+--------------------+ sphinx-themes.org__ is a gallery that showcases various themes for Sphinx,
| **Theme overview** | | with demo documentation rendered under each theme. Themes can also be found
+--------------------+--------------------+ on PyPI__ (using the classifier ``Framework :: Sphinx :: Theme``), GitHub__
| |sphinx_rtd_theme| | | and GitLab__.
| | |
| *sphinx_rtd_theme* | |
+--------------------+--------------------+
.. |sphinx_rtd_theme| image:: /_static/themes/sphinx_rtd_theme.png
There are many third-party themes available. Some of these are general use,
while others are specific to an individual project. A section of third-party
themes is listed below. Many more can be found on PyPI__, GitHub__, GitLab__ and
sphinx-themes.org__.
.. cssclass:: clear
**sphinx_rtd_theme**
`Read the Docs Sphinx Theme`_.
This is a mobile-friendly sphinx theme that was made for readthedocs.org.
View a working demo over on readthedocs.org. You can get install and options
information at `Read the Docs Sphinx Theme`_ page.
.. _Read the Docs Sphinx Theme: https://pypi.org/project/sphinx_rtd_theme/
.. versionchanged:: 1.4
**sphinx_rtd_theme** has become optional.
.. __: https://pypi.org/search/?q=&o=&c=Framework+%3A%3A+Sphinx+%3A%3A+Theme
.. __: https://github.com/search?utf8=%E2%9C%93&q=sphinx+theme&type=
.. __: https://gitlab.com/explore?name=sphinx+theme
.. __: https://sphinx-themes.org/ .. __: https://sphinx-themes.org/
.. __: https://pypi.org/search/?q=&o=&c=Framework+%3A%3A+Sphinx+%3A%3A+Theme
.. __: https://github.com/search?utf8=%E2%9C%93&q=sphinx+theme
.. __: https://gitlab.com/explore?name=sphinx+theme