- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
3.6 KiB
Шрифты
Конвертация не зависит от шрифтов системы: 30 TTF упакованы в jar
wordpdf-core/src/main/resources/fonts/, выгружаются во временный каталог и
регистрируются в docx4j/FOP. Реестр шрифтов после каждой конвертации возвращается
к бандлу — шрифты, встроенные в чужие docx, не влияют на последующие документы.
java.awt.Font не используется (метрики и глифы — fontbox напрямую), поэтому
fontconfig серверу не нужен.
Бандл
7 текстовых семейств по 4 начертания + 2 покрывающих (только regular):
| Семейство | Аналог MS-шрифта | Назначение |
|---|---|---|
| Carlito | Calibri | метрически совместимая замена |
| Caladea | Cambria | метрически совместимая замена |
| Arimo | Arial | метрически совместимая замена |
| Tinos | Times New Roman | метрически совместимая замена |
| Cousine | Courier New | метрически совместимая замена |
| DejaVu Sans / DejaVu Serif | — | fallback с гарантированной кириллицей |
| Noto Naskh Arabic | — | арабские дополнения U+07B1–U+08FF |
| Noto Sans Armenian | — | армянские знаки Unicode 16 |
Алиасы (BundledFontAliases)
Имена шрифтов из документа подменяются аналогами при конвертации:
| Имя в docx | Физический шрифт |
|---|---|
| Calibri | Carlito |
| Cambria | Caladea |
| Arial | Arimo |
| Times New Roman | Tinos |
| Courier New | Cousine |
Fallback-цепочка
- Ран идёт своим шрифтом (по
w:rFonts+ алиасам). - Знака нет в шрифте рана (тире «—», кавычки, U+2000–U+2EFF) — ран падает в DejaVu Sans (FOP-фолбэк-семейства задекларированы всецело, шаг 4 конвейера).
- Serif-раны ищут покрытие сначала в serif-семействах (DejaVu Serif, Tinos, Caladea).
- Знака нет и там —
GlyphCoverageNormalizer(правило 7) режет ран и каждой части назначает покрывающее семейство: serif → DejaVu Serif, sans → DejaVu Sans, экзотика → Noto. - Знака нет ни в одном шрифте бандла — остаётся
.notdef(пустой бокс).
Все шрифты встраиваются в PDF как подмножества (кириллица и латиница воспроизводятся на любом просмотрщике).
Лицензии
| Шрифты | Лицензия |
|---|---|
| Arimo, Cousine, Tinos, Carlito, Caladea | SIL OFL 1.1 (fonts/FONT-LICENSE.txt) |
| DejaVu Sans / DejaVu Serif | SIL OFL 1.1 / Bitstream Vera (fonts/DejaVu-LICENSE.txt) |
| Noto Naskh Arabic, Noto Sans Armenian | SIL OFL 1.1 (fonts/Noto-LICENSE.txt) |
GPL-шрифты в бандл не добавляем намеренно (из-за этого два символа эталона —
U+2188/U+218A — остаются .notdef; см. Ограничения).
Новый шрифт = файл в resources/fonts/ + запись в BundledFonts.ENTRIES
(синхронность проверяет BundledFontsTest).