Skip to content

docs(readme): note Ghostscript dependency for full PDF/A-2b conformance#29

Merged
MrChengLen merged 1 commit into
mainfrom
pr-audit-readme-pdfa-note
May 11, 2026
Merged

docs(readme): note Ghostscript dependency for full PDF/A-2b conformance#29
MrChengLen merged 1 commit into
mainfrom
pr-audit-readme-pdfa-note

Conversation

@MrChengLen
Copy link
Copy Markdown
Owner

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.

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.
@MrChengLen MrChengLen merged commit 8b7e6d1 into main May 11, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant