Skip to content

enthought/enthought-sphinx-theme

Repository files navigation

enthought-sphinx-theme

Sphinx theme for Enthought projects, derived from the Scipy theme.

Installation

Install this as a normal Python package. The theme files are in the package data.

In your project's conf.py file, do the following:

import enthought_sphinx_theme
html_theme_path = [enthought_sphinx_theme.theme_path]
html_theme = 'enthought'

Theme options

The theme takes the followin options in the html_theme_options configuration variable:

  • rootlinks

    List of tuples (url, link_name) to show in the beginning of the breadcrumb list on the top left. You can override it by defining an edit_link block in searchbox.html.

  • sidebar

    One of "left", "right", "none". Defines where the sidebar should appear.

  • navigation_links

    True or False. Whether to display "next", "prev", "index", etc. links.

  • use_default_logo

    True or False. Whether to use the default Enthought logo in the sidebar. If the html_logo configuration parameter is non-empty, it will override this. Set this to False and html_logo to empty only if you want no logo at all.

  • use_default_favicon

    True or False. Whether to use the default Enthought logo as the favicon. If the html_favicon configuration parameter is non-empty, it will override this. Set this to False and html_favicon to empty only if you want no favicon at all.

The following blocks are defined:

  • layout.html:header

    Block at the top of the page, for logo etc.