b3511f8b74
- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
3.2 KiB
3.2 KiB
Ограничения рендера
Конвертер не является pixel-perfect рендером Word: часть расхождений — неустранимые невозможности связки docx4j + Apache FOP, а не упущения проекта.
Что конвертируется приближённо
- Раскладка, поля и некоторые эффекты могут отличаться от Word (ограничения FOP/docx4j по построению).
- Символы U+2000–U+2EFF (тире, кавычки): из шрифта рана, если в нём есть глиф, иначе — из fallback-семейства DejaVu.
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
остаётся
.notdef(пустой бокс). В эталонном наборе таких два: U+2188 (ↈ) и U+218A (↊) — глифы есть только в GNU FreeSerif под GPL, а бандл держится целиком на SIL OFL. - Поддержка таблиц/изображений — базовая (уровень docx4j/FOP).
- На
.docerror-флаги диаграмм/SmartArt/OLE не срабатывают: BLIP-плейсхолдеры бинарного формата — уже растры (вставляются картинками), EMF/WMF/PICT пропускаются с warn — Мост .doc.
Стоп-лист «не чинить»
До любой попытки «починить» расхождение с Word — сверьтесь со списком: это невозможности движка, попытка фикса хуже самого расхождения.
| Конструкция | Что происходит | Почему не чинится |
|---|---|---|
w:jc="distribute" |
рендерится как left | межсимвольного распределения в FOP нет; text-align-last в форке отсутствует |
w:suff="tab" |
игнорируется (label через hanging-tab) | нужна per-item ширина; совпадает с поведением docx4j |
w:lvlJc |
игнорируется | — |
| кернинг | не применяется | — |
framePr (обтекание) |
не поддерживается | — |
кэш полей REF/SEQ/TOC |
печатается кэш из docx | живой пересчёт вне контура (PAGE/NUMPAGES/PAGEREF/DATE — пересчитываются) |
| руби (надстрочница) | надстрочная часть вырезается, база печатается | ruby-разметки в FOP нет; потеря текста хуже потери аннотации |
ptab |
не поддерживается | — |
| U+2188/U+218A | .notdef |
GPL-шрифты не добавляем намеренно |
lineRule="auto" |
— | не «чинить»: метрический шаг пинен тестом |
Полный перечень с доказательствами по ECMA-376 — render-limitations.md (репозиторий).