Skip to content

Commit 56edc93

Browse files
use prerelease-link-subdomain instead of quarto-root metadata
1 parent 3ae0563 commit 56edc93

2 files changed

Lines changed: 5 additions & 6 deletions

File tree

docs/blog/posts/2026-03-05-pdf-accessibility-and-standards/index.qmd

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ author: Gordon Woodhull
66
date: "2026-03-05"
77
image: verapdf.jpg
88
image-alt: "veraPDF logo"
9-
quarto-root: https://prerelease.quarto.org
109
---
1110

1211
{{< include ../_quarto-1.9-feature.qmd >}}
@@ -84,9 +83,9 @@ Quarto's Markdown-based workflow handles many accessibility requirements automat
8483
But you do need to make sure your document has:
8584

8685
* A **title** in the YAML front matter.
87-
* **Alt text for every image**, specified with `fig-alt`. See [Figures]({{< meta quarto-root >}}/docs/authoring/figures.html#alt-text) for details.
86+
* **Alt text for every image**, specified with `fig-alt`. See [Figures](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/authoring/figures.html#alt-text) for details.
8887

89-
See the [LaTeX]({{< meta quarto-root >}}/docs/output-formats/pdf-basics.html#accessibility-requirements) and [Typst]({{< meta quarto-root >}}/docs/output-formats/typst.html#accessibility-requirements) documentation for more details.
88+
See the [LaTeX](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/output-formats/pdf-basics.html#accessibility-requirements) and [Typst](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/output-formats/typst.html#accessibility-requirements) documentation for more details.
9089

9190
## If your document fails validation
9291

@@ -102,7 +101,7 @@ We ran our test suite -- 188 LaTeX examples and 317 Typst examples -- to find wh
102101

103102
Margin content is the biggest structural blocker. If you use `.column-margin` divs, `cap-location: margin`, `reference-location: margin`, or `citation-location: margin`, the resulting PDF will not pass UA-2. The underlying `sidenotes` and `marginnote` LaTeX packages [do not cooperate with PDF tagging](https://github.com/quarto-dev/quarto-cli/issues/14103).
104103

105-
(Margin content does work with Typst and passes UA-1 -- see [Typst Article Layout]({{< meta quarto-root >}}/docs/output-formats/typst.html#article-layout).)
104+
(Margin content does work with Typst and passes UA-1 -- see [Typst Article Layout](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/output-formats/typst.html#article-layout).)
106105

107106
There are smaller upstream issues in Pandoc, LaTeX, and LaTeX packages, [documented here](https://github.com/quarto-dev/quarto-cli/pull/14097#issuecomment-3947653207).
108107

@@ -112,7 +111,7 @@ In our tests, Typst catches every UA-1 violation, and fails to generate the PDF.
112111

113112
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.
114113

115-
However, we did discover that [Typst Books]({{< meta quarto-root >}}/docs/books/book-output.html#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.
114+
However, we did discover that [Typst Books](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/books/book-output.html#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.
116115

117116
## Conclusion
118117

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
::: callout-note
22
## Pre-release Feature
33

4-
This feature is new in the upcoming Quarto 1.9 release. To use the feature now, you'll need to [download and install]({{< meta quarto-root >}}/docs/download/prerelease.html) the Quarto pre-release.
4+
This feature is new in the upcoming Quarto 1.9 release. To use the feature now, you'll need to [download and install](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/download/prerelease.html) the Quarto pre-release.
55
:::

0 commit comments

Comments
 (0)