 |
Resumen | Discourse Math utiliza MathJax (predeterminado) o KaTeX para renderizar fórmulas matemáticas en tu foro de Discourse. |
 |
Guía de instalación | Este plugin viene incluido en el núcleo de Discourse. No es necesario instalarlo por separado. |
Habilitar Matemáticas
El plugin de Matemáticas se puede habilitar desde su configuración, accesible en tu página admin/plugins:
Funcionalidades
Una vez habilitado, puedes renderizar matemáticas en línea envolviéndolas con un solo $ de la siguiente manera: $E=mc^2$.
Puedes renderizar bloques de matemáticas envolviéndolos con $$:
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
Discourse Math utiliza una heurística para asegurar que oraciones como: “Gasté 20$ y otros 100$” no se conviertan.
Delimitadores LaTeX
Cuando se habilita mediante la configuración del sitio, también puedes usar delimitadores estándar de LaTeX:
- En línea:
\(...\)- Ejemplo:\(E=mc^2\) - Bloque:
\[...\]- Ejemplo:\[ \frac{1}{2} \]
AsciiMath (solo MathJax)
Al usar MathJax, puedes habilitar el procesamiento de asciimath que utiliza % como delimitador: %E=mc^2%
Integración con el Editor
El editor incluye un botón Insertar Matemáticas en la barra de herramientas con el atajo de teclado \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Esto abre un modal donde puedes:
- Alternar entre modo en línea y modo bloque
- Escribir tu expresión LaTeX
- Previsualizar e insertar en tu publicación
En el editor de texto enriquecido, las expresiones matemáticas aparecen como nodos editables con un botón de edición para modificar la expresión.
Soporte para Chat
Las expresiones matemáticas también se renderizan en los mensajes de Chat de Discourse utilizando la misma configuración y motor de renderizado.
Motores de Renderizado
MathJax (Predeterminado)
- Versión: 4.1
- Formatos de salida: HTML (predeterminado) o SVG
- Funcionalidades:
- Menú contextual (clic derecho sobre la fórmula)
- Mejoras de accesibilidad para lectores de pantalla
- Zoom con Alt+clic (zoom al 175%)
- Soporte para AsciiMath
KaTeX (Alternativa)
- Funcionalidades:
- Renderizado rápido
- Extensión Mhchem para ecuaciones químicas
- Extensión CopyTex - haz clic en la fórmula para copiar el código LaTeX al portapapeles
- Soporte de referencias cruzadas con las macros
\label,\refy\eqref
Configuración del Sitio
Consulta todas las configuraciones relevantes del sitio buscando “math” en tu configuración de administrador.
| Nombre | Descripción |
|---|---|
| discourse math enabled | Habilitar el plugin Discourse Math (agrega procesamiento especial a los bloques $ y $$) |
| discourse math provider | Proveedor de renderizado matemático: mathjax (predeterminado) o katex |
| discourse math enable latex delimiters | Habilitar delimitadores estilo LaTeX: \(...\) para matemáticas en línea y \[...\] para bloques |
| discourse math mathjax output | Formato de salida de MathJax: html (predeterminado) o svg (solo MathJax) |
| discourse math enable menu | Habilitar menú contextual para expresiones matemáticas (solo MathJax) |
| discourse math enable accessibility | Habilitar funciones de accesibilidad como enriquecimiento de texto (solo MathJax con menú) |
| discourse math zoom on click | Zoom al 175% al hacer Alt+clic (solo MathJax con menú) |
| discourse math enable asciimath | Habilitar procesamiento de asciimath con el delimitador % (solo MathJax) |
¿Alojado por nosotros? Este plugin está disponible en todos nuestros niveles de alojamiento: Math | Discourse - Civilized Discussion