summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/edittemplate.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
commitdef01959f8b76178d393a39ecd2c5af9be20b31f (patch)
treeed9b5b062671c30e55fe691625fc7ddcb31fee1f /ikiwiki/directive/edittemplate.mdwn
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'ikiwiki/directive/edittemplate.mdwn')
-rw-r--r--ikiwiki/directive/edittemplate.mdwn39
1 files changed, 39 insertions, 0 deletions
diff --git a/ikiwiki/directive/edittemplate.mdwn b/ikiwiki/directive/edittemplate.mdwn
new file mode 100644
index 0000000..a4f90c1
--- /dev/null
+++ b/ikiwiki/directive/edittemplate.mdwn
@@ -0,0 +1,39 @@
+La directive `edittemplate` est fournie par le greffon [[!iki
+plugins/edittemplate desc=edittemplate]].
+
+Cette directive permet l'enregistrement de modèles de pages, qui proposent
+un contenu par défaut aux pages nouvellement créées avec l'interface
+web. Pour enregistrer un modèle, il faut insérer une directive
+[[ikiwiki/directive/template]] dans une quelconque autre page.
+
+ \[[!edittemplate template="bugtemplate" match="bugs/*"]]
+
+Dans l'exemple ci-dessus, la page nommée « bugtemplate » est enregistrée
+comme modèle de page à utiliser pour toute page nommée « bugs/* » qui sera
+créée. Pour éviter que la directive n'affiche une note au sujet de
+l'enregistrement du modèle, il suffit d'activer le paramètre « silent=yes ».
+
+Souvent la page modèle contient le simple squelette d'une page
+particulière. Pour le modèle « rapport de bogue » dans l'exemple, ce
+squelette pourrait se présenter ainsi :
+
+ Paquet :
+ Version :
+ Reproductible : o/n
+ Détails :
+
+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.
+
+----
+
+Ce n'est pas une bonne idée de mettre la directive `edittemplate` dans la
+page modèle elle-même. En effet la directive serait alors incluse comme
+partie du modèle sur les nouvelles pages, qui seraient à leur tour
+enregistrées comme modèles. Si de nombreuses pages sont enregistrées comme
+modèles pour une page, un modèle est choisi au hasard et tout devient
+confus.
+
+[[!meta robots="noindex, follow"]]