This repository contains Sphinx themes for Flask and Flask related projects. To use this theme in your Sphinx documentation:
Install the package using pip:
pip install Flask-Sphinx-Themes
Add this to
conf.py
:html_theme = 'flask'
The following themes exist for html_theme
.
flask | The standard Flask documentation theme for large projects |
flask_small | Small single page theme. Intended to be used by very small addon libraries for Flask. |
The following options can be set with html_theme_options
.
index_logo | Filename of a picture in _static to be used
as replacement for the h1 in the
index.rst file.
Default unset. |
index_logo_height | Height of the index logo. Default 120px. |
touch_icon | Filename of a picture in _static to be use
as the app icon on Apple devices.
Default unset. |
github_fork | Repository name on GitHub for the "Fork Me" badge. Default unset. |
github_ribbon_color | Color for the "Fork Me" badge. Default darkblue_121621. |
The following sidebar templates can be included in html_sidebars
.
relations.html | Show parent, previous, and next links. |
The theme automatically sets pygments_style
to the provided style.
Make sure you remove any override from conf.py
or set it to
flask_sphinx_themes.pygments.FlaskyStyle
.