Files
java-word-pdf/docs/agent/render-limitations.md
T
Pjandro aaad5d2bb0
PR checks / web (pull_request) Successful in 42s
PR checks / java (pull_request) Failing after 2m53s
fix: устранение расхождений кода со спецификациями и синхронизация доков
- docx-нормализаторы: tblInd без w:type = dxa (§17.4.87); явный vanish=false перекрывает стиль (§17.3.2.70);
  RubyNormalizer снимает обёртку w:ruby и удаляет rubyBaseText; DocxOnOffNormalizer не трогает w:scrollbar;
  SymbolFontNormalizer читает прямые коды w:sym
- мост .doc: borderVal 0x1B→inset; STK_CHARACTER=2 (§2.4.6.5); grpprl toggle + знаковые XAS; ChpxIndex cb=0;
  PapxIndex cpara + ключ по последнему символу; sprmCIstd reset+preserve; Sections YAS/bkc/pgnStart/gutter/nfc;
  NPE-гард Lists; BrcMayBeNil = нет границы; emission (w:id, слоты шрифтов, Kul, ISS, header-картинки);
  OfficeArt 0x46B/TIFF/DIB/второй UID + warn EMF/WMF/PICT; PrcData стоп-обработка; CfbReader бюджет +
  MUST-поля заголовка (§2.2); FibHeader csw/cslw + cbRgFcLcb; PieceTable aCP-дубли + cbMac
- мёртвый код: девять неиспользуемых STEP-констант, недостижимая ветка pgMar
- javadoc: исправлены номера секций ECMA-376/MS-DOC/MS-CFB/MS-ODRAW в нормализаторах, chart-пакете, мосту
- доки: pipeline.md, repo-map.md, doc-bridge.md, render-limitations.md, AGENTS.md синхронизированы с кодом
2026-11-16 00:43:43 +03:00

4.8 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-формулы: на хосте с fontconfig рисуются вектором jeuclid-fop (§22.1 — текст из PDF не извлекается, пинь пикселями), без fontconfig — деградация в текст m:t (правило 11; контейнерный рантайм без fontconfig), фон 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 вне контура).