collective/cdsc_tex
20
0
Fork 0
Code Activity

removed extra extraneous comments

Browse Source 
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>
This commit is contained in:
Benjamin Mako Hill
2026-08-15 10:24:15 +09:00
parent 4ae0bddb40
commit f7e16a221c
7 changed files with 54 additions and 146 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
memo_template/cdsc-memo.sty
View File

@@ -8,12 +8,8 @@
% line, sans-serif uppercase section headings, no paragraph indent,
% and a small-caps "page/total" footer.
%
% Headings come from the article class's own \@startsection hook
% rather than from titlesec. The tagging code hooks into
% \@startsection to emit the H1, H2, and H3 tags a screen reader
% navigates by; titlesec bypasses that hook, so loading it silently
% produces a PDF with no headings in the structure tree. See the
% Accessibility section of the README.
% Headings use the class's own \@startsection hook, not titlesec,
% which breaks tagging. See the Customizing section of the README.
%
% Copyright 2009-2026 Benjamin Mako Hill <mako@atdot.cc>
% Copyright 2008-2009 Kieran Healy <kjhealy@soc.duke.edu>
@@ -43,15 +39,9 @@
\pagestyle{cdsc-page-memo}
%%% Section headings: sans-serif bold uppercase, with the tight
%%% before/after spacing the original memo style used.
%%%
%%% \@startsection takes {name}{level}{indent}{beforeskip}{afterskip}
%%% {style}. The style argument is applied to the whole heading as an
%%% argument, so \MakeUppercase can be appended to it; the tagging
%%% code wraps the section number in \NoCaseChange so the number is
%%% left alone. A negative afterskip makes a heading run in to the
%%% paragraph that follows it.
%%% Section headings: sans-serif bold uppercase. \@startsection applies
%%% the style argument to the whole heading, so \MakeUppercase can be
%%% appended; the tagging code wraps the number in \NoCaseChange.
\makeatletter