Skip to content

Improve accessibility #4

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

Merged
rowanc1 merged 3 commits into from
Mar 10, 2026
Merged

Improve accessibility #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
31f94d4
Enable PDF accessibility tagging (PDF/UA-2).
ryanlovett Mar 6, 2026
2979673
Add latex lifted from @rhstanton to improve color.
ryanlovett Mar 7, 2026
0b231a3
Fix table placement with tagging=on.
ryanlovett Mar 9, 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
4 changes: 2 additions & 2 deletions lapreprint.cls
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@
\setlength{\parindent}{0pt}\raggedright
\textcolor{MediumGrey}{\rule{\textwidth}{2pt}}
\vskip16pt
\textcolor{lightColour}{\large\bfseries\abstractname\space}
\textcolor{darkColour}{\large\bfseries\abstractname\space}

% Here we squeeze in the margin metadata
\marginpar{\raggedright\footnotesize\themetadata\par}
Expand Down Expand Up @@ -539,7 +539,7 @@
allcolors=black,
citecolor=MediumGrey,
linkcolor=MediumGrey,
urlcolor=lightColour,
urlcolor=darkColour,
hypertexnames=false}
\urlstyle{sf}

Expand Down
45 changes: 45 additions & 0 deletions template.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,26 @@
%%% PREAMBLE
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% Enable PDF accessibility tagging (PDF/UA-2) via the LaTeX Tagging Project.
% Requires LuaLaTeX and TeX Live 2025+.
% See
% https://latex3.github.io/tagging-project/documentation/usage-instructions
% https://github.com/rhstanton/accessible_LaTeX/blob/main/accessible_article.tex
\DocumentMetadata{
lang=en,
pdfstandard=a-2u, % PDF/A-2u format (archival standard with Unicode support)
pdfstandard=ua-1, % Add PDF/UA-1 accessibility conformance target
pdfstandard=ua-2,
pdfversion=1.7, % Explicit PDF version used for compatibility with conformance tooling

@cycomachead cycomachead May 12, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I'm late to this, but I think we should probably start targeting pdf 2.0 standard documents. 2.0 is required for MathML and UA-2 is designed to work with 2.0. (Older readers can still open 2.0 documents, and even though they score less on checkers, I think that will be an anti-pattern soon enough.)

tagging=on,
tagging-setup={
math/alt/use, % Keep math accessibility enabled (screen readers get tagged math)
math/mathml/AF=false, % Do not embed MathML as PDF Associated Files (helps some strict conformance checkers)
math/tex/AF=false, % Do not embed TeX source as Associated Files
math/mathml/sources= % Clear MathML source attachment list (avoid extra embedded helper files)
}
}

% Declare document class
\documentclass[9pt
[#- if options.venue_footer == "biorxiv" #],biorxiv[# endif -#]
Expand Down Expand Up @@ -49,6 +69,31 @@
\usepackage{multirow}
\usepackage{snotez} % For sidenote environments. enotez for endnotes
\usepackage{csquotes} % For language-based quote rules (helps BiBLaTeX)
\usepackage{unicode-math} % Unicode math fonts (provides \setmathfont + automatic MathML)
\usepackage{xcolor} % Color support (needed for accessibility-friendly colors)
\usepackage{float} % Provides \floatplacement
\floatplacement{table}{htbp} % Restore here-preferring placement; tagging=on changes the default

% ======================================================================
% HYPERLINK CONFIGURATION
% ======================================================================
% Links should be both colored AND underlined for accessibility
% Color alone is not sufficient (fails WCAG guidelines)

\usepackage{url,hyperref}
\urlstyle{same} % URLs use the same font as surrounding text

% Custom commands for underlined hyperlinks
\newcommand{\hrefu}[2]{\href{#1}{\uline{#2}}} % Hyperlink with underline
\newcommand{\urlu}[1]{\uline{\url{#1}}} % URL with underline

% Set link colors (blue for consistency with heading color in slides)
\hypersetup{
colorlinks=true,
linkcolor=blue, % Internal links (TOC, references)
urlcolor=blue, % External URLs
citecolor=blue % Citations
}

[-IMPORTS-]

Expand Down
3 changes: 3 additions & 0 deletions template.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,3 +125,6 @@ packages:
- unicode-math
- wrapfig
- xcolor

build:
engine: -lualatex
Loading