DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:namespace_templates

Ceci est une ancienne révision du document !


:!: à relire après mise à jour :!:

:?: «Modèles de pages» ne serait-il pas plus parlant pour les utilisateurs que «Modèles de catégorie» ou «Modèles d'espace de noms», (catégorie versus espace de noms n'étant pas ici le débat), même si on perd en précision technique.

FIXME Cette page mérite encore une refonte. Doit-on garder tous ces modes d'éditions ou le déplacer dans une page existante ou à créer de «toutes les autres manières de créer, modifier supprimer les pages d'un wiki». Cela complique inutilement l'explication de l'usage des modèles des pages alors que c'est une fonctionnalité puissante et vraiment utile, nue ou en combinaison avec des extensions comme Bureaucracy, data, Struct…..

Modèles de catégorie

Il peut vous arriver de souhaiter que toutes les pages d'un espace de noms (catégorie) 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 de pages». Lorsque vous créez une page, DokuWiki cherche un fichier _template.txt dans la catégorie à laquelle 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.

Fichiers modèles

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

  • _template.txt qui est utilisé dans l'espace de noms courant, et
  • __template.txt (notez les deux caractères de soulignement) qui fonctionne comme le fichier _template.txt standard, excepté qu'il agit dans toutes les espaces de noms contenus dans celui-ci.

Si les deux fichiers (hérité et normal) sont présents dans un espace de noms, le fichier normal est utilisé.

Comme vous ne pouvez pas créer et modifier le fichier _template.txt directement dans DokuWiki, vous pouvez choisir :

  1. d'utiliser une extension comme TemplatePagename qui simplifie la procédure (voir les extensions concernées plus bas) en vous permettant de créer et modifier un fichier modèle depuis le wiki
  2. d'utiliser le wiki pour sauver une page dans l'espace de noms approprié, avec le contenu que vous voulez utiliser comme modèle,
    1. puis par FTP ou WebDAV faire une copie de ce fichier dans le même dossier et de le renommer ensuite en _template.txt ou __template.txt
    2. et enfin via le wiki, supprimer la page originale
  3. d'utiliser des liens symboliques (voir plus bas dans les modes d'éditions des modèles)

Syntaxe

Le contenu du fichier est le langage de balisage standard du wiki.

Motifs de remplacement

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

@ID@ identifiant (ID) complet de la page
@NS@ catégorie de la page
@PAGE@ nom de la page 1)
@!PAGE@ idem que précédemment mais avec la première lettre en majuscule
@!!PAGE@ idem que précédemment mais avec la première lettre de chaque mot en majuscule
@!PAGE!@ idem que précédemment mais avec toutes les lettres en majuscule
@FILE@ nom de la page 2)
@!FILE@ idem que précédemment mais avec la première lettre en majuscule
@!FILE!@ idem que précédemment mais avec toutes les lettres en majuscule
@USER@ identifiant de l'utilisateur qui créé la page
@NAME@ nom de l'utilisateur qui créé la page
@MAIL@ adresse email de l'utilisateur qui créé la page
@DATE@ date et heure à laquelle l'édition de la page a commencé
%a %d-%m-%y etc. N'importe quelle valeur d'strftime pour insérer la date au moment de la création dans un format personnalisable
%% N'oubliez pas de doubler les % pour que cela fonctionne. Ici, un caractère litéral % apparait dans le modèle

Exemples

Imaginons que vous ayez la structure suivante:

.../www/rep_de_dokuwiki/data/pages/

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/rep_de_dokuwiki/data/pages/
Donc: .../www/rep_de_dokuwiki/data/pages/__template.txt

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

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

  • En H1 le nom de la page déjà écrit (correspond à @PAGE@ : voir 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 exemple pour indiquer à l'utilisateur l'emplacement où il doit mettre son texte par exemple…

Imaginons maintenant que vous ayez la structure suivante:

.../www/rep_de_dokuwiki/data/pages/abc
.../www/rep_de_dokuwiki/data/pages/def
.../www/rep_de_dokuwiki/data/pages/ghi
.../www/rep_de_dokuwiki/data/pages/jkl

Vous souhaitez que chaque page créée dans chacun de ces espaces de noms soit différente de celles créées dans une autre.

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

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

tandis que dans l'espace de noms 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 à sa catégorie:

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

Enfin, si vous voulez qu'une template soit appliquée uniquement au niveau d'une catégorie (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ù vous souhaitez qu'il soit appliqué.

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

.../www/rep_de_dokuwiki/data/pages/abc/

et pas du tout sous:

.../www/rep_de_dokuwiki/data/pages/abc/xxx/

Extensions

Des fonctionnalités supplémentaires sont implémentés par des extensions pour les modèles de catégories.

  • L'extension TemplatePagename change les noms de _template et __template à votre choix dans les paramètres de configuration. Les valeurs par défaut sont respectivement c_template et i_template. Cette extension vous permet de choisir des pages wiki normales comme modèle afin qu'elles soient éditables via l'interface wiki.
  • L'extension NewPageTemplate ajoute un paramètre dans l'URL qui définit quelle page existant du wiki est chargée comme modèle. Chaque page autorisé par les ACLS est autorisé.
  • L'extension Snippets ajoute un bouton dans la barre d'édition qui vous permet d'insérer facilement des modèles à l'édition d'une page. Les modèles illustrés ont besoin d'être listés sur une page, par défaut snippets que vous pouvez renommer dans les paramètres de configuration.
  • L'extension Headerfooter ajoute le texte de l'en-tête ou du pied de page aux pages, uniquement lorsqu'elles sont affichées.

Support @GROUPS@

Il peut être intéressant de prendre en charge le motif de remplacement @GROUPS@ pour l'étendre à la liste de groupes de l'utilisateur qui crée la page (par exemple, pour spécifier un ensemble de balises sur la page d'accueil d'un utilisateur).

Le correctif suivant l'implémente.

Index: dokuwiki-2009-02-14/inc/common.php
===================================================================
--- dokuwiki-2009-02-14.orig/inc/common.php    2009-11-19 11:58:41.000000000 +0100
+++ dokuwiki-2009-02-14/inc/common.php 2010-01-05 10:17:35.000000000 +0100
@@ -840,6 +840,7 @@
                         '@USER@',
                         '@NAME@',
                         '@MAIL@',
+                        '@GROUPS@',
                         '@DATE@',
                      ),
                      array(
@@ -855,6 +856,7 @@
                         $_SERVER['REMOTE_USER'],
                         $INFO['userinfo']['name'],
                         $INFO['userinfo']['mail'],
+                        implode(" ", $INFO['userinfo']['grps']),
                         $conf['dformat'],
                      ), $tpl);

Olivier Mehani 2010/01/05 10:19

Édition de modèles

Cette section de documentation est ancienne mais apporte certaines explications intéressantes à conserver ici ou ailleurs.

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.

Modèles éditables par le biais de liens symboliques

De cette manière, vous pouvez stocker vos modèles dans une catégorie. 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 une catégorie appelée “modeles”, ou n'importe quel nom similaire.
  2. Dans cette catégorie, créez une page pour chaque modèle de catégorie 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 la catégorie que vous avez précédemment créé. Vous avez maintenant un modèle qui peut être modifié facilement par l'interface wiki.

Modèles éditables pour tous les utilisateurs

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 3).
  2. À présent n'importe quel utilisateur ayant un accès en écriture dans la catégorie peut y créer une page appelée “modele” 4) 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).

Modèles éditables (méthode dépréciée)

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 de catégorie avec l'URL doku.php?id=_template&do=edit. Note: Ceci ne semble fonctionner que pour le modèle de la catégorie 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 cette catégorie pourra créer une page appelée “template” dans cette catégorie, qui servira de modèle.

Crédits

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
Digitalin 2018-01-27 11:52

1)
l'ID sans la catégorie et avec les caractère de soulignement “_” remplacés par des espaces
2)
l'ID sans la catégorie, en conservant les caractères de soulignement “_”
3)
Lignes 811 et 812 dans la version 2009-02-14
4)
ou le nom que vous aurez choisi à l'étape 1
fr/namespace_templates.1524679294.txt.gz · Dernière modification : 2018-04-25 20:01 de Digitalin

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki