Discourse é altamente personalizável, permitindo que você modifique quase todos os aspectos de sua aparência através de temas.
Para manter a compatibilidade com as atualizações contínuas do Discourse e novos recursos, todos os temas exigem manutenção ocasional. A frequência da manutenção depende da complexidade e do tipo de personalização. Você pode minimizar os esforços de manutenção do seu tema seguindo estas diretrizes:
- Verifique se há temas oficiais ou componentes de tema que correspondam à funcionalidade desejada. Estes são atualizados juntamente com o Discourse. Eles também podem servir como exemplos de como abordar suas próprias personalizações.
- Substitua o texto da interface usando o recurso admin → customize → text, pesquisando o texto específico e atualizando-o lá.
- O CSS do tema é aditivo, permitindo que você substitua estilos padrão sem editá-los diretamente. Essa abordagem melhora a manutenibilidade do CSS e minimiza conflitos com atualizações.
- Use um sistema de controle de versão como o Git com GitHub, GitLab ou Bitbucket para rastrear alterações. Embora o editor de HTML e CSS em admin → customize → themes seja conveniente para pequenos ajustes, os sistemas de controle de versão podem facilitar o rastreamento e a solução de problemas de alterações mais complexas.
- Para personalizações avançadas, crie módulos independentes para novas funcionalidades e integre-os através de plugin outlets. O Discourse usa Ember.js, portanto, construir componentes Ember é o ideal. Esse método isola a funcionalidade personalizada, reduz a manutenção e ajuda a evitar conflitos com as atualizações do Discourse.
Substituir o JavaScript e os modelos HTML padrão do Discourse dentro de um tema deve ser o último recurso, pois essas alterações são mais propensas a serem incompatíveis com as atualizações do Discourse, podem ser difíceis de solucionar e são mais suscetíveis a erros que resultam em tempo de inatividade.
Para mais informações sobre como usar e construir temas do Discourse, sinta-se à vontade para fazer perguntas em nossa comunidade Meta, e confira nossos guias de temas:
- Guia para Iniciantes sobre o Uso de Temas do Discourse
- Guia do Designer para Temas do Discourse
- Guia do Desenvolvedor para Temas do Discourse
- Como ativar o Modo de Segurança para solucionar problemas com temas e plugins
- Estrutura de temas e componentes de tema
- Crie e compartilhe um componente de tema de fonte
- Como criar e compartilhar um esquema de cores
- Como usar variáveis principais do Discourse em seu tema
- Como adicionar configurações ao seu tema do Discourse
- Theme Creator, crie e exiba temas sem instalar o Discourse!
Este documento é versionado - sugira alterações no github.