O Discourse suporta temas nativos que podem ser obtidos a partir de um arquivo .tar.gz ou de um repositório git remoto, incluindo repositórios privados.
Um exemplo de tema está disponível em: GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme · GitHub
O repositório git será verificado em busca de atualizações (uma vez por dia) ou usando o botão Verificar Atualizações. Quando alterações forem detectadas, o botão Verificar Atualizações será alterado para Atualizar para a Versão Mais Recente.
Para criar um tema, você precisa seguir uma estrutura de arquivos específica. Estes são os arquivos que você pode incluir:
about.json (obrigatório)
common/common.scss
common/header.html
common/after_header.html
common/footer.html
common/head_tag.html
common/body_tag.html
common/embedded.scss
desktop/desktop.scss
desktop/header.html
desktop/after_header.html
desktop/footer.html
desktop/head_tag.html
desktop/body_tag.html
mobile/mobile.scss
mobile/header.html
mobile/after_header.html
mobile/footer.html
mobile/head_tag.html
mobile/body_tag.html
locales/en.yml
locales/{locale}.yml
stylesheets/{anything}/{anything}/{anything}.scss
javascripts/{anything}.js
javascripts/{anything}.gjs
javascripts/{anything}.hbs
assets/{asset_filename}
settings.yml
Qualquer um desses arquivos 
é opcional, então você só precisa criar os que forem necessários.
Para quem deseja dividir os arquivos SCSS do tema em múltiplos arquivos, isso agora é possível.
Para quem deseja dividir o tema em múltiplos arquivos JS, basta adicionar os arquivos JS desejados no diretório javascripts.
A estrutura do arquivo about.json está abaixo, e você pode ver mais informações sobre ele em https://meta.discourse.org/t/adding-metadata-to-a-theme/119205:
{
"name": "Meu Tema",
"component": false,
"license_url": null,
"about_url": null,
"authors": null,
"theme_version": null,
"minimum_discourse_version": null,
"maximum_discourse_version": null,
"assets": {
"variable-name": "assets/my-asset.jpg"
},
"color_schemes": {
"Meu Esquema de Cores": {
"primary": "222222"
}
},
"screenshots": ["screenshots/light.jpeg", "screenshots/dark.jpeg"]
}
Instruções sobre como adicionar configurações ao seu tema estão disponíveis aqui: Add settings to your Discourse theme.
Para informar ao Discourse que você vai adicionar um componente de tema e não um tema completo, basta adicionar a linha "component": true ao arquivo about.json.
A estrutura de arquivos corresponde às personalizações de CSS/HTML do tema.
Leitura adicional
Confira os outros artigos com a tag #themes::tag.
Veja também:
- Developing Discourse Themes & Theme Components
- Install the Discourse Theme CLI console app to help you build themes
- Include assets (e.g. images, fonts) in themes and components
Última revisão por @SaraDev em 2022-08-15T21:00:00Z
Este documento está sob controle de versão — sugira alterações no GitHub.