sphinxawesome-theme 3.2.2

An awesome theme for the Sphinx documentation generator

Sphinx awesome theme

Create beautiful and awesome documentation websites with Sphinx. See how the theme looks like on sphinxawesome.xyz.

Get started

To use this theme for your documentation, install it via pip and add it to your Sphinx configuration.

1. Install the theme as a Python package:

   pip install sphinxawesome-theme
   

   See How to install the theme for more information.

2. Set html_theme in the Sphinx configuration file conf.py:

   html_theme = "sphinxawesome_theme"
   

   See How to load the theme for more information.

You can change some parts of this theme. See How to configure the theme for more information.

Features

With this awesome theme, you can build readable, functional, and beautiful documentation websites. Compared to other Sphinx themes, these features enhance the user experience:

Awesome code blocks

The code block shows the language of the code in a header. Each code block has a Copy button for easy copying. This theme enhances Sphinx's code-block directive with:

• emphasize-added: highlight lines that should be added to code
• emphasize-removed: highlight lines that should be removed from the code
• emphasize-placeholder: PLACEHOLDER: highlight PLACEHOLDER in the code block to emphasize placeholder text the user should replace.

Collapsible elements

Nested navigation links allow you to reach all pages from all other pages. You can make code object definitions, like methods, classes, or modules, collapsible as well, to focus on one block at a time.

Better headerlinks

Clicking the link icon after a header or caption automatically copies the URL to the clipboard.

Better keyboard navigation

Use the / key to start searching. Use the Tab key to quickly skip through all sections on the page. Use the Space key to expand or collapse items in the navigation menu or in code definitions.