Discourse es altamente personalizable, lo que le permite modificar casi cualquier aspecto de su apariencia a través de temas.
Para mantener la compatibilidad con las actualizaciones continuas de Discourse y las nuevas funciones, todos los temas requieren un mantenimiento ocasional. La frecuencia del mantenimiento depende de la complejidad y el tipo de personalización. Puede minimizar los esfuerzos de mantenimiento de su tema siguiendo estas pautas:
- Busque 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 sus propias personalizaciones.
- Reemplace el texto de la interfaz de usuario utilizando la función administrador → personalizar → texto buscando el texto específico y actualizándolo allí.
- El CSS del tema es aditivo, lo que le permite anular los estilos predeterminados sin editarlos directamente. Este enfoque mejora la mantenibilidad del CSS y minimiza los conflictos con las actualizaciones.
- Utilice un sistema de control de versiones como Git con GitHub, GitLab o Bitbucket para rastrear los cambios. Si bien el editor de HTML y CSS en administrador → 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, cree módulos independientes para nuevas funcionalidades e intégralos a través de salidas de complementos (plugin outlets). Discourse utiliza Ember.js, por lo que construir 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 el JavaScript predeterminado de Discourse y las plantillas HTML dentro de un tema debe ser el último recurso, ya que es más probable que estos cambios sean incompatibles con las actualizaciones de Discourse, difíciles de solucionar y más propensos a errores que provoquen tiempo de inactividad.
Para obtener más información sobre el uso y la creación de temas de Discourse, no dude en hacer preguntas en nuestra comunidad Meta y eche un vistazo a nuestras guías de temas:
- Guía para principiantes sobre el uso de temas de Discourse
- Guía para diseñadores de temas de Discourse
- Guía para desarrolladores de temas de Discourse
- Cómo habilitar el Modo Seguro para solucionar problemas con temas y complementos
- Estructura de temas y componentes de tema
- Crear y compartir un componente de tema de fuente
- Cómo crear y compartir un esquema de color
- Cómo usar las variables principales de Discourse en su tema
- Cómo agregar configuraciones a su tema de Discourse
- Theme Creator, ¡cree y muestre temas sin instalar Discourse!
Este documento está controlado por versiones: sugiera cambios en github.