Files
java-word-pdf/docs/agent/render-limitations.md
T
Pjandro f3ff218686
PR checks / web (pull_request) Successful in 9s
PR checks / java (pull_request) Successful in 5m26s
Main: tests, deploy, autotests / web (push) Successful in 9s
Main: tests, deploy, autotests / images-web (push) Successful in 23s
Main: tests, deploy, autotests / java (push) Successful in 1m30s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Successful in 2m13s
Main: tests, deploy, autotests / autotests (push) Successful in 17s
Main: tests, deploy, autotests / rollback (push) Has been skipped
feat(core): собственный рендер OMML→PNG и полный FOP-конфиг шрифтов
Замена JEuclid/AWT-ветки формул на детерминированный растер только
бандл-шрифтами jar (без fontconfig); FOP-конфиг дополняется всеми
бандл-начертаниями при каждом declare — иначе общая FopFactory
замораживает fopconf первого документа и теряет глифы.

MathModel/MathRenderer: OMML (§22.1) → дерево боксов → PNG 300 dpi
(только GlyphFont/fontbox, без java.awt.Font); метрики боксов равны
габариту paint (пределы nary/sPre не обрезаются канвой). Unsupported
конструкция или переполнение бюджета — текстовая деградация (m:t).
Inline-картинка опускается раном w:rPr/w:position на базовую линию
строки (FOP ставит инлайн-графику нижним краем на базу; AUDIT-FIX
baseline-shift). Байтовое правило 6 MathFallbackNormalizer (перед
GlyphCoverage) срезает unsupported-формулы до загрузки docx4j; формула
в wps:txbx уходит в docx4j-фолбэк mathText.

JEuclid исключён из pom (de.rototor jeuclid-core/jeuclid-fop); порядок
zip-правил сдвинут (MathFallback → 6). Порядок сканов шрифтов закрыт
гейтом FontsBundledOnlyInvariantTest + BundledFontAliases (единый
алиас-реестр вместо рефлексивных мутаций реестра).

Счётчики: 63 класса / 1004 теста (core 57/956, app 6/48); JaCoCo
BRANCH core 0.8518. Доки: pipeline/render-limitations/repo-map/
testing/doc-bridge/MEM_USAGE_UPGRADE синхронизированы.
2026-11-20 23:51:40 +03:00

5.7 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 чинит правило 9, 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 не кернит; MS-OI29500 §2.1.83 уточняет лишь диапазон w:val) — по умолчанию совпадает с нами, расходится только для документов с явно заданным w:kern. Починено веткой layout-class-c: левый padding ячейки (LayoutPostRenderer, шаг 4.25), w:tblInd при w:jc≠left (правило 8), w:suff="space" (правило 9).

  • Аудит .docx-путей по ECMA-376 (2026-11) — запинено синтетикой (без фикстур): сноски/концевые сноски с номерами (§17.11), внешние гиперссылки с /URI-аннотацией (§17.12.23), PAGEREF (complex и вложенный в результат TOC) и DATE подменяют кэш живым значением, titlePg → first/default колонтитуки (§17.10.6), vMerge restart/continue (§17.4.70), block-level w:sdt (§17.5.2), wps:txbx-текст (§17.3.3.23; формула внутри текстового бокса до растера не доходит — обход drawing-нагрузку не спускается и уходит в docx4j-фолбэк mathText, конкатенация m:t; регрессия — WordPdfConverterTest#drawingTextBoxMath_convertsViaDocx4jTextFallback), OMML-формулы (§22.1) рисует собственный растер MathModel/MathRenderer — PNG 300 dpi, только бандл-шрифты jar, без AWT/JEuclid (текст из PDF не извлекается, пинь пикселями); неподдерживаемая конструкция или превышение бюджета — текстовая деградация (конкатенация m:t, MathFallbackNormalizer, правило 6) + warn, inline-формула выравнивается по базовой линии текста (мат-ось Word — принятая деградация), m:oMathPara — отдельный центрированный абзац (left/right по m:jc, indentLeft→left); фон w:highlight/w:shd рисуется (§17.3.2.16/.29). Скрытый текст w:vanish не печатается (правило 10); текст руби-базы и w:moveFrom/w:moveTo/w:bdo/w:dir не теряется (правило 11 + AUDIT-FIX-2). Остаток (не чиним): w:framePr игнорируется — текст печатается в общем потоке, геометрия фрейма теряется (ни XSLT, ни createBlockForPPr не читают); REF/SEQ/литеральные записи TOC печатают устаревший кэш из docx (движка пересчёта нет; инстринции полей не печатаются); надстрочница руби не выводится (правило 11 печатает только базу — ruby-разметки в FOP нет); w:ptab без @w:alignment, bar, list теряются catch-all'ом; w:bdo/w:dir печатаются LTR (bidi вне контура).