summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/edittemplate.mdwn
blob: a4f90c10258415365bb9046b1ad3ff5893448d90 (plain)

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"]]