Vorlage:Bruch/Doku

Diese Vorlage dient der typografisch sauberen Darstellung von Brüchen im Fließtext. Sie nutzt intern die Math-Erweiterung (MathML), ist dadurch barriereärmer als reine HTML- oder Unicode-Lösungen und bleibt zugleich kompakt genug für laufenden Text.

Die Vorlage unterstützt zwei Eingabeformen:

• eine kurze, positionsbasierte Schreibweise
• eine explizite Schreibweise mit benannten Parametern (empfohlen für den VisualEditor)

Grundprinzip

Die Bedeutung der Positionsparameter hängt von ihrer Anzahl ab. Sobald ein dritter Positionsparameter gesetzt ist, wird automatisch ein gemischter Bruch angenommen.

TemplateData

Fügt einen Bruch oder gemischten Bruch in in den Fließtext ein.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Ganzzahl	ganz 1	Ganzzahliger Anteil des gemischten Bruchs Beispiel 9	Zahlenwert	vorgeschlagen
Zähler	zaehler 1 2	Zähler (über dem Bruchstrich) Beispiel 3	Zahlenwert	erforderlich
Nenner	nenner 2 3	Wert des Nenners (unter dem Bruchstrich) Beispiel 4	Zahlenwert	erforderlich

Format: inline

Positionsbasierte Schreibweise

Einfacher Bruch (2 Parameter)

{{Bruch|Zähler|Nenner}}

Beispiel

	Eingabe	Ergebnis
{{Bruch|3|4}}		$\frac{3}{4}$

In diesem Fall gilt:

• 1 = Zähler
• 2 = Nenner

Gemischter Bruch (3 Parameter)

{{Bruch|Ganzzahl|Zähler|Nenner}}

Beispiel

	Eingabe	Ergebnis
{{Bruch|9|3|4}}		9$\frac{3}{4}$

Sobald ein dritter Positionsparameter vorhanden ist, „rücken“ die Bedeutungen der Parameter automatisch weiter:

• 1 = Ganzzahl
• 2 = Zähler
• 3 = Nenner

Diese Logik ist bewusst so gewählt, um eine möglichst kurze und intuitive Eingabe für häufige Anwendungsfälle zu ermöglichen.

Benannte Parameter

Alternativ können alle Werte explizit über benannte Parameter angegeben werden. Diese Form ist insbesondere für den VisualEditor gedacht und vermeidet jede Mehrdeutigkeit.

	Eingabe	Ergebnis
{{Bruch|ganz=9|zaehler=3|nenner=4}}		9$\frac{3}{4}$

Auch ein einfacher Bruch kann benannt geschrieben werden:

{{Bruch|zaehler=3|nenner=4}}

Benannte Parameter haben Vorrang vor Positionsparametern.

Hinweise zur Darstellung

• Die Vorlage ist für die Nutzung im Fließtext optimiert.
• Gemischte Brüche werden optisch kompakt dargestellt, um die Zeilenhöhe nicht unnötig zu vergrößern.
• Die gesamte Darstellung erfolgt in einer Math-Umgebung, wodurch Screenreader Brüche zuverlässiger erkennen können als bei rein visuellen Konstruktionen.

Typische Stolperstellen

• {{Bruch|1|2|3}} wird als gemischter Bruch interpretiert (1 2/3).
• Soll ein einfacher Bruch dargestellt werden, dürfen nur zwei Positionsparameter verwendet werden.
• Für maximale Klarheit kann jederzeit auf die benannte Schreibweise ausgewichen werden.

Wann welche Schreibweise?

• Positionsparameter: kurz, schnell, gut lesbar im Wikitext
• Benannte Parameter: eindeutig, empfehlenswert im VisualEditor oder bei komplexeren Vorlagen