diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 17:56:50 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 17:56:50 +0000 |
commit | 6637322c8ab1c5ff80a2b6ca59c9ba1d40aeba2c (patch) | |
tree | 04e41667e9eae835f5d88bda4f6d3f5c2664de01 /README.rst | |
parent | Initial commit. (diff) | |
download | sphinx-rtd-theme-6637322c8ab1c5ff80a2b6ca59c9ba1d40aeba2c.tar.xz sphinx-rtd-theme-6637322c8ab1c5ff80a2b6ca59c9ba1d40aeba2c.zip |
Adding upstream version 2.0.0+dfsg.upstream/2.0.0+dfsgupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..f51d8b2 --- /dev/null +++ b/README.rst @@ -0,0 +1,74 @@ +************************** +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 |