from __future__ import annotations import csv import hashlib import json from pathlib import Path from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile, ZipInfo ROOT = Path(__file__).parent OUTPUT = ROOT / "field-notes-with-print-pages.epub" FIXED_TIME = (2026, 9, 20, 0, 0, 0) PAGES = [ ("i", "frontmatter.xhtml", "page-i", "Title page", "Front matter", False), ("ii", "frontmatter.xhtml", "page-ii", "Copyright and edition note", "Front matter", False), ("1", "chapter.xhtml", "page-1", "Chapter opening", "Body matter", False), ("2", "chapter.xhtml", "page-2", "Boundary inside a paragraph", "Body matter", False), ("3", "chapter.xhtml", "page-3", "Blank print page", "Body matter", True), ("4", "chapter.xhtml", "page-4", "Text resumes after the blank page", "Body matter", False), ] MIMETYPE = "application/epub+zip" CONTAINER = """ """ def write_entry(book: ZipFile, name: str, data: str, compression: int) -> None: info = ZipInfo(name, FIXED_TIME) info.compress_type = compression info.external_attr = 0o644 << 16 book.writestr(info, data.encode("utf-8")) def build_epub() -> None: frontmatter = """ Front matter

Field Notes

A controlled pagination fixture.

Edition note

Pagination follows the fixture's print source.

""" chapter = """ Chapter One

Chapter One

The first note begins at the edge of the garden and follows the path toward the glasshouse.

A printed sentence begins on the previous source page. The next sentence begins on print page 2, so the marker remains inside this paragraph without forcing a screen break.

The source page numbered 3 was intentionally blank, so the next text starts on print page 4.

""" nav_items = "".join( f'
  • {label}
    • ' for label, file_name, marker, _, _, _ in PAGES ) nav = f""" Navigation """ package = """ urn:uuid:cc016641-150d-5cff-b841-881738723c06 Field Notes with Print Pages BookTranslator Test Fixture en CC0 1.0 Universal urn:uuid:5b247d07-a036-590d-af5b-252c5cb4b980 pageBreakMarkers pageNavigation 2026-09-20T00:00:00Z """ style = "body { font-family: serif; line-height: 1.55; margin: 5%; } [role='doc-pagebreak'] { display: inline; }" with ZipFile(OUTPUT, "w") as book: write_entry(book, "mimetype", MIMETYPE, ZIP_STORED) write_entry(book, "META-INF/container.xml", CONTAINER, ZIP_DEFLATED) write_entry(book, "EPUB/package.opf", package, ZIP_DEFLATED) write_entry(book, "EPUB/nav.xhtml", nav, ZIP_DEFLATED) write_entry(book, "EPUB/frontmatter.xhtml", frontmatter, ZIP_DEFLATED) write_entry(book, "EPUB/chapter.xhtml", chapter, ZIP_DEFLATED) write_entry(book, "EPUB/style.css", style, ZIP_DEFLATED) def write_inventory() -> None: with (ROOT / "page-inventory.csv").open("w", newline="", encoding="utf-8") as handle: writer = csv.writer(handle, lineterminator="\n") writer.writerow(["print_label", "content_file", "marker_id", "source_content", "section", "blank_page"]) writer.writerows(PAGES) def main() -> None: write_inventory() build_epub() digest = hashlib.sha256(OUTPUT.read_bytes()).hexdigest() manifest = { "title": "Field Notes with Print Pages", "license": "CC0-1.0", "generated": "2026-09-20", "pages": len(PAGES), "epub_sha256": digest, "notes": "Synthetic publishing fixture; not a BookTranslator product output or reader benchmark.", } (ROOT / "fixture-manifest.json").write_text(json.dumps(manifest, indent=2) + "\n", encoding="utf-8") print(json.dumps(manifest, indent=2)) if __name__ == "__main__": main()