PaperLab Book Typesetting Release
When to Use
USE WHEN: preparing a PaperLab book for professional review, course release, or
publisher submission. This skill checks rendered outputs, not only Markdown
source. Use after content, figure, citation, and notebook checks are mostly stable.
DO NOT USE for: scientific validation of claims. Pair with
paperlab-scientific-traceability-audit for that.
Required Render Targets
For a release candidate, render at least:
python paperflow.py book-build books/<book> --format html --skip-notebooks --no-compile
python paperflow.py book-render books/<book> --format docx
python paperflow.py book-render books/<book> --format pdf
python paperflow.py book-render books/<book> --format odf
Use --format odf, not --format odt.
HTML Checks
- No horizontal page overflow at 500 px, 768 px, 1024 px, and desktop widths.
- Sidebar behavior is usable on desktop and hidden or collapsed on small screens.
- Cover, title, figures, equations, and tables are not clipped.
- Tables scroll horizontally only inside the table area, not the full page.
- KaTeX equations render without raw LaTeX showing in normal reading mode.
- Standalone HTML has embedded images when generated with the book-root
_embed_images.py helper.
PDF Checks
- Correct page size, margins, font size, and publisher profile.
- Chapter openings start cleanly, preferably recto for two-sided books.
- Running headers are absent from title pages and sensible on body pages.
- Tables use booktabs-style rules and do not overflow the text block.
- Figures stay close to their first reference and do not split from captions.
- Equations are numbered by chapter and do not collide with text.
- No orphan headings, widowed single lines, or large blank areas caused by floats.
DOCX Checks
- Equations become native Word equations when the OMML conversion dependency is available.
- Figure captions use consistent style and numbering.
- Cross-references and citation text survive conversion.
- Tables have readable column widths and no vertical-rule clutter.
- Heading levels map correctly to Word styles and table of contents generation.
ODF Checks
- Unicode math fallback is readable.
- Tables and figures remain within page bounds.
- Styles are not flattened into uneditable direct formatting where avoidable.
Release Checklist
## Typesetting Release Review
- HTML: pass | warn | fail
- PDF: pass | warn | fail
- DOCX: pass | warn | fail
- ODF: pass | warn | fail
- Blocking issues:
- <issue>
- Non-blocking polish:
- <issue>
- Recommended renderer fix:
- <file/function or none>
Safety Rules
- Fix renderer source files, not generated files in
submission/.
- Do not hand-edit
submission/book.typ, book.html, or book.docx as a source of truth.
- When a rendered issue is caused by Markdown source, fix the chapter source and rebuild.
- Record viewport, renderer command, and output path for every reported issue.
1---2name: paperlab-book-typesetting-release-23description: |4 Final production review for PaperLab books across HTML, PDF, DOCX, and ODF.5 Use for responsive layout, page breaks, equation rendering, table overflow,6 caption style, running headers, figure placement, and release-candidate polish.7metadata:8 source: https://skillmd.com/skills/equinor/paperlab-book-typesetting-release-29---1011# PaperLab Book Typesetting Release1213## When to Use1415USE WHEN: preparing a PaperLab book for professional review, course release, or16publisher submission. This skill checks rendered outputs, not only Markdown17source. Use after content, figure, citation, and notebook checks are mostly stable.1819DO NOT USE for: scientific validation of claims. Pair with20`paperlab-scientific-traceability-audit` for that.2122## Required Render Targets2324For a release candidate, render at least:2526```powershell27python paperflow.py book-build books/<book> --format html --skip-notebooks --no-compile28python paperflow.py book-render books/<book> --format docx29python paperflow.py book-render books/<book> --format pdf30python paperflow.py book-render books/<book> --format odf31```3233Use `--format odf`, not `--format odt`.3435## HTML Checks3637- No horizontal page overflow at 500 px, 768 px, 1024 px, and desktop widths.38- Sidebar behavior is usable on desktop and hidden or collapsed on small screens.39- Cover, title, figures, equations, and tables are not clipped.40- Tables scroll horizontally only inside the table area, not the full page.41- KaTeX equations render without raw LaTeX showing in normal reading mode.42- Standalone HTML has embedded images when generated with the book-root43 `_embed_images.py` helper.4445## PDF Checks4647- Correct page size, margins, font size, and publisher profile.48- Chapter openings start cleanly, preferably recto for two-sided books.49- Running headers are absent from title pages and sensible on body pages.50- Tables use booktabs-style rules and do not overflow the text block.51- Figures stay close to their first reference and do not split from captions.52- Equations are numbered by chapter and do not collide with text.53- No orphan headings, widowed single lines, or large blank areas caused by floats.5455## DOCX Checks5657- Equations become native Word equations when the OMML conversion dependency is available.58- Figure captions use consistent style and numbering.59- Cross-references and citation text survive conversion.60- Tables have readable column widths and no vertical-rule clutter.61- Heading levels map correctly to Word styles and table of contents generation.6263## ODF Checks6465- Unicode math fallback is readable.66- Tables and figures remain within page bounds.67- Styles are not flattened into uneditable direct formatting where avoidable.6869## Release Checklist7071```markdown72## Typesetting Release Review7374- HTML: pass | warn | fail75- PDF: pass | warn | fail76- DOCX: pass | warn | fail77- ODF: pass | warn | fail78- Blocking issues:79 - <issue>80- Non-blocking polish:81 - <issue>82- Recommended renderer fix:83 - <file/function or none>84```8586## Safety Rules8788- Fix renderer source files, not generated files in `submission/`.89- Do not hand-edit `submission/book.typ`, `book.html`, or `book.docx` as a source of truth.90- When a rendered issue is caused by Markdown source, fix the chapter source and rebuild.91- Record viewport, renderer command, and output path for every reported issue.