Initial commit

2026-08-20 11:41:17 +00:00
commit 6949695eac
2334 changed files with 646393 additions and 0 deletions
@@ -0,0 +1,47 @@
+# External Preflight Matrix
+
+This folder contains a minimal scaffold to generate one sample PDF for each supported mode and run external validators.
+
+## Included scripts
+
+- `generate_mode_samples.php` generates sample PDFs for:
+  - `pdfx`, `pdfx1a`, `pdfx3`, `pdfx4`, `pdfx5`
+  - `pdfua`, `pdfua1`, `pdfua2`
+- `run_preflight_matrix.sh` runs:
+  - `qpdf --check` when `qpdf` is available
+  - `verapdf --format text --flavour ua1|ua2` for PDF/UA samples when `verapdf` is available
+  - a custom PDF/X validator command when `PDFX_VALIDATOR_CMD` is set
+
+## Usage
+
+From the repository root:
+
+```bash
+make preflight
+```
+
+Optional PDF/X validator hook:
+
+```bash
+PDFX_VALIDATOR_CMD='my-pdfx-validator --mode "$MODE" "$FILE"' make preflight
+```
+
+The script runs the command through `bash -lc` with these environment variables set per file:
+
+- `MODE`: the current conformance mode, for example `pdfx4`
+- `FILE`: the generated sample PDF path
+- `REPORT`: the report file path under `target/preflight/report/`
+
+Optional custom output directory:
+
+```bash
+bash resources/preflight/run_preflight_matrix.sh /tmp/tc-lib-pdf-preflight
+```
+
+Reports are written under `target/preflight/report/` (or the custom output path).
+
+## Notes
+
+- This is a tooling scaffold for repeatable external validation runs.
+- veraPDF is used here as an explicit PDF/UA validator, not as a PDF/X validator.
+- Final compliance claims still require profile-specific preflight policies and manual review using your selected validation authority.