2024-10-14 14:05:23 +02:00
|
|
|
Building the doc locally
|
|
|
|
|
============================
|
|
|
|
|
|
|
|
|
|
install
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
First, install a python virtual environment::
|
|
|
|
|
|
|
|
|
|
python -m venv .venv
|
|
|
|
|
source .venv/bin/activate
|
|
|
|
|
|
|
|
|
|
Then install the sphinx libraries::
|
|
|
|
|
|
|
|
|
|
./.venv/bin/pip3 install sphinx
|
|
|
|
|
./.venv/bin/pip3 install sphinx_rtd_theme
|
|
|
|
|
./.venv/bin/pip3 install sphinx_lesson
|
2024-10-14 22:51:05 +02:00
|
|
|
./.venv/bin/pip3 install httpx
|
|
|
|
|
|
2024-10-14 14:05:23 +02:00
|
|
|
|
|
|
|
|
The generatef html output is located in the `docs/build/html` subfolder,
|
|
|
|
|
you can modify the target or the output type in the :file:`docs/Makefile`.
|
|
|
|
|
|
|
|
|
|
scraps
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
`variable <https://en.wikipedia.org/wiki/Variable_(computer_science)>`_
|
