||||
-|-|
| Resumen | Discourse Math utiliza MathJax (predeterminado) o KaTeX para renderizar matemáticas en tu foro de Discourse.
| Guía de instalación | Este plugin está integrado en el núcleo de Discourse. No es necesario instalar el plugin por separado.
Habilitar matemáticas
El plugin de matemáticas se puede habilitar desde su configuración, accesible desde tu página admin/plugins:
Características
Una vez habilitado, puedes renderizar matemáticas en línea envolviéndolas con un solo $ así: $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 de LaTeX
Cuando se habilita a través de 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 compositor
El compositor incluye un botón Insertar matemáticas en la barra de herramientas con el atajo de teclado Shift+M. Esto abre un modal donde puedes:
- Alternar entre el modo en línea y el 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 en Chat
Las expresiones matemáticas también se renderizan en los mensajes de Discourse Chat 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
- Características:
- Menú contextual (clic derecho en las matemáticas)
- Enriquecimiento de accesibilidad para lectores de pantalla
- Zoom con alt+clic (zoom del 175%)
- Soporte para AsciiMath
KaTeX (Alternativa)
- Características:
- Renderizado rápido
- Extensión Mhchem para ecuaciones químicas
- Extensión CopyTex - haz clic en las matemáticas para copiar el código LaTeX al portapapeles
- Soporte para referencias cruzadas con las macros
\label,\refy\eqref
Configuración del sitio
Consulta todas las configuraciones relevantes buscando “math” en tu configuración de administración.
| Nombre | Descripción |
|-|
| discourse math enabled | Habilitar el plugin Discourse Math (añade procesamiento especial a bloques $ y $$) |
| discourse math provider | Proveedor de renderizado de matemáticas: 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 (MathJax con menú solo) |
| discourse math zoom on click | Zoom del 175% en interacción con alt+clic (MathJax con menú solo) |
| discourse math enable asciimath | Habilitar procesamiento de asciimath con delimitador % (solo MathJax) |
¿Alojado por nosotros? Este plugin está disponible en todas nuestras tarifas de alojamiento Math | Discourse - Civilized Discussion