pendoc

Build PenText XML reports into PDFs using Docker. Packages Saxon HE 9.7 and Apache FOP into a container so you don't need Java or FOP installed locally.

Requirements

• Docker

Setup

make install          # symlink to ~/.local/bin
make install-system   # symlink to /usr/local/bin (may need sudo)

The Docker image is built on first invocation. Subsequent runs reuse the cached image.

Usage

pendoc                            # build report in current dir
pendoc /path/to/pentext-project   # build from a specific project
pendoc -w                         # watch mode - rebuild on changes
pendoc -w /path/to/pentext-project

Output is written to target/report.pdf inside the project directory.

Flag	Description
-w, --watch	Watch for .xml/.xsl/.xslt changes and rebuild
-h, --help	Show help

How it works

1. XML to XSL-FO - Saxon HE transforms source/report.xml via xslt/generate_report.xsl
2. XSL-FO to PDF - Apache FOP renders to PDF using fonts/fop.conf

Watch mode monitors source/, findings/, non-findings/, and xslt/ using inotifywait with a 1-second debounce.