summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/edittemplate.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/edittemplate.mdwn')
-rw-r--r--ikiwiki/directive/edittemplate.mdwn38
1 files changed, 38 insertions, 0 deletions
diff --git a/ikiwiki/directive/edittemplate.mdwn b/ikiwiki/directive/edittemplate.mdwn
new file mode 100644
index 0000000..29ff4c9
--- /dev/null
+++ b/ikiwiki/directive/edittemplate.mdwn
@@ -0,0 +1,38 @@
+Die `edittemplate`-Anweisung wird durch die [[!iki plugins/edittemplate
+desc=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
+[[ikiwiki/directive/template]]-Anweisung auf einer anderen Seite ein.
+
+ \[[!edittemplate template="bugtemplate" match="bugs/*"]]
+
+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 ein einfaches Skelett für einen bestimmten
+Seitentyp. Für die Fehlerberichte aus dem obigen Beispiel könnte sie
+folgendermaßen aussehen:
+
+ Paket:
+ Version:
+ Reproduzierbar: ja/nein
+ Details:
+
+The template page can also contain [[!cpan HTML::Template]] directives,
+like other ikiwiki [[templates]]. Currently only one variable is
+set: `<TMPL_VAR name>` is replaced with the name of the page being
+created.
+
+----
+
+It's generally not a good idea to put the `edittemplate` directive in the
+template page itself, since the directive would then be included as part of
+the template on new pages, which would then in turn be registered as
+templates. If multiple pages are registered as templates for a new page, an
+arbitrary one is chosen, so that could get confusing.
+
+[[!meta robots="noindex, follow"]]