Skip to content

Create beautiful and awesome websites with the Sphinx documentation generator.

License

Notifications You must be signed in to change notification settings

kai687/sphinxawesome-theme

Repository files navigation

Sphinx awesome theme

MIT license PyPI version Netlify Deploy GitHub Workflow Status

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.