This is a simple and (hopefully) clean theme for Sphinx. You can see it used here. Or see screenshots at the bottom of this page.
One of:
- download a release and extract it to your Sphinx doc directory.
git clone
this repo and copyfreja/_static
andfreja/_templates
to your Sphinx doc directory.
See templating for more info. The relevant bits:
To customize the output of your documentation you can override all the templates (both the layout templates and the child templates) by adding files with the same name as the original filename into the template directory of the structure the Sphinx quickstart generated for you.
Sphinx will look for templates in the folders of templates_path first, and if it can’t find the template it’s looking for there, it falls back to the selected theme’s templates.
Thus the _templates/layout.html
.
This theme/layout override might not provide all the bells and whistles of a full-blown theme.
It provides:
- An overall layout
- ToC for current page
- ToC for overall docs
- Support for class/method/params/fields
- Support for index pages
- Support for the search page
- Support for project logo (set in your conf.py and add image to
_static
) - All within one file
It does not provide
- Full featured support for everything Sphinx has to offer (I don't know what that may be though :) )
- Extensibility (yet?). It does not inherit from basic theme's layout and does not provide blocks itself
- i18n for hardcoded strings. Once again, not realy using all of Sphinx's features
Version 0.2 is based on Elixir docs.
Linear Icons licensed under CC BY-SA 4.0.