Extension:Math/de

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

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

Mathe anzeigen
Die Math-Erweiterung versucht, MathML als Output auszuliefern, und bietet als Fallbacklösungen SVG- bzw. PNG-Bilder an. Der Output wird abhängig von den Fähigkeiten des verwendeten Geräts gewählt. 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.
 * In einigen Versionen des Internet Explorers ist es möglich, MathPlayer als Unterstützungstechnologie zu verwenden.

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 und  für die Math-Erweiterung, aber immerhin ist ein Arbeitsentwurf vorhanden. Bitte beitragen.

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

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.:

Mathoid
Modus: 'mathml' (pre-July 2015: MW_MATH_MATHML)

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.

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

Siehe Mathoid für Hinweise zum Betrieb eines eigenen Mathoid-Servers. Bitte beachten, dass dies ab März 2017 wahrscheinlich auch eine/n RESTbase Server/Installation benötigt (siehe ).

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:

LaTeX
Modus: 'png' (pre-July 2015: MW_MATH_PNG)

Dieser Modus erfordert am meisten Einrichtungsaufwand, weil zum Funktionieren mindestens das texvc-Programm installiert werden muss, und idealerweise auch texvccheck. Siehe Installing texvc für Hinweise, wie beide zu installieren sind.

LaTeXML
Modus: 'latexml' (pre-July 2015: MW_MATH_LATEXML)

Verwendet LaTeXML. Das Rendern erfolgt über einen Onlineservice (gesetzt per $wgLaTeXMLUrl, welche einen Defaultwert hat).

Kein Rendern
Modus: 'source', (pre-July 2015: MW_MATH_SOURCE)

This mode will forward the Latex input without rendering, presenting it in a 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.

MathJax
Modus: MW_MATH_MATHJAX

Dieser Modus nutzt die Anwendung MathJax zum Rendern auf Clientseite. Er ist mittlerweile veraltet und erfordert MediaWiki 1.25 oder niedriger. Siehe Client-side rendering with MathJax als Nutzungsanleitung.

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  attirbute to the $$ element. eg.. to force an image being rendered ...$$.

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 für ältere Versionen und weitere Informationen.

Siehe auch

 * - eine Alternative, um das Rendern mathematischer Formeln in Wikis zu unterstützen, ohne texvc oder LaTeX
 * - Beschreibung von texvc
 * Eine andere Alternative ist die Verwendung von:
 * - Beschreibung von texvc
 * Eine andere Alternative ist die Verwendung von:
 * Eine andere Alternative ist die Verwendung von:
 * Eine andere Alternative ist die Verwendung von: