Discourse es altamente personalizable, lo que te permite modificar casi cualquier aspecto de su apariencia mediante temas.
Para mantener la compatibilidad con las actualizaciones continuas de Discourse y las nuevas funciones, todos los temas requieren mantenimiento ocasional. La frecuencia del mantenimiento depende de la complejidad y el tipo de personalización. Puedes minimizar los esfuerzos de mantenimiento de tu tema siguiendo estas pautas:
- Busca temas o componentes de tema oficiales que coincidan con la funcionalidad deseada. Estos se actualizan junto con Discourse. También pueden servir como ejemplos de cómo abordar tus propias personalizaciones.
- Reemplaza el texto de la interfaz utilizando la función admin → personalizar → texto, buscando el texto específico y actualizándolo allí.
- El CSS del tema es aditivo, lo que te permite anular los estilos predeterminados sin editarlos directamente. Este enfoque mejora la mantenibilidad del CSS y minimiza los conflictos con las actualizaciones.
- Utiliza un sistema de control de versiones como Git con GitHub, GitLab o Bitbucket para rastrear los cambios. Aunque el editor de HTML y CSS en admin → personalizar → temas es conveniente para ajustes menores, los sistemas de control de versiones pueden facilitar el seguimiento y la solución de problemas de cambios más complejos.
- Para personalizaciones avanzadas, crea módulos independientes para nuevas funcionalidades e intégralos mediante salidas de plugin. Discourse utiliza Ember.js, por lo que crear componentes de Ember es ideal. Este método aísla la funcionalidad personalizada, reduce el mantenimiento y ayuda a evitar conflictos con las actualizaciones de Discourse.
Anular las plantillas JavaScript y HTML predeterminadas de Discourse dentro de un tema debe ser un último recurso, ya que estos cambios son más propensos a ser incompatibles con las actualizaciones de Discourse, pueden ser difíciles de solucionar y son más propensos a errores que resulten en tiempo de inactividad.
Para más información sobre el uso y creación de temas de Discourse, no dudes en hacer preguntas en nuestra comunidad Meta y echa un vistazo a nuestras guías de tematización:
- Guía para principiantes sobre el uso de temas de Discourse
- Guía para diseñadores sobre temas de Discourse
- Guía para desarrolladores sobre temas de Discourse
- Cómo habilitar el modo seguro para solucionar problemas con temas y plugins
- Estructura de temas y componentes de tema
- Crear y compartir un componente de tema de fuente
- Cómo crear y compartir un esquema de colores
- Cómo usar las variables centrales de Discourse en tu tema
- Cómo agregar configuraciones a tu tema de Discourse
- Creador de temas, ¡crea y muestra temas sin instalar Discourse!
Este documento está controlado por versiones - sugiere cambios en github.