Parfois vous voudriez que toutes les pages d'un espace de noms donné aient un « squelette » commun. Par exemple, dans l'espace de noms adresse, vous auriez un tableau déjà prêt qu'il n'y aurait plus qu'à remplir avec les données. Ceci peut facilement être réalisé grâce aux “modèles d'espaces de noms”. Lorsque vous créez une page, dokuwiki cherche un fichier _template.txt dans l'espace de nom auquel appartient la page. S'il existe, il le copie dans la fenêtre de l'éditeur de la nouvelle page. Ces fichiers _template.txt sont de simples fichiers texte contenant de la syntaxe wiki.

Deux types de modèles peuvent être utilisés :

• _template.txt qui est utilisé dans l'espace de nom en cours
• et __template.txt (notez les deux caractères de soulignement) qui fonctionne comme le fichier _template.txt standard, sauf qu'il agit dans tous les espaces de nom contenu dans celui-ci

Un moyen de créer un fichier modèle est :

1. utiliser le wiki pour sauver une page dans l'espace de noms approprié, avec le contenu que vous voulez utiliser comme modèle pour cet espace
2. utiliser FTP ou WebDAV pour faire une copie de ce fichier dans le même dossier et de le renommer ensuite en _template.txt
3. utiliser le wiki pour supprimer la page originale

Imaginons que vous ayez la structure suivante:

.../www/repertoire_de_dokuwiki/

Imaginons que pour l'ensemble du site, vous désirez que toutes les nouvelles pages soient créées avec le code basique suivant:

====== @PAGE@ ======
{{ :dummy.png?75x75|Nom de la section}}
Lorem ipsum dolor sit amet, ...

Il suffit alors de créer un fichier __template.txt (avec 2 soulignés au début) sous .../www/repertoire_de_dokuwiki/ Donc: .../www/repertoire_de_dokuwiki/__template.txt

Ainsi, chaque fois que vous créerez une nouvelle page et voudrez l'éditer pour la première fois, le code ci-haut sera déjà là !

Lorsque vous éditerez la page pour la première fois, vous aurez donc:

• En H1 le nom de la page déjà écrit (correspond à @PAGE@ : voir plus bas la liste des motifs de remplacement
• Une image à gauche, pour indiquer à l'utilisateur l'emplacement de l'image et lui rappeler éventuellement de la changer…
• Un texte bidon pour indiquer à l'utilisateur l'emplacement où il doit mettre son texte par exemple…

Imaginons maintenant que vous ayez la structure suivante:

.../www/repertoire_de_dokuwiki/abc
.../www/repertoire_de_dokuwiki/def
.../www/repertoire_de_dokuwiki/ghi
.../www/repertoire_de_dokuwiki/jkl

Vous voulez que chaque page créée dans chacun de ces espaces de noms soit différente de celles créées dans un autre espace de nom.

Par exemple, dans l'espace de nom abc, vous voulez ceci:

====== @PAGE@ ======
{{ :dummyabc.png?75x75|Nom de la section ABC}}
Lorem ipsum dolor sit amet, ...

tandis que dans l'espace de nom DEF, vous voulez plutôt ceci:

====== @PAGE@ ======
{{ :dummydef.png?75x75|Nom de la section DEF}}
Lorem ipsum dolor sit amet, ...

Il suffit de créer des fichiers __template.txt différents et de mettre chacun dans le répertoire correspondant à son espace de nom:

.../www/repertoire_de_dokuwiki/abc/__template.txt (avec le code pour la section abc)
.../www/repertoire_de_dokuwiki/def/__template.txt (avec le code pour la section def)
.../www/repertoire_de_dokuwiki/ghi/__template.txt ...
.../www/repertoire_de_dokuwiki/jkl/__template.txt ...

Enfin, si vous voulez qu'une template soit appliquée __uniquement__ au niveau d'un espace de nom (et non ailleurs sous lui ou avant lui), alors il suffit de créer le fichier _template.txt (avec un seul souligné au début) et de le mettre où l'on souhaite qu'il soit appliqué.

Par exemple: …/www/repertoire_de_dokuwiki/abc/_template.txt ne sera appliqué que sous :

.../www/repertoire_de_dokuwiki/abc/

et pas du tout sous:

.../www/repertoire_de_dokuwiki/abc/xxx/

si j'ai bien compris

Le contenu du fichier est le langage standard du wiki.

À l'intérieur du fichier, vous pouvez également utiliser certain motif de remplacement pour rendre votre modèle un peu plus dynamique.

De plus, vous pouvez utiliser n'importe quelle valeur d'strftime pour insérer la date dans un format personnalisable. N'oubliez pas de doubler les % pour que cela fonctionne.

Un exemple serait le bienvenu. Peu compréhensible en l'état.

Vous ne pouvez pas éditer le fichier _template.txt via DokuWiki – seul celui qui peut éditer les fichiers directement depuis le serveur le peut (généralement un administrateur qui utilise FTP ou WebDAV). Pour ce faire il y a deux astuces: l'une par la mise en place de liens symboliques, et l'autre impliquant une modification de code.

Une troisième astuce a été laissée pour information, mais a été dépréciée et supprimée de la version anglaise de cette documentation.

De cette manière, vous pouvez stocker vos modèles dans un espace de noms. En faisant un lien symbolique vers eux, vous pourrez les utiliser comme modèles. Vous pouvez bien évidemment choisir de faire un modèle non-modifiable en n'utilisant pas de lien symbolique.

1. Créez un espace de noms appelé “modeles”, ou n'importe quel nom similaire.
2. Dans cet espace de noms, créez une page pour chaque modèle d'espaces de noms que vous souhaitez rendre disponible.
3. Suivez les instructions données ci-dessus, à la seule différence que vous devez faire de _template.txt un lien symbolique vers la page de modèle correcte depuis l'espace de noms que vous avez précédemment créé. Vous avez maintenant un modèle qui peut être modifié facilement par l'interface wiki.

De cette façon, tous les modèles seront modifiables par n'importe qui avec un accès en écriture.

1. Changez le nom du modèle par défaut en “modele.txt” (ou template.txt ou encore aaa_template.txt) au alentours de la ligne 718 du fichier inc/common.php ³⁾.
2. À présent n'importe quel utilisateur ayant un accès en écriture dans l'espace de noms peut y créer une page appelée “modele” ⁴⁾ qui servira de modèle.

• Note: Cette méthode a l'avantage que les nouveaux modèles seront immédiatement reconnus. Ça ne pourrait être le cas pour les autres méthodes (en ajoutant manuellement des fichiers ou des liens symboliques dans les dossiers de DokuWiki).

Vous pouvez permettre l'édition dans le wiki aux admins avec le hack suivant: Ouvrez inc/pageutils.php et cherchez la fonction cleanID(). Au début de cette fonction, ajoutez global $INFO

  global $INFO;

puis vers la ligne 98 (celle avec trim() ), remplacez par

  $id = ($INFO['perm'] == 255 ? trim($id,':.-') : trim($id,':._-';))

Maintenant, vous devriez être capable d'éditer le modèle d'espace de noms avec l'URL doku.php?id=_template&do=edit. Note: Ceci ne semble fonctionner que pour le modèle de l'espace de noms racine.

Si vous voulez autoriser quiconque à éditer le modèle, vous pouvez changer son nom en “template.txt” vers la ligne 524 de inc/common.php. Dès lors, tout utilisateur ayant le droit d'écriture dans cet espace de noms pourra créer une page appelée “template” dans cet espace de noms, qui servira de modèle.

— Philippe LAPEYRIE 2006-05-21 21:27 — Aurélie 2006-12-10 18:02 — Yves Jacolin 2008-05-25 10:29 — Laynee 2008/08/25 13:04 — Bertrand Villien 2009-07-07 01:40