Files
java-word-pdf/docs/agent/render-limitations.md
T
Pjandro 838ec29a69
PR checks / web (pull_request) Successful in 51s
PR checks / java (pull_request) Failing after 1m3s
feat(core): правило 9 DistributeStampNormalizer - w:jc=distribute растягивает все строки (Part 1 17.18.44)
docx4j для DISTRIBUTE не эмитит в FO ничего - абзац печатался по левому краю.
Нормализатор ставит в distribute-абзацы закладку-якорь pj-distribute-<часть>-<n>
(после Hidden, content-части, идемпотентно), LayoutPostRenderer по якорю дописывает
блоку пару text-align/text-align-last=justify - межсловный разнос всех строк,
включая последнюю (пин форка DistributeLineTestCase). Паттерн якоря принимает и
префиксную, и безпрефиксную сериализацию fo:inline (DOM-поддерево toNode).
Фикстура distribute.docx (хвост трёхсловный - одно слово растягивать нечем),
регрессии distribute_allLinesReachRightMargin + юниты нормализатора и фильтра.

Доки: правила 1-9 (Ole - правило 10), шаг 4.25, FOP-оверлей в инвариантах и
новая секция AGENTS; render-limitations - distribute перенесён в починенное.
Дополнительно в AGENTS: заметки про гейт готовности podman-контейнеров.
2026-11-08 23:18:56 +00:00

5.4 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, реаудит на docx4j 17.3.6 + форке FOP 2.12 — 2026-11) — известные нечинимые ограничения FOP/docx4j (Java-слой): w:lvlJc игнорируется (numbering-лейбл всегда у number position: lvlJc="right"/"center" рендерятся идентично left — лейблы по общему левому краю; suff=space чинит правило 6, suff=nothing совпадает с docx4j — разделителя нет); абзац без w:line рендерится natural-высотой FOP 15.44pt@11pt, явный lineRule="auto" — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; обе величины считаются по метрикам шрифта); кернинг не применяется ни для одного бандл-семейства (замер на 17.3.6/форке 2.12: dx пары = сумма advance без поправки — Carlito «Wa»/«AV», DejaVu Sans «Ta»; GPOS-only у 22 TTF, а legacy kern-таблица DejaVu Sans/Serif ключована glyph id, не совпадающими с cmap (2568/2727 пар без Unicode-маппинга, пары A→V нет) — латинский путь FOP (TextLayoutManager→Font.hasKerning) читает только legacy kern и такие пары отбрасывает; GPOS-путь в форке тоже не применяется); свойства 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 (правило 5), w:suff="space" (правило 6). Починено на 17.3.6+форке: w:jc="distribute" (правило 9 DistributeStampNormalizer ставит закладку-якорь, LayoutPostRenderer дописывает блоку пару text-align/text-align-last="justify" — межсловный разнос всех строк, включая последнюю; пин в форке DistributeLineTestCase, в конвертере distribute_allLinesReachRightMargin; межсимвольный kashida-разнос §17.18.44 не реализован — для латиницы Word разносит межсловные пробелы, однословная строка не растягивается, потому что растягивать нечем). Починено апстримом 17.3.6: w:framePr (фрейм позиционируется — замер: FRAME на x=252pt = левое поле 72pt + w:x=180pt; до апгрейда текст шёл в общем потоке), symbol-шрифты и complex-поля PAGE/NUMPAGES (экспорт сам маппит PUA-маркеры и пересчитывает page-поля).

  • Аудит .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 не печатается (правило 7); текст руби-базы и w:moveFrom/w:moveTo/w:bdo/w:dir не теряется (правило 8 + AUDIT-FIX-2). Остаток (не чиним): REF/SEQ/литеральные записи TOC печатают устаревший кэш из docx (движка пересчёта нет; инстринции полей не печатаются); надстрочница руби не выводится (правило 8 печатает только базу — ruby-разметки в FOP нет); w:ptab без @w:alignment, bar, list теряются catch-all'ом; w:bdo/w:dir печатаются LTR (bidi вне контура).