How to build the documentation

How to build the documentation

Install prerequisites: Debian-based linux

apt install cmake g++ gfortran ninja-build bzip2 zlib1g-dev libnetcdf-mpi-dev libopenmpi-dev doxygen python3-pygments python3-jinja2 texlive-latex-base texlive-latex-extra texlive-fonts-extra lcov cppcheck
wget https://github.com/RPGillespie6/fastcov/raw/master/fastcov.py -O /usr/local/bin/fastcov.py
chmod a+rx /usr/local/bin/fastcov.py

To clone and build the documentation do

git clone https://codeberg.org/xyst/xyst.git && cd xyst
mkdir build && cd build
cmake -DBUILD_DOC=on ../src
make doc

The documentation will be accessible on the local file system at xyst/build/doc/html/index.html.