Skip to content

Commit 942d301

Browse files
address second round of review feedback
- Add front matter: author, description, image, image-alt, draft - Use layout-ncol=2 instead of panel-tabset for YAML examples - Clarify veraPDF behavior when not installed - Reword Java install requirement - Fix wording: "due to missing titles or missing alt text"
1 parent 36e8781 commit 942d301

2 files changed

Lines changed: 18 additions & 9 deletions

File tree

docs/blog/posts/2026-02-xx-pdf-accessibility-and-standards/index.qmd

Lines changed: 18 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
---
22
title: PDF Accessibility and Standards
3+
description: |
4+
Quarto 1.9 brings PDF accessibility and standards support, building on new tagging features in LaTeX and Typst.
5+
author: Gordon Woodhull
6+
date: "2026-02-xx"
7+
image: verapdf.jpg
8+
image-alt: "veraPDF logo"
9+
draft: true
310
---
411

512
2025 was a big year for PDF accessibility. LaTeX and Typst both released support for PDF tagging and accessibility standards, just in time for new regulations in the [EU](https://en.wikipedia.org/wiki/European_Accessibility_Act) (June 2025) and [US](https://accessible.org/ada-title-ii-web-accessibility/) (April 2026).
@@ -21,39 +28,41 @@ Both standards instruct the PDF renderer to provide screen readers:
2128

2229
In Quarto 1.9, specify a PDF standard for your document or project with `pdf-standard`
2330

24-
::: panel-tabset
25-
## PDF (LaTeX)
31+
::::: {layout-ncol=2}
32+
:::: {}
33+
**PDF (LaTeX)**
2634

2735
```yaml
2836
format:
2937
pdf:
3038
pdf-standard: ua-2
3139
```
40+
::::
3241
33-
## Typst
42+
:::: {}
43+
**Typst**
3444
3545
```yaml
3646
format:
3747
typst:
3848
pdf-standard: ua-1
3949
```
40-
:::
50+
::::
51+
:::::
4152
4253
`pdf-standard` takes a single standard name or list of standard names. PDF version is used if provided in the list, but otherwise inferred from the standard.
4354

44-
If you specify a PDF standard, Quarto first instructs LaTeX or Typst to use the standard when producing the PDF, and then validates the output PDF against the standard using veraPDF, an open-source PDF validation tool.
55+
If you specify a PDF standard, Quarto first instructs LaTeX or Typst to use the standard when producing the PDF, and then validates the output PDF against the standard using veraPDF, an open-source PDF validation tool. If veraPDF is not installed, you'll get a warning but still receive a PDF -- it just won't be validated.
4556

4657
::: {.callout-note}
4758
## Installing veraPDF
4859

49-
veraPDF requires a separate install:
60+
To install veraPDF, you'll first need Java, then run:
5061

5162
```{.bash filename="Terminal"}
5263
quarto install verapdf
5364
```
5465

55-
veraPDF requires Java.
56-
5766
:::
5867

5968
When a document passes validation, you'll see output like:
@@ -93,7 +102,7 @@ There are smaller upstream issues in Pandoc, LaTeX, and LaTeX packages, [documen
93102

94103
In our tests, Typst catches every UA-1 violation, and fails to generate the PDF. veraPDF did not detect any violation that Typst did not.
95104

96-
Typst also seems to do a very good job of generating UA-1 compliant output by default -- almost all errors were titles and alt text.
105+
Typst also seems to do a very good job of generating UA-1 compliant output by default -- almost all errors were due to missing titles or missing alt text.
97106

98107
However, we did discover that [Typst Books](/docs/books/book-output.qmd#typst-output) are not yet compliant. There is a [structural problem with the Typst orange-book package](https://github.com/flavio20002/typst-orange-template/issues/38) and we'll work with the maintainers to correct it.
99108

10.2 KB
Loading

0 commit comments

Comments
 (0)