% Tagged PDF (PDF/UA-2) accessibility setup. The article class works
% with the LaTeX tagging project, so we use the full \DocumentMetadata
% path here.
%
% tagging=on is what actually builds the structure tree: it loads the
% kernel code that tags paragraphs, headings, lists, tables, and
% floats. Declaring pdfstandard=ua-2 on its own only writes the claim
% into the metadata; without tagging=on the PDF is marked as UA-2 but
% carries no structure for a screen reader to read. This needs TeX
% Live 2025 or later --- on Overleaf, set it in Menu > Settings >
% TeX Live version.
\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.

% ACCESSIBILITY: every figure needs an alt= description, which is what
% a screen reader announces in place of the image. Describe what the
% reader is meant to take from the figure rather than naming it: "Edit
% counts rising sharply after 2005" tells them something, "Figure 1"
% does not. The caption is read separately, so alt text that repeats
% the caption is wasted. For a purely decorative image, use
% \includegraphics[artifact]{...} instead, which keeps it out of the
% reading order entirely.
%
% \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}

% ACCESSIBILITY: header-rows tells the tagging code which rows are
% headers, so their cells become TH rather than TD and a screen reader
% can announce the column a value belongs to. Without it, a data table
% reads as an undifferentiated grid of numbers. Set it for each table
% that has headers; use {1,2} if two rows are headers.
\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 table used only to position things on the page, rather than to
% present data, should be marked so assistive software skips its
% structure:  \tagpdfsetup{table/tagging=presentation}

% bibliography here
\setcounter{biburlnumpenalty}{9001}
\printbibliography[title = {References}, heading=secbib]


\end{document}

%  LocalWords:  
