Awesome Sample#

This is a demo site for Awesome, generated as part of Sphinx Themes Gallery.

Important

This sample documentation was generated on Dec 16, 2024, and is rebuilt weekly.

Quickstart#

Install this theme:
```
$ pip install sphinxawesome-theme
```

Set the following in your existing Sphinx documentation’s conf.py file:

html_permalinks_icon = '<span>#</span>'
html_theme = 'sphinxawesome_theme'

Build your Sphinx documentation with the new theme! [1]

Documentation#

You can find this theme’s documentation at https://sphinxawesome.xyz.

Exploration#

The Kitchen Sink section contains pages that contains basically everything that you can with Sphinx “out-of-the-box”.

Kitchen Sink

Browsing through that section should give you a good idea of how stuff looks in this theme.

Navigation#

This is the most important part of a documentation theme. If you like the general look of the theme, please make sure that it is possible to easily navigate through this sample documentation.

Ideally, the pages listed below should also be reachable via links somewhere else on this page (like the sidebar, or a topbar). If they are not, then this theme might need additional configuration to provide the sort of site navigation that’s necessary for “real” documentation.

This is a caption

Some pages like Placeholder Page Three are declared in a “hidden” toctree, and thus would not be visible above. However, they are still a part of the overall site hierarchy and some themes may choose to present them to the user in the site navigation.