Skip to content

paper: HTML only #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lex00 merged 1 commit into from
Sep 13, 2026
Merged

paper: HTML only #154

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions justfile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,9 @@ smoke-published:
smoke claim="":
bash scripts/smoke.sh {{claim}}

# The paper's assembled draft (paper/draft.md) rendered for readers: HTML
# always, PDF when a LaTeX engine is installed (`brew install tectonic`).
# The paper's draft (paper/draft.md) rendered to HTML at paper/build/draft.html.
# No PDF: a binary in the repository would need LFS, and HTML is enough to read.
paper:
mkdir -p paper/build
pandoc paper/draft.md --standalone --toc --number-sections=false --resource-path=paper -o paper/build/draft.html
@command -v tectonic >/dev/null 2>&1 && pandoc paper/draft.md --pdf-engine=tectonic --resource-path=paper -V geometry:margin=1in -o paper/build/draft.pdf && echo "paper/build/draft.pdf" || echo "no tectonic: HTML only at paper/build/draft.html"
@echo paper/build/draft.html
2 changes: 1 addition & 1 deletion paper/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Each draft feeds one section of the paper.

## The assembled draft

`draft.md` is the sections below assembled into one document for readers, with the repository references removed and the numbers refreshed to the artifacts appendix B names. `just paper` renders it to HTML, and to PDF when tectonic is installed. It is cut to about the venue's length; the final fit to the 2027 call's limits is the remaining pass.
`draft.md` is the sections below assembled into one document for readers, with the repository references removed and the numbers refreshed to the artifacts appendix B names. `just paper` renders it to HTML under `paper/build/`, which is not committed; there is no PDF target, since a binary in the repository would need LFS. It is cut to about the venue's length; the final fit to the 2027 call's limits is the remaining pass.

## Still to write

Expand Down