Repository navigation
docs: pair pdfua with PDF/A-2b in the cURL examples - #51
Open
fstandhartinger wants to merge 1 commit into
Open
fstandhartinger wants to merge 1 commit into
fstandhartinger wants to merge 1 commit into
Conversation
The PDF/A & PDF/UA examples sent pdfa=PDF/A-1b together with pdfua=true. The warning on the LibreOffice page already says this pairing has no effect: LibreOffice writes PDF/A-1 as PDF 1.4 and only enables PDF/UA at PDF 1.7 or 2.0. Use PDF/A-2b so the examples produce what they request. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The PDF/A & PDF/UA cURL examples send
pdfa=PDF/A-1btogether withpdfua=true. The warning on the LibreOffice page already says this pairing has no effect, so anyone who copies the example gets a PDF/A-1b file with no PDF/UA. This PR switches the four examples toPDF/A-2b, which the same warning recommends. ThePDF/A-1boption stays documented as it was.Changed (4 lines, docs only):
docs/_shared/_pdfa_pdfua_pdfengines.mdx, both cURL blocks (used by the Chromium and PDF-engine pages)docs/convert-with-libreoffice/convert-to-pdf.mdx, the PDF/A & PDF/UA exampledocs/manipulate-pdfs/pdfa-pdfua.mdx, the/forms/pdfengines/convertexampleWhy it fails. LibreOffice writes PDF/A-1 as PDF 1.4 (
vcl/source/pdf/pdfwriter_impl.cxx), and since core commit f9d6125020 ("pdf: enable PDF/UA only when writing PDF version 1.7 or 2.0", LibreOffice 25.8+) it only turns PDF/UA on for PDF 1.7 or 2.0./forms/pdfengines/convertgoes through the same LibreOffice export vialibreoffice-pdfengine, so it is affected too.Measured with LibreOffice 26.8.2.2 (the 26.8 line in trixie-backports), using the filter options Gotenberg passes (
SelectPdfVersion,EmbedStandardFonts,PDFUACompliance=true,UseTaggedPDF=true), on a small HTML document:SelectPdfVersionpdfaid:partpdfuaid:part%PDF-1.4%PDF-1.7%PDF-1.7I didn't run a Gotenberg container for this. The measurement is LibreOffice itself, called with the same export options.
Checklist
PDF/A-2bis an acceptedpdfavalue)prettier --checkpasses on the changed filesnpm run buildpassesDisclosure: I build a hosted document-generation API. Nothing of it is linked or mentioned in the docs here. This PR, including the measurement above, was prepared with AI assistance (Claude Code).
🤖 Generated with Claude Code