fix(fonts): реальные начертания бандла в getBoldForm/getItalicForm/getBoldItalicForm
PR checks / web (pull_request) Successful in 9s
PR checks / java (pull_request) Successful in 3m57s
Main: tests, deploy, autotests / web (push) Successful in 8s
Main: tests, deploy, autotests / java (push) Successful in 1m16s
Main: tests, deploy, autotests / images-web (push) Successful in 1m22s
Main: tests, deploy, autotests / images-app (push) Successful in 20s
Main: tests, deploy, autotests / deploy (push) Successful in 2m8s
Main: tests, deploy, autotests / autotests (push) Successful in 14s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PR checks / web (pull_request) Successful in 9s
PR checks / java (pull_request) Successful in 3m57s
Main: tests, deploy, autotests / web (push) Successful in 8s
Main: tests, deploy, autotests / java (push) Successful in 1m16s
Main: tests, deploy, autotests / images-web (push) Successful in 1m22s
Main: tests, deploy, autotests / images-app (push) Successful in 20s
Main: tests, deploy, autotests / deploy (push) Successful in 2m8s
Main: tests, deploy, autotests / autotests (push) Successful in 14s
Main: tests, deploy, autotests / rollback (push) Has been skipped
На macOS PhysicalFonts.getBoldForm для имён бандл-шрифтов ('Tinos Regular',
'Carlito Regular', ...) уходит в MicrosoftFontsRegistry, где у этих записей
Mac-имя файла null, и возвращает null; docx4j строит simulate-style fopconf
(все начертания на regular-TTF), FOP теряет реальные Bold/Italic — метрики и
кернинг ломают переносы (strictOoxml: 'таблица' -> 'таблиц а').
BundledFontMapper переопределяет три variant-form метода: семейство опознаётся
по embeddedURI regular-варианта, начертание берётся реальным из бандла; вне
бандла / без init() — родительская логика без изменений.
Тест: BundledFontMapperTest#variantForms_resolveBundleSibling (красный на macOS
без override); регрессии: WordPdfConverterTest#strictOoxml_convertsNotRejected,
#ruPlain_regularRunsUseRegularFont (проверены под -Dos.name='Mac OS X').
docs/agent/pipeline.md: абзац о macOS-ветке.
This commit was merged in pull request #114.
This commit is contained in:
@@ -26,6 +26,17 @@ import java.util.Set;
|
||||
* файл для каждого начертания. Ключи register*Form — точное имя из
|
||||
* документа: docx4j ищет варианты именно по нему.
|
||||
*
|
||||
* ВАЖНО (macOS): {@code PhysicalFonts.getBoldForm} для имён бандл-шрифтов
|
||||
* ({@code Tinos Regular}, {@code Carlito Regular}, …) на macOS уходит в
|
||||
* {@code MicrosoftFontsRegistry} и возвращает {@code null} — у этих записей
|
||||
* нет Mac-имени файла. docx4j тогда строит simulate-style fopconf (все
|
||||
* начертания на regular-TTF), и FOP теряет реальные Bold/Italic: другие
|
||||
* метрики и кернинг ломают переносы в узких ячейках (регрессии —
|
||||
* {@code WordPdfConverterTest#strictOoxml_convertsNotRejected},
|
||||
* {@code #ruPlain_regularRunsUseRegularFont}). Override-ы
|
||||
* {@code getBoldForm}/{@code getItalicForm}/{@code getBoldItalicForm}
|
||||
* отдают реальные бандл-варианты.
|
||||
*
|
||||
* ВАЖНО (порядок инициализации): конструктор BestMatchingMapper
|
||||
* запускает обнаружение системных шрифтов, которые могут занять те же
|
||||
* имена в реестре docx4j. Поэтому {@code BundledFonts.init()} нужно
|
||||
@@ -86,6 +97,51 @@ public class BundledFontMapper extends BestMatchingMapper {
|
||||
}
|
||||
}
|
||||
|
||||
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||
@Override
|
||||
public PhysicalFont getBoldForm(String fontName, PhysicalFont physicalFont) {
|
||||
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD);
|
||||
return bundled != null ? bundled : super.getBoldForm(fontName, physicalFont);
|
||||
}
|
||||
|
||||
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||
@Override
|
||||
public PhysicalFont getItalicForm(String fontName, PhysicalFont physicalFont) {
|
||||
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_ITALIC);
|
||||
return bundled != null ? bundled : super.getItalicForm(fontName, physicalFont);
|
||||
}
|
||||
|
||||
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||
@Override
|
||||
public PhysicalFont getBoldItalicForm(String fontName, PhysicalFont physicalFont) {
|
||||
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD_ITALIC);
|
||||
return bundled != null ? bundled : super.getBoldItalicForm(fontName, physicalFont);
|
||||
}
|
||||
|
||||
/**
|
||||
* Реальное начертание бандл-семейства, к которому относится {@code pf}.
|
||||
*
|
||||
* <p>Семейство опознаётся по {@code embeddedURI} regular-варианта, а не
|
||||
* по имени: на macOS имя в реестре docx4j — полное из TTF-таблицы
|
||||
* ({@code Tinos Regular}), и именно на нём ломается
|
||||
* {@code PhysicalFonts.getBoldForm}. Шрифт вне бандла (или {@code pf ==
|
||||
* null}, {@code BundledFonts.init()} не вызван) → {@code null}, вызывающий
|
||||
* идёт родительской логикой.</p>
|
||||
*/
|
||||
private static PhysicalFont bundledSibling(PhysicalFont pf, String variant) {
|
||||
if (pf == null || pf.getEmbeddedURI() == null) {
|
||||
return null;
|
||||
}
|
||||
String uri = pf.getEmbeddedURI().toString();
|
||||
for (String family : BundledFonts.families()) {
|
||||
PhysicalFont regular = BundledFonts.regular(family);
|
||||
if (regular != null && uri.equals(regular.getEmbeddedURI().toString())) {
|
||||
return BundledFonts.font(family, variant);
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Привязывает все начертания семейства к имени шрифта из документа.
|
||||
*/
|
||||
|
||||
@@ -99,4 +99,31 @@ class BundledFontMapperTest {
|
||||
"без init() алиасованный шрифт не должен попасть и в fallback");
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Варианты начертаний отдаются реальным sibling-файлом бандла, а не
|
||||
* результатом registry-эвристики: на macOS без override
|
||||
* {@code PhysicalFonts.getBoldForm} для «Carlito Regular» уходит в
|
||||
* {@code MicrosoftFontsRegistry} (Mac-имя файла {@code null}) и возвращает
|
||||
* {@code null} — на этой платформе тест красный. На Linux super тоже
|
||||
* находит bold, поэтому сквозная регрессия macOS — конвертерные тесты
|
||||
* {@code WordPdfConverterTest#strictOoxml_convertsNotRejected} и
|
||||
* {@code #ruPlain_regularRunsUseRegularFont}, а этот фиксирует контракт
|
||||
* маппера.
|
||||
*/
|
||||
@Test
|
||||
void variantForms_resolveBundleSibling() {
|
||||
BundledFonts.init();
|
||||
BundledFontMapper mapper = new BundledFontMapper();
|
||||
PhysicalFont regular = BundledFonts.regular("carlito");
|
||||
|
||||
assertSame(BundledFonts.bold("carlito"),
|
||||
mapper.getBoldForm("Carlito Regular", regular), "bold-вариант");
|
||||
assertSame(BundledFonts.italic("carlito"),
|
||||
mapper.getItalicForm("Carlito Regular", regular), "italic-вариант");
|
||||
assertSame(BundledFonts.boldItalic("carlito"),
|
||||
mapper.getBoldItalicForm("Carlito Regular", regular), "bolditalic-вариант");
|
||||
assertNull(mapper.getBoldForm("Unknown", null),
|
||||
"путь super без physicalFont не должен падать");
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user