pdf accessibility blog post by gordonwoodhull · Pull Request #1934 · quarto-dev/quarto-web

gordonwoodhull · 2026-03-04T17:10:54Z

This replaces #1898

Blog post now destined for main, using meta shortcode to point to prerelease docs for now.

cc @cwickham

github-actions · 2026-03-04T17:19:04Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

github-actions · 2026-03-04T17:33:26Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

cderv · 2026-03-04T17:36:38Z

I think I can tweak current improvement of #1932 I am doing to handle this use case.

We currently have {{< meta prerelease-subdomain >}} to be able to have link in doc inside prerelease branch to have links using prerelease.quarto.org while they will have quarto.org only when prerelease will be merged in main, without us doing anything in each file.

So I think we can come up with something similar here to have

doc in main being able to point to prerelease.quarto.org when for example rc profile is on
and then point to quarto.org when rc switch back to second profile.

I believe that would work if we want to avoid modifying the blog post YAML when making the merge of prerelease into main. And avoid forgetting to do it.

What do think @cwickham ?

cwickham · 2026-03-04T17:45:52Z

@cderv Yes, that sounds like a great idea. I like tying it to rc, that seems like the period we are likely to make these "coming soon" blog posts.

github-actions · 2026-03-04T19:00:26Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

github-actions · 2026-03-04T19:24:41Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

cderv · 2026-03-04T20:02:11Z

@gordonwoodhull I added a meta to help in #1932

[PDF Accessibility](https://{{< meta prerelease-link-subdomain >}}quarto.org/docs/output-formats/pdf-accessibility.html)

I'll merge before this PR.

Also your last commit 5afe467 (this PR) makes me realize that we could also find a way to use some prerelease-aware meta to conditionnaly include the prerelease feature include file. Currently, it exists on prerelease but is empty on main.

quarto-web/docs/prerelease/1.9/_pre-release-feature.qmd

Lines 1 to 5 in c15681d

    
           ::: {.callout-note} 
        
           ## Pre-release Feature 
        
           This feature is new in the upcoming Quarto 1.9 release. To use the feature now, you'll need to [download](/docs/download/prerelease.qmd) and install the Quarto pre-release. 
        
           :::

https://github.com/quarto-dev/quarto-web/blob/41e5f27285e54d01be787416992d90ab1c34eac8/docs/prerelease/1.9/_pre-release-feature.qmd

I think we could avoid that - again to minimize what needs to be modified when docs is out.

cderv · 2026-03-04T20:06:12Z

I merged it so you should be able to try it if you rebase on main

github-actions · 2026-03-04T20:27:35Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

github-actions · 2026-03-04T20:46:23Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

github-actions · 2026-03-04T20:57:57Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

docs/blog/posts/_quarto-1.9-feature.qmd

Co-authored-by: Charlotte Wickham <charlotte.wickham@posit.co>

github-actions · 2026-03-04T21:20:53Z

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1934.quarto.org

🔄 Modified Documents

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

The `prerelease-link-subdomain` variable is phase-aware but not version-aware — on the next RC cycle, old blog posts would incorrectly point to prerelease.quarto.org even though those docs already moved to quarto.org. Add a `prerelease-docs-url` shortcode extension that compares a version argument against the `version` key in `_quarto.yml` to decide whether docs live on quarto.org or prerelease.quarto.org. On the prerelease site (prerelease-docs profile), it always returns "prerelease." regardless of version. Follow-up to quarto-dev#1932, relates to quarto-dev#1934.

github-actions · 2026-03-05T14:30:38Z

Successfully created backport PR for prerelease:

[Sync to prerelease] pdf accessibility blog post #1941

The `prerelease-link-subdomain` variable is phase-aware but not version-aware — on the next RC cycle, old blog posts would incorrectly point to prerelease.quarto.org even though those docs already moved to quarto.org. Add a `prerelease-docs-url` shortcode extension that compares a version argument against the `version` key in `_quarto.yml` to decide whether docs live on quarto.org or prerelease.quarto.org. On the prerelease site (prerelease-docs profile), it always returns "prerelease." regardless of version. Follow-up to #1932, relates to #1934.

* Replace prerelease-link-subdomain with version-aware shortcode The `prerelease-link-subdomain` variable is phase-aware but not version-aware — on the next RC cycle, old blog posts would incorrectly point to prerelease.quarto.org even though those docs already moved to quarto.org. Add a `prerelease-docs-url` shortcode extension that compares a version argument against the `version` key in `_quarto.yml` to decide whether docs live on quarto.org or prerelease.quarto.org. On the prerelease site (prerelease-docs profile), it always returns "prerelease." regardless of version. Follow-up to #1932, relates to #1934. * Update PDF accessibility blog post to use prerelease-docs-url shortcode

* Replace prerelease-link-subdomain with version-aware shortcode The `prerelease-link-subdomain` variable is phase-aware but not version-aware — on the next RC cycle, old blog posts would incorrectly point to prerelease.quarto.org even though those docs already moved to quarto.org. Add a `prerelease-docs-url` shortcode extension that compares a version argument against the `version` key in `_quarto.yml` to decide whether docs live on quarto.org or prerelease.quarto.org. On the prerelease site (prerelease-docs profile), it always returns "prerelease." regardless of version. Follow-up to #1932, relates to #1934. * Update PDF accessibility blog post to use prerelease-docs-url shortcode (cherry picked from commit 63a21f0)

gordonwoodhull mentioned this pull request Mar 4, 2026

draft: pdf accessibility blog post #1898

Closed

2 tasks

github-actions bot temporarily deployed to pull request March 4, 2026 17:18 Inactive

github-actions bot temporarily deployed to pull request March 4, 2026 17:33 Inactive

cderv mentioned this pull request Mar 4, 2026

Fix profile configuration for prerelease website #1932

Merged

github-actions bot temporarily deployed to pull request March 4, 2026 19:00 Inactive

gordonwoodhull force-pushed the blog/pdf-a11y branch from ad1be58 to 5afe467 Compare March 4, 2026 19:16

github-actions bot temporarily deployed to pull request March 4, 2026 19:24 Inactive

gordonwoodhull added 6 commits March 4, 2026 15:13

pdf accessibility blog post

66f7b3c

not draft

b5a3114

update date

f021f98

date: tomorrow

85541ac

add pre-release feature callout

bf6b1b3

use prerelease-link-subdomain instead of quarto-root metadata

2c33209

gordonwoodhull force-pushed the blog/pdf-a11y branch from 5afe467 to 2c33209 Compare March 4, 2026 20:19

github-actions bot temporarily deployed to pull request March 4, 2026 20:27 Inactive

lowercase "Typst books"

9ee3573

github-actions bot temporarily deployed to pull request March 4, 2026 20:46 Inactive

Update thumbnail

3670c8a

github-actions bot temporarily deployed to pull request March 4, 2026 20:57 Inactive

cwickham reviewed Mar 4, 2026

View reviewed changes

docs/blog/posts/_quarto-1.9-feature.qmd Outdated Show resolved Hide resolved

Update docs/blog/posts/_quarto-1.9-feature.qmd

bf86ac4

Co-authored-by: Charlotte Wickham <charlotte.wickham@posit.co>

github-actions bot temporarily deployed to pull request March 4, 2026 21:20 Inactive

cderv mentioned this pull request Mar 5, 2026

Replace prerelease-link-subdomain with version-aware shortcode #1939

Merged

gordonwoodhull merged commit 3bc2286 into main Mar 5, 2026
4 checks passed

gordonwoodhull deleted the blog/pdf-a11y branch March 5, 2026 14:30

github-actions bot mentioned this pull request Mar 5, 2026

[Sync to prerelease] pdf accessibility blog post #1941

Merged

github-actions bot mentioned this pull request Mar 6, 2026

[Sync to prerelease] Replace prerelease-link-subdomain with version-aware shortcode #1943

Merged

Conversation

gordonwoodhull commented Mar 4, 2026

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

cderv commented Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cwickham commented Mar 4, 2026

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

cderv commented Mar 4, 2026

Uh oh!

cderv commented Mar 4, 2026

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

Uh oh!

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

🔄 Modified Documents

Uh oh!

Uh oh!

github-actions bot commented Mar 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

cderv commented Mar 4, 2026 •

edited

Loading