Template (Vorlagen)

In diesem Wiki sind in allen Ordnern (Namensräumen) sogenannte Templates bereits abgelegt. Dieses wird bei Neu-Anlage einer Seite automatisch in das Editorfeld geladen. Darin ist die Überschrift bereits gesetzt (ggf. anpassen) und die jeweiligen Abteilungen vorgegeben. Zudem sind kleine Erinnerungs-Marker und ggf. Tabellen angelegt.

Namespace Templates

Manchmal möchte man neuen Seiten in einem bestimmten Namespace ein vorgegebenes Skelet geben.

Als Beispiel: In dem Namespace address könnte man bei jeder neuen Seite eine vordefinierte Tabelle haben, welche nur noch mit Daten gefüllt werden muss.

Dies kann ganz einfach mit sogenannten „namespace templates“ erledigt werden.

Wenn eine neue Seite angelegt wird, schaut DokuWiki ob eine Template Datei existiert und zeigt dieses im Editor an. Die Template Dateien sind in Wiki Sprache verfasst und als .txt Datei gespeichert.

Template Dateien

Zwei Arten von Template Dateien können benutzt werden:

_template.txt, welche im aktuellen Namespace benutzt werden. (hier verwendet)
__template.txt (zwei führende unterstriche), welche auch als normales _template.txt funktionieren, deren Inhalte allerdings auf alle untergeordneten Namespace angewand werden (Vererbung)

Ein weg um eine Template Datei zu erstellen:

Öffne eine normale Wikiseite im gewünschten Namespace und füge den Inhalt für das Template ein
Öffne den Ordner mit FTP (oder WebDAV) und mache eine Kopie der Seite und benenne Sie wie oben beschrieben
Benutze das Wiki um den Templateentwurf zu löschen

Syntax

Der Inhalt der Datei ist normale Wiki Sprache.

Ersetzungsmuster

Innerhalb der Datei können auch einige Ersetzungsmuster benutzt werden, die das Template dynamischer gestalten.

@ID@	vollständige ID der Seite
@NS@	Namensraum der Seite
@PAGE@	Seitenname (ID ohne Namensraum; Unterstriche werden durch Leerzeichen ersetzt)
@!PAGE@	Das gleiche wie oben, der erste Buchstabe des ersten Wortes ist großgeschrieben
@!!PAGE@	Das gleiche wie oben, der erste Buchstabe von jedem Wort ist großgeschrieben (hier verwendet)
@!PAGE!@	Das gleiche wie oben, alle Buchstabe sind großgeschrieben
@FILE@	Seiten Name (ID ohne Namensraum, unterstriche bleiben erhalten)
@!FILE@	Das gleiche wie oben, der erste Buchstabe des ersten Wortes ist großgeschrieben
@!!FILE@	Das gleiche wie oben, der erste Buchstabe von jedem Wort ist großgeschrieben
@USER@	Die ID des Benutzers der die Seite erstellt
@NAME@	Der Name des Benutzers, welcher die Seite erstellt
@MAIL@	Die E-Mail Adresse des Benutzers, welcher die Seite erstellt
@DATE@	Datum und Uhrzeit der Erstelltung der neuen Seite

Um das Zeichen % im Template zu benutzen, muss es doppelt notiert werden.

Template Bearbeitung

Die Datei _template.txt kann nicht aus DokuWiki heraus editiert werden – nur jemand mit Schreibrechten innerhalb der DokuWiki Ordnern (für gewöhnlich ein Administrator mit FTP oder WebDAV zugriff) kann die Templates ändern. Es gibt zwei Tricks um dies zu umgehen. Für einen muss ein symlink gesetzt werden, für den anderen ist es nötig den Code zu ändern.

….

Inhaltsverzeichnis