The template declared pdfstandard=ua-2 and loaded tagpdf with
\tagpdfsetup{activate-all}, which sets /Marked true and writes the
conformance claim but does not turn on the kernel code that tags
document structure. The result passed veraPDF's ua2 profile while its
structure tree held nothing but /Document: every paragraph of the
letter was marked as an artifact, so the checker had no untagged real
content to complain about, and both alt= descriptions were dropped on
the floor.
That is a worse failure than an outright invalid file. A letter that
announces itself as accessible and contains nothing readable is the
one a person relying on a screen reader will trust.
Adding tagging=on fixes it: the built letter now carries twenty tagged
paragraphs and a Figure element holding the signature's alt text, and
still passes ua2. The manual tagpdf lines are dropped since the kernel
loads it.
This requires TeX Live 2025 or later; on TeX Live 2024 the key is
unknown and the build stops. The README gains that requirement, an
Accessibility section, and a warning that a veraPDF pass is necessary
but not sufficient.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Replace Mako's real phone number, email, and website with placeholder
values to match the rest of the fake "John Hancock" example content.
This commit is for the public master branch only and should not be
merged into branches customized with real contact details.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add \DocumentMetadata for PDF 2.0 / PDF/UA-2, load tagpdf with
activate-all, extend hypersetup with pdftitle/pdfauthor/pdflang/
pdfdisplaydoctitle, and add alt text to the letterhead and signature
images. Drop xetex-only xltxtra and switch the Makefile from xelatex
to lualatex. Verified compliant with verapdf's PDF/UA-2 profile.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- fully incorporated back sayamindu's stuff for dealing with encrypted
signatures files (not a bad idea!)
- removed an old uw-header file from a previous version
