Skip to content

Commit 254e8e6

Browse files
committed
docs(readme): note Ghostscript dependency for full PDF/A-2b conformance
L2 from logical-beaming-brooks.md plan: the format table advertises PDF/A-2b output, but the README never mentioned that full veraPDF conformance requires Ghostscript. Self-hosters running the local-Python install path could end up with markup-only PDF/A output that fails veraPDF when the source has unembedded fonts. Footnote on the PDF row + a one-paragraph note under the format table: - Docker image bundles Ghostscript (no action needed) - Local-Python installs follow docs/installation.md - Markup-only fallback is the visible behaviour without it No code change. The fallback path in app/converters/pdfa.py already exists and structured-logs `mode=markup` vs `mode=rerender` so operators can spot the gap; this just makes the dependency documented.
1 parent d484744 commit 254e8e6

1 file changed

Lines changed: 9 additions & 1 deletion

File tree

README.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ and [`COMMERCIAL-LICENSE.md`](COMMERCIAL-LICENSE.md).
8383
|---------------|------------------------------------------------------------------|-----------------------------------------------|
8484
| **Images** | HEIC, HEIF, JPG, JPEG, PNG, WebP, BMP, TIFF, GIF, ICO | JPG, PNG, WebP, BMP, TIFF, GIF, ICO |
8585
| **Documents** | DOCX, TXT, Markdown (`.md`) | PDF, TXT, HTML |
86-
| **PDF** | PDF | TXT, PDF/A-2b |
86+
| **PDF** | PDF | TXT, PDF/A-2b<sup>†</sup> |
8787
| **Spreadsheets** | XLSX, CSV, JSON | CSV, XLSX, JSON |
8888
| **Audio** | MP3, WAV, FLAC, OGG, M4A, AAC, WMA, Opus | MP3, WAV, FLAC, OGG, M4A, AAC, WMA, Opus |
8989
| **Video** | MP4, MOV, AVI, MKV, WebM, FLV, WMV | MP4, MOV, AVI, MKV, WebM, FLV, WMV |
@@ -92,6 +92,14 @@ and [`COMMERCIAL-LICENSE.md`](COMMERCIAL-LICENSE.md).
9292
Images: JPG, PNG, WebP, TIFF · Video: MP4, MOV, AVI, MKV, WebM
9393
Compress mode supports both *by quality %* and *by target size MB*.
9494

95+
<sup>†</sup> Full PDF/A-2b conformance (passes
96+
[veraPDF](https://verapdf.org/) validation) requires
97+
[Ghostscript](https://www.ghostscript.com/) on the host. The Docker
98+
image bundles it; for local-Python installs see
99+
[`docs/installation.md`](docs/installation.md). Without Ghostscript,
100+
`pdf → pdfa` falls back to a markup-only output that veraPDF will
101+
reject if the source PDF has unembedded fonts.
102+
95103
---
96104

97105
## Quickstart

0 commit comments

Comments
 (0)