Nefertiti for Sphinx 
Nefertiti is a theme for Sphinx that features:
- Responsive design, based on Bootstrap 5.3.
- Text input field to filter the index.
- Font configuration compliant with EU's GDPR.
- Different fonts can be used for different elements.
- Light and dark color schemes, for normal text and code highlighted with Pygments styles.
- Images that switch between color schemes. Released as sphinx-colorschemed-images.
- Diverse color sets are available: blue, indigo, purple, pink, red, orange, yellow, ...
- Header and footer links. Header links can be grouped in dropdown elements.
- Optional highlighting of the project repository in the header.
- Optional project version selector in the header.
- Back-to-top button.
See it in action in sphinx-themes.org.
Tested
- Tested against Sphinx 7.3, 7.4, 8.0 and 8.1, see matrix python-sphinx.
- Tested with NodeJS v20, see javascript-tests.
Index filtering
By default the index shows the content folded. Opening or closing items is remembered while browsing the documentation. To quickly find items use the input filter. The filter will display items that could be invisible within a folded item. When the user types in the input field, let us say fo, the index gets filtered with all the entries that match those two characters. So the index will display three matches: Fonts, Footer links and Footnotes. Those three entries were all folded within their sections:
The TOC on the right side
The Table of Contents, displayed on the right side, spans itself to the right border of the browser to display long items, improving readability.
Other features
Nefertiti for Sphinx comes with the following color sets. Change between them using the attribute display of the html_theme_options setting.
In order to be compliant with EU's GDPR, Nefertiti for Sphinx comes bundled with a group of fonts licensed for free distribution. Adding more fonts is explained in the User's Guide:
- Assistant
- Exo
- Montserrat
- Mulish
- Nunito
- Open Sans
- Red Hat Display
- Sofia Sans
- Ubuntu Sans
- Varta
- Work Sans
- Fira Code (monospace)
- Red Hat Mono (monospace)
- Ubuntu Sans Mono (monospace)
Combine up to 5 different fonts:
html_theme_options = {
"sans_serif_font": "Nunito",
"documentation_font": "Open Sans",
"monospace_font": "Ubuntu Sans Mono",
"project_name_font": "Nunito",
"doc_headers_font": "Georgia",
"documentation_font_size": "1.2rem",
"monospace_font_size": "1.1rem",
}
To use it
Install the package from PyPI:
pip install sphinx-nefertiti
Edit the conf.py file of your Sphinx project and change the html_theme setting:
html_theme = "sphinx_nefertiti"
Now rebuild the docs and serve them to get a first glimpse of your site made up with Nefertiti for Sphinx. It has many customizable options worth to explore. You might want to continue reading the customization section of the docs.
To develop it
Clone the Git repository, create a Python virtual environment, and install the NodeJS packages:
git clone git@github.com:danirus/sphinx-nefertiti.git
cd sphinx-nefertiti
python3.12 -m venv venv
source venv/bin/activate
pip install -e .
nvm use --lts
npm install
Before contributing, please, install the pre-commit hook scripts:
pre-commit install
There are a comprehensive number of scripts in the package.json. Beyond them there is a Makefile that saves time when building the CSS and JavaScript bundles to deliver them within the Python package of the theme.
Further read the following sections:
License
Project distributed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for sphinx-nefertiti 0.9.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinx_nefertiti-0.9.9.tar.gz | 9.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinx_nefertiti-0.9.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.0 MB
Release files / sphinx_nefertiti-0.9.9.tar.gz
| Download URL | sphinx_nefertiti-0.9.9.tar.gz |
|---|---|
| Size | 9.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
95b5afb967af52318977c02e70eefce9b45a6b8e40f3f1ad0bb65a40c402622b
|
|
BLAKE2b-256 checksum How to use checksums |
6ae0c9252b4caff310cdeebe397f575f77629ea92e24c1c872ef4a8ce155aaf5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Release files / sphinx_nefertiti-0.9.9-py3-none-any.whl
| Download URL | sphinx_nefertiti-0.9.9-py3-none-any.whl |
|---|---|
| Size | 9.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dd0b7a33b8c2f7cbbe9db8c0d886e9e788741744f3e7010fccd405034e0bf4ef
|
|
BLAKE2b-256 checksum How to use checksums |
d15573acc5ae0059049a76d382bca2957cac51e46580f85c3f2f391e462a5e81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
