Vorlage:Transklusion

Dokumentation ansehen ‖ bearbeiten ‖ Versionsverlauf ‖ Cache leeren

Diese Vorlage nutzt Stylesheets in CSS für die Gestaltung der Browser-Ausgabe.
Das Stylesheet kann auf einer Unterseite der Vorlage, oder in einem zentralen CSS eingebunden sein.

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

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

Format: inline

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

Vorlagenparameter

Diese Vorlage bevorzugt Inline-Formatierung von Parametern.

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

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

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

Ausgabe-Beispiel
Abschnittstransklusion Dieser Abschnitt wurde von dieser Seite eingebunden.

Aktuelle Einschränkungen der Vorlage

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:

• 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)

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

{{Transklusion|Seitenname|Abschnittsname}}

Style / CSS

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