Building a printable handbook (optional)

Some readers want a single PDF (offline reading on clusters, proposals, teaching). This repository does not require Pandoc for a normal build; handbook generation is optional.

Prerequisites

  • pandoc on PATH

  • A LaTeX engine if you want PDF output (e.g. pdflatex via a TeX Live install)

Generate

From the repository root:

./scripts/build_handbook.sh

The script concatenates the manifest order in handbook_manifest.txt and writes build-handbook/openpfc-handbook.pdf when LaTeX is available; otherwise it may emit Markdown only—see script output.

Note: CI does not fail if Pandoc is missing; this is a maintainer / educator convenience.

See also