Installation and Usage§
Make sure you have Python installed.
Install the Python package
insipid-sphinx-theme, e.g. with pip:
python3 -m pip install insipid-sphinx-theme --user
Depending on your Python installation, you may have to use
python3. If you want to install the module system-wide for all users (assuming you have the necessary rights), you should drop the
--userflag. If you are using a virtual environment, you should also drop the
--userflag (otherwise you’ll get an error like
ERROR: Can not perform a '--user' install. User site-packages are not visible in this virtualenv.). If you have installed the module already, you can use the
--upgradeflag to get the newest release.
conf.pyfile (just create an empty file if it doesn’t exist yet, or use sphinx-quickstart) and add/edit the line:
html_theme = 'insipid'
Make sure your source files are in the same directory as your
conf.py. If you don’t have any source files yet, you can start with a simple
My Docs ======= Hello, world!
At some point, you’ll probably want to have more than one page. You can use the
toctreedirective to include additional pages.
Run Sphinx, e.g. by using:
python3 -m sphinx <source-dir> <build-dir>
<source-dir>is the directory that contains your
<build-dir>is the place where the generated HTML files should be written to. For example, the full command could look something like this:
python3 -m sphinx doc html-files
For more options, see sphinx-build.
It is convenient to install the theme as a Python package,
because this way Sphinx can find it easily
and you don’t have to worry about where the theme’s files are stored.
However, the package installation is not strictly necessary
insipid theme is just a theme
and not a full-blown Sphinx extension).
If you don’t want to install the package,
you can instead use
to tell Sphinx where the directory containing the
insipid directory is.
For example, you could include the insipid-sphinx-theme repository
as a Git submodule in your own repository and point to that submodule
html_theme_path = ['path-to-submodule/src/insipid_sphinx_theme'] html_theme = 'insipid'