Sphinx theme for readthedocs.org
Go to file
Aaron Carlisle 30b57e66d3
Set collapse_navigation to true (#600)
This matches 0.2.4 behavior. Although it might not be desired behavior, the behavior of setting this to true can result in file size to explode and build times also.

This was caused by bf9faa98f0 which effectly switched the logic of `collapse_navigation`
2018-04-02 13:31:22 -04:00
.github Create CODE_OF_CONDUCT.md (#562) 2018-02-02 18:43:18 -05:00
docs Update changelog to 0.3.0 for release 2018-03-29 18:32:12 -06:00
js use id to find the future current sidebar item (#586) 2018-03-18 12:40:45 -04:00
sass Merge branch 'master' into foldable-local-toc 2018-03-29 17:35:01 -06:00
sphinx_rtd_theme Set collapse_navigation to true (#600) 2018-04-02 13:31:22 -04:00
tests Adds testing and hopefully a final fix for the empty toctree issue 2017-03-06 14:45:58 -08:00
.gitignore Add bower to dev depends 2018-03-29 18:20:23 -06:00
.travis.yml No double build 2017-12-20 20:37:27 -08:00
Apache-License-2.0.txt Add local google font 2014-08-25 16:13:38 -04:00
bower.json Replace the name 'Dave Snider' with RTD (#572) 2018-03-19 07:56:34 -04:00
Gruntfile.js Uglify during build 2017-12-28 10:22:16 +01:00
LICENSE Replace the name 'Dave Snider' with RTD (#572) 2018-03-19 07:56:34 -04:00
MANIFEST.in Include fontawesome-webfont.woff2 in pip package 2017-03-05 19:50:44 +01:00
OFL-License.txt Add local google font 2014-08-25 16:13:38 -04:00
package.json Merge branch 'master' into agj/changelog-0.3.0 2018-03-30 10:21:10 -06:00
README.rst Docs: Fix typos (#584) 2018-02-28 17:53:23 -05:00
setup.cfg Configure package as py2, py3 universal wheel 2016-09-26 20:26:33 +02:00
setup.py Replace the name 'Dave Snider' with RTD (#572) 2018-03-19 07:56:34 -04:00
tox.ini With deps 2017-12-20 20:39:13 -08:00

**************************
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://travis-ci.org/rtfd/sphinx_rtd_theme.svg?branch=master
   :target: https://travis-ci.org/rtfd/sphinx_rtd_theme
   :alt: Build Status
.. 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

The ``sphinx_rtd_theme`` is a sphinx_ theme designed to look modern and be mobile-friendly.
This theme is primary focused to be used on readthedocs.org_ but can work with your
own sphinx projects. To read more and see a working demo_ head over to readthedocs.org_.

.. _sphinx: http://www.sphinx-doc.org
.. _readthedocs.org: http://www.readthedocs.org
.. _demo: https://sphinx-rtd-theme.readthedocs.io/en/latest/


Installing
==========

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

   pip install sphinx_rtd_theme

For more information read the full installing docs
`here <https://sphinx-rtd-theme.readthedocs.io/en/latest/installing.html>`__.

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


Configuration
=============

The ``sphinx_rtd_theme`` is highly customizable on both the page level and on a global level.
To see all the possible configuration options read the configuring docs
`here <https://sphinx-rtd-theme.readthedocs.io/en/latest/configuring.html>`__.


Contributing
============

If you would like to help improve the theme or have more control
over the theme in case of a fork please read our contributing guide
`here <https://sphinx-rtd-theme.readthedocs.io/en/latest/contributing.html>`__.