Поддержка шрифтов#

Использование шрифтов движками шаблонизации#

Движок FreeMarker#

Движок FreeMarker не использует шрифтов.

Движок XDocReport#

Движок XDocReport при генерации документа использует шрифты шаблона или доступные системные шрифты.

Движок JasperReports#

Движок JasperReports имеет возможность при генерации документа поставлять шрифты через расширение библиотеки JasperReports, подключая их в момент генерации. Подробнее читайте в документации продукта JasperReports.

Компонент DCGL подключает расширения:

• jasperreports-font, которое содержит шрифты семейства DejaVu:

  • DejaVu Sans;

  • DejaVu Sans Mono;

  • DejaVu Serif;

• jasperreports-fonts-liberation, которое содержит шрифты семейства Liberation:

  • Liberation Sans;

  • Liberation Serif;

  • Liberation Mono.

В шаблоне JasperReports рекомендуется явно указывать шрифт. Если шрифт не задан, используется шрифт по умолчанию — Liberation Sans из пакета шрифтов Liberation.

При использовании в шаблоне JasperReports шрифтов, которые не поставляются с DCGL, необходимо их наличие в ОС, в которой развернут DCGL. Если в шаблоне указан шрифт, который отсутствует в classpath при генерации, или он не был указан как используемый дополнительный шрифт, возвращается ошибка об его отсутствии — net.sf.jasperreports.engine.util.JRFontNotFoundException.

Добавление шрифтов в ОС с использованием утилиты fontconfig#

Уилита fontconfig служит в Linux для управления шрифтами. Дистрибутив/базовый образ Linux должен содержать fontconfig по умолчанию. Если утилиты нет, установите пакет fontconfig.

Установка шрифтов производится в подпапку в домашней директории для текущего пользователя.

Шрифты по умолчанию зависят от дистрибутива/базового образа Linux.

Для установки шрифтов выполните следующие шаги:

1. Проверьте наличие папки ~/.fonts (например, можно перейти в эту папку командой cd ~/.fonts).

2. Если папка ~/.fonts отсутствует, создайте ее командой mkdir ~/.fonts.

3. Скопируйте в эту папку файлы шрифтов (cp –rvf ~/.downloaded_fonts — заменить на папку, в которую были предварительно скачаны шрифты).

4. Выполните команду fc-cache ~/.fonts.

5. Убедитесь, что шрифты установились в систему, используя команду fc-list для просмотра доступных шрифтов.

6. Проверьте, что необходимые шрифты сконфигурированы в fonts.conf (для поиска конфигурации выполните find / -name "fonts.conf").

Подключение дополнительных шрифтов посредством DCGL (без утилиты fontconfig)#

Компонент DCGL для шаблонов движков XDocReport и JasperReports позволяет использовать дополнительные шрифты при генерации документа. Поддерживаются шрифты типов Type 1 и TrueType.

Для каждого семейства шрифтов в подсемейство можно добавить шесть стилей в соответствии со спецификацией OpenType (см. описание кода 1 в приведенной по ссылке таблице):

• Regular (обычный);

• Bold (жирный);

• Italic (курсив);

• Oblique (наклонный);

• Bold Italic (жирный курсив);

• Bold Oblique (жирный наклонный).

Для движка XDocReport для шрифтов любых подтипов (Black, Semibold, Thin, иные) могут быть добавлены все шесть перечисленных выше стилей.

Для движка JasperReports для шрифтов любых подтипов (Black, Semibold, Thin, Display, иные) могут быть добавлены четыре стиля: Regular, Bold, Italic/Oblique (при наличии обоих стилей предпочтение будет отдано стилю Italic), Bold Italic/Bold Oblique (при наличии обоих стилей предпочтение будет отдано стилю Bold Italic).

Настройка параметров#

Для использования дополнительных шрифтов при установке требуется выполнить следующие действия:

1. Выставить для параметра dcgn.customFonts.enabled значение true.

2. Задать путь до директории с дополнительными шрифтами параметром dcgn.customFonts.path. В директории, указанной в параметре dcgn.customFonts.path, могут присутствовать файлы шрифтов, ZIP-архивы, содержащие файлы шрифтов, а также директории, в которых содержатся файлы шрифтов и ZIP-архивы, содержащие файлы шрифтов.

3. При необходимости настроить подключаемые шрифты (задать псевдонимы, задать пути до файлов шрифтов):

   • выставить для параметра dcgn.customFonts.fineTune.enabled значение true;

   • выставить для параметра dcgn.customFonts.fineTune.fontFamilies значение список псевдонимов шрифтов, разделенных точкой с запятой: (<псевдоним_1;...;псевдоним_N>);

   • выставить для параметра dcgn.customFonts.fineTune.fontFilesPaths значение список сопоставлений шрифтов к стилю для каждого псевдонима, разделенных точкой с запятой: (<сопоставление1>;...;<сопоставлениеN>).

Указанные параметры описаны в разделе Конфигурирование.

Требования к файлам#

1. Могут использоваться файлы шрифтов типов Type 1 и TrueType, а также наборы шрифтов, сжатых в один ZIP-архив (не более 20 файлов на один архив).

2. Имена файлов могут содержать любые латинские символы, а также дефис.

3. Файлы могут быть закодированы в Base64. В таком случае они должны именоваться по следующей маске: {имя-файла}.{расширение}.base64;

4. Значение суммы Размер закодированного файла + размер {имя-файла} + размер {имя-файла}.{расширение} должно быть таким, чтобы результирующий ConfigMap, содержащий данные о шрифте, не превышал 1 Мбайт.

Требования к сопоставлению стилей шрифтов для псевдонимов#

1. Каждому псевдониму сопоставляется шесть стилей, разделенных двоеточием, в следующем порядке: обычный:курсив:наклонный:жирный:жирный курсив:жирный наклонный. При отсутствии шрифта для конкретного стиля соответствующую позицию оставляют пустой.

2. Сопоставления требуется указывать в порядке определения псевдонимов и разделять точкой с запятой.

3. Каждому стилю следует задать путь до файла шрифта.

4. Путь должен начинаться с директории, названной так же, как и исходный файл шрифта, но в нижнем регистре.

5. Если файл шрифта находится в архиве, имя файла требуется отделять от пути до архива вертикальной чертой (|).

calibri/calibri.zip|Calibri.ttf:calibri-italic/calibri.zip|Calibri-Italic.ttf::calibri-bold/Calibri-Bold.ttf:calibri-bold-italic/Calibri-Bold-Italic.ttf::