If you find bugs, errors, omissions or other things that need improvement, please create an issue or a pull request at https://github.com/mgeier/insipid-sphinx-theme/. Contributions are always welcome!
git clone https://github.com/mgeier/insipid-sphinx-theme.git --recursive cd insipid-sphinx-theme python3 -m pip install -e .
-e stands for
When installing this way, you can quickly try other Git branches (in this example the branch is called “another-branch”):
git checkout another-branch
If you want to go back to the “master” branch, use:
git checkout master
To get the latest changes from Github, use:
git pull --ff-only
If you used the
--recursive option when cloning,
Font-Awesome submodule (containing the SVG icons)
will be checked out automatically.
If not, you can get the submodule with:
git submodule update --init
Building the Documentation#
If you make changes to the documentation, you should create the HTML pages locally using Sphinx and check if they look OK.
Initially, you might need to install a few packages that are needed to build the documentation:
python3 -m pip install -r doc/requirements.txt
To (re-)build the HTML files, use:
python3 setup.py build_sphinx
The generated files will be available in the directory
Auto-Generated Documentation for Pull Requests#
Whenever a Pull Request (PR) is created on https://github.com/mgeier/insipid-sphinx-theme/pull/, the documentation is automatically built on https://readthedocs.org/. On the PR page, find the latest commit and click on its green check mark (or on the red “x” in case of a test failure), look for the readthedocs.org entry and click on “Details” to see the auto-generated HTML pages.