Аудит: точная формулировка кернинга и честная — про «Word ≈13.9pt»
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m2s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m5s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 40s
Main: tests, deploy, autotests / deploy (push) Successful in 1m35s
Main: tests, deploy, autotests / autotests (push) Successful in 39s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PR checks / web (pull_request) Successful in 33s
PR checks / java (pull_request) Successful in 1m2s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m5s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 40s
Main: tests, deploy, autotests / deploy (push) Successful in 1m35s
Main: tests, deploy, autotests / autotests (push) Successful in 39s
Main: tests, deploy, autotests / rollback (push) Has been skipped
- Кернинг: DejaVu Sans/Serif имеют legacy kern-таблицу, но она ключована glyph id вне cmap (2568/2727 пар без Unicode-маппинга, A->V нет) — FOP такие пары отбрасывает; замер конвейера: A->V = A->A и у Carlito, и у DejaVu (7.524pt@11pt). Вывод «не кернит ни одно семейство» подтверждён, причина «все шрифты GPOS-only» была неточна — исправлено в AGENTS.md - «Word ≈13.9pt»: заявленное «пиксельное округление 18px@96dpi» — нерепродуцируемая реконструкция (артефактов замера нет); переформулировано в AGENTS.md, LayoutPostRenderer и WordPdfConverterTest
This commit was merged in pull request #69.
This commit is contained in:
@@ -95,7 +95,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
||||
- `PhysicalFonts` — глобальный и мутируемый → ядро не потокобезопасно; приложение сериализует конвертации одним воркером.
|
||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `w:sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитуках — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy `val`: `null|true|1|on`). На не-zip молчит — подпись проверяет вызывающий. `checkPageCount` — один стриминговый проход `ZipInputStream` без буферизации частей (хелпер `noClose` глушит `close()` сканеров): потребление O(одной части) вместо O(суммы XML-частей).
|
||||
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
||||
- Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой): `w:jc="distribute"` рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*); `w:suff="tab"` и `w:lvlJc` игнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 8, suff=nothing совпадает с docx4j — разделителя нет); абзац без `w:line` рендерится natural-высотой FOP 15.44pt@11pt, явный `lineRule="auto"` — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; первичный замер аудита «Word ≈13.9pt» — пиксельное округление 18px@96dpi, расхождения с явной строкой нет, пункт закрыт); кернинг не применяется вовсе: шрифты бандла GPOS-only, латинский путь FOP (`TextLayoutManager`→`Font.hasKerning`) читает только legacy `kern`-таблицу, свойства `kerning` в форке нет (замер: advance A→V = A→A = 6.369pt@11pt Carlito); Word кернит только при явно заданном `w:kern` в иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19; при отсутствии `w:kern` Office не кернит — MS-OI29500 §21.1.2.3.9a) — по умолчанию совпадает с нами, расходится только для документов с явно заданным `w:kern`. Починено веткой layout-class-c: левый padding ячейки (`LayoutPostRenderer`, шаг 4.25), `w:tblInd` при `w:jc`≠left (правило 7), `w:suff="space"` (правило 8).
|
||||
- Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой): `w:jc="distribute"` рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*); `w:suff="tab"` и `w:lvlJc` игнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 8, suff=nothing совпадает с docx4j — разделителя нет); абзац без `w:line` рендерится natural-высотой FOP 15.44pt@11pt, явный `lineRule="auto"` — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; «Word ≈13.9pt» из первичного аудита не воспроизводится: обе величины считаются по метрикам шрифта, артефакты исходного замера не сохранились → пункт закрыт без правок); кернинг не применяется ни для одного бандл-семейства (замер: advance A→V = A→A — Carlito 6.369pt, DejaVu Sans 7.524pt@11pt): 22 TTF — GPOS-only, а legacy `kern`-таблица DejaVu Sans/Serif ключована glyph id, не совпадающими с cmap (2568/2727 пар без Unicode-маппинга, пары A→V нет) — латинский путь FOP (`TextLayoutManager`→`Font.hasKerning`) читает только legacy `kern` и такие пары отбрасывает; свойства `kerning` в форке нет, порог `w:kern` через FO не выражается. Word кернит только при явно заданном `w:kern` в иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19; при отсутствии `w:kern` Office не кернит — MS-OI29500 §21.1.2.3.9a) — по умолчанию совпадает с нами, расходится только для документов с явно заданным `w:kern`. Починено веткой layout-class-c: левый padding ячейки (`LayoutPostRenderer`, шаг 4.25), `w:tblInd` при `w:jc`≠left (правило 7), `w:suff="space"` (правило 8).
|
||||
- Внимание: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
|
||||
|
||||
### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`)
|
||||
|
||||
@@ -33,8 +33,8 @@ import java.util.regex.Pattern;
|
||||
* которую считают и docx4j, и форк FOP, — каноническая по метрикам
|
||||
* Carlito/Calibri (hhea 1950+550, OS/2 win 1950+550, OS/2 typo 1536+512+452 —
|
||||
* все 2500/2048 em; Carlito метрически совмест с Calibri). Первичный замер
|
||||
* аудита «Word ≈13.9pt» — пиксельное округление (18px@96dpi), расхождения
|
||||
* нет. Регрессия, пинящая метрический шаг, —
|
||||
* аудита «Word ≈13.9pt» не воспроизводится (артефакты исходного замера
|
||||
* не сохранились), расхождения по метрикам нет. Регрессия, пинящая метрический шаг, —
|
||||
* WordPdfConverterTest#lineRuleAuto_wordSingleLinePitch.
|
||||
*/
|
||||
public final class LayoutPostRenderer implements FORenderer {
|
||||
|
||||
@@ -777,8 +777,8 @@ class WordPdfConverterTest {
|
||||
* w:spacing w:line="240" w:lineRule="auto" (single): шаг базовых =
|
||||
* 13.4277pt — канонический «single» по метрикам Carlito/Calibri
|
||||
* (hhea/win/typo — все 2500/2048 em @11pt; Carlito метрически совмест с
|
||||
* Calibri). Пиксельный замер аудита «Word ≈13.9pt» — округление
|
||||
* (18px@96dpi), расхождения с Word нет → rescale в LayoutPostRenderer
|
||||
* Calibri). «Word ≈13.9pt» из аудита не воспроизводится (артефакты
|
||||
* исходного замера не сохранились), расхождения по метрикам нет → rescale в LayoutPostRenderer
|
||||
* НЕ делается, тест пинит метрический шаг от регрессий. Регрессия —
|
||||
* аудит раскладки (матрица A2, пункт закрыт).
|
||||
*/
|
||||
@@ -793,7 +793,7 @@ class WordPdfConverterTest {
|
||||
+ " w:line=\"240\" w:lineRule=\"auto\"/></w:pPr>"
|
||||
+ "<w:r>" + run + "<w:t>Q</w:t></w:r></w:p>");
|
||||
Path pdf = convertPdf(docx, "t");
|
||||
// 2500/2048 em × 11pt = 13.4277 (не 13.9 — пиксельное округление)
|
||||
// 2500/2048 em × 11pt = 13.4277 (не 13.9 — тот замер не воспроизведён)
|
||||
assertEquals(13.4277, yOfMarker(pdf, 'Q') - yOfMarker(pdf, 'P'), 0.1);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user