Making custom CSS changes on your site

:bookmark: Este guia explica como fazer alterações de CSS em seu site Discourse, incluindo uma introdução ao CSS, onde adicionar CSS no Discourse e como encontrar os seletores corretos usando ferramentas de inspeção do navegador.

:person_raising_hand: Nível de usuário necessário: Administrador

Resumo

Este guia abrange:

  1. Uma breve introdução ao CSS e conceitos-chave
  2. Como adicionar CSS ao seu site Discourse usando componentes de tema
  3. Usando ferramentas de inspeção do navegador para encontrar os seletores CSS corretos

Entendendo os conceitos básicos de CSS

CSS significa Cascading Style Sheets (Folhas de Estilo em Cascata). Aqui estão três conceitos-chave para entender:

  1. Estrutura: Uma regra CSS consiste em um seletor, propriedade e valor.
p {
  color: red;
}
  • Seletor: p (seleciona todas as tags p HTML)
  • Propriedade: color
  • Valor: red

  1. Cascade (Cascata): A última regra aplicada tem precedência. Por exemplo:
p {
  color: red;
}
p {
  color: green;
}

Os parágrafos ficarão verdes porque é a última regra aplicada.

  1. Especificidade: Regras mais específicas substituem as menos específicas. Por exemplo:
div p {
  color: green;
}
p {
  color: red;
}

Os parágrafos dentro de divs permanecerão verdes porque div p é mais específico que p.

Adicionando CSS ao seu site Discourse

Para adicionar CSS ao seu site Discourse:

  1. Vá para Aparência > Temas e componentes na barra lateral ou siga este URL para o seu site: https://yoursite.com/admin/customize/components

  2. Clique em Instalar e :heavy_plus_sign: Criar Novo, respectivamente.

  3. Nomeie seu componente de tema e clique em Criar

  4. Escolha em quais temas aplicar o componente

  5. Clique em Editar Código

  6. Adicione seu CSS na aba CSS

  7. Clique em “Salvar” para aplicar suas alterações.

:warning: Se você tiver vários temas selecionáveis pelo usuário, certifique-se de adicionar seus componentes de tema a todos os temas relevantes.

Encontrando os seletores CSS corretos

Use as ferramentas de inspeção do navegador para encontrar os seletores CSS corretos:

  1. Clique com o botão direito no elemento que você deseja modificar.

  2. Selecione “Inspecionar” no menu de contexto.

  3. No painel de ferramentas do desenvolvedor, localize os seletores de elementos.

  4. Clique nos seletores respectivos e adicione sua regra CSS.

  5. Copie a regra, cole-a na seção CSS do seu componente de tema e remova outras regras.

Para seletores mais específicos, pode ser necessário copiar o seletor usado nos estilos existentes do Discourse e modificá-lo em seu componente de tema.

Aqui está um vídeo demonstrando os passos acima:

:information_source: Se suas alterações não forem aplicadas, verifique se:

  • O componente de tema está ativado em seus temas.
  • Sua regra CSS é específica o suficiente para substituir os estilos existentes.

Recursos adicionais

39 curtidas

Isso poderia ser transformado em uma wiki? As informações sob o título Onde Adiciono Meu CSS? precisam ser atualizadas, pois não há mais o botão Editar CSS/HTML se você instalou um tema existente — o que é provável agora se alguém escolheu um tema através do novo Assistente de Configuração. Agora usamos componentes de tema que serão adicionados a temas existentes.

Posso atualizá-lo assim que for transformado em uma wiki.

10 curtidas

Ok, isso foi concluído :+1:

5 curtidas