Skip to main content

An awesome theme for the Sphinx documentation generator

Project description

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.

Project details


Release history Release notifications | RSS feed

This version

5.3.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinxawesome_theme-5.3.2.tar.gz (364.0 kB view hashes)

Uploaded Source

Built Distribution

sphinxawesome_theme-5.3.2-py3-none-any.whl (375.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page