|||
-|-|-|
| Resumo | O Discourse FontAwesome Pro permite o uso de ícones Font Awesome Pro no Discourse com uma licença FontAwesome usando o token do pacote NPM da sua conta.
| Link do Repositório | https://github.com/discourse/discourse-fontawesome-pro
| Guia de Instalação | Como instalar plugins no Discourse
Configuração
Isso requer algumas etapas extras para habilitar em comparação com um plugin normal:
Primeiro, você precisará configurar uma variável de ambiente adicional contendo sua chave de licença do Font Awesome Pro: DISCOURSE_FONTAWESOME_AUTH_TOKEN
O script de instalação também precisa ser chamado durante a inicialização, como um hook adicional de “after_code”. Isso baixa e adiciona os SVGs do FontAwesome Pro na compilação usando seu token de autenticação. Este é um bloco adicional separado do bloco de clonagem do plugin.
Aqui está um exemplo de instalação em 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
Selecionando uma família de substituição:
Nas configurações de administrador, você pode substituir a família de ícones padrão do Discourse:
Selecionando um estilo de substituição:
Você também pode substituir o estilo de ícone padrão:
Duotone
Para ter controle total sobre o suporte duotone, você precisará substituir o seguinte CSS (em um tema, ou de outra forma) e substituí-lo por seu próprio esquema de cores:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Para colorir ícones individuais, consulte o ID do SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Atualização de Estilização Duotone
Se você estiver usando seletores baseados em classe como:.fa-secondary { color: red; }Você precisará atualizar sua estilização para usar propriedades personalizadas CSS em vez disso. Substituições de cores baseadas em classe não funcionam mais, pois foram descontinuadas no Font Awesome v7
Por baixo dos panos, isso usa o repositório do FontAwesome para instalar fontes na pasta SVG do plugin e permite que o Discourse pegue os sprites de lá.
Hospedado por nós? Este plugin está disponível em nossos planos Enterprise.
