Diskurs Mathematik

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

Mathematik aktivieren

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

Math-Einstellungen

Funktionen

Nach der Aktivierung können Sie inline Mathematik rendern, indem Sie den Ausdruck mit einem einzelnen $ umschließen, z. B.: $E=mc^2$.

Sie können Blöcke von Mathematik rendern, indem Sie diese mit $$ umschließen:

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

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

LaTeX-Trennzeichen

Wenn dies über die Site-Einstellungen aktiviert ist, können Sie auch die Standard-LaTeX-Trennzeichen verwenden:

  • Inline: \(...\) - Beispiel: \(E=mc^2\)
  • Block: \[...\] - Beispiel:
    \[
    \frac{1}{2}
    \]
    

AsciiMath (nur MathJax)

Wenn Sie MathJax verwenden, können Sie die asciimath-Verarbeitung aktivieren, die % als Trennzeichen verwendet: %E=mc^2%

Integration in den Editor

Der Editor enthält eine Schaltfläche Mathematik einfügen in der Symbolleiste mit der Tastenkombination Shift+M. Dies öffnet ein Modal, in dem Sie:

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

Im Rich-Text-Editor werden Mathematik-Ausdrücke als bearbeitbare Knoten mit einer Schaltfläche zum Bearbeiten des Ausdrucks angezeigt.

Chat-Unterstützung

Mathematik-Ausdrücke werden auch in Discourse-Chat-Nachrichten unter Verwendung der gleichen Einstellungen und des gleichen Render-Engines dargestellt.

Render-Engines

MathJax (Standard)

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

KaTeX (Alternative)

  • Funktionen:
    • Schnelles Rendern
    • Mhchem-Erweiterung für chemische Gleichungen
    • CopyTex-Erweiterung - Klicken Sie auf Mathematik, um die LaTeX-Quelle in die Zwischenablage zu kopieren
    • Querverweis-Unterstützung mit den Makros \label, \ref und \eqref

Site-Einstellungen

Sehen Sie sich alle relevanten Site-Einstellungen an, 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 Math-Render-Anbieter: mathjax (Standard) oder katex
discourse math enable latex delimiters LaTeX-ähnliche 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 Mathematik-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 (nur MathJax mit Menü)
discourse math enable asciimath AsciiMath-Verarbeitung mit %-Trennzeichen aktivieren (nur MathJax)

:discourse2: Von uns gehostet? Dieses Plugin ist in allen unseren Hosting-Tarifen 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“

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

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.

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.

1 „Gefällt mir“

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.

1 „Gefällt mir“

Ich habe ein neues Tool namens RaTeX entdeckt, das in Rust geschrieben und zu 100 % mit Katex kompatibel ist.

GitHub - erweixin/RaTeX: >99.5% KaTeX syntax coverage. LaTeX math renderer in pure Rust. No JavaScript, no WebView, no DOM. One Rust core → iOS, Android, Flutter, Web, PNG. C ABI · WASM · Server-side PNG/SVG. · GitHub

Es könnte eine gute Alternative sein.