First, you need to install Python 3 and PIP (if not already present on your system):
sudo apt-get install python3-pip
You might need to update PIP right away
pip3 install -U pip
Then, install pipenv
sudo pip install pipenv
Finally, install dependencies
pipenv install
and activate the pipenv shell
pipenv shell
Install the following required extensions
-
sphinx-tabs extension
pip install sphinx-tabs
-
sphinx-copybutton extension extension
pip install sphinx-copybutton
-
sphinxext-remoteliteralinclude extension
pip3 install sphinxext-remoteliteralinclude
-
pip install sphinx_rtd_theme
After meeting all requirements, you're ready to build the docs by running this command:
make html
The docs will be under build
folder.
To clear the build folder run
make clean
NOTE Remember that when building the docs you need to activate the pipenv shell.