Vorlage:Transklusion/Doku

Diese Vorlage dient dazu, einen spezifischen, markierten Abschnitt von einer anderen Wiki-Seite in die aktuelle Seite einzubinden (zu transkludieren). Sie verwendet die Parser-Funktion #lst: der Erweiterung Labeled Section Transclusion.

Parameter Bearbeiten

VisualEditor

Die Vorlage ist für die Verwendung mit dem VisualEditor und TemplateData optimiert um die Handhabung einfach zu gestalten.

TemplateData

Bindet einen zur Transklusion markierten Abschnitt aus einer anderen Seite ein und markiert diesen als transkludierten Inhalt.

Parameter		Beschreibung	Typ	Status
Quellseite	`seite` 1	Die Seite von der Transkludiert werden soll. (Namensraum nicht vergessen.) Beispiel Hilfe:Vorlagen	Einzeiliger Text	erforderlich
Abschnittsname	`abschnitt` 2	Der Abschnittsname, wie er auf der Quellseite definiert wurde. Beispiel Vorlageneinbindung	Einzeiliger Text	erforderlich

Wichtige Voraussetzung: Quellseite muss vorbereitet sein Bearbeiten

Damit die Transklusion funktioniert, muss die Quellseite den gewünschten Abschnitt mit den speziellen <section>-Tags markieren.

Beispiel für die Markierung auf der Quellseite

<section begin="Beispiel" />
Der Inhalt des Abschnitts, der transkludiert werden soll.
<section end="Beispiel" />

Fehlt diese Markierung, wird kein Inhalt eingebunden, da die Vorlage explizit die Labeled Section Transclusion (#lst:) verwendet.

Beispiel Bearbeiten

Hier folgt nun die Einbindung des oben definierten Abschnitts "Beispiel".

Ausgabe-Beispiel
Abschnittstransklusion Beispiel für die Markierung auf der Quellseite <section begin="Beispiel" /> Der Inhalt des Abschnitts, der transkludiert werden soll. <section end="Beispiel" /> Dieser Abschnitt wurde von dieser Seite eingebunden.

Aktuelle Einschränkungen der Vorlage Bearbeiten

Die Vorlage unterstützt gegenwärtig ausschließlich die Transklusion eines markierten Abschnitts von einer angegebenen Seite. Sie nutzt dafür direkt die Syntax: {{#lst:{{{seite|{{{1}}}}}}|{{{abschnitt|{{{2}}}}}}}}

Nicht unterstützte Fälle: Bearbeiten

Transklusion anhand von Überschriften: Die Funktion, Inhalte anhand bereits existierender Wiki-Überschriften einzubinden (z.B. mit #lsth:), wird nicht unterstützt.
Einbinden/Ausschließen des gesamten Seiteninhalts: Speziellere Fälle der LST-Erweiterung (z.B. das Einbinden von Seiten ohne Angabe eines Abschnitts zur Exklusion) werden nicht unterstützt und müssen manuell im Wikitext vorgenommen werden.

Verwendung (Syntax) Bearbeiten

Die Vorlage wird mit zwei Parametern aufgerufen. Es wird empfohlen, die unbenannten Parameter zu nutzen:

{{Transklusion|Seitenname|Abschnittsname}}

Style / CSS Bearbeiten

Die Vorlage benutzt TemplateStyles als Grundlage für das Layout. Das entsprechende Stylesheet ist under Transklusion/styles.css zu finden.