seiten Einbinden

Diese Art der Übernahme von einem elektronischen Dokument oder Teilen davon in ein anderes wird auch als Transklusion bezeichnet, in der deutschsprachigen Wiki meist als Einbindung.

In erster Linie werden kleinere Textbausteine (Vorlagen) in andere Seiten eingebunden, um dieses Textstück zentral warten zu können. Dabei können immer auch Parameter angegeben werden, die das Ergebnis einheitlich und teilweise sehr komplex abwandeln, während der Parameter ein einfacher Schalter sein kann.

Die vollständige Einbindung einer ganzen Seite in eine andere Seite, jedoch nur diese, ist absolut unerwünscht.

• Grund: Die Versionsgeschichte des wirklichen Textes ist auf der vorgetäuschten Seite nicht mehr nachvollziehbar, die Autoren bleiben im Dunkeln.
• Der tatsächliche Name der Seite wird verschleiert.
• Hier ist eine Weiterleitung zu verwenden.

Die Syntax lautet

{{Seitenname}} 

Es darf durch Seitenname nicht zu einem Konflikt mit dem Namen einer Parserfunktion oder dergleichen kommen.

Wirkung: An genau dieser Stelle wird die Textsequenz eingefügt, die sich durch Auswertung der eingebundenen Seite unter den momentanen Bedingungen ergibt.

Optional können Parameter angegeben werden, die von Seitenname durch Pipe-Symbole | getrennt werden:

• {{Seitenname|Parameterliste}}

Außerdem gibt es zwei spezielle Parser-Funktionen; siehe unten:

• {{#lst:SeiteX|sectionY}}
• {{#lstx:SeiteX|sectionZ}}

Grundsätzlich kann jede reguläre (statische) Seite (des eigenen Wiki) in eine andere eingebunden werden. Zu den verschiedenen Namensräumen gibt es Besonderheiten.

Vorlagen

Die bei weitem überwiegende Menge an eingebundenen Seiten entstammt dem Vorlagen-Namensraum. Die Seiten in diesem Namensraum sind von vornherein dazu gedacht, irgendwo eingebunden zu werden.

Wenn beim Namen der eingebundenen Seite kein Namensraum angegeben wird, dann erwartet die Software diese Seite im Vorlagen-Namensraum.

Technisch könnte ein Namensraum-Präfix Vorlage: zwar vorangestellt werden; das verwirrt jedoch nur, stört bei Suchvorgängen und soll deshalb unterbleiben. In den sehr frühen Jahren der Wiki-Software war das einmal erforderlich.

Innerhalb der Vorlagenprogrammierung selbst ist es üblich, in die für andere Seiten bestimmte Vorlagenseite eine Unterseite namens /Doku einzubinden. Diese Unterseite erscheint jedoch nicht in anderen Seiten. Das soll einheitlich nur mittels der Vorlage:Dokumentation erfolgen. Näheres siehe Hilfe:Vorlagendokumentation #Dokumentation auf Unterseite.

Artikel

In der Regel ist es unerwünscht, Seiten aus dem Artikel-Namensraum in andere einzubinden.

Es gibt einige Ausnahmefälle, bei denen man Artikel im Rahmen einer übergeordneten Systematik dafür vorsieht, in anderen Artikeln eingebunden zu werden. Der bekannteste und häufigste Fall ist die Einbindung von Begriffsklärungsseiten zu Vorname Familienname in eine übergeordnete Seite zu Familienname.

Beispiel:

• Petra Müller ist die Seite, die eingebunden wird.
• In der Seite Müller (Familienname) erscheint der Inhalt dieser Seite. Die Syntax unter „P“ lautet dort:
  • {{:Petra Müller}}
• Diese Methode hat den Vorteil, dass die Angaben zu den Petra Müller nur an einer Stelle aktuell gehalten werden müssen.

Die eingebundene Seite wird meist auf bestimmte Bereiche eingegrenzt.

Auch hier muss der Namensraum vorangestellt werden; fehlende Angaben werden als Vorlage: interpretiert. Der Name des Artikel-Namensraums ist (leer) – demzufolge muss der Seitenname mit einem vorangestellten Doppelpunkt beginnen.

Wenn außer im allgemein bekannten Fall der Familiennamen die Einbindung von Artikeln beabsichtigt ist, sollte man im Quelltext der eingebundenen Seite einen versteckten Kommentar anbringen. Darin soll auf die einbindende Seite hingewiesen sowie der Zweck erklärt werden (welche Inhalte in der Einbindung erwünscht sind oder gerade nicht).

Benutzer

Vor dem Einbinden fremder Benutzerseiten sollte die Zustimmung dieses Benutzers eingeholt werden; es sei denn, die Seite ist ihrer Art nach (Linksammlung, Hilfestellung, Vorlagen-ähnlich) von vornherein dafür vorgesehen, an anderen Stellen verwendet zu werden, oder wird gar dazu angeboten.

Datei, Kategorie

Es wird die Beschreibung der Kategorie oder Datei eingebunden; nicht aber die Liste aller momentanen Mitglieder der Kategorie oder das Bild selbst. Zur Anzeige von Bildern und anderen Dateien im Artikel siehe Hilfe:Bilder, zur Verwendung von Kategorien siehe Hilfe:Kategorien.

• Bei Dateibeschreibungsseiten muss daran gedacht werden, dass diese häufig nur im Commons-Projekt hinterlegt sind. Die dann hier lokal sichtbaren virtuellen Dateibeschreibungsseiten lassen sich nicht einbinden.

Modul

Es wird der Lua-Quelltext angezeigt.

Der Inhalt eines ganzen Moduls kann farbig dargestellt werden mit:

{{#tag:syntaxhighlight | {{Modul:Hello}} | lang=lua}} 

Neben der Einbindung des Quelltextes eines Moduls zählt auch die Verwendung der Funktionen #invoke sowie require() und mw.loadData() als Einbindung im weiteren Sinn.

Sonstige Projektseiten

Mit Seiten auf Wiki: oder Hilfe: und Portal werden Einbindungen gelegentlich benutzt.

Das ist insbesondere dann sinnvoll, wenn die eingebundenen Seiten nicht für den allgemeinen Gebrauch gedacht und geeignet sind, sondern nur auf einer einzelnen oder wenigen bestimmten Seiten verwendet werden. Oft werden sie dann als Unterseite der einbindenden Seite angelegt, wodurch die Zuordnung offensichtlich ist.

Die Technik wird öfters verwendet, um Einleitungsabschnitte gesondert abzulegen, meist unter dem Namen /Intro als Unterseite.
Das hat folgende Vorteile:

• Der Quelltext der Diskussion wird übersichtlicher.
• Die Datenbank wird etwas entlastet vom tausendfach wiederkehrenden Speichern statischer Texte.
• Es werden nicht aus Versehen einzelne Zeilen aus der Einführung durch Diskutanten gelöscht.
• Bei gefährdeten Seiten kann die Intro teil- oder vollgeschützt werden.

Zu beachten ist:

• Eine Archivierung muss auf der eigentlichen Seite konfiguriert sein, da die Bots nur den Quelltext derselben Seite analysieren, von der aus dann auch Abschnitte archiviert werden.
• Auf der Seite /Intro müssen Kategorien, Schalter und Shortcuts mit includeonly unwirksam gemacht werden, weil sie nicht in der Intro-Seite, sondern nur auf der eigentlichen Seite greifen dürfen.

Spezialseiten

Die Einbindung von Spezialseiten ist nur eingeschränkt möglich. Teilweise hängt es vom aktuellen Inhalt ab (ggf. ohne Treffer kein sinnvoll darstellbares Ergebnis), teilweise geht es überhaupt nicht. Grund ist deren dynamische Generierung.

Diejenigen Spezialseiten, bei denen eine Einbindung möglich ist, sind in der Liste aller Spezialseiten markiert.

Weiterhin ist es auch hier möglich, die URL-Parameter als „Vorlagenparameter“ anzugeben. So erzeugt

{{Spezial:Präfixindex/Hilfe:Seite|hideredirects=1}} 

die nachstehende Ausgabe:

Bei Verlinkungen ist der Bezug auf Unter- und Schwesterseiten möglich:

• [[/Unterseite|Titel für Unterseite]]
• [[../|Titel für Oberseite]]
• [[../Schwesterseite|Titel für Schwesterseite]]

Bei deren Einbindung geht das im Prinzip auch; jedoch muss in einigen Fällen mittels der Funktion #rel2abs der Seitenbezug hergestellt werden:

• {{/Unterseite}}
• {{{{#rel2abs:..}}#}}
• {{{{#rel2abs:..}}/Schwesterseite}}

Der Parser-Funktion #rel2abs können nur Punkte und Schrägstriche als Parameter übergeben werden; dies muss mit einem Punkt beginnen und enden.

Vorsicht: Bei Nutzung in einer einbindenden Seite zählt die momentane äußerste (angezeigte) Seite als Bezug für den relativen Pfad. Die Seite . ist die Seite, die dem Leser angezeigt wird und in der URL steht. Die Parserfunktionen beziehen sich ebenfalls auf die oberste (angezeigte) Seite, die in der URL benannt ist, und nicht auf die eingebundene Seite.

Wenn zu erwarten ist, dass die einbindende Seite durch eine andere Seite eingebunden wird, sollte man deshalb vollständige Pfade verwenden.

Grundsätzlich kann jede Seite mit Parametern eingebunden werden. Das ist aber nur bei Vorlagen (Quellseite im Vorlagen-Namensraum) üblich; ansonsten höchstens bei speziellen Unterseiten bestimmter Projektseiten.

• {{Seitenname|Parameterliste}}

Zu Einzelheiten siehe Vorlagen.

Häufig soll in der resultierenden Seite (Zielseite) nicht alles wirken, was in der Quellseite enthalten ist.

noinclude, includeonly, onlyinclude

Mit den folgenden drei Tags kann das Verhalten gesteuert werden:

…
Damit umschlossene Bereiche werden beim Einbinden in der Zielseite nicht berücksichtigt, sind aber bei der normalen Darstellung der Quellseite wirksam.
So kann zum Beispiel die Quellseite kategorisiert werden, die Zielseite wird aber nicht kategorisiert.
…
Damit umschlossene Bereiche sind in der Einbindung wirksam; aber nicht bei der normalen Anzeige der Quellseite.
So kann zum Beispiel die einbindende Seite kategorisiert werden, die Quellseite kommt jedoch nicht in die Kategorie.
Dadurch werden in Vorlagen Darstellungen der Vorlagenseite selbst ausgeschlossen, die nur bei Einbindung mittels Parametern sinnvoll sind, ansonsten aber Fehlermeldungen und Syntaxbruchstücke zeigen würden.
…
In der Quellseite wird alles wirksam.
In die einbindende Seite wird nur der eingeschlossene Wikitext übernommen. Alle anderen Bereiche werden für die Einbindung ignoriert.
Es ist der sicherste Weg, genau den beabsichtigten Teil einer Vorlagenprogrammierung einzubinden, nicht aber irrtümlich noch Leerzeichen oder gar Zeilenumbrüche anzuhängen.
Auf diese Weise werden Vorlagen dokumentiert.

Mehr dazu unter Hilfe:Vorlagen #Bedingtes Einbinden von Quelltextblöcken.

– Abschnitte einbinden

Eine Entwicklung von 2012 ermöglicht, identifizierbare Abschnitte einer Quellseite einzubinden. Die vorstehenden include-Tags gelten gleichermaßen für alle Einbindungen.