Как добавить модификатор собственного шрифта?
Данная инструкция предполагает добавление модификатора для шрифта, который не предусмотрен в SIMAI: Framework (посмотреть документацию).
Инструкция предусматривает "костыльный" способ подключения модификатора.
Изменения, выполненные по инструкции в файлах /simai.data/template/style.php и /simai/config/.asset.config.php могут быть затерты при выпуске обновлений для этих файлов.
В архиве со шрифтом должен быть сформирован файл stylesheet.css (Возможно сделать на сайте https://transfonter.org/).
Архив должен быть в формате .zip (1С-Битрикс не поддерживает .rar).
Шаг 1. Перейти в папку /simai/asset/
Шаг 2. Добавить папку my-fonts.
Шаг 3. Перейти в созданную папку /simai/asset/my-fonts/.
Шаг 4. Загрузить в папку архив в формате .zip.
Шаг 5. Распаковать архив. В архиве обязательно должен присутствовать файл stylesheet.css
Шаг 6. Открыть файл stylesheet.css в режиме редактирования PHP-кода
и добавить код модификатора:
Например:
.t-myriad {
font-family: 'Myriad Pro';
}
Шаг 7. Перейти в папку /simai/config/.
Шаг 8. Открыть файл .asset.config.php в режиме редактирования PHP-кода.
Шаг 9. Добавить код для изменения конфигурации: необходимо добавить массив, после return array.
Например, нужно добавить шрифт Myriad Pro, тогда код файла будет следующий:
'my-fonts' => array(
'name' => 'My fonts',
'dir' => '/my-fonts',
'asset' => array(
'default' => array(
'version' => '1.0.0',
'dir' => '/Myriad Pro',
'file' => array(
'0' => array(
'path' => '/stylesheet.css',
'type' => 'style',
),
),
),
),
),
Шаг 10. Перейти в папку /simai.data/template/ (если сайт находится в директории, например, /ru, то путь до файла будет /ru/simai.data/template/).
Шаг 11. Открыть файл style.php в режиме редактирования PHP-кода.
Шаг 12. Добавить код.
Asset::getInstance()->load("my-fonts");
Если необходимо у текста использовать данный шрифт, нужно использовать созданный модификатор (в примере t-myriad). Остальные модификаторы (например, размер, толщина, жирность и т.д.) прописываются исходя из документации - http://sf4.simai.pro/ru/ui/content/typography.php
После добавления модификатора шрифта можно прописывать его в параметрах компонентов, например:
