Экзотические глифы: решётка «#» вместо .notdef
Знак без глифа в шрифте ранa FOP рисовал .notdef — в эталонном references/word.docx таких оставалось 28. - Noto Naskh Arabic и Noto Sans Armenian (SIL OFL, 278 КБ) в бандле: FontFallback.selectCovering перебирает весь реестр PhysicalFonts и находит их сам — арабские дополнения и армянские Unicode 16 рисуются без нашего кода. - GlyphCoverageNormalizer режет ран по покрытию глифов и пишет семейство в w:rFonts. Нужен из-за двух дыр docx4j: needsCoverage=false для «латинской» группы (римские цифры U+2150–U+218F) и кэш fallbackByScript на всю группу Юникода (армянские U+058D/U+058E получали DejaVu Serif). - FopFallbackFonts.declare декларирует все бандл-семейства: FOP встраивает только задекларированные, а font-family в FO может запросить любое. В эталоне осталось 2 решёток: U+2188 и U+218A есть только в GNU FreeSerif (GPL-3+ с Font Exception), которого в бандле нет намеренно.
This commit is contained in:
@@ -71,8 +71,8 @@ WordPdfConverter.convert(Path.of("doc.docx"), Path.of("out.pdf")); // явный
|
||||
|
||||
## Шрифты
|
||||
|
||||
В `wordpdf-core/src/main/resources/fonts/` упакованы 28 TTF (по 4 начертания
|
||||
на семейство):
|
||||
В `wordpdf-core/src/main/resources/fonts/` упакованы 30 TTF: 7 текстовых
|
||||
семейств по 4 начертания плюс два покрывающих шрифта (только regular):
|
||||
|
||||
| Семейство | Аналог MS-шрифта |
|
||||
|---|---|
|
||||
@@ -82,11 +82,17 @@ WordPdfConverter.convert(Path.of("doc.docx"), Path.of("out.pdf")); // явный
|
||||
| Tinos | Times New Roman |
|
||||
| Cousine | Courier New |
|
||||
| DejaVu Sans / DejaVu Serif | fallback |
|
||||
| Noto Naskh Arabic | арабские дополнения U+07B1–U+08FF |
|
||||
| Noto Sans Armenian | армянские знаки Unicode 16 |
|
||||
|
||||
`BundledFontMapper` подставляет метрически совместимые аналоги при конвертации
|
||||
(`Calibri → Carlito` и т.д.). Нераспознанные шрифты и символы, не найденные в
|
||||
шрифте ранa (em-dash «—», кавычки, U+2000–U+2EFF), падают в **DejaVu Sans**
|
||||
(гарантированная кириллица). Все шрифты встраиваются в PDF как подмножества.
|
||||
(гарантированная кириллица). Знак, которого нет ни в шрифте ранa, ни там, куда
|
||||
его отправил docx4j, ищет себе место сам: `GlyphCoverageNormalizer` режет такой
|
||||
ран и для каждой части назначает покрывающее семейство — serif-раны в
|
||||
**DejaVu Serif**, sans — в **DejaVu Sans**, экзотика — в Noto. Все шрифты
|
||||
встраиваются в PDF как подмножества.
|
||||
|
||||
### Лицензии шрифтов
|
||||
|
||||
@@ -94,6 +100,8 @@ WordPdfConverter.convert(Path.of("doc.docx"), Path.of("out.pdf")); // явный
|
||||
(см. `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`).
|
||||
|
||||
## Как это работает
|
||||
|
||||
@@ -107,7 +115,7 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
|
||||
из-за чего regular-раны могли рендериться жирным курсивом),
|
||||
`SymbolFontNormalizer` (маркеры из Symbol/Wingdings вместо «#») и
|
||||
`FieldNormalizer` (поля `PAGE`/`NUMPAGES` пересчитываются, а не печатают
|
||||
кэш из docx).
|
||||
кэш из docx) и `GlyphCoverageNormalizer` (раны со знаками вне их шрифта).
|
||||
2. Документ загружается в `WordprocessingMLPackage`, привязывается
|
||||
`BundledFontMapper`, диаграммы и SmartArt предварительно растеризуются
|
||||
в PNG (`DrawingPreRenderer`).
|
||||
@@ -120,6 +128,10 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
|
||||
приближённые (ограничения FOP/docx4j, а не «мы что-то упустили»).
|
||||
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
|
||||
есть глиф, иначе — из fallback-семейства DejaVu.
|
||||
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
||||
остаётся `.notdef`. В эталонном `references/word.docx` таких два — U+2188 (ↈ)
|
||||
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
|
||||
целиком на SIL OFL.
|
||||
- Поддержка таблиц/изображений — базовая (через docx4j/FOP).
|
||||
|
||||
## Тесты
|
||||
|
||||
Reference in New Issue
Block a user