Documentación sobre cómo extender Discourse con plugins, temas y componentes de temas, trabajar con el código base y usar la API de Discourse.
Introducción
- Introducción: Introducción al desarrollo en Discourse
Entornos de desarrollo
- Dev Container: Desarrollo de Discourse utilizando un Dev Container
- GitHub Codespaces: Desarrollo de Discourse en GitHub Codespaces
- Configuración con Docker: Instalar Discourse para desarrollo utilizando Docker
- Configuración en macOS: Instalar Discourse en macOS para desarrollo
- Configuración en Ubuntu/Debian: Instalar Discourse en Ubuntu o Debian para desarrollo
- Configuración en Windows: Instalar Discourse en Windows para desarrollo
- Plugins sin Docker: Instalar plugins en tu entorno de desarrollo sin Docker
- Configuración local: ¿Configurar un entorno de desarrollo local de Discourse?
- Configuración multisitio: Configurar un entorno de desarrollo multisitio
- Configuración en Fedora: Configurar Discourse para desarrollo en Fedora Linux
Código e internos
- Componentes Ember: Añadir componentes Ember a Discourse
- UI kit: El UI kit de componentes, helpers y modificadores compartidos de Discourse
- Linting y formato: Linting y formateo automático del código antes de los commits
- Pruebas de aceptación: Escribir pruebas de aceptación para código Ember en Discourse
- Ejecutar suites de pruebas: Cómo ejecutar las suites de pruebas QUnit del núcleo, plugins y temas de Discourse
- Compatibilidad de versiones: Fijación (pinning) de versiones de plugins y temas para instalaciones antiguas de Discourse (ramas d-compat)
- Propiedad de objetos Ember: Propiedad de objetos Ember (getOwner, inyección de servicios, etc.)
- Rendimiento JS: Uso de ‘tachometer’ de Google para medir cambios de rendimiento JS en Discourse
- CI con GitHub Actions: Configuración de integración continua utilizando GitHub Actions
- Extensiones Markdown: Guía para desarrolladores sobre extensiones Markdown
- Conversión de modales: Conversión de modales de controladores antiguos a la nueva API de componentes DModal
- API DModal: Uso de la API DModal para renderizar ventanas modales (aka popups/diálogos) en Discourse
- API JS: Uso de la API JS
- Conectores de plugin outlet: Uso de conectores de plugin outlet desde un tema o plugin
- modifyClass: Uso de modifyClass para cambiar el comportamiento del núcleo
- Creación de rutas: Creación de rutas en Discourse y visualización de datos
- Método de autenticación: Añadir un nuevo método de autenticación ‘managed’ a Discourse
- Serialización accidental de modelos ActiveRecord: Prevención de la serialización accidental de modelos ActiveRecord
- Anulación de plantillas: (no recomendado) Anulación de plantillas de Discourse desde un tema o plugin
- Objetos de servicio: Uso de objetos de servicio en Discourse
- Especificaciones de sistema: Escribir especificaciones de sistema de extremo a extremo para la interfaz de usuario de Discourse
- FormKit: Kit de herramientas de Discourse para renderizar formularios.
- Triggers de AppEvents: Referencia de triggers de AppEvents
- Transformers: Uso de Transformers para personalizar valores y comportamiento del lado del cliente
- Personalización de la lista de temas: Personalización de la lista de temas
- Pautas CSS: Pautas para clases CSS utilizando BEM
- Sugerencias y validación de tipos JS: Sugerencias y validación de tipos JavaScript (typescript)
- Diseño para dispositivos: Diseño para diferentes dispositivos (táctil y hover)
- Diseño para anchos responsivos: Diseño para anchos responsivos (puntos de interrupción, viewport y contenedores)
- Primitivos de gestos: Primitivos de arrastre, cambio de tamaño y gestos
- División de paquetes: División de paquetes (bundle splitting) para plugins
- Módulos privados: Módulos privados y la convención
-internals - Pruebas de componentes: Escribir pruebas de componentes para Discourse
Plugins
- Plugin básico: Desarrollo de plugins de Discourse - Parte 1 - Crear un plugin básico
- Plugin outlet: Desarrollo de plugins de Discourse - Parte 2 - Conectarse a un plugin outlet
- Configuraciones del sitio: Desarrollo de plugins de Discourse - Parte 3 - Añadir configuraciones personalizadas del sitio
- Configuración de Git: Desarrollo de plugins de Discourse - Parte 4 - Configurar git
- Interfaz de administración: Desarrollo de plugins de Discourse - Parte 5 - Añadir una interfaz de administración
- Pruebas de aceptación: Desarrollo de plugins de Discourse - Parte 6 - Añadir pruebas de aceptación
- Publicar tu plugin: Desarrollo de plugins de Discourse - Parte 7 - Publicar tu plugin
- Nuevos locales: Añadir un nuevo local desde un plugin
- Integración de chat: Añadir un nuevo proveedor a discourse-chat-integration
- Extensión markdown-it: Reempaquetar una extensión markdown-it como un plugin de Discourse
- Autoload de Rails: Estructura de un plugin para el autoload de Rails
Temas y componentes
- Desarrollo de temas: Desarrollo de temas y componentes de temas de Discourse
- Referencia rápida: Guía de referencia rápida para desarrolladores de temas
- Guía para diseñadores: Guía para diseñadores sobre cómo empezar con los temas en Discourse
- Theme Creator: Comienza con Theme Creator y la CLI de Temas
- CLI de Temas: Instala la aplicación de consola Discourse Theme CLI para ayudarte a crear temas
- Estructura de temas: Estructura de temas y componentes de temas
- Múltiples archivos JS: Dividir el JavaScript del tema en múltiples archivos
- Múltiples archivos SCSS: Dividir el SCSS del tema en múltiples archivos
- Configuraciones de tema: Añadir configuraciones a tu tema de Discourse
- Objetos para configuraciones de tema: Tipo de objeto para la configuración del tema
- Migrar configuraciones: Migrar las configuraciones del tema de Discourse
- Metadatos del tema: Añadir metadatos y capturas de pantalla a un tema
- Variables del núcleo: Usar las variables del núcleo de Discourse en tu tema
- Cadenas localizables: Añadir cadenas localizables a temas y componentes de temas
- Pruebas E2E: Pruebas de sistema de extremo a extremo para temas y componentes de temas
- Minimizar el mantenimiento: Minimizar el mantenimiento de las personalizaciones de temas
- Tamaños de fuente: Cambiar los tamaños de fuente en tus temas
- Incluir recursos: Incluir recursos (p. ej. imágenes, fuentes) en temas y componentes
- Iconos personalizados: Reemplazar los iconos SVG predeterminados de Discourse con iconos personalizados en un tema
- Modo oscuro: Actualizar temas y plugins para soportar el modo oscuro automático
- Modificadores de tema: Modificadores de tema: Una breve introducción
- Pseudo-elementos: Insertar texto o imágenes en cualquier parte de tu sitio usando pseudo-elementos CSS
- Componente de fuente: Crear y compartir un componente de tema de fuente
- Idioma para Highlight.JS: Instalar un nuevo idioma para Highlight.JS mediante un componente de tema
- Contenido de la página de inicio: Añadir contenido personalizado que solo aparece en tu página de inicio
- Formato de mensaje: Soporte de formato de mensaje para la localización
- Cambios globales de iconos: Cambiar iconos globalmente
- Iconos alternativos: Iconos alternativos
- Estilo de publicación wiki: Cambiar el estilo de una publicación wiki
- Esquema de color: Crear y compartir un esquema de color
- Menú de navegación: Usar el parámetro de consulta
navigation_menupara previsualizar la barra lateral u otras opciones - Estilos del contenido de las publicaciones: Personalizar el contenido de las publicaciones con tus propios estilos
- Capturas de pantalla de temas: Añadir capturas de pantalla de vista previa a los temas de Discourse
- Configuraciones del sitio personalizables: Controlar las configuraciones del sitio con temas
Guías generales
- Apps móviles de marca blanca: Cosas a considerar antes de decidir hacer el rebranding (white-label) de las apps móviles de Discourse
- Automatizaciones personalizadas: Crear automatizaciones personalizadas
- Volcado de datos públicos: Volcado de datos públicos de Discourse
- Evals de IA: Ejecutar evals de Discourse AI
- Bot de IA vía API: Uso del bot de IA vía la API de Discourse
Tutorial de desarrollo de temas
- 1 - Introducción: Tutorial para desarrolladores de temas: 1. Introducción
- 2 - Tema remoto: Tutorial para desarrolladores de temas: 2. Crear un tema remoto
- 3 - CSS: Tutorial para desarrolladores de temas: 3. CSS en temas
- 4 - Outlets: Tutorial para desarrolladores de temas: 4. Uso de outlets para insertar y reemplazar contenido
- 5 - Componentes: Tutorial para desarrolladores de temas: 5. Construcción y uso de componentes
- 6 - API JS: Tutorial para desarrolladores de temas: 6. Uso de la API JS
- 7 - Conclusión: Tutorial para desarrolladores de temas: 7. Resumen