DM-55518: Add technote_typst project template#348
Open
timj wants to merge 5 commits into
Open
Conversation
A proof-of-concept template for Typst technotes that follows the Markdown technote workflow: metadata and authors live in technote.toml (managed by documenteer technote add-author/sync-authors), the rubin-technote Typst template from lsst-texmf is vendored as a package by the Makefile, and the shared Rubin bibliographies are downloaded by a sync-bibs target. make pdf compiles the document with Typst and CI uploads the PDF as an artifact until a shared publication workflow exists. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
timj
commented
Jul 18, 2026
| ] | ||
| subprocess.run( | ||
| [ | ||
| "lander", |
Member
Author
There was a problem hiding this comment.
Ideally we should fix lander to understand index.typ as well as documenteer.toml and the latex authors.yaml.
The rubin-technote template emits its front matter as a labeled metadata element, so the landing-page upload now extracts the title and abstract from the compiled document with typst query instead of baking the scaffold-time title into the workflow. Author, title, and abstract changes are all picked up automatically on the next push, with queried content flattened to the plain text lander expects. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Only the technote date_created timestamps changed; every other example file round-tripped identically, confirming the committed examples match their skeletons. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
make pdf now derives the abbreviated commit hash and dirty state from git, exactly as the LaTeX technote Makefile does, and passes it to the compile as --input source-version=..., where the template renders it in the front matter after the change record. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
make pdf now compiles with --pdf-standard a-2a,ua-1, producing archival PDF/A-2a output with PDF/UA-1 tagging where missing alt text is a compilation failure; the PDF_STANDARD variable must be explicitly emptied to opt out. CI additionally audits the built PDF's conformance with veraPDF for both flavours, covering the machine-checkable requirements. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A proof-of-concept template for Typst technotes that follows the Markdown technote workflow: metadata and authors live in technote.toml (managed by documenteer technote add-author/sync-authors), the rubin-technote Typst template from lsst-texmf is vendored as a package by the Makefile, and the shared Rubin bibliographies are downloaded by a sync-bibs target. make pdf compiles the document with Typst and CI uploads the PDF as an artifact until a shared publication workflow exists.
Requires lsst/lsst-texmf#2070