Die edittemplate
-Anweisung wird durch die edittemplate-Erweiterung bereitgestellt.
Diese Anweisung erlaubt es, Vorlagen-Seiten zu registrieren, die einen Standardinhalt für neue Seiten bereitstellen, die über das Webfrontend angelegt werden. Um eine Vorlage zu registrieren, fügt man eine edittemplate-Anweisung auf einer anderen Seite ein.
[[!edittemplate template="bugtemplate" match="bugs/*"]]
Der empfohlene Ort für die Anweisungen ist die Elternseite der mit der Vorlage erzeugten Seiten. Das obige Beispiel würde also auf der bugs-Seite platziert. (Verwende die Anweisung nicht auf der Vorlagenseite selbst.)
Im obigen Beispiel wird die Seite mit Namen "bugtemplate" für alle Seiten
als Vorlage registriert, die mit Namen "bugs/*" angelegt werden. Um den
Hinweis über die Registrierung der Vorlage zu unterdrücken, kann man
silent=yes
hinzufügen.
Oft enthält eine Vorlagen-Seite eine templatebody-Anweisung mit einem einfachen Skelett für einen bestimmten Seitentyp. Für die Fehlerberichte aus dem obigen Beispiel könnte sie folgendermaßen aussehen:
[[!templatebody <<ENDBODY
Paket:
Version:
Reproduzierbar: ja/nein
Details:
ENDBODY]]
Wie andere ikiwiki-Vorlagen kann eine Seiten-Vorlage HTML::Template-Anweisungen enthalten.
Diese Variablen können gesetzt werden:
<TMPL_VAR name>
wird durch den Namen der erzeugten Seite ersetzt.<TMPL_VAR uuid>
wird eine (zufällige) Version-4-UUID ersetzt, die geeignet ist zur Verwendung in[[!meta guid="urn:uuid:<TMPL_VAR uuid>"]]
. (Erfordert das Perl-ModulUUID::Tiny
oder Linux.)<TMPL_VAR time>
wird ersetzt durch die aktuelle Zeit (bei Vorlagen-Erstellung) in einem festen Format (RFC 3339,%Y-%m-%dT%H:%M:%SZ
), das geeignet ist zur Verwendung in[[!meta date="<TMPL_VAR time>"]]
(siehe meta) oder[[!date "<TMPL_VAR time>"]]
(siehe date).
Text außerhalb der templatebody-Anweisung ist nicht Teil der Vorlage und kann verwendet werden, um diese zu dokumentieren.
Wenn die Vorlage keine templatebody-Anweisung enthält, wird der gesamte Dateiinhalt der Quellseite als Vorlage verwendet. Dies ist überholt.