Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,35 @@ follow semantic versioning; release dates are ISO 8601.

### Public API

- **A DOCX export stands a list's items where the page sets them in their exact lines, as it does a
paragraph's.** Word and LibreOffice stand an exact line's baseline four fifths of the way down it,
the page its face's ascent below the line's top, and a paragraph's line is moved there; a list
item's was not moved at all. By the export's own measure of Word's seat, 68 items of the corpus
stood low by under half a point, a median 0.22pt, and 16 high by half a point and more; measured,
they stood about where it put them: `BoxedSections`' skills, 0.18pt low by it, 0.23 to 0.28pt low
in Word and LibreOffice, `MidnightNavy`'s two-line duties, 0.9pt high by it, 0.76 to 1.06pt high.
An item is now seated as a paragraph is: a line set low rises into the gap above it as far as the
gap goes and owes as much below, which the item under it rises into in turn; under half a point, one
opening a cell takes what the gap cannot give from the cell's padding, or from the space above its
row of columns; and what is left where the whole difference is half a point or more, and a line set
that much high, is its text's position. Not raised into the gap, though still moved by its position
where it takes one: an item the layout opens a page with — the first of a list it starts on a new
page in the flow, or one it sets on a later page than the item before it — whose space above Word
drops there, nor one of a list the layout sets over two pages in a cell, where what an item owed
would be the space above the next page's first, inside the cell. An item whose marker Word draws,
a Word list's, is not moved by its position: Word sets that marker from the paragraph's mark,
which LibreOffice does not move by the mark's position — lowered a point by both, `MidnightNavy`'s
duties stood 1.15pt under their bullets there — so its line keeps what the space above does not
take of it, and `MidnightNavy`'s and `NavySidebar`'s duties stand as high as before. An item the
layout's lines are not matched to, as `SlateOrange`'s certifications in a table's composed cell, is
not seated.

`ClassicInvoice`'s notes moved up 0.24 to 0.36pt in Word and 0.3pt in LibreOffice, to within
0.05pt of the page, `BoxedSections`' and `ModernProfessional`'s skills and projects 0.12 to 0.24pt
and 0.2pt, and `Executive`'s project descriptions, items of a list Word does not number, down
0.48pt and 0.55pt, to within 0.06pt. By median, 5 documents moved nearer the page in Word, 3 in
LibreOffice on Windows and 3 in LibreOffice 24.2, none further.

- **A DOCX export stands the first line of a panel, a table's composed cell and a row's column where
the page sets it, where nothing was written above the line to raise it into.** Word and LibreOffice
stand an exact line's baseline four fifths of the way down it, and a line the page sets higher is
Expand Down
Binary file modified assets/readme/examples/word-export-companion.docx
Binary file not shown.
2 changes: 1 addition & 1 deletion docs/architecture/backend-capability-matrix.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/recipes/docx-export.md

Large diffs are not rendered by default.

768 changes: 384 additions & 384 deletions qa/src/test/resources/docx-fidelity/libreoffice-linux-lines.tsv

Large diffs are not rendered by default.

36 changes: 18 additions & 18 deletions qa/src/test/resources/docx-fidelity/libreoffice-linux.tsv
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
# libreoffice build 420(Build:2) on linux
document engine_pages editor_pages lines matched median p90 over2
cv-blue_banner 2 2 54 52 0.13 0.45 0
cv-boxed_sections 2 2 58 58 0.23 0.36 0
cv-boxed_sections 2 2 58 58 0.08 0.17 0
cv-centered_headline 2 2 58 56 0.13 0.31 0
cv-charcoal_gold 1 1 85 83 0.17 0.24 0
cv-classic_serif 2 2 57 54 0.10 0.28 0
cv-compact_mono 1 1 58 58 0.17 0.30 0
cv-classic_serif 2 2 57 54 0.07 0.15 0
cv-compact_mono 1 1 58 58 0.17 0.29 0
cv-editorial_blue 2 2 82 82 0.14 0.30 0
cv-engineering_resume 1 1 57 57 0.26 0.38 0
cv-executive 2 2 60 60 0.26 0.50 0
cv-executive 2 2 60 60 0.26 0.30 0
cv-midnight_navy 1 1 86 84 0.28 0.87 0
cv-minimal_underlined 2 2 59 59 0.33 0.62 0
cv-minimal_underlined 2 2 59 59 0.21 0.45 0
cv-mint_editorial 2 2 59 59 0.07 0.30 0
cv-modern_professional 2 2 61 59 0.06 0.24 0
cv-modern_professional 2 2 61 59 0.04 0.06 0
cv-monogram_sidebar 1 1 53 50 0.20 0.44 0
cv-navy_sidebar 1 1 71 71 0.20 0.45 0
cv-nordic_clean 1 1 63 58 0.25 0.43 0
Expand All @@ -26,26 +26,26 @@ cv-teal_pulse 1 1 57 57 0.22 0.63 0
cv-terracotta_rail 1 1 102 102 0.44 0.94 0
cv-timeline_minimal 2 2 89 87 0.45 0.49 0
cv-violet_grid 1 1 80 78 0.26 0.54 0
invoice-classic 1 1 56 56 0.05 0.22 0
invoice-classic_long 2 2 166 166 0.03 0.12 0
invoice-classic 1 1 56 56 0.05 0.12 0
invoice-classic_long 2 2 166 166 0.03 0.08 0
invoice-consulting 1 1 92 92 0.19 1.01 0
invoice-consulting_long 2 2 236 236 0.23 0.78 0
invoice-luma_studio 1 1 97 97 0.12 0.46 2
invoice-luma_studio_long 3 3 192 192 0.20 0.41 2
invoice-consulting_long 2 2 236 236 0.18 0.51 0
invoice-luma_studio 1 1 97 97 0.14 0.46 2
invoice-luma_studio_long 3 3 192 192 0.11 0.41 2
invoice-merchant 1 1 94 94 0.78 1.96 6
invoice-metered 1 1 99 99 1.01 10.38 48
invoice-modern 1 1 54 54 0.10 0.20 0
invoice-modern_long 2 2 162 162 0.10 0.15 0
invoice-modern 1 1 54 54 0.08 0.17 0
invoice-modern_long 2 2 162 162 0.07 0.10 0
invoice-obsidian 1 1 81 81 0.27 2.80 15
invoice-payments 1 1 104 104 0.32 5.23 40
invoice-platform 1 1 111 111 0.32 0.43 0
invoice-subscription 1 1 81 81 0.19 0.51 0
invoice-workspace 1 1 90 90 0.19 0.42 0
letter-blue_banner 1 1 10 10 0.21 0.46 0
letter-boxed_sections 1 1 10 10 0.11 0.23 0
letter-boxed_sections 1 1 10 10 0.09 0.13 0
letter-centered_headline 1 1 11 11 0.10 0.23 0
letter-classic_serif 1 1 10 10 0.10 0.15 0
letter-compact_mono 1 1 10 8 0.24 0.35 0
letter-compact_mono 1 1 10 8 0.13 0.35 0
letter-editorial_blue 1 1 12 12 0.07 0.16 0
letter-engineering_resume 1 1 15 15 0.19 0.41 0
letter-executive 1 1 12 12 0.18 0.30 0
Expand All @@ -58,7 +58,7 @@ letter-sidebar_portrait 1 1 12 12 0.41 0.49 0
letter-timeline_minimal 1 1 15 15 0.33 0.53 0
proposal-editorial 2 2 132 129 44.75 45.38 72
proposal-indigo 1 1 72 70 0.26 0.65 0
proposal-modern 1 1 44 44 0.10 0.20 0
proposal-modern 1 1 44 44 0.10 0.17 0
proposal-northline 2 2 132 132 0.17 0.45 0
receipt-modern 1 1 57 57 0.09 0.29 0
rota-cobalt 1 1 154 151 0.22 0.52 0
receipt-modern 1 1 57 57 0.09 0.11 0
rota-cobalt 1 1 154 151 0.25 0.52 0
Loading
Loading