...
Create a virtual environment for the project:
python3 -m venv env
Activate the virtual environment:
source env/bin/activate- An
(env)now appears at the beginning of your prompt.
Install all the required dependencies in this virtual environment:
pip install -r common/build_toolsCI/requirements.txt
Run the following command in the project directory:
mkdocs serve
In the output of this command, follow the link displayed on the line that looks like the following:
[I 190206 18:48:47 server:298] Serving on http://127.0.0.1:8000In this case, go to
http://127.0.0.1:8000. You can let this server run while you work on the documentation. It updates the local website automatically when you save changes in your Markdown files.
Deactivate the virtual environment if you work on another Python project, by running
deactivate. You can preview the same documentation site again starting from step 3 and skipping step 4, until you update Python.
...