20
0
Commit Graph

11 Commits

Author SHA1 Message Date
f7e16a221c removed extra extraneous comments
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>
2026-08-15 10:24:15 +09:00
4ae0bddb40 README: point the verification section at veraPDF
The section previously led with a pikepdf one-liner and described
veraPDF as unavailable because it is not in Debian. It is available,
just not from apt, and it is the only check that actually tests the
PDF/UA-2 claim these templates make rather than merely confirming a
structure tree exists.

Verified against the templates: all four tagged builds pass ua2, and
the pre-fix builds of the paper and memo fail it. So this check would
have caught the untagged-but-declared-UA-2 state at any point; it was
simply never run.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-13 18:21:38 -07:00
b94d69f6a3 README: document what makes the tagging work, and what defeats it
Records that tagging=on is the key doing the work and pdfstandard=ua-2
only writes the claim, since setting the second without the first is
the failure this series fixes and is easy to reintroduce.

Adds the TeX Live 2025 requirement to Dependencies, including that
Debian trixie ships 2024 and that Overleaf projects choose their TeX
Live version in the settings menu and do not always default high
enough.

Adds sections on writing an accessible document (headings, alt text,
table header rows), on customizing the styles, and on verifying that a
PDF really carries structure. The customizing section names titlesec
and titling specifically: they are the obvious tools for the job the
two style files do, and they break tagging silently.

Notes that the poster is not accessible and makes no claim.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-13 18:16:01 -07:00
172cd5c4e5 templates: swap EB Garamond for Libertinus Serif
EB Garamond's bold weight ships with only 127 cmapped glyphs --- no
Latin Extended-A, no Vietnamese, no Greek, no Cyrillic, no fi/fl
ligatures --- so any bold text containing accented characters
(Polish, Czech, Vietnamese, etc., as well as bold author names in
citations) renders as tofu boxes or font-fallback substitutions.

Switch the default body font in paper_template, memo_template, and
letter_template to Libertinus Serif. It ships in texlive-fonts-extra,
has comprehensive Latin / Vietnamese / Greek / Cyrillic coverage in
every weight, and includes all the standard f-ligatures explicitly.

Each template also picks up a commented-out
\\setmainfont{Garamond Premier Pro} block plus a short note: Adobe
Garamond Premier Pro is Mako's preferred body font but is commercial
and not redistributable, so the public templates default to
Libertinus and CDSC members can swap in once they have the font
installed (e.g., in ~/.fonts/).

README updated to match.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 16:07:36 -07:00
dab1be34c5 README: reflect memo template, drop memoir incompatibility note
- Replace assignment_template references with memo_template.
- Update the type list in the new_tex_document section.
- Update the aliases section (new_tex_assignment -> new_tex_memo).
- Drop the migration entry for the assignment script.
- Rewrite the Accessibility section: now all four templates are
  PDF/UA-2 compliant (paper and memo were ported off memoir to the
  article class with custom .sty files), so the memoir-blocked
  caveat no longer applies.
- Add poster to the master-branch templates list.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-26 12:34:19 -07:00
cc993ca40d README: document lualatex requirement and accessibility status
Adds texlive-luatex to the Debian dependency list, documents the
switch to LuaLaTeX + EB Garamond/TeX Gyre Heros, and adds a new
Accessibility section describing which templates produce tagged
PDF/UA-2 output and why the memoir-based templates don't (yet).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-12 21:14:46 -07:00
3b444f70fc Consolidate document creation scripts and fix bugs
Replace the individual new_knitr_document, new_tex_assignment, and
new_tex_letter scripts with a single new_tex_document script that takes
a document type as its first argument. Fix bugs present in all scripts:
unquoted variables, TMPDIR name collision, missing existence checks, and
mktemp running unconditionally. Add cdsc_tex_aliases.sh for backwards
compatibility with old script names. Add rename_tex_to_dirname script
(moved from ~/bin). Update README and wiki page to reflect new setup.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-29 10:31:08 -07:00
1eb1a43806 updated README file 2025-11-01 12:06:30 -07:00
c5c0f59072 updated links to git repository 2018-05-06 08:25:26 -07:00
90c98aff47 added explanation for why the letters are bad 2009-12-22 22:23:29 -05:00
004862666b added installation details
created a new readme file with:
- installation details
- dependency information
- git repo details
2009-12-22 21:55:15 -05:00