A Sphinx theme with the look and feel of napari based on the awesome pydata-sphinx-theme.
Since the napari-sphinx-theme extends the pydata-sphinx-theme, the configurations and affordances provided by the PyData Sphinx Theme can be used within the napari docs.
After creating a virtual environment, install the theme in editable mode:
python -m pip install -e .Modify options in theme.conf to customize the pydata-sphinx-theme for napari.
Styling settings and napari's custom CSS is found in the
static/css/napari-sphinx-theme.css file.
The styling of code snippets is configured in napari_sphinx_theme/napari_code_theme.py.
To modify page layouts, modify the html template files in the napari_sphinx_theme
and napari_sphinx_theme/partials directories.
To build the demo site found in this repo, run:
cd docs/
make htmlUse the demo site to manually test changes to styles and page layouts.
The napari website is built using the napari docs repo. The styling of the website is based on this theme. Install this theme as a dependency in the napari docs repo.
To modify the website's styling, minor changes to CSS can be made in the docs repo. More significant changes, such as those that may impact the entire website and docs, should be made here.