Files
java-word-pdf/docs/agent/render-limitations.md
T
Pjandro f41ac54072
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m15s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m15s
Main: tests, deploy, autotests / images-web (push) Successful in 34s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m41s
Main: tests, deploy, autotests / autotests (push) Successful in 35s
Main: tests, deploy, autotests / rollback (push) Has been skipped
docs(AGENTS): сжать до роутера без дублей, счётчики — в testing.md
2026-11-08 00:57:53 +00:00

4.6 KiB
Raw Blame History

читать до попытки «починить» перечисленное ниже — это не баги, а невозможности FOP/docx4j. Авторитетно наравне с AGENTS.md.

Ограничения раскладки (FOP / docx4j)

  • Известный остаток эталона: 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; обе величины считаются по метрикам шрифта); кернинг не применяется ни для одного бандл-семейства (замер: 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).

  • Аудит .docx-путей по ECMA-376 (2026-11) — запинено синтетикой (без фикстур): сноски/концевые сноски с номерами (§17.11), внешние гиперссылки с /URI-аннотацией (§17.12.23), PAGEREF (complex и вложенный в результат TOC) и DATE подменяют кэш живым значением, titlePg → first/default колонтитуки (§17.13.1.35), vMerge restart/continue (§17.4.70), block-level w:sdt (§17.5.2), wps:txbx-текст (§17.3.3.23), OMML-формулы рисуются вектором jeuclid-fop (§22.1 — текст из PDF не извлекается, пинь пикселями), фон w:highlight/w:shd рисуется (§17.3.2.16/.29). Скрытый текст w:vanish не печатается (правило 9); текст руби-базы и w:moveFrom/w:moveTo/w:bdo/w:dir не теряется (правило 10 + AUDIT-FIX-2). Остаток (не чиним): w:framePr игнорируется — текст печатается в общем потоке, геометрия фрейма теряется (ни XSLT, ни createBlockForPPr не читают); REF/SEQ/литеральные записи TOC печатают устаревший кэш из docx (движка пересчёта нет; инстринции полей не печатаются); надстрочница руби не выводится (правило 10 печатает только базу — ruby-разметки в FOP нет); w:ptab без @w:alignment, bar, list теряются catch-all'ом; w:bdo/w:dir печатаются LTR (bidi вне контура).