Extension:Math/de

<languages /> Template:Extension

Die Math-Erweiterung unterstützt die Darstellung mathematischer Formeln. Eine Übersicht des aktuellen Funktionsumfangs der Erweiterung ist in der Dokumentation der englischen Wikipedia verfügbar.

Mehr Informationen zur Installation und Konfiguration dieser Erweiterung, auch für ältere Versionen, sind unter Template:Ll zu finden.

See an overview of what can currently be done with this extension at Extension:Math/Syntax.

Installation

You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. Falls Probleme auftauchen, ist es am besten, einen Task auf https://phabricator.wikimedia.org anzulegen.

Leider gibt es keine gut getestete Anleitung zur Installation von Template:Ll und Template:Ll für die Math-Erweiterung, aber immerhin ist ein Arbeitsentwurf vorhanden. Template:Ll Bitte beitragen.

Weiterhin gibt es eine Anleitung für Installation und Setup von MediaWiki mit Restbase und Mathoid in MW1.28.

Usage

Once installed, you write formulas using TeX markup syntax inside the Template:Tag tag. For example:

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

Renders as:

$E=m{c}^2$

Mathe anzeigen

The type of output depends on the software that you use to read the page. Die Math-Erweiterung versucht, eine MathML-Ausgabe mit Fallback auf Bilder in SVG (Konvertieren von Zeichen in < path>s) oder PNG (am wenigsten bevorzugt) zu liefern. Grundlegender Mathe-Support funktioniert auf allen Webbrowsern. Für optimale Darstellungsergebnisse sind jedoch spezielle Einstellungen nötig:

• Für Firefox oder andereGecko-Browser ist es nötig, die Native MathML extension und math fonts zu installieren.
  Barrierefreiheit wird durch NVDA, VoiceOver oder Orca angeboten. Darüber hinaus erfordert NVDA das MathPlayer-Plugin, um Mathematik lesen zu können.
• Für Safari oder andere WebKit-Browser können außerdem Mathe-Fonts installiert und das native MathML Rendering aktiviert werden, indem einige CSS-Regeln in das benutzerdefinierte Style Sheet der eigenen Browsereinstellungen eingefügt werden.
  Barrierefreiheit wird durch den VoiceOver Screenreader angeboten, aber noch nicht durch Orca.
• Für Chrome müssen zur Unterstützung von Barrierefreiheit über ChromeVox oder visuelles Rendering per MathJax plugin einige CSS-Regeln in das benutzerdefinierte Style Sheet der eigenen Browsereinstellungen eingefügt werden.

Liste wesentlicher Konfigurationseinstellungen

Name der Einstellung	Defaultwert	Beschreibung
Template:Ll	[ 'source', 'mathml' ]	Definiert den Modus, der auf dem Server erlaubt ist.
Template:Ll	'never'	Option, um den Tex-Filter zu deaktivieren. Wenn dieser Wert auf true gesetzt wird, werden jegliche LaTeX-Ausdrücke geparst, was ein potentielles Sicherheitsrisiko darstellen kann. Wenn dieser Wert auf false gesetzt wird, ist nur eine Untermenge der TeX-Befehle erlaubt. Siehe die Wikipediaseite Help:Math für Details. Um dies zu deaktivieren, "always" verwenden.
$wgMathFullRestbaseURL	false	Die Math-Erweiterung erhält die Standard-Config vom Visual Editor, sofern verfügbar. Einzelheiten.
$wgMathPreferRestbaseURL	true	Whether to allow using of internal RESTBase path instead of $wgMathFullRestbaseURL and $wgVisualEditorFullRestbaseURL. Set false if you want to use external RESTBase in any case.

Math Output-Modi

Die Einstellung $wgMathValidModes enthält die Namen der Output-Modi, die zum Rendern verwendet werden können. Wenn mehrere Modi aktiviert sind, können angemeldete Nutzer in den persönlichen Einstellungen unter Aussehen eine Vorliebe festlegen.

Auch kann die Einstellung $wgDefaultUserOptions verwendet werden, um festzulegen, welcher dieser Modi Standard sein sollte, z. B.:

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

Mathoid

Modus: 'mathml' Template:Warning

Für MW 1.23 und höher kann ein Mathoid-Server verwendet werden, der MathJax benutzt, um texvc Input auf Serverseite in MathML+SVG Rendering zu konvertieren. Mathoid is currently the Math rendering mode used on Wikipedia.

Benutzung von Mathoid

Für die Benutzung von Mathoid, was Leistungsvorteile bringt, werden folgende Einstellungen empfohlen:

// MathML als Standard-Renderoption festlegen
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';

Siehe Mathoid für Hinweise zum Betrieb eines eigenen Mathoid-Servers.

Mathoids CLI Oberfläche

Um "Mathoid´s CLI Umgebung" nutzen zu können, was möglicherweise einfacher einzurichten ist und zu geringerem, permanentem Speicherverbrauch bei weniger Leistung führt, werden die folgenden Einstellungen empfohlen: To use this approach, the following settings are recommended:

// Setze MathML als Standard Rendering Option
$wgDefaultUserOptions['math'] = 'mathml';
// Bitte erstelle im Voraus eine config.yaml. Vorlagen befinden sich im Mathoid Verzeichnis.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Erhöhe die Speichergrenze von MediaWiki auf 1,2 GB für Mathoid
$wgMaxShellMemory = 1228800;

LaTeX

Template:MW 1.39 Modus: 'png'

Since MediaWiki 1.32, this mode will also require a Mathoid server to work. In older versions, it requires installing texvc and texvccheck, which may require the most setup work.

LaTeXML

Modus: 'latexml'

Verwendet LaTeXML. Das Rendern erfolgt über einen Onlinedienst (gesetzt per $wgLaTeXMLUrl, welche einen Standardwert von https://latexml.formulasearchengine.com/convert hat).

Native MathML

Template:MW 1.40 Mode: 'native'

This mode will generate MathML from LaTeX via PHP without Mathoid. Note this mode does not have image fallback, so formulas will only be displayed correctly if the browser supports MathML. Firefox and Safari introduced MathML support early (2006 and 2008), but support in Chromium-based browsers is a much more recent addition (Chrome 109, released in 2023).

MathJax

Template:MW 1.42 Mode: 'mathjax'

This mode works the same as Native MathML mode (generating MathML from LaTeX via PHP), but it will use MathJax 3 to render MathML. Therefore it will work for browsers that do not have MathML support, with the overhead of loading MathJax library (bundled in Math extension) on page views. Template:Warning

Kein Rendern

Modus: 'source'

This mode will forward the Latex input without rendering, presenting it in a Template:Tag element, surrounded by $ :formula $.

Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.

Tracking categories

The extension creates a number of Template:Ll to detect errors and deprecated features. Their message keys begin with math-. Administrators may change a tracking category's name in a wiki by editing the message's value in that wiki's MediaWiki namespace. Special:TrackingCategories shows each tracking category's name, message key, and description.

MediaWiki-Seite	Standard	Beschreibung
MediaWiki:Math-tracking-category-error	Category:Pages with math errors	Pages where there is a syntax error in the formula causing the rendering to fail
MediaWiki:Math-tracking-category-render-error	Category:Pages with math render errors	Pages where there has been a temporary error in the rendering pipeline causing the rendering to fail. These normally fix themselves
MediaWiki:Math-tracking-category-texvc-deprecation	Category:Pages that use a deprecated format of the math tags	Pages which use deprecated texvc syntax like $ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor, which should be replaced by more standard LaTeX \$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed) respectively. Siehe Template:Ll.
MediaWiki:Math-tracking-category-mhchem-deprecation	Category:Pages that use a deprecated format of the chem tags	Deprecated chemical markup, see Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax.

Tipps und Tricks

• Um Formeln zu anderen Anwendungen wie Microsoft Word (Video) oder Google docs mit dem g(Math)-Plugin (Video) zu kopieren, kann das Firefox MathML Copy Addon verwendet werden
• You can override the user preferred and default rendermode by adding the forcemathmode attribute to the Template:Tag element. e.g. to force an image being rendered <math forcemathmode="png">...</math>.
• All images of rendered formula are stored in a cache and not automatically recreated if the page is viewed or edited. To force the re-rendering of all formulas of a page, purge using the ?action=purge&mathpurge=true action. For example the URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true will force re-rendering of the w:Integral article. Afterwards you need to bypass your browser cache so that the new created images of the formulas are actually downloaded.

Fehler melden

Probleme mit der Math-Erweiterung können in Phabricator gemeldet werden. Zusätzlich sollte überprüft werden, wie sich das Problem zu den automatischen Unit-Tests verhält, die aus der Seite CoverageTest generiert werden.

Weitere Lektüre

Siehe Template:Ll für ältere Versionen und weitere Informationen.

Siehe auch

• Template:Ll
• Template:Ll
• Template:Ll - eine Alternative, um das Rendern mathematischer Formeln in Wikis zu unterstützen, ohne texvc oder LaTeX
• Template:Ll
• Template:Ll
• Template:Ll

[[Category:TeX{{#translation:}}]] [[Category:Math display extensions{{#translation:}}]] [[Category:Extensions with VisualEditor support{{#translation:}}]]