Discourse Matemáticas

||||\n-|-|-|\n:discourse2: | Resumen | Discourse Math utiliza MathJax (predeterminado) o KaTeX para renderizar matemáticas en su foro de Discourse.\n:open_book: | Guía de instalación | Este plugin viene incluido con el núcleo de Discourse. No es necesario instalar el plugin por separado.\n\n\n[quote]\n\n:discourse2: Al ser un plugin official mantenido por el equipo de Discourse, las solicitudes de Support, Bug, UX y Feature se pueden realizar en las categorías respectivas aquí en Meta, y etiquetadas con la etiqueta de plugin apropiada. Haga clic en un enlace a continuación para iniciar una. :+1:\n\n\u003ckbd\u003e [:question:\u0026nbsp;Soporte](Discourse Meta "Preguntar por soporte sobre la configuración y el uso de Discourse Math") \u003c/kbd\u003e \u003ckbd\u003e [:bug:\u0026nbsp;Error](Discourse Meta "Un informe de error significa que algo está roto, lo que impide el uso normal/típico del plugin") \u003c/kbd\u003e \u003ckbd\u003e [:eyes:\u0026nbsp;UX](Discourse Meta "Discusión sobre la interfaz de usuario de Discourse Math, y cómo se presentan las características (incluidos el idioma y los elementos de la interfaz de usuario)") \u003c/kbd\u003e \u003ckbd\u003e [:bulb:\u0026nbsp;Característica](Discourse Meta "Discusión sobre cómo se pueden mejorar o ampliar las características existentes de Discourse Math, y cómo podrían funcionar las nuevas características propuestas")\u003c/kbd\u003e\n\n[/quote]\n\n### Habilitar Matemáticas\n\nEl plugin Math se puede habilitar desde su configuración, a la que se accede desde su página admin/plugins:\n\nMath settings\n\n\n### Características\n\nUna vez habilitado, puede renderizar matemáticas en línea envolviendo con un solo $ como este: $E=mc^2$.\n\nPuede renderizar bloques de matemáticas envolviendo con $$\n\n\n$$\n\\sqrt{(-1)} \\; 2^3 \\; \\sum \\; \\pi\n$$\n\n\n

\n\nDiscourse Math utiliza una heurística para asegurar que oraciones como: "Gasté 20$ y otros 100$" no se conviertan.\n\n#### Delimitadores LaTeX\n\nCuando se habilita a través de la configuración del sitio, también puede usar los delimitadores estándar de LaTeX:\n\n- En línea: \\(...\\) - Ejemplo: \\(E=mc^2\\)\n- Bloque: \\[...\\] - Ejemplo:\n \n \\[\n \\frac{1}{2}\n \\]\n \n\n#### AsciiMath (Solo MathJax)\n\nCuando se usa MathJax, puede habilitar el procesamiento de asciimath que usa % como delimitador: %E=mc^2%\n\n### Integración con el Compositor\n\nEl compositor 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 una ventana modal donde puede:\n\n- Cambiar entre el modo en línea y el de bloque\n- Escribir su expresión LaTeX\n- Previsualizar e insertar en su publicación\n\nEn 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.\n\n### Soporte en Chat\n\nLas expresiones matemáticas también se renderizan en los mensajes de Discourse Chat utilizando la misma configuración y motor de renderizado.\n\n### Motores de Renderizado\n\n#### MathJax (Predeterminado)\n\n- Versión: 4.1\n- Formatos de salida: HTML (predeterminado) o SVG\n- Características:\n - Menú contextual (clic derecho sobre la matemática)\n - Enriquecimiento de accesibilidad para lectores de pantalla\n - Zoom con alt-clic (zoom del 175%)\n - Soporte para AsciiMath\n\n#### KaTeX (Alternativa)\n\n- Características:\n - Renderizado rápido\n - Extensión Mhchem para ecuaciones químicas\n - Extensión CopyTex - haga clic en la matemática para copiar la fuente LaTeX al portapapeles\n - Soporte para referencias cruzadas con las macros \\label, \\ref y \\eqref\n\n### Configuración del Sitio\n\nVea todas las configuraciones relevantes del sitio buscando en su configuración de administrador "math".\n\n| Nombre | Descripción |\n|-|-|\n| discourse math enabled | Habilitar el plugin Discourse Math (agrega procesamiento especial a los bloques $ y $$) |\n| discourse math provider | Proveedor de renderizado de matemáticas: mathjax (predeterminado) o katex |\n| discourse math enable latex delimiters | Habilitar delimitadores estilo LaTeX: \\(...\\) para matemáticas en línea y \\[...\\] para matemáticas en bloque |\n| discourse math mathjax output | Formato de salida de MathJax: html (predeterminado) o svg (solo MathJax) |\n| discourse math enable menu | Habilitar menú contextual para expresiones matemáticas (solo MathJax) |\n| discourse math enable accessibility | Habilitar características de accesibilidad como enriquecimiento de texto (solo MathJax con menú) |\n| discourse math zoom on click | Zoom del 175% con interacción alt-clic (solo MathJax con menú) |\n| discourse math enable asciimath | Habilitar procesamiento de asciimath con delimitador % (solo MathJax) |\n\n\n\u003e :discourse2: ¿Alojado por nosotros? Este plugin está disponible en todos nuestros niveles de alojamiento Math | Discourse - Civilized Discussion

70 Me gusta

2 publicaciones se dividieron en un nuevo tema: Añadir soporte para el formato de correo electrónico de MathJax

2 publicaciones fueron divididas a un nuevo tema: ¿Se puede actualizar Mathjax a la versión 3?

6 publicaciones fueron movidas a un nuevo tema: Añadir soporte para bloques y texto en línea estilo Latex para Matemáticas

Una publicación fue dividida en un nuevo tema: Las ecuaciones no se muestran correctamente en los bloques

Una publicación fue dividida en un nuevo tema: No se renderiza el formato matemático en la vista previa

15 publicaciones se dividieron en un nuevo tema: Soluciones alternativas de matemáticas e IA

26 publicaciones se dividieron en un nuevo tema: Actualización de Mathjax a la versión 4

Solo una nota rápida (positiva) del mundo real después de migrar a la integración más reciente de MathJax (v4.1) en Discourse Math.

Una mejora en la calidad de vida que he notado es que MathJax ahora proporciona retroalimentación muy específica y localizada cuando la entrada no es válida o no se define una macro:

  • Todavía renderiza la estructura válida circundante correctamente (por ejemplo, \\frac{...}{...}, paréntesis, etc.)
  • Pero deja el comando no reconocido visible literalmente (por ejemplo, mostrando \\sinc como texto) en lugar de fallar toda la expresión o producir un error parcial confuso.

En la práctica, esto hace que sea inmediatamente obvio qué necesita ser corregido, sin oscurecer lo que ya es correcto, lo cual es especialmente útil en contextos de enseñanza y al iterar sobre publicaciones con mucho contenido matemático.

Por ejemplo, en lugar de depender de que se defina \\sinc, el enfoque robusto es escribirlo explícitamente como un operador:

\n\\frac{\\Delta}{T}\\operatorname{sinc}\\!\\left(\\frac{\\omega_r\\Delta}{2}\\right)\n

con:

\n\\operatorname{sinc}(x)=\\frac{\\sin x}{x}\n

En general, este comportamiento de “renderizar lo que se pueda, mostrar el resto claramente” se siente como una gran victoria en usabilidad en comparación con modos de fallo anteriores/menos transparentes. Gracias a todos los involucrados en el trabajo de actualización de MathJax.

3 Me gusta