|
| Резюме | Discourse FontAwesome Pro позволяет использовать иконки Font Awesome Pro в Discourse с лицензией FontAwesome, используя токен пакета NPM вашей учетной записи.|
|
| Ссылка на репозиторий | https://github.com/discourse/discourse-fontawesome-pro|
|
| Руководство по установке | Как установить плагины в Discourse|
Конфигурация
Для включения этого плагина требуется несколько дополнительных шагов по сравнению с обычным плагином:
Сначала вам нужно создать дополнительную переменную окружения, содержащую ваш лицензионный ключ Font Awesome Pro: DISCOURSE_FONTAWESOME_AUTH_TOKEN
Скрипт установки также необходимо вызвать во время инициализации в качестве дополнительного хука “after_code”. Это скачивает и добавляет SVG-файлы Font Awesome Pro при сборке, используя ваш токен авторизации. Это отдельный блок, не входящий в блок клонирования плагина.
Вот пример установки в app.yml:
env:
DISCOURSE_FONTAWESOME_AUTH_TOKEN: 123456
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/discourse-fontawesome-pro.git
- exec:
cd: $home/plugins/discourse-fontawesome-pro
raise_on_fail: false
cmd:
- $home/plugins/discourse-fontawesome-pro/scripts/install.sh
Выбор семейства переопределения:
В настройках администратора вы можете переопределить семейство иконок Discourse по умолчанию:
Выбор стиля переопределения:
Вы также можете переопределить стиль иконок по умолчанию:
Двухцветные иконки
Для полного контроля над поддержкой двухцветных иконок вам потребуется переопределить следующий CSS (в теме или ином месте) и заменить его на вашу собственную цветовую схему:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Для окрашивания отдельных иконок обратитесь к ID SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Обновление стилей для двухцветных иконок
Если вы используете селекторы на основе классов, например:.fa-secondary { color: red; }вам необходимо обновить стилизацию, используя вместо этого CSS-переменные. Переопределение цвета на основе классов больше не работает, так как оно было удалено в Font Awesome v7
В основе работы используется репозиторий FontAwesome для установки шрифтов в папку SVG плагина, что позволяет Discourse загружать спрайты оттуда.
Размещено нами? Этот плагин доступен в наших корпоративных тарифах.