beffroi-tools/docs/exporter.md

26 lines
1.3 KiB
Markdown

# Export presentations and PDF pages
```sh
python3 tools/exporter.py presentation.pptx --output pdf,images
python3 tools/exporter.py document.pdf --output images
python3 tools/exporter.py presentation.pptx --output images --dpi 192 -d exports
```
`exporter.py` uses DeckCraft for PPTX exports and PdfCraft for PDF page rendering.
It finds `deckcraft-cli` / `pdfcraft-cli` on `PATH`, or temporarily extracts the
bundled CLI from the newest matching AppImage in `~/Applications`. You can
specify a CLI executable or AppImage with `--deckcraft-cli` / `--pdfcraft-cli`,
or the `DECKCRAFT_CLI` / `PDFCRAFT_CLI` environment variables.
Output goes to `<file-stem>_export/`: `<file-stem>.pdf` and/or numbered PNGs
inside `images/`. Images default to 144 DPI. Existing output requires
`--overwrite`, which replaces generated files and removes stale numbered
slide/page PNGs. PDF-to-PDF is a successful no-op; other input extensions are
errors. Rendering completes in temporary storage before output is copied.
Interactive terminals show an updating progress line, with page counts for PDF
rendering and a spinner during DeckCraft's bulk export. Only output paths, the
final summary, and warnings/errors remain afterward. Redirected output uses
plain line logs. Set `NO_COLOR` to disable colors or `TERM=dumb` to disable
animation as well.