From 40d58463c7342a92134219dc4c7ef7c9b7ffe8e3 Mon Sep 17 00:00:00 2001 From: Steffen Becker Date: Tue, 11 Aug 2026 19:52:39 +0000 Subject: [PATCH] docs: per-section margins ship, and what the corpus reports Also records the harness change that made the longest fixture measurable at all. --- CHANGELOG.md | 3 ++- tests/render-parity/README.md | 17 +++++++++++++---- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d90b814..9d896bb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -72,6 +72,7 @@ - Page margins (cm) and page orientation (portrait / landscape) - Page format picker (Layout panel): 15 Word/LibreOffice sizes — A3–A6, ISO B4–B6, JIS B4/B5, Letter, Legal, Tabloid, Executive, Folio, Statement — each showing its cm dimensions; drives the on-screen page, pagination, and ODT/DOCX/PDF export, and is detected & adopted on import - Multi-column (newspaper) layout: 1–3 columns with adjustable gap, applied to the whole document (no selection) or to selected paragraphs, Word-style — text fills column 1 to the page bottom, then column 2, and flows across pages with mid-paragraph line breaks; a section followed by other content balances its columns. Round-trips to ODF `text:section`/`style:columns` and DOCX continuous sections with `w:cols` +- Page margins per section: a section's own `w:pgMar` / ODF page layout is read, rendered and written back, and an ODF page style that hands over to another (`style:next-style-name`, the title-page idiom) gives its layout to the section's first page and the successor's to the rest. The ruler and the header/footer layer still show the document's own pair - Headers & footers: page-number / page-count fields, configurable edge distances, and variants — different first page and different odd & even pages (edit a page's zone directly; blank first/even zones supported). Press Enter to add blank lines that grow a zone into the page while body text reflows so the page break sits above the footer / below the header, never overlapping. Inline images/logos can be inserted in a zone. Round-trips to ODF (`style:header-first`/`-left`, `draw:frame`) and DOCX (`w:titlePg`/`w:evenAndOddHeaders`, `ImageRun`) - Zoom (20–300 %) - Horizontal ruler above the page: click to place a tab stop of the selected type, drag to move it, drag it off to remove it; three markers set the paragraph's first-line, left and right indent. Toggle in the extended toolbar @@ -124,7 +125,7 @@ The gap against Word/LibreOffice, most valuable first. Reviewed 2026-08-08. - Heading level H6 (clamped to H5; Word and LibreOffice go to 10) - Alphabetical index and bibliography - Line numbering (LibreOffice Tools ▸ Line numbering / Word Layout ▸ Line numbers) -- Section-level page setup: a section with its own page size, orientation or margins. Page geometry is one document-wide setting, so a file whose sections disagree keeps the last one's (per-section headers/footers already work) +- Section-level page **size and orientation**: only the margins are per section. A file whose sections disagree on the page size keeps the last one's - Table extras: repeat the header row on every page, keep a row from splitting across pages, sort, sum/formula in a cell, number recognition - A list level's own hanging indent: the marker sits at the 0.635 cm both exports write (`LIST_HANGING_CM`), so a wider *left*-set marker overflows where Word moves the text to the next list tab (a **right**-set one — `w:lvlJc`, which is what the built-in Roman numberings use — grows into the margin and is fine). Reading the value back naively also moves the markers of our own ODT exports — LibreOffice draws its own flat hanging at exactly the value odf-kit writes for level 2; see `tests/render-parity/README.md` before building on it - Images live as data-URIs in the autosaved JSON, so an image-heavy document can exceed the ~5 MB localStorage quota; `storage/autosave.ts` warns once and a reload restores the last version that still fit. IndexedDB (as `embeddedFontStore.ts` already uses) would lift the ceiling diff --git a/tests/render-parity/README.md b/tests/render-parity/README.md index 23d248e..284c08a 100644 --- a/tests/render-parity/README.md +++ b/tests/render-parity/README.md @@ -87,14 +87,23 @@ editor (`global.css`), so give LibreOffice the same answer: What the real-world fixtures — the contract (an IHK contract form), the summary (a student summary: bullets, wrapped pictures, one table), the thesis (a 48-page thesis with charts, metafile figures and -a German TOC) and the Math Guide (LibreOffice's own 63-page Math Guide: a title page, -a three-page index, per-section masters, ~35 figure frames and 400 formulas) — still -report. Both run one page off LibreOffice (thesis 48 against 49, Math Guide 64 against 63), -in each case downstream of a line the rules below cost or gained: +a German TOC) the Math Guide (LibreOffice's own 63-page Math Guide: a title page, +a three-page index, per-section masters, ~35 figure frames and 400 formulas) and +the Writer Guide (its 458-page Writer Guide) — still report. The two guides and +the thesis run off LibreOffice on page count (thesis 48 against 49, Math Guide 64 against +63, Writer Guide 477 against 458), in each case downstream of a line the rules below cost +or gained: - **A page-anchored frame's coordinates are its page's, but a frame in a *header* keeps the ones its zone gives it.** Both are drawn out of flow; the body one (`anchorPage`, `image.ts`) sits behind the text at `--page-cycle` × (page − 1) + its `svg:y`. +- **An index entry keeps its heading's hard break.** A book's chapter heading is its + number and its title on two lines, and both producers copy that break into the entry — + the Writer Guide's contents is 18 rows shorter without it. The leader and the page + number ride the entry's last line (`align-items: last baseline`). +- **The 458-page Writer Guide is a frontier of its own**: 19 pages over LibreOffice, with + the drift accumulating (its index is one page short at "Autoformatting", two long by + "Index"). Nothing in it has been diagnosed past the contents. - **The index is its own pagination.** A generated TOC is a block atom, so pagination has no inner position to put a spacer at; the node view breaks it between entries itself (`tableOfContents.ts`) and asks for one recompute when that changes its height.