We welcome contributions to this documentation! Before making any changes, please read the Contribution Guide.
Clone the Git repository:
git clone [email protected]:phytec/doc-bsp-yocto.git
Change your current working directory to the just cloned source code:
cd doc-bsp-yocto/
This documentation depends on Python tox for
building. It is recommended to install it in a virtualenv with pip. All required
dependencies are specified in requirements/
:
python3 -m venv env source env/bin/activate pip3 install -r requirements/setup.txt
Make also sure that your system has following tools installed (example for debian based systems):
apt install latexmk texlive-xetex
Build the documentation as HTML, which is the default build target:
tox
To produce a LaTeX generated PDF documentation, specify the target explicitly:
tox -e py3-pdf
Open the locally built HTML pages in your webbrowser:
xdg-open build/html/index.html