Accessibility

[Schiano-NOAA]

Please use this discussion thread to mention needs, wants, or issues with accessibility. If any issues arise that can be actionable or are more than just an idea, they will be move to our Issues page.

[Schiano-NOAA]

To start off this discussion, I wanted to document that an older/alternative version of the add_alttext() function works by replacing \pandocbounded with \pdftooltip then adding the alt text at the end of the line through {}. However, it looks like once the .tex file is compiled, the figures are scaled incorrectly off the page.

This issue was identified by @okenk on the 2025 yellowtail assessment

[okenk]

Just to add, the function to do this is PEPtools::add_alttext()

There may be other ways to ensure figures fit on the page. Before we added alt text, we were not specifying the size of any figures, and plots that were large were automatically resized (possibly by pandocbounded). Now, all figures are inserted in their original size.

[okenk]

Update, if you add the following line to your LaTeX header it will size all figures in your document to the margin width:
\setkeys{Gin}{width=\linewidth}
As a bonus, you can also resize all figures to, for example, 80% of margin width, by using 0.8\linewidth.

This code can be added to the header by appending it to an existing .tex file that is loaded under your YAML's include-in-header or you can include something like the following in your YAML:

include-in-header:
   -'support_files/in-header.tex'
   -text: \setkeys{Gin}{width=\linewidth}