Skip to content

draft: pdf accessibility blog post#1898

Closed
gordonwoodhull wants to merge 8 commits intoprereleasefrom
pdf-a11y-blog-post
Closed

draft: pdf accessibility blog post#1898
gordonwoodhull wants to merge 8 commits intoprereleasefrom
pdf-a11y-blog-post

Conversation

@gordonwoodhull
Copy link
Collaborator

@gordonwoodhull gordonwoodhull commented Feb 23, 2026 •
edited
Loading

@cwickham

This turns out to be slightly longer than I thought, but still manageable. I think I'm getting the right balance, but if anything is too technical we can take it out.

I need to dig a little deeper but at first glance I would summarize as Typst will solve almost everything except for needing alt text/caption and title, but in LaTeX you need to be more careful.

  • I think the blog post should also paraphrase the section called Accessibility Requirements here:

https://prerelease.quarto.org/docs/output-formats/typst.html#accessibility-requirements

which is a list of ways that quarto and markdown automatically fill in a lot of what you need for accessibility.

@gordonwoodhull gordonwoodhull changed the title pdf accessibility blog post draft: pdf accessibility blog post Feb 23, 2026
@gordonwoodhull gordonwoodhull changed the base branch from main to prerelease February 23, 2026 19:33
@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Feb 23, 2026

/deploy-preview

@github-actions
Copy link
Contributor

github-actions bot commented Feb 23, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@gordonwoodhull gordonwoodhull marked this pull request as ready for review February 24, 2026 18:11
@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Feb 24, 2026 •
edited
Loading

Now contains results of testing, and what to expect. I think it's ready for review.

Note: this is based against prerelease and links to prerelease documentation; if this goes out after release we should update it.

@github-actions github-actions bot temporarily deployed to pull request February 24, 2026 18:18 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Feb 24, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@github-actions github-actions bot temporarily deployed to pull request February 24, 2026 18:31 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Feb 24, 2026

📝 Preview Deployment

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

🔄 Modified Documents

cwickham
cwickham requested changes Feb 24, 2026
View reviewed changes
Copy link
Collaborator

@cwickham cwickham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good, Gordon. This is mostly structural and organizational feedback. I'm more than happy to do a finer grain wording review on the next pass.

@github-actions github-actions bot temporarily deployed to pull request February 24, 2026 20:15 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Feb 24, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@github-actions github-actions bot temporarily deployed to pull request February 24, 2026 21:20 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Feb 24, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Feb 24, 2026 •
edited
Loading

I think I've addressed the first pass.

Glad to revise further; please give it another read.

cwickham
cwickham reviewed Feb 27, 2026
View reviewed changes
Copy link
Collaborator

@cwickham cwickham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had a few more comments to address before we publish (whenever that may be). But, this is looking really good.

@gordonwoodhull
address second round of review feedback
52e8cb4 
- 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"
@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Mar 3, 2026

I think I've addressed everything.

I'm ready to publish this (again, after release since this links into docs)... as long as we we are okay with saying that our book template is a WIP.

@github-actions github-actions bot temporarily deployed to pull request March 3, 2026 17:23 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Mar 3, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Mar 3, 2026 •
edited
Loading

Hmm, the post is not showing in preview.

The image for the listing might be kind of obnoxious - I just used the veraPDF logo, because how else do you visualize accessibility.

Any suggestions?

@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Mar 3, 2026

/deploy-preview

@github-actions
Copy link
Contributor

github-actions bot commented Mar 3, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@github-actions github-actions bot temporarily deployed to pull request March 4, 2026 15:46 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@gordonwoodhull gordonwoodhull mentioned this pull request Mar 4, 2026
Merged
@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Mar 4, 2026

Closing in favor of #1934

@github-actions github-actions bot temporarily deployed to pull request March 4, 2026 17:14 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Mar 4, 2026

📝 Preview Deployment

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

🔄 Modified Documents

@gordonwoodhull gordonwoodhull deleted the pdf-a11y-blog-post branch March 4, 2026 19:50
@github-actions github-actions bot mentioned this pull request Mar 5, 2026
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@cwickham cwickham cwickham requested changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@gordonwoodhull @cwickham