Discourse Math

[Discourse]

	Zusammenfassung	Discourse Math verwendet MathJax (Standard) oder KaTeX, um Mathematik in Ihrem Discourse-Forum darzustellen.
	Installationsanleitung	Dieses Plugin ist im Discourse-Kern enthalten. Es ist keine separate Installation des Plugins erforderlich.

Da dies ein #offizielles Plugin ist, das vom Discourse-Team gewartet wird, können #Support-, #Bug-, #UX- und #Feature-Anfragen in den entsprechenden Kategorien hier auf Meta gestellt und mit dem passenden Plugin-Tag versehen werden. Klicken Sie auf einen der folgenden Links, um einen neuen Beitrag zu starten.

\u003ckbd\u003e [\u0026nbsp;Support](Discourse Meta "Hilfe bei der Konfiguration und Verwendung von Discourse Math anfordern") \u003c/kbd\u003e \u003ckbd\u003e [\u0026nbsp;Fehler](Discourse Meta "Ein Fehlerbericht bedeutet, dass etwas defekt ist und die normale/gebräuchliche Nutzung des Plugins verhindert") \u003c/kbd\u003e \u003ckbd\u003e [\u0026nbsp;UX](Discourse Meta "Diskussion über die Benutzeroberfläche von Discourse Math und wie Funktionen präsentiert werden (einschließlich Sprache und UI-Elementen)") \u003c/kbd\u003e \u003ckbd\u003e [\u0026nbsp;Feature](Discourse Meta "Diskussion darüber, wie bestehende Discourse Math-Funktionen verbessert oder erweitert werden können und wie vorgeschlagene neue Funktionen funktionieren könnten")\u003c/kbd\u003e

Mathematik aktivieren

Das Math-Plugin kann über seine Einstellungen aktiviert werden, die Sie auf Ihrer admin/plugins-Seite erreichen:

Funktionen

Nach der Aktivierung können Sie Inline-Mathematik rendern, indem Sie sie mit einem einzelnen $ umschließen, wie folgt: $E=mc^2$.

Sie können Mathematikblöcke rendern, indem Sie sie mit $$ umschließen:

$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$

Discourse Math verwendet eine Heuristik, um sicherzustellen, dass Sätze wie: „Ich habe 20$ und weitere 100$ ausgegeben" nicht fälschlicherweise konvertiert werden.

LaTeX-Trennzeichen

Wenn dies in den Seiteneinstellungen aktiviert ist, können Sie auch Standard-Latex-Trennzeichen verwenden:

• Inline: \(…\) – Beispiel: \(E=mc^2\)
• Block: \[…\] – Beispiel:

  \[
  \frac{1}{2}
  \]
  

AsciiMath (nur MathJax)

Bei Verwendung von MathJax können Sie die Verarbeitung von asciimath aktivieren, das % als Trennzeichen verwendet: %E=mc^2%

Integration in den Composer

Der Composer enthält in der Symbolleiste eine Mathematik einfügen-Taste mit der Tastenkombination \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Dies öffnet einen Modal-Dialog, in dem Sie:

• Zwischen Inline- und Blockmodus umschalten
• Ihren LaTeX-Ausdruck eingeben
• Vorschau anzeigen und in Ihren Beitrag einfügen

Im Rich-Text-Editor erscheinen mathematische Ausdrücke als bearbeitbare Knoten mit einer Bearbeiten-Taste, um den Ausdruck zu ändern.

Chat-Unterstützung

Mathematische Ausdrücke werden auch in Discourse-Chat-Nachrichten mit denselben Einstellungen und derselben Render-Engine dargestellt.

Render-Engines

MathJax (Standard)

• Version: 4.1
• Ausgabeformate: HTML (Standard) oder SVG
• Funktionen:
  • Kontextmenü (Rechtsklick auf Mathematik)
  • Barrierefreiheitsverbesserung für Screenreader
  • Zoom bei Alt-Klick (175 % Zoom)
  • AsciiMath-Unterstützung

KaTeX (Alternative)

• Funktionen:
  • Schnelle Darstellung
  • Mhchem-Erweiterung für chemische Gleichungen
  • CopyTex-Erweiterung – Klicken Sie auf Mathematik, um die LaTeX-Quelltext in die Zwischenablage zu kopieren
  • Unterstützung für Querverweise mit den Makros \label, \ref und \eqref

Seiteneinstellungen

Alle relevanten Seiteneinstellungen finden Sie, indem Sie in Ihren Admin-Einstellungen nach „math" suchen.

Name	Beschreibung
discourse math enabled	Discourse Math-Plugin aktivieren (fügt spezielle Verarbeitung für $- und $$-Blöcke hinzu)
discourse math provider	Mathematik-Render-Anbieter: mathjax (Standard) oder katex
discourse math enable latex delimiters	LaTeX-artige Trennzeichen aktivieren: \(…\) für Inline- und \[…\] für Block-Mathematik
discourse math mathjax output	MathJax-Ausgabeformat: html (Standard) oder svg (nur MathJax)
discourse math enable menu	Kontextmenü für mathematische Ausdrücke aktivieren (nur MathJax)
discourse math enable accessibility	Barrierefreiheitsfunktionen wie Textanreicherung aktivieren (nur MathJax mit Menü)
discourse math zoom on click	175 %-Zoom bei Alt-Klick-Interaktion aktivieren (nur MathJax mit Menü)
discourse math enable asciimath	AsciiMath-Verarbeitung mit %-Trennzeichen aktivieren (nur MathJax)

Bei uns gehostet? Dieses Plugin ist in allen unseren Hosting-Tarifen verfügbar Math | Discourse - Civilized Discussion

[Ethsim2 (Ethan)]

Nur eine kurze (positive) Anmerkung aus der Praxis nach der Umstellung auf die neuere MathJax (v4.1) Integration in Discourse Math.

Eine Verbesserung der Lebensqualität, die mir aufgefallen ist, ist, dass MathJax nun sehr spezifisches, lokalisiertes Feedback gibt, wenn die Eingabe ungültig ist oder ein Makro nicht definiert ist:

• Es rendert die umgebende gültige Struktur weiterhin korrekt (z. B. \\frac{...}{...}, Klammern usw.)
• Aber es lässt den nicht erkannten Befehl buchstäblich sichtbar (z. B. zeigt \\sinc als Text an), anstatt den gesamten Ausdruck fehlschlagen zu lassen oder einen verwirrenden teilweisen Fehler zu erzeugen.

In der Praxis macht dies sofort ersichtlich, was korrigiert werden muss, ohne das, was bereits korrekt ist, zu verdecken – was besonders in Lehrkontexten und beim Iterieren über Beiträge mit viel Mathematik hilfreich ist.

Zum Beispiel ist anstatt sich darauf zu verlassen, dass \\sinc definiert ist, der robuste Ansatz, es explizit als Operator zu schreiben:

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

mit:

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

Insgesamt fühlt sich dieses Verhalten „rendere, was du kannst, zeige den Rest deutlich“ wie ein großer Usability-Gewinn im Vergleich zu älteren/weniger transparenten Fehlermodi an. Vielen Dank an alle, die an der MathJax-Upgrade-Arbeit beteiligt waren.

[LeafGlowPath]

Ich möchte nur alle, die über Google hierhergekommen sind, darauf hinweisen, dass dieses Plugin nicht im kostenlosen Hosting-Plan verfügbar ist.

[NateDhaliwal]

Hallo, ich kann deine Frustration verstehen. Es tut mir leid, dass du dich so fühlst. Für zukünftige Fälle kannst du dir das Plugins-Verzeichnis je nach Plan hier ansehen.

[LeafGlowPath]

Der Math-Plugin ist auf dieser Seite als Plugin für Pro-/Business-/Enterprise-Nutzer aufgeführt. Daher könnte man annehmen, dass es auch für den kostenlosen Plan verfügbar ist. Ich schlage nicht vor, dass Sie es kostenlos anbieten sollten. Ich finde nur, dass dies etwas klarer formuliert sein sollte.

[NateDhaliwal]

Richtig. Die Seite unter Discourse pricing | Discourse - Civilized Discussion listet alle Pläne und deren Grenzen auf, einschließlich Plugins, sodass Sie schnell sehen können, welche Plugins erlaubt sind.