Extensión:Math

La extensión Math provee ayuda para representar fórmulas matemáticas.

Más información sobre cómo instalar y configurar esta extensión, incluidas las versiones anteriores, se puede encontrar en Extension:Math/advancedSettings .

Vea un resumen de las cosas que pueden ser hechos por esta extensión a Extensión: Math/Sintaxis.

• Descarga y mueve la carpeta Math extraída a tu directorio extensions/.
  Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/Math
  

• Añade el siguiente código en la parte final de tu archivo LocalSettings.php :

  wfLoadExtension( 'Math' );
  

• Si está utilizando la versión de MediaWiki antes de 1.42, ejecute el script update.php para crear las tablas de base de datos necesarias. Esto ya no es necesario si está instalando Matemáticas en MediaWiki 1.42+.
• Para ver las matemáticas más allá de la salida de texto plano, sigue las instrucciones siguientes para habilitar varios modos de visualización matemática.
• Si tiene problemas para representar fórmulas al intentar usar RESTBase, puede intentar usar el siguiente patch.
• Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Instalación Vagrant:

• Si se utiliza Vagrant , instala con vagrant roles enable math --provision

También debe ir a la página Special:MathStatus para ver si todos los componentes de la extensión Math ahora funcionan. Para cualquier problema que vea, la mejor opción es crear una tarea en https://phabricator.wikimedia.org.

Desafortunadamente, no hay una guía bien probada para instalar Mathoid y RESTBase para trabajar con la extensión de Matemáticas, pero hay al menos un borrador de trabajo. Extension:Math/RESTBase por favor contribuya.

Además, hay una guía de para la instalación y configuración de MediaWiki con RESTBase y Mathoid en MW1.28.

Cuando instalado, escribe las fórmulas con sintaxis del marcado TeX dentro del tag ‎<math>. Por ejemplo:

<math>E=mc^2</math>

se muestra como:

$E=m{c}^2$

El tipo de salida depende del software que utilice para leer la página. Si puede, la extensión Math produce MathML. Si no, produce imagenes en SVG (convertiendo caracteres a elementos <path>) o PNG. El soporte matemático básico funciona para todos los navegadores. Pero, para obtener mejores resultados, es posible que deba cambiar sus configuraciones:

• Para Firefox o otros navegadores de Gecko, instale la extensión nativa de MathML y las fuentes matemáticas.
  Los lectores de pantalla NVDA, VoiceOver y Orca ofrecen soporte de accesibilidad. Para leer matemáticas, NVDA necesita el complemento MathPlayer.
• Para Safari o otros navegadores de Webkit, usted puede instalar fuentes matemáticas y habilitar representación nativa de MathML por insertar algunas reglas de CSS en la hoja de estilo personalizada de su navegador.
  El lector de pantalla VoiceOver provee suporte de accesibilidad. El lector de pantalla Orca ya no provee.
• Para Chrome, tiene que insertar algunas reglas de CSS en la hoja de estilo personalizada de su navegador para obtener soporte de accesibilidad con el lector de pantalla ChromeVox o representación visual con el complemento MathJax.

La configuración $wgMathValidModes contiene una matriz con los nombres de los modos de salida que se pueden utilizar para la representación. Si se habilitan múltiples modos, los usuarios iniciados en sesión pueden establecer una preferencia personal en el panel de apariencia de su página de preferencias de usuario.

También puede utilizar la configuración $wgDefaultUserOptions para establecer cuál de estos modos debe ser el predeterminado, por ejemplo:

$wgDefaultUserOptions['math'] = 'mathml';

Modo: 'mathml'

Puede usar Mathoid, una aplicación que usa MathJax en el lado del servidor para convertir entrada de texvc a representación de MathML+SVG. Mathoid es actualmente el modo de representación de matemáticas utilizado en Wikipedia.

Mathoid como un servicio es el enfoque sugerido para la extensión Math, y la opción predeterminada. Si no añade preferencias adicionales a LocalSettings.php, Math usará Mathoid del grupo de beta y servicios de RESTBase para hacer todas las renderizaciones de fórmulas matemáticas. Las opciones predeterminadas son:

// Configurar MathML como opción de renderización predeterminada
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';

Puede modificar estas configuraciones para utilizar diferentes servicios de Mathoid y RESTBase, incluyendo los suyos.

En su lugar, puede ejecutar Mathoid como un servicio de línea de comandos en el servidor local. Para utilizar este enfoque, se recomiendan las siguientes configuraciones:

// Configurar MathML como opción de renderización predeterminada
$wgDefaultUserOptions['math'] = 'mathml';
// Por favor, cree una config.yaml con anticipación. Las plantillas están en el repositorio de Mathoid.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Aumenta el límite de memoria de MediaWiki a 1.2G para Mathoid.
$wgMaxShellMemory = 1228800;

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

Modo: 'png'

Desde MediaWiki 1.32, este modo también requerirá un servidor Mathoid para funcionar. En versiones antiguas, requiere instalar texvc y texvccheck, que pueden requerir el más trabajo de la configuración.

Modo: 'latexml'

Utiliza la utilidad LaTeXML. La representación se realiza a través de un servicio en línea (establecido con $wgLaTeXMLUrl, que tiene un valor predeterminado de https://latexml.formulasearchengine.com/convert).

Modo: 'native'

Este modo generará MathML de LaTeX por PHP sin Mathoid. Tenga en cuenta que este modo no tiene retroceso de imagen, por lo que las fórmulas solo se mostrarán correctamente si el navegador admite MathML. Firefox y Safari introdujeron soporte MathML temprano (2006 y 2008), pero el soporte en navegadores basados en Chromium es una adición mucho más reciente (Chrome 109, lanzado en 2023).

Modo: 'mathjax'

Este modo funciona igual que el modo MathML nativo (generar MathML desde LaTeX a través de PHP), pero utilizará MathJax 3 para renderizar MathML. Por lo tanto, funcionará para navegadores que no tienen soporte MathML, con el costo general de cargar la biblioteca MathJax (agrupada en la extensión Math) en las vistas de página.

Modo: 'source'

Este modo enviará la entrada de Latex sin renderizarla, presentándola en un elemento de ‎<span>, rodeado de $ :formula $.

Asegúrese de establecer $wgMathDisableTexFilter a 'always' (ver abajo) si sólo desea la fórmula LaTeX crudo, de lo contrario aparecerá un error debido a la verificación fallida de las representaciones PNG.

La extensión crea un número de categorías de seguimiento para detectar errores y características obsoletas. Sus llaves de mensaje comienzan con math-. Los administradores pueden cambiar el nombre de una categoría de seguimiento en una wiki editando el valor del mensaje en el espacio de nombres MediaWiki de esa wiki. Special:TrackingCategories muestra el nombre, la clave del mensaje y la descripción de cada categoría de seguimiento.

• Puede usar el complemento de copia MathML de Firefox para copiar fórmulas a otras aplicaciones como Microsoft Word (video), o Google Docs con el complemento g(Math) (video).
• Puede anotar el modo de renderización preferido y predeterminado del usuario añadiendo el atributo forcemathmode al elemento ‎<math>. Por ejemplo, para forzar una imagen que se está renderizando <math forcemathmode="png">...</math>.
• Todas las imágenes de la fórmula renderizada se almacenan en una caché y no se recrean automáticamente si se ve o se edita la página. Para forzar a volver a renderizar todas las fórmulas en una página, purgue mediante la acción ?action=purge&mathpurge=true. Por ejemplo, el URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true forzará re-renderización del artículo w:Integral. Después, necesita limpiar su caché para que los imagenes nuevos de las fórmulas son verdaderamente descargados.

Si hay un problema con la extension matemática, puede informar sobre ello a Phabricator. Además debe verificar como su problema se relaciona con las pruebas unitarias automatizadas que son generadas a partir de la página CoverageTest.

Consulte Extension:Math/advancedSettings para versiones antiguas y más información.

• Extension:Math/Roadmap
• Mathoid
• Extensión:SimpleMathJax – una forma alternativa de proporcionar soporte para renderizar fórmulas matemáticas en wiki, sin texvc o LaTeX
• Texvc PHP Alternative
• Manual:Enable TeX/problems
• Manual:Math

• Stable extensions/es
• Tag extensions/es
• EditPage::showEditForm:initial extensions/es
• GetPreferences extensions/es
• LoadExtensionSchemaUpdates extensions/es
• ParserAfterTidy extensions/es
• ParserFirstCallInit extensions/es
• ParserOptionsRegister extensions/es
• ResourceLoaderGetConfigVars extensions/es
• SpecialPage initList extensions/es
• UserGetDefaultOptions extensions/es
• WikibaseClientDataTypes extensions/es
• WikibaseRepoDataTypes extensions/es
• GPL licensed extensions/es
• Extensions in Wikimedia version control/es
• All extensions/es
• Extensions bundled with MediaWiki 1.38/es
• Extensions used on Wikimedia/es
• Extensions included in BlueSpice/es
• Extensions included in Canasta/es
• Extensions included in Fandom/es
• Extensions included in Miraheze/es
• Extensions included in ProWiki/es
• Extensions included in Telepedia/es
• Extensions included in Weird Gloop/es
• Extensions included in wiki.gg/es
• TeX/es
• Math display extensions/es
• Extensions with VisualEditor support/es