Referenz / Formulix 0.1.0

HTML und Anzeige

Gespeicherte Unterrichtsmaterialien sollen außerhalb des Editors und ohne aktiven Tarif lesbar bleiben.

Gespeichertes Format

Element	Gespeichertes HTML	Erhalten
Formel	`<math data-latex="…">…</math>`	MathML für die Anzeige, data-latex für erneute Bearbeitung.
Rechnung / Lösung	`div.conta-armada`, Tabellen, Text, MathML	data-conta mit JSON, wenn vorhanden; Inline-Stile und Struktur.
Graph / Zeichnung	`<img>` mit PNG	src, alt, Maße und data-grafico oder data-quimica.
Chemische Formel	`<math data-quimica="…">`	MathML, LaTeX und Konfigurations-JSON.
CKEditor / Tiptap	`span/div[data-formulix]`	Wrapper und bereinigte Kindelemente; Tiptap erlaubt auch JSON.

Während der Bearbeitung nutzt TinyMCE .eqx[data-mathml]; beim Speichern erzeugt der Adapter portables MathML. Das temporäre Element ist nicht das Speicherformat. LaTeX liegt in data-latex, weil der Sanitizer von TinyMCE 8 semantics/annotation entfernt.

<math xmlns="http://www.w3.org/1998/Math/MathML" data-latex="x^2">
  <msup><mi>x</mi><mn>2</mn></msup>
</math>

Anzeige für Lernende

Geben Sie das gespeicherte HTML mit der sicheren Verarbeitung Ihrer Plattform aus. Moderne Browser zeigen MathML; Tabellen und Bilder benötigen Formulix nicht zum Lesen. PNGs müssen im Plattformspeicher erreichbar bleiben. Entfernte Metadaten können das Erscheinungsbild erhalten, aber die erneute Bearbeitung verhindern.

Für ältere Browser empfiehlt das Projekt MathJax 3. Hosten Sie die Dateien selbst oder laden Sie auf der Leseseite die folgende Komponente gemäß offizieller MathJax-3-Anleitung. Das Beispiel nutzt ein externes CDN: prüfen Sie CSP und Datenschutz für Drittanbieterressourcen.

<script defer
  src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">
</script>

Führen Sie bei dynamisch ergänzten Inhalten MathJax.typesetPromise([element]) aus, sobald MathJax bereit ist. Auf der Lernseite muss Formulix nicht geladen werden.

HTML-Bereinigung und Barrierefreiheit

Erhalten Sie nur erforderliche Elemente und Attribute mit expliziten Regeln im Sanitizer. Deaktivieren Sie die Bereinigung nicht für nicht vertrauenswürdiges HTML. Prüfen Sie MathML, Tabellen, Stile und Metadaten beim Speichern und Wiederöffnen. Für Drupal Alpha gilt eine besondere Full-HTML-Einschränkung.

Erhalten Sie Alternativtexte von Bildern. MathML unterstützt assistive Technik, ersetzt aber keine Tests mit Editor, Browser und Screenreader Ihrer Schule.