This is a playground for a new VyOS documentation starting for VyOS 1.2 (Crux) release.

Build

Native

To build the manual run the following commands inside the docs folder:

• make html for a HTML manual
• make latexpdf for a LaTeX rendered PDF

Required Debian Packages:

• python-sphinx
• python-sphinx-rtd-theme
• latexmk
• texlive-latex-recommended
• texlive-fonts-recommended
• texlive-latex-extra

Docker

Using our Dockerfile you create your own Docker container that is used to build a VyOS documentation.

Setup

$ docker build -t vyos-docu docker

Build

Linux

$ docker run --rm -it -v "$(pwd)":/vyos -w /vyos/docs -e GOSU_UID=$(id -u) -e GOSU_GID=$(id -g) vyos-docu make html