There is a PDF ready-made for you at [] but you can use this if you want to build it yourself.
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
mkdir -p orchestration
git mv $src $dst
perl -pi -e "s|$src|$dst|" chapters-md.txt
python build/mdbook/mv-links.py $src $dst
git checkout $dst
make check-links-local
When included images are too large, make them smaller a bit:
mogrify -format png -resize 1024x1024\> *png