https://github.com/readthedocs/sphinx_rtd_theme

Sphinx theme from Read the Docs
https://github.com/readthedocs/sphinx_rtd_theme

sphinx-doc sphinx-theme

Last synced: 7 months ago
JSON representation

Sphinx theme from Read the Docs

• Host: GitHub
• URL: https://github.com/readthedocs/sphinx_rtd_theme
• Owner: readthedocs
• License: mit
• Created: 2013-10-17T17:10:49.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2025-02-20T10:22:58.000Z (10 months ago)
• Last Synced: 2025-05-05T17:21:43.926Z (7 months ago)
• Topics: sphinx-doc, sphinx-theme
• Language: Sass
• Homepage: https://sphinx-rtd-theme.readthedocs.io/
• Size: 13.7 MB
• Stars: 4,901
• Watchers: 172
• Forks: 1,766
• Open Issues: 251
• Metadata Files:
  • Readme: README.rst
  • Contributing: docs/contributing.rst
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Support: docs/supported-browsers.csv

Awesome Lists containing this project

• best-of-python-dev - GitHub - 27% open · ⏱️ 01.12.2025): (Documentation)
• awesome-starred - readthedocs/sphinx_rtd_theme - Sphinx theme for readthedocs.org (others)
• awesome-mess - Read the Docs Sphinx Theme
• awesome-reverse-engineering - **3131**星

README

          
**************************

Read the Docs Sphinx Theme

**************************

.. image:: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg

   :target: https://pypi.python.org/pypi/sphinx_rtd_theme

   :alt: Pypi Version

.. image:: https://circleci.com/gh/readthedocs/sphinx_rtd_theme.svg?style=svg

   :alt: Build Status

   :target: https://circleci.com/gh/readthedocs/sphinx_rtd_theme

.. image:: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg

   :target: https://pypi.python.org/pypi/sphinx_rtd_theme/

   :alt: License

.. image:: https://readthedocs.org/projects/sphinx-rtd-theme/badge/?version=latest

  :target: http://sphinx-rtd-theme.readthedocs.io/en/latest/?badge=latest

  :alt: Documentation Status

This Sphinx_ theme was designed to provide a great reader experience for

documentation users on both desktop and mobile devices. This theme is used

primarily on `Read the Docs`_ but can work with any Sphinx project. You can find

a working demo of the theme in the `theme documentation`_

.. _Sphinx: http://www.sphinx-doc.org

.. _Read the Docs: http://www.readthedocs.org

.. _theme documentation: https://sphinx-rtd-theme.readthedocs.io/en/stable/

Installation

============

This theme is distributed on PyPI_ and can be installed with ``pip``:

.. code:: console

   $ pip install sphinx-rtd-theme

To use the theme in your Sphinx project, you will need to edit

your ``conf.py`` file's ``html_theme`` setting:

.. code:: python

    html_theme = "sphinx_rtd_theme"

.. admonition:: See also:

    `Supported browsers`_

        Officially supported and tested browser/operating system combinations

    `Supported dependencies`_

        Supported versions of Python, Sphinx, and other dependencies.

    `Example documentation`_

        A full example of this theme output, with localized strings enabled.

.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme

.. _Supported browsers: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-browsers

.. _Supported dependencies: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-dependencies

.. _Example documentation:  https://sphinx-rtd-theme.readthedocs.io/en/stable/

Configuration

=============

This theme is highly customizable on both the page level and on a global level.

To see all the possible configuration options, read the documentation on

`configuring the theme`_.

.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html

Contributing

============

If you would like to help modify or translate the theme, you'll find more

information on contributing in our `contributing guide`_.

.. _contributing guide: https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html