An awesome theme for the Sphinx documentation generator
Project description
Sphinx awesome theme
Create beautiful and awesome documentation websites with Sphinx. See how the theme looks like on sphinxawesome.xyz.
Get started
-
Install the theme as a Python package:
pip install sphinxawesome-theme
For more information, see Install the theme.
-
Add
sphinxawesome_theme
as an HTML theme in your Sphinx configuration fileconf.py
:html_theme = "sphinxawesome_theme"
For more information, see Add your theme.
-
Optional: add bundled extensions for more awesome features:
# conf.py extensions += ["sphinxawesome_theme.docsearch", "sphinxawesome.highlighting"]
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.
-
If you load the bundled
sphinxawesome_theme.highlighting
, you can use these additional options in yourcode-block
directives:emphasize-added
. Highlight lines that should be added to codeemphasize-removed
. Highlight lines that should be removed from the codeemphasize-text: TEXT
. HighlightTEXT
in the code block to emphasize placeholder text.
Better headerlinks
Clicking the link icon after headers or captions automatically copies the URL to the clipboard.
DocSearch
If you have an Algolia DocSearch account for your documentation, you can use DocSearch for a search-as-you-type experience with autocomplete. Algolia DocSearch is free for open source documentation projects.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinxawesome_theme-5.0.0b5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 365fe8bd71e649c31551036d975d2836d2a32dc87f9501ec00dd004371085a83 |
|
MD5 | d4749f94679c575183dd9d1b8e77d653 |
|
BLAKE2b-256 | 559a14ccc730b629f8663b12d49cd8ccebde1908706b340e8119fa607198110c |
Hashes for sphinxawesome_theme-5.0.0b5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 084b5dfc0e3677a73969020a5938256d74dd73d67e031294e254f480d3099e70 |
|
MD5 | 8788ff946d4f10703e7aa5900fd3a4d2 |
|
BLAKE2b-256 | 51e608e1c58c71d71d0f5a1c88bfcdab6f144b7b8d86284ea9983dbf10882e5a |