 |
Resumo | Discourse FontAwesome Pro permite o uso de ícones do Font Awesome Pro no Discourse com uma licença do Font Awesome, utilizando 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, além de 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 gancho “after_code” adicional. Isso baixa e adiciona os SVGs do Font Awesome 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
Escolhendo uma família de substituição:
Nas configurações de administração, você pode substituir a família de ícones padrão do Discourse:
Escolhendo um estilo de substituição:
Você também pode substituir o estilo de ícone padrão:
Duotone
Para ter controle total sobre o suporte a duotone, você precisará substituir o seguinte CSS (em um tema ou de outra forma) e substituí-lo pela sua própria paleta de cores:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Para colorir ícones individuais, referencie o ID do SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
Atualização de Estilo Duotone
Se você estiver usando seletores baseados em classe como:.fa-secondary { color: red; }Você precisará atualizar seu estilo para usar propriedades personalizadas de CSS em vez disso. Substituições de cor baseadas em classe não funcionam mais, pois foram removidas no Font Awesome v7
Por baixo dos panos, isso usa o repositório do Font Awesome para instalar fontes na pasta SVG do plugin e permite que o Discourse capture os sprites de lá.
Hospedado por nós? Este plugin está disponível em nossos planos Enterprise.