Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CL-PDF and accessibility via screen readers #29

Open
phmarek opened this issue May 20, 2021 · 2 comments
Open

CL-PDF and accessibility via screen readers #29

phmarek opened this issue May 20, 2021 · 2 comments

Comments

@phmarek
Copy link
Contributor

phmarek commented May 20, 2021

To be readable by screen readers, PDFs need to include a few tags.

CL-PDF should support these tags; if they could be inserted automatically by a flag in WITH-DOCUMENT or so it would be great.

Thanks!

@mbattyani
Copy link
Owner

Looks like a useful one. Which tags?

@phmarek
Copy link
Contributor Author

phmarek commented May 31, 2021

The PDF Reference has "9.8 Accessibility Support", which lists

  • Specifying the natural language used for text in a PDF document [...]
  • Providing textual descriptions for images or other items [...]
  • Specifying the expansion of abbreviations or acronyms

Then there's "9.8.2 Alternate Descriptions"; here's an excerpt:

For annotation types that normally display text, that text (specified in the Contents entry of the annotation dictionary) is the natural source for vocaliza- tion purposes. For annotation types that do not display text, a Contents entry (PDF 1.4) may optionally be included to specify an alternate description.

And there's an Alt tag as well - and some more details.

Basically, I guess that the language needs to be specified (default per file, and then if different per sentence or paragraph - we might be able to use hyphenation-language for that?); and images (and QR codes and links) may need an &key (or &optional) alt argument.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants