Sphinx it4freedom Theme

A modern responsive theme for python's Sphinx documentation generator based on sphinx_press_theme and ablog.

This theme is based on VuePress. It uses Vue.js and LessCSS managed by webpack through vue-cli.

Usage

On Sphinx project's conf.py: set the theme name to it4freedom.

System Message: WARNING/2 (<stdin>, line 17)

Cannot analyze code. Pygments package not found.

.. code:: python

   html_theme = "it4freedom"

See details on Sphinx theming docs.

Development

To rebuild web assets:

System Message: WARNING/2 (<stdin>, line 28)

Cannot analyze code. Pygments package not found.

.. code:: bash

   npm run build

Install theme locally with pip install -e ..

docs folder contains theme's own documentantion.

System Message: WARNING/2 (<stdin>, line 36)

Cannot analyze code. Pygments package not found.

.. code:: bash

   cd docs
   make clean; make html

Compatibility

This theme needs CSS vars enabled in the browser, so it doesn't work on IE. Four color variations are available :

• light low contrast (default) ;

• light high contrast ;

• dark low contrast ;

• dark high contrast.

The good one is used based on prefers-contrast and prefers-color-scheme media queries. This is automatically done by a compatible browser. If not, the default theme is used. Some browsers need manual configuration like Chromium on Linux (a flag to enable for all websites).

Example

See the IT4Freedom's web site