Skip to content

Latest commit

 

History

History
51 lines (33 loc) · 1.71 KB

README.md

File metadata and controls

51 lines (33 loc) · 1.71 KB

Sphinx awesome theme

MIT license PyPI version

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

Get started

  1. Install the theme as a Python package:

    pip install sphinxawesome-theme

    For more information, see Install the theme.

  2. Add sphinxawesome_theme as an HTML theme in your Sphinx configuration file conf.py:

    html_theme = "sphinxawesome_theme"

    For more information, see Add your theme.

Features

With the Awesome Theme, you can build readable, functional, and beautiful documentation websites.

Awesome code blocks

  • Code block have a Copy button for copying the code.

  • You can use these additional options in code-block directives:

    • emphasize-added. Highlight lines that should be added
    • emphasize-removed. Highlight lines that should be removed
    • emphasize-text: TEXT. Highlight TEXT in the code block

Better headerlinks

Clicking the link icon after headers or captions automatically copies the URL to the clipboard.

DocSearch

This theme supports the sphinx-docsearch extension to replace the built-in search with Algolia DocSearch.