Discourse Mathe

||||\n-|-|-|\n:discourse2: | Zusammenfassung | Discourse Math verwendet MathJax (Standard) oder KaTeX zur Darstellung von Mathematik in Ihrem Discourse-Forum.\n:open_book: | Installationsanleitung | Dieses Plugin ist in Discourse Core enthalten. Es ist nicht notwendig, das Plugin separat zu installieren.\n\n\n[quote]\n\n:discourse2: Da dies ein von dem Discourse-Team gewartetes #offizielles Plugin ist, können #Support-, #Bug-, #UX- und #Feature-Anfragen in den entsprechenden Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie auf einen der untenstehenden Links, um eine Anfrage zu starten. :+1:\n\n\u003ckbd\u003e [:question:\u0026nbsp;Support](Discourse Meta "Support bei der Konfiguration und Verwendung von Discourse Math anfordern") \u003c/kbd\u003e \u003ckbd\u003e [:bug:\u0026nbsp;Bug](Discourse Meta "Ein Bug-Report bedeutet, dass etwas kaputt ist und die normale/typische Nutzung des Plugins verhindert") \u003c/kbd\u003e \u003ckbd\u003e [:eyes:\u0026nbsp;UX](Discourse Meta "Diskussion über die Benutzeroberfläche von Discourse Math und wie Funktionen präsentiert werden (einschließlich Sprache und UI-Elemente)") \u003c/kbd\u003e \u003ckbd\u003e [:bulb:\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\n\n[/quote]\n\n### Mathematik aktivieren\n\nDas Math-Plugin kann über seine Einstellungen aktiviert werden, die Sie auf Ihrer Seite admin/plugins aufrufen können:\n\nMath settings\n\n\n### Funktionen\n\nSobald es aktiviert ist, können Sie Inline-Mathematik rendern, indem Sie sie mit einem einzelnen $ umschließen, wie hier: $E=mc^2$.\n\nSie können Mathematikblöcke rendern, indem Sie sie mit $$ umschließen\n\n\n$$\n\\sqrt{(-1)} \\; 2^3 \\; \\sum \\; \\pi\n$$\n\n\n

\n\nDiscourse Math verwendet eine Heuristik, um sicherzustellen, dass Sätze wie: „Ich habe 20$ ausgegeben und weitere 100$“ nicht umgewandelt werden.\n\n#### LaTeX-Trennzeichen\n\nWenn sie über die Website-Einstellungen aktiviert sind, können Sie auch Standard-LaTeX-Trennzeichen verwenden:\n\n- Inline: \\(...\\) - Beispiel: \\(E=mc^2\\)\n- Block: \\[...\\] - Beispiel:\n \n \\[\n \\frac{1}{2}\n \\]\n \n\n#### AsciiMath (nur MathJax)\n\nWenn Sie MathJax verwenden, können Sie die asciimath-Verarbeitung aktivieren, die % als Trennzeichen verwendet: %E=mc^2%\n\n### Composer-Integration\n\nDer Composer enthält eine Schaltfläche Mathematik einfügen in der Werkzeugleiste mit der Tastenkombination \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e. Dies öffnet ein Modal, in dem Sie:\n\n- Zwischen Inline- und Blockmodus umschalten können\n- Ihren LaTeX-Ausdruck eingeben können\n- Vorschau anzeigen und in Ihren Beitrag einfügen können\n\nIm Rich-Text-Editor erscheinen mathematische Ausdrücke als bearbeitbare Knoten mit einer Bearbeitungsschaltfläche, um den Ausdruck zu ändern.\n\n### Chat-Unterstützung\n\nMathematische Ausdrücke werden auch in Discourse Chat-Nachrichten unter Verwendung derselben Einstellungen und derselben Rendering-Engine dargestellt.\n\n### Rendering-Engines\n\n#### MathJax (Standard)\n\n- Version: 4.1\n- Ausgabeformate: HTML (Standard) oder SVG\n- Funktionen:\n - Kontextmenü (Rechtsklick auf Mathematik)\n - Barrierefreiheitsverbesserungen für Screenreader\n - Zoomen bei Alt-Klick (175% Zoom)\n - AsciiMath-Unterstützung\n\n#### KaTeX (Alternative)\n\n- Funktionen:\n - Schnelles Rendern\n - Mhchem-Erweiterung für chemische Gleichungen\n - CopyTex-Erweiterung – Klicken Sie auf Mathematik, um die LaTeX-Quelle in die Zwischenablage zu kopieren\n - Unterstützung für Querverweise mit den Makros \\label, \\ref und \\eqref\n\n### Site-Einstellungen\n\nAlle relevanten Site-Einstellungen finden Sie, indem Sie in Ihren Admin-Einstellungen nach „math“ suchen.\n\n| Name | Beschreibung |\n|-|-|\n| discourse math enabled | Discourse Math Plugin aktivieren (fügt spezielle Verarbeitung für $ und $$ Blöcke hinzu) |\n| discourse math provider | Mathematik-Rendering-Anbieter: mathjax (Standard) oder katex |\n| discourse math enable latex delimiters | LaTeX-ähnliche Trennzeichen aktivieren: \\(...\\) für Inline- und \\[...\\] für Block-Mathematik |\n| discourse math mathjax output | MathJax Ausgabeformat: html (Standard) oder svg (nur MathJax) |\n| discourse math enable menu | Kontextmenü für mathematische Ausdrücke aktivieren (nur MathJax) |\n| discourse math enable accessibility | Barrierefreiheitsfunktionen wie Texterweiterung aktivieren (nur MathJax mit Menü) |\n| discourse math zoom on click | 175% Zoom bei Alt-Klick-Interaktion (nur MathJax mit Menü) |\n| discourse math enable asciimath | Asciimath-Verarbeitung mit %-Trennzeichen aktivieren (nur MathJax) |\n\n\n\u003e :discourse2: Bei uns gehostet? Dieses Plugin ist auf allen unseren Hosting-Stufen verfügbar Math | Discourse - Civilized Discussion

70 „Gefällt mir“

2 Beiträge wurden in ein neues Thema verschoben: Unterstützung für E-Mail-Formatierung von MathJax hinzufügen

2 Beiträge wurden in ein neues Thema verschoben: Kann Mathjax auf Version 3 aktualisiert werden?

6 Beiträge wurden in ein neues Thema verschoben: Unterstützung für Latex-Style-Blöcke und Inlines für Mathematik hinzufügen

Ein Beitrag wurde in ein neues Thema verschoben: Gleichungen werden in Blöcken nicht korrekt dargestellt

Ein Beitrag wurde in ein neues Thema aufgeteilt: Mathematik wird in der Vorschau nicht gerendert

15 Beiträge wurden in ein neues Thema verschoben: Math and AI workarounds

26 Beiträge wurden in ein neues Thema verschoben: Upgrading Mathjax to version 4

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.

3 „Gefällt mir“