 |
Сводка | Discourse FontAwesome Pro позволяет использовать иконки Font Awesome Pro в Discourse с помощью лицензии FontAwesome, используя токен NPM-пакета вашего аккаунта. |
 |
Ссылка на репозиторий | https://github.com/discourse/discourse-fontawesome-pro |
 |
Гид по установке | Как установить плагины в Discourse |
Конфигурация
Для включения этого плагина требуется несколько дополнительных шагов по сравнению с обычным плагином:
Во-первых, вам нужно установить дополнительную переменную окружения, содержащую ваш токен пакета font awesome pro (обратите внимание, что это отличается от вашего API-токена): DISCOURSE_FONTAWESOME_AUTH_TOKEN
Скрипт установки также должен вызываться во время инициализации в качестве дополнительного хука “after_code”. Это скачивает и добавляет SVG-файлы FontAwesome 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 по умолчанию:
Выбор стиля переопределения:
Вы также можете переопределить стиль иконок по умолчанию:
Duotone
Чтобы полностью контролировать поддержку duotone, вам нужно будет переопределить следующий 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;
}
Обновление стиля Duotone
Если вы используете селекторы на основе классов, например:.fa-secondary { color: red; }Вам нужно будет обновить свой стиль, чтобы использовать CSS-переменные вместо этого. Переопределения цвета на основе классов больше не работают, поскольку они были удалены в Font Awesome v7
Под капотом здесь используется репозиторий FontAwesome для установки шрифтов в папку SVG плагина, и позволяет Discourse подбирать спрайты оттуда.