This document assumes you're working from the root of the repo.
- Install python packages used during book build
pip install -r build/requirements.txt
- Download the free version of Prince XML. It's used to build the pdf version of this book.
make html
make pdf
It will first build the html target and then will use it to build the pdf version.
To validate that all local links and anchored links are valid run:
make check-links-local
To additionally also check external links
make check-links-all
use the latter sparingly to avoid being banned for hammering servers.
e.g. slurm => orchestration/slurm
src=slurm
dst=orchestration/slurm
git mv $src $dst
perl -pi -e "s|$src|$dst|" chapters-md.txt
python build/utils/mv-links.py $src $dst
make check-links-local