Motivation
The research paper is maintained in docs/paper/reductions.typ, and the documentation workflow already compiles it to book/reductions.pdf. The public website currently links directly to that PDF, so readers leave the site navigation and get a browser-dependent raw PDF view.
The paper should be readable from a first-party website page without introducing a second manually maintained document. The Typst source must remain the canonical source, and readers must retain a direct PDF download.
Typst native HTML export is not a suitable production dependency yet. Typst 0.15 marks HTML export as under active development and incomplete, while the deployment workflow currently pins Typst 0.14. The stable implementation should therefore reuse the PDF that the project already builds.
Objective
Add a website paper reader that is generated and published automatically from the existing Typst build:
docs/paper/reductions.typ
-> typst compile
book/reductions.pdf
-> embedded by
book/paper.html
docs/paper/reductions.typ remains in the repository and remains the only paper source. No generated paper copy is maintained by hand.
Recommended implementation
Use the existing mdBook pipeline instead of adding a new frontend or document converter:
- Add a
docs/src/paper.md page and include it in docs/src/SUMMARY.md.
- Embed
reductions.pdf with a native <object type="application/pdf"> or equivalent accessible browser element.
- Put a normal
Download PDF link outside the embed and repeat it as the fallback content inside the embed.
- Give the embedded document an accessible title and make the reader fill the available viewport without causing horizontal page overflow.
- Change website links whose intent is reading the paper to open
paper.html; keep explicit download links pointed directly at reductions.pdf.
- Continue compiling the PDF from
docs/paper/reductions.typ in the documentation workflow. A Typst compilation failure must fail the deployment.
This requires no PDF viewer dependency. If native embedding proves insufficient on supported browsers, evaluate a self-hosted PDF.js viewer separately rather than loading a third-party hosted viewer.
Acceptance criteria
Out of scope
- Deleting or converting away from the Typst source.
- Maintaining a second hand-written paper in Markdown or HTML.
- Depending on experimental Typst HTML output for production deployment.
- Adding a custom PDF rendering frontend before native embedding is shown to be insufficient.
Motivation
The research paper is maintained in
docs/paper/reductions.typ, and the documentation workflow already compiles it tobook/reductions.pdf. The public website currently links directly to that PDF, so readers leave the site navigation and get a browser-dependent raw PDF view.The paper should be readable from a first-party website page without introducing a second manually maintained document. The Typst source must remain the canonical source, and readers must retain a direct PDF download.
Typst native HTML export is not a suitable production dependency yet. Typst 0.15 marks HTML export as under active development and incomplete, while the deployment workflow currently pins Typst 0.14. The stable implementation should therefore reuse the PDF that the project already builds.
Objective
Add a website paper reader that is generated and published automatically from the existing Typst build:
docs/paper/reductions.typremains in the repository and remains the only paper source. No generated paper copy is maintained by hand.Recommended implementation
Use the existing mdBook pipeline instead of adding a new frontend or document converter:
docs/src/paper.mdpage and include it indocs/src/SUMMARY.md.reductions.pdfwith a native<object type="application/pdf">or equivalent accessible browser element.Download PDFlink outside the embed and repeat it as the fallback content inside the embed.paper.html; keep explicit download links pointed directly atreductions.pdf.docs/paper/reductions.typin the documentation workflow. A Typst compilation failure must fail the deployment.This requires no PDF viewer dependency. If native embedding proves insufficient on supported browsers, evaluate a self-hosted PDF.js viewer separately rather than loading a third-party hosted viewer.
Acceptance criteria
docs/paper/reductions.typand its Typst build remain intact and are not replaced by generated HTML or Markdown./paper.htmlreader page./reductions.pdfon browsers with native PDF embedding.Download PDFlink points directly to/reductions.pdf.paper.htmlandreductions.pdffrom the same revision.Out of scope