Discourse é altamente personalizável, permitindo que você modifique quase qualquer aspecto de sua aparência por meio 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 a existência de temas ou componentes de tema oficiais que correspondam à funcionalidade desejada. Eles são atualizados junto com o Discourse. Esses também podem servir como exemplos de como abordar suas próprias personalizações.
- Substitua o texto da interface usando o recurso admin → personalizar → texto, pesquisando pelo texto específico e atualizando-o lá.
- O CSS do tema é aditivo, permitindo que você substitua os estilos padrão sem editá-los diretamente. Essa abordagem melhora a manutenibilidade do CSS e minimiza conflitos com as atualizações.
- Use um sistema de controle de versão como Git com GitHub, GitLab ou Bitbucket para acompanhar as alterações. Embora o editor de HTML e CSS em admin → personalizar → temas seja conveniente para ajustes menores, os sistemas de controle de versão podem facilitar o acompanhamento 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 por meio de saídas de plugin. O Discourse usa Ember.js, portanto, criar componentes Ember é ideal. Esse método isola a funcionalidade personalizada, reduz a manutenção e ajuda a evitar conflitos com as atualizações do Discourse.
A substituição dos modelos JavaScript e HTML padrão do Discourse dentro de um tema deve ser uma última opção, pois essas alterações têm mais probabilidade de ser incompatíveis com as atualizações do Discourse, podem ser difíceis de solucionar e estão mais sujeitas a erros que resultam em tempo de inatividade.
Para mais informações sobre o uso e criação de temas do Discourse, sinta-se à vontade para fazer perguntas em nossa comunidade Meta e dê uma olhada em 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 Seguro para solucionar problemas com temas e plugins
- Estrutura de temas e componentes de tema
- Criar e compartilhar um componente de tema de fonte
- Como criar e compartilhar um esquema de cores
- Como usar variáveis do núcleo do Discourse em seu tema
- Como adicionar configurações ao seu tema do Discourse
- Criador de temas, crie e mostre temas sem instalar o Discourse!
Este documento possui controle de versão - sugira alterações no github.