Benjamin Mako Hill
f7e16a221c
Cuts the multi-line rationale blocks down to what a reader of the file needs. The reasoning behind the tagging setup belongs in the commit messages that introduced it, not repeated above every \DocumentMetadata block. Also trims the README: drops the consequence clause explaining what happens when the standard is declared without the tagging, drops the quoted TeX Live 2024 error message, and notes that sid has a new enough TeX Live for anyone not on Overleaf. Adds the caveat that a veraPDF PASS is necessary but not sufficient, since a document whose body text is all artifact passes too. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
244 lines
9.9 KiB
TeX
244 lines
9.9 KiB
TeX
% Tagged PDF (PDF/UA-2) accessibility setup.
|
|
\DocumentMetadata{
|
|
tagging=on,
|
|
pdfversion=2.0,
|
|
pdfstandard=ua-2,
|
|
lang=en-US,
|
|
}
|
|
|
|
\documentclass[12pt]{article}
|
|
|
|
\usepackage{cdsc-paper}
|
|
|
|
\usepackage{fontspec}
|
|
% fontspec disables the classic TeX input ligatures by default
|
|
% (-- => en-dash, --- => em-dash, `` and '' => curly quotes), so
|
|
% re-enable them globally for every font loaded below.
|
|
\defaultfontfeatures{Ligatures=TeX}
|
|
\setmainfont{Libertinus Serif}
|
|
% Mako prefers Adobe Garamond Premier Pro
|
|
% (https://fonts.adobe.com/fonts/garamond-premier-pro). It is a
|
|
% commercial font and is not redistributable, so the templates default
|
|
% to the free Libertinus Serif above. If you have the font installed
|
|
% (e.g., dropped into ~/.fonts/), comment the line above and uncomment
|
|
% the next one. CDSC members can contact Mako (mako@atdot.cc) for the
|
|
% font files.
|
|
% \setmainfont{Garamond Premier Pro}
|
|
\setsansfont{TeX Gyre Heros}
|
|
\usepackage{wrapfig}
|
|
|
|
\usepackage[letterpaper,left=1.65in,right=1.65in,top=1.3in,bottom=1.2in]{geometry}
|
|
|
|
% packages i use in essentially every document
|
|
\usepackage{graphicx}
|
|
\usepackage{enumerate}
|
|
|
|
% packages i use in many documents but leave off by default
|
|
% \usepackage{amsmath, amsthm, amssymb}
|
|
% \usepackage{dcolumn}
|
|
% \usepackage{endfloat}
|
|
|
|
% import and customize urls
|
|
\usepackage[dvipsnames]{xcolor}
|
|
\usepackage[breaklinks]{hyperref}
|
|
|
|
% pdftitle/pdfauthor populate PDF and XMP metadata; keep these in sync
|
|
% with \title{} and \author{} below. UA-2 requires dc:title in XMP.
|
|
\hypersetup{colorlinks=true, linkcolor=Black, citecolor=Black, filecolor=Blue,
|
|
urlcolor=Blue, unicode=true,
|
|
pdftitle={Title},
|
|
pdfauthor={Your Name},
|
|
pdflang={en-US},
|
|
pdfdisplaydoctitle=true}
|
|
|
|
% list of footnote symbols for \thanks{}
|
|
\makeatletter
|
|
\renewcommand*{\@fnsymbol}[1]{\ensuremath{\ifcase#1\or *\or \dagger\or \ddagger\or
|
|
\mathsection\or \mathparagraph\or \|\or **\or \dagger\dagger
|
|
\or \ddagger\ddagger \else\@ctrerr\fi}}
|
|
\makeatother
|
|
\newcommand*\samethanks[1][\value{footnote}]{\footnotemark[#1]}
|
|
|
|
% add bibliographic stuff
|
|
\usepackage[american]{babel}
|
|
\usepackage{csquotes}
|
|
\usepackage[natbib=true, style=apa, backend=biber]{biblatex}
|
|
\addbibresource{refs.bib}
|
|
\DeclareLanguageMapping{american}{american-apa}
|
|
|
|
\defbibheading{secbib}[\bibname]{%
|
|
\section*{#1}%
|
|
\markboth{#1}{#1}%
|
|
\baselineskip 14.2pt}
|
|
|
|
\def\citepos#1{\citeauthor{#1}'s (\citeyear{#1})}
|
|
\def\citespos#1{\citeauthor{#1}' (\citeyear{#1})}
|
|
|
|
% LATEX NOTE: these lines will import vc stuff after running `make vc` which
|
|
% will add version control information to the bottom of each page. This can be
|
|
% useful for keeping track of which version of a document somebody has:
|
|
% \input{vc}
|
|
% \pagestyle{cdsc-page-git}
|
|
|
|
% LATEX NOTE: this alternative line will just input a timestamp at the
|
|
% build process, useful for Overleaf
|
|
% \pagestyle{cdsc-page-overleaf}
|
|
|
|
\begin{document}
|
|
|
|
\setlength{\parskip}{4.5pt}
|
|
% LATEX NOTE: Ideal linespacing is usually said to be between 120-140% the
|
|
% typeface size. So, for 12pt (default in this document, we're looking for
|
|
% somewhere between a 14.4-17.4pt \baselineskip. Single; 1.5 lines; and Double
|
|
% in MSWord are equivalent to ~117%, 175%, and 233%.
|
|
|
|
\baselineskip 16pt
|
|
|
|
\title{Title}
|
|
\author{Your Name\\
|
|
\href{mailto:youremail@uw.edu}{youremail@uw.edu}}
|
|
\date{}
|
|
|
|
\published{\textsc{\textcolor{BrickRed}{This document is an
|
|
unpublished draft.\\ Please do not distribute or cite without
|
|
permission.}}}
|
|
|
|
\maketitle
|
|
|
|
\begin{abstract}
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog.
|
|
\end{abstract}
|
|
|
|
\section{Section}
|
|
|
|
% LATEX NOTE: This alphabet below is here so we can measure the line-length of
|
|
% different layouts. Typesetters suggest that an average line-length of
|
|
% between 45-90 characters and a rule of thumb for typesetting is that you
|
|
% should be able to fit between 2-3 alphabets on one line. Generally speaking,
|
|
% the shorter the line length, the better -- and the smaller the linespacing
|
|
% can become. The following line is 3 alphabets (73 characters).
|
|
|
|
abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
The quick brown fox jumps over the lazy dog. The quick brown fox jumps
|
|
over the lazy dog. The quick brown fox jumps over the lazy dog. The
|
|
quick brown fox jumps over the lazy dog. The quick brown fox jumps over
|
|
the lazy dog. The quick brown fox jumps over the lazy dog. The quick
|
|
brown fox jumps over the lazy dog. The quick brown fox jumps over the
|
|
lazy dog. The quick brown fox jumps over the lazy dog. The quick brown
|
|
fox jumps over the lazy dog \citep{989866}.
|
|
|
|
\section{Accessible Figures and Tables}
|
|
|
|
Table~\ref{tab:example} shows a data table whose header row is tagged,
|
|
and the commented-out block below it shows a figure carrying alt text.
|
|
Both are here as worked examples; delete them along with this section
|
|
when you start writing.
|
|
|
|
% alt= is what a screen reader announces in place of the image. Say what
|
|
% the reader should take from it, not what it is called. A decorative
|
|
% image takes [artifact] instead, keeping it out of the reading order.
|
|
%
|
|
% \begin{figure}
|
|
% \centering
|
|
% \includegraphics[width=0.6\linewidth,
|
|
% alt={Edit counts by year, rising sharply after 2005}]{figure.pdf}
|
|
% \caption{A caption, which is read separately from the alt text.}
|
|
% \label{fig:example}
|
|
% \end{figure}
|
|
|
|
% header-rows makes the first row TH rather than TD. Use {1,2} for two.
|
|
\tagpdfsetup{table/header-rows={1}}
|
|
\begin{table}
|
|
\centering
|
|
\begin{tabular}{lr}
|
|
Item & Quantity \\ \hline
|
|
Widgets & 42 \\
|
|
Gadgets & 13
|
|
\end{tabular}
|
|
\caption{A data table whose first row is tagged as headers.}
|
|
\label{tab:example}
|
|
\end{table}
|
|
|
|
% A layout table, used to position rather than present, takes
|
|
% \tagpdfsetup{table/tagging=presentation}
|
|
|
|
% bibliography here
|
|
\setcounter{biburlnumpenalty}{9001}
|
|
\printbibliography[title = {References}, heading=secbib]
|
|
|
|
|
|
\end{document}
|
|
|
|
% LocalWords:
|