Erweiterung:Math

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Math and the translation is 92% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Tiếng Việt • ‎dansk • ‎español • ‎français • ‎magyar • ‎português do Brasil • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
MediaWiki-Erweiterungen
OOjs UI icon advanced.svg
Math
Erscheinungsstatus: stabil
ExtensionMath (cropped).png
Einbindung Tag
Beschreibung Erlaubt das Rendern mathematischer Formeln
Autor(en)
  • Moritz Schubotz,
  • Tomasz Wegrzanowski,
  • Brion Vibber
  • und andere
Letzte Version continuous updates
MediaWiki 1.25+
Datenbankänderungen Ja
Tabellen math
mathoid
mathlatexml
Lizenz GNU General Public License 2.0 or later
Herunterladen

  • $wgUseTeX
  • $wgTexvc
  • $wgTexvcBackgroundColor
  • $wgMathCheckFiles
  • $wgMathPath
  • $wgMathDirectory
  • $wgMathFileBackend
<math>
Übersetze die Math Erweiterung wenn sie auf translatewiki.net verfügbar ist
Prüfe die Benutzungs- und Versionsmatrix.
Probleme Offene Aufgaben · Einen Fehler melden

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 Extension:Math/advancedSettings 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.

Installation

Siehe diese Mail für Informationen zur Installation dieser Erweiterung ab MediaWiki 1.31.
  • Falls Vagrant benutzt wird, installiere mit vagrant roles enable math --provision
Manuelle Installation
  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'Math' );
    // Für Installation und Konfiguration siehe unten:
    
  • Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
  • Um Mathe jenseits eines einfachen Textoutputs zu sehen, bitte den Anweisungen unten zur Aktivierung verschiedener Mathe-Output-Modi folgen.
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

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 Mathoid und RESTBase für die Math-Erweiterung, aber immerhin ist ein Arbeitsentwurf vorhanden. Extension:Math/Restbase 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.:

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

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:

// MathML als Standard-Renderoption festlegen
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathFullRestbaseURL = 'https://en.wikipedia.org/api/rest_';

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 task T154394).

Mathoid´s 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:

// Setze MathML als Standard Rendering Option
$wgDefaultUserOptions['math'] = 'mathml';
// Bitte erstelle im Voraus eine config.yaml. Vorlagen sind 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;

If you run MediaWiki under system containing SELinux and you get Mathoid cli '/path/to/mathoid/cli.js' is not executable message from the error log, you can run

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

to make sure the Apache server allow to change system limits.

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

Liste wesentlicher Konfigurationseinstellungen

Name der Einstellung Defaultwert Beschreibung
$wgMathValidModes array( 'png', 'source', 'mathml' ) Definiert den Modus, der auf dem Server erlaubt ist.
$wgMathDisableTexFilter '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.


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 attirbute to the <math> element. eg.. to force an image being rendered <math forcemathmode="png">...</math>.

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 Extension:Math/advancedSettings für ältere Versionen und weitere Informationen.

Unterseiten

Siehe auch