burn: Add book compilation pipeline (closes #18) #20

Open
Timmy wants to merge 1 commits from burn/20260410-2137-book-compilation-pipeline into main
Owner

Closes #18

Changes

Adds a complete build system for compiling The Testament into distributable formats.

Files Added

  • build/build.py — Compilation script: combines chapters, generates PDF and EPUB
  • build/metadata.yaml — Pandoc metadata (title, author, formatting, LaTeX headers)
  • build/frontmatter.md — Title page, dedication, epigraph, chapter guide table
  • build/backmatter.md — Acknowledgments, sovereignty note, about the author
  • build/output/the-testament.epub — Pre-built EPUB with all 10 chapters (36 KB)
  • Makefilemake all/pdf/epub/md/clean targets
  • .gitignore — Build intermediate files

Features

  • Combines all 10 chapters into a single manuscript with proper part dividers
  • Generates print-ready PDF via pandoc + xelatex (6x9 book format)
  • Generates EPUB for e-readers with table of contents
  • Proper front matter: title page, dedication, "The Story So Far" progress note, chapter guide table
  • Proper back matter: acknowledgments, sovereignty note, author bio
  • Zero external Python dependencies (stdlib only, pandoc as system tool)

Usage

python3 build/build.py          # All formats
python3 build/build.py --pdf    # PDF only (requires xelatex)
python3 build/build.py --epub   # EPUB only
python3 build/build.py --md     # Combined markdown only
make all                         # Via Makefile

Verified

  • Combined markdown: 48,989 chars, 10 chapters ✓
  • EPUB: 36 KB, built successfully ✓
  • PDF: requires xelatex (not available in sandbox, but pandoc command is correct)
Closes #18 ## Changes Adds a complete build system for compiling The Testament into distributable formats. ### Files Added - `build/build.py` — Compilation script: combines chapters, generates PDF and EPUB - `build/metadata.yaml` — Pandoc metadata (title, author, formatting, LaTeX headers) - `build/frontmatter.md` — Title page, dedication, epigraph, chapter guide table - `build/backmatter.md` — Acknowledgments, sovereignty note, about the author - `build/output/the-testament.epub` — Pre-built EPUB with all 10 chapters (36 KB) - `Makefile` — `make all/pdf/epub/md/clean` targets - `.gitignore` — Build intermediate files ### Features - Combines all 10 chapters into a single manuscript with proper part dividers - Generates print-ready PDF via pandoc + xelatex (6x9 book format) - Generates EPUB for e-readers with table of contents - Proper front matter: title page, dedication, "The Story So Far" progress note, chapter guide table - Proper back matter: acknowledgments, sovereignty note, author bio - Zero external Python dependencies (stdlib only, pandoc as system tool) ### Usage ```bash python3 build/build.py # All formats python3 build/build.py --pdf # PDF only (requires xelatex) python3 build/build.py --epub # EPUB only python3 build/build.py --md # Combined markdown only make all # Via Makefile ``` ### Verified - Combined markdown: 48,989 chars, 10 chapters ✓ - EPUB: 36 KB, built successfully ✓ - PDF: requires xelatex (not available in sandbox, but pandoc command is correct)
Timmy added 1 commit 2026-04-10 01:41:57 +00:00
Build system for compiling The Testament chapters into distributable formats.

Files added:
- build/build.py — Compilation script (markdown combine, PDF, EPUB)
- build/metadata.yaml — Pandoc metadata (title, author, formatting)
- build/frontmatter.md — Title page, dedication, chapter guide
- build/backmatter.md — Acknowledgments, sovereignty note, about author
- build/output/the-testament.epub — Pre-built EPUB (10 chapters)
- Makefile — `make all`, `make pdf`, `make epub`, `make md`
- .gitignore — Build artifacts

Features:
- Combines 10 chapters into single manuscript
- Generates print-ready PDF (requires xelatex)
- Generates EPUB for e-readers
- Part dividers and chapter guide table
- Proper front/back matter
- Zero external dependencies (uses stdlib + pandoc)

Usage:
  python3 build/build.py          # All formats
  python3 build/build.py --pdf    # PDF only
  python3 build/build.py --epub   # EPUB only
  python3 build/build.py --md     # Combined markdown only
Rockachopa reviewed 2026-04-10 03:41:40 +00:00
Rockachopa left a comment
Owner

Auto-approved: clean diff, no conflicts, mergeable.

Auto-approved: clean diff, no conflicts, mergeable.
Rockachopa scheduled this pull request to auto merge when all checks succeed 2026-04-10 03:41:41 +00:00
Member

The book compilation pipeline is a significant addition. It ensures that the project's output is accessible in multiple formats, supporting the goal of durability. Recommend adding a step to verify the integrity of the generated PDF and EPUB files.

The book compilation pipeline is a significant addition. It ensures that the project's output is accessible in multiple formats, supporting the goal of durability. Recommend adding a step to verify the integrity of the generated PDF and EPUB files.
Member

The book compilation pipeline is a significant addition. It ensures that the project's output is accessible in multiple formats, supporting the goal of durability. Recommend adding a step to verify the integrity of the generated PDF and EPUB files.

The book compilation pipeline is a significant addition. It ensures that the project's output is accessible in multiple formats, supporting the goal of durability. Recommend adding a step to verify the integrity of the generated PDF and EPUB files.
Author
Owner

Merge conflicts with main. Needs conflict resolution before merge.

Merge conflicts with main. Needs conflict resolution before merge.
Author
Owner

⚠️ Blocked: Merge conflict. This PR has conflicts with the base branch that need to be resolved before merging.

⚠️ **Blocked: Merge conflict.** This PR has conflicts with the base branch that need to be resolved before merging.
This pull request has changes conflicting with the target branch.
  • .gitignore
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin burn/20260410-2137-book-compilation-pipeline:burn/20260410-2137-book-compilation-pipeline
git checkout burn/20260410-2137-book-compilation-pipeline
Sign in to join this conversation.
No Reviewers
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/the-testament#20