Build Documentation Guide

Contents

Build Documentation Guide#

1. Prerequisites (Debian)#

Download and install dependencies:

sudo apt-get update --fix-missing
sudo apt-get install -y \
        --no-install-recommends -y \
        python3-sphinx \
        python3-pip \
        python3 \
        make

Download and install python3 pip dependencies:

python3 -m pip install        \
        sphinx_book_theme     \
        myst_parser           \
        sphinxcontrib.mermaid \
        sphinx-copybutton

2. Build documentation (HTML)#

Execute make build command to build HTML option

make -C {project_dir}/doc/sphinx html

3. Open built documentation (HTML)#

cd {project_dir}/doc/_build/html

Open index.html via web browser

3.1. Alternative run nginx server#

docker run -it --rm -d -p 8080:80 --name web -v ./doc/_build/html:/usr/share/nginx/html nginx

Open index.html via web browser using http://<you-ip-addr>:8080/ or using local address http://127.0.0.1:8080/