Skip to content

Improve PDF accessibility with PDF/UA-2 compliance and metadata #319

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.

Sign up for GitHub

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

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
+34 −6
Draft

Improve PDF accessibility with PDF/UA-2 compliance and metadata #319

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f309b66
Initial plan
Copilot Jan 14, 2026
416fe8b
Improve PDF accessibility with enhanced metadata and standards compli…
Copilot Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion 7forecast.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -404,7 +404,7 @@

\begin{figure}[H]
\centering
\includegraphics[width=0.7\textwidth]{images/ProtectionLevel.png}
\includegraphics[alt={Graph showing ABC buffer versus relative stock size. The green line shows the ABC buffer for a target reference point of 0.4 SSB0, a limit reference point of 0.2 SSB0, and default ABC buffer of 0.85. The red line matches the green line, except there is a protection level at 0.3 SSB0.},width=0.7\textwidth]{images/ProtectionLevel.png}
\caption{ABC buffer versus relative stock size. The green line shows the ABC buffer for a target reference point of 0.4 SSB\textsubscript{0}, a limit reference point of 0.2 SSB\textsubscript{0}, and default ABC buffer of 0.85. The red line matches the green line, except there is a protection level at 0.3 SSB\textsubscript{0}.}
\label{fig:ProtectionLevel}
\end{figure}
Expand Down
38 changes: 33 additions & 5 deletions SS330_User_Manual.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,12 @@
%Options added to improve pdf accessibility:
\RequirePackage{pdfmanagement-testphase}
\PassOptionsToPackage{enable-debug}{expl3}
%\DeclareDocumentMetadata { }
\DocumentMetadata{testphase={phase-III,math}}
\ExplSyntaxOn
\pdfmanagement_add:nnn{Catalog}{Lang}{(enUS)}
\ExplSyntaxOff
\DocumentMetadata{
testphase={phase-III,math,firstaid},
pdfversion=2.0,
pdfstandard=ua-2,
lang=en-US
}
% End accessibility options
\documentclass[12pt]{article}
\usepackage{sectsty} % Allows for different fonts for header and body
Expand Down Expand Up @@ -120,6 +121,19 @@

%%The following sets up how the pdf displays links and functions in Acrobat.
\hypersetup{
pdftitle = {Stock Synthesis User Manual Version 3.30.24.1},
pdfauthor = {Richard D. Methot Jr., Chantel R. Wetzel, Ian G. Taylor, Kathryn L. Doering, Elizabeth F. Perl, and Kelli F. Johnson},
pdfsubject = {Stock assessment model documentation for Stock Synthesis},
pdfkeywords = {Stock Synthesis, SS3, fisheries, stock assessment, population dynamics, NOAA},
pdfcontactaddress = {NOAA Fisheries},
pdfcontactcity = {Seattle},
pdfcontactregion = {WA},
pdfcontactpostcode = {98112},
pdfcontactcountry = {USA},
pdfcontactemail = {nmfs.stock.synthesis@noaa.gov},
pdfcontacturl = {https://github.com/nmfs-ost/ss3-doc},
pdflang = {en-US},
pdfdisplaydoctitle = true,
bookmarks = true, % show bookmarks bar?
unicode = false, % non-Latin characters in Acrobat's bookmarks
pdftoolbar = true, % show Acrobat's toolbar?
Expand Down Expand Up @@ -191,6 +205,20 @@
% Set base font as serif
%\fontfamily{crimson}\selectfont

% ====== Accessibility Statement ===================================================
\section*{Accessibility}

This document has been prepared to be accessible to individuals with disabilities. If you encounter any accessibility issues or need assistance accessing any content in this document, please contact us:

\begin{itemize}
\item Email: \href{mailto:nmfs.stock.synthesis@noaa.gov}{nmfs.stock.synthesis@noaa.gov}
\item GitHub: \url{https://github.com/nmfs-ost/ss3-doc}
\item Website: \url{https://nmfs-ost.github.io/ss3-website/}
\end{itemize}

We are committed to making our documentation accessible and will work to address any accessibility barriers you may encounter.

\newpage

% ====== Table of Contents ===================================================
\glsaddall
Expand Down
Loading