- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
4.2 KiB
Диаграммы, SmartArt, формулы
XSLT-экспорт docx4j диаграммы не умеет, поэтому DrawingPreRenderer (шаг 3.5
конвейера) до генерации XSL-FO заменяет c:chart / dgm:relIds / m:oMath
на PNG-картинки (pic:pic). Рендер — собственный Java2D-движок (internal/chart,
21 класс), без Word/LibreOffice/JEuclid; текст рисуется глифами fontbox (GlyphFont),
поэтому fontconfig серверу не нужен.
Диаграммы
- Выход: PNG 300 dpi (
ChartRenderer.DPI = 300), размеры изwp:extent(EMU→pt). - Поддерживаемые типы (
ChartSpec.Type):PIE,PIE3D,DOUGHNUT,BAR,BAR_HORIZONTAL,LINE,AREA,SURFACE3D,AREA3D,BAR3D,LINE3D,RADAR,SCATTER,BUBBLE,STOCK,OF_PIE,SURFACE(+UNSUPPORTED). - Combo («Комбинированная», §21.2.2.145): несколько групп в одном plotArea
(bar+line/area), привязка по
c:axId, вторичная ось значений справа; серии масштабируются по своей оси. - Стекинг
stacked/percentStacked— ряды накопленной суммой. - Геометрия/камера 3-D и пропорции откалиброваны по эталонным экспортам Word (пиксельные тесты с допусками).
Умные границы (враждебный XML)
| Бюджет | Значение | Поведение при превышении |
|---|---|---|
ChartRenderer.MAX_PIXELS |
16 777 216 (4096², 64 МБ ARGB) | fitDpi понижает эффективный dpi (24″-график: 300→≈171 dpi), геометрия не меняется |
ChartSpec.MAX_POINTS |
100 000 | отказ до предвыделения списка |
ChartRenderer.MAX_TICKS |
1000 | безумный шаг оси заменяется «красивым» 1/2/5·10ⁿ |
DrawingPreRenderer.MAX_EXTENT_EMU |
22 000 000 (≈24″) | объект остаётся как есть + warn (не удаляется) |
| бюджет chart/math-PNG на документ | 128 MiB | объект удаляется + warn |
Модель деградации
Битая/неподдерживаемая часть роняет не конвертацию, а объект:
| Ситуация | Исход |
|---|---|
| битая chart-часть / превышение бюджета PNG | объект удалён + warn |
| неподдерживаемая/битая OMML-формула | текст (конкатенация m:t) + warn — текст терять хуже |
wp:extent вне диапазона/ноль |
объект остаётся + warn (FOP молча потеряет) |
OutOfMemoryError |
не деградация — ConversionException (REST 500) |
SmartArt
SmartArtRenderer рисует диаграмму по разметке [MS-ODRAWXML]/§21.4: узлы, макет,
связи; тот же DPI/fitDpi.
Формулы OMML
Собственный растер: MathModel разбирает OMML (§22.1) в дерево боксов,
MathRenderer рисует его только бандл-шрифтами. Конструкции вне списка SUPPORTED
деградируют в текст ещё на шаге нормализации (правило 6). Inline-формула опускается
на нижний запас рана — FOP ставит инлайн-графику нижним краем на базу строки.
Контрафт media-частей
PNG-части получают имена /word/media/chart-N.png (константа
CHART_MEDIA_URI_PREFIX); по этому префиксу ChartImageHandler отключает
пересжатие картинок в FOP — переименование молча вернёт «мыльный» ресемпл.
Глубина (пейнтеры, калибровки, спецификационные секции) — chart.md (репозиторий).