sphinx-docs-theme 0.3.0

Prerequisites

Sphinx is required to make use of this theme, as it is meant to be integrated into a Sphinx project. To find more information about this check its webpage, which will also tell which Python interpreters can be used.

All other Python dependencies are indicated on the requirements.txt file.

These dependencies can be installed with:

$ pip install --upgrade -r requirements.txt

The frontend libraries are defined as npm dependencies, and require this package manager to be defined.

These dependencies can be installed with:

$ python setup.py frontend

Installing

The project is offered as a Pypi package, and using pip is the preferred way to install it. For this use the following command;

$ pip install sphinx-docs-theme

If needed, manual installation is possible:

$ python setup.py install

Using it as a dependency

If the project has been installed in the local libraries repository, it can be used just by adding the following lines to the conf.py file of any Sphinx project:

import sphinx_docs_theme

html_theme = 'sphinx_docs_theme'
html_theme_path = sphinx_docs_theme.get_html_theme_path()

Using it from the Sphinx themes folder

Another possibility is just adding the project code, contained int the ‘sphinx_docs_theme’ folder, to the themes folder of your Sphinx project, which is:

docs\_themes\sphinx_docs_theme\

And then it is just needed to add the following files to the conf.py file:

html_theme = 'sphinx_docs_theme'
html_theme_path = ["_themes", ]

Issues management

Issues are managed at the GitHub project issues tracker, where any Github user may report bugs or ask for new features.

Getting the code

If you wish to fork or modify the code, visit the GitHub project page, where the latest versions are always kept. Check the ‘master’ branch for the latest release, and the ‘develop’ for the current, and stable, development version.