DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:namespace_templates

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
fr:namespace_templates [2018-04-25 20:01] – maj Digitalinfr:namespace_templates [2020-06-10 07:20] (Version actuelle) – [Motifs de remplacement] ajout nouveaux motifs Digitalin
Ligne 1: Ligne 1:
-:!: à 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 ====== ====== Modèles de catégorie ======
  
 Il peut vous arriver de souhaiter que toutes les pages d'un [[fr:namespaces|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.  Il peut vous arriver de souhaiter que toutes les pages d'un [[fr:namespaces|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,  Ceci peut facilement être réalisé grâce aux «modèles de pages». Lorsque vous créez une page, 
-[[fr:dokuWiki|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.+[[fr:dokuWiki|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 ===== ===== Fichiers modèles =====
Ligne 16: Ligne 9:
 Deux types de modèles peuvent être utilisés : Deux types de modèles peuvent être utilisés :
  
-  * ''_template.txt'' qui est utilisé dans l'espace de noms courant, et +  * ''%%_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.+  * ''%%__template.txt%%'' (notez les deux caractères de soulignement) qui fonctionne comme le premier, 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é. 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 [[fr:dokuWiki|DokuWiki]], vous pouvez choisir :+Comme vous ne pouvez pas créer et modifier le fichier ''%%_template.txt%%'' directement dans [[fr:dokuWiki|DokuWiki]], vous pouvez choisir :
  
    - d'utiliser une extension comme [[plugin: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    - d'utiliser une extension comme [[plugin: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
   - d'utiliser le wiki pour sauver une page dans l'espace de noms approprié, avec le contenu que vous voulez utiliser comme modèle,   - d'utiliser le wiki pour sauver une page dans l'espace de noms approprié, avec le contenu que vous voulez utiliser comme modèle,
-      - 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%%''+      - 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%%''
       - et enfin via le wiki, supprimer la page originale       - et enfin via le wiki, supprimer la page originale
-  - d'utiliser des liens symboliques (voir plus bas dans les [[#Édition de modèles|modes d'éditions des modèles]])+  - d'utiliser des liens symboliques (voir plus bas dans les [[#Modèles éditables par le biais de liens symboliques]])
  
  
Ligne 39: Ligne 32:
 ^ @ID@     | identifiant (ID) complet de la page                                                                                         | ^ @ID@     | identifiant (ID) complet de la page                                                                                         |
 ^ @NS@     | catégorie de la page | ^ @NS@     | catégorie de la page |
 +^ @CURNS@  | dernier élément de la catégorie de la page |
 +^ @!CURNS@ | idem que précédemment mais avec la première lettre en majuscule  |
 +^ @!!CURNS@ | idem que précédemment mais avec la première lettre de tous les mots en majuscule  |
 +^ @!CURNS!@ | idem que précédemment mais avec tous les caractères en majuscule  |
 ^ @PAGE@   | nom de la page ((l'ID sans la catégorie et avec les caractère de soulignement "_" remplacés par des espaces))               | ^ @PAGE@   | nom de la page ((l'ID sans la catégorie et avec les caractère de soulignement "_" remplacés par des espaces))               |
 ^ @!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 en majuscule                                                             |
Ligne 130: Ligne 127:
 .../www/rep_de_dokuwiki/data/pages/abc/xxx/ .../www/rep_de_dokuwiki/data/pages/abc/xxx/
 </code> </code>
 +
 +===== Modèles éditables par le biais de liens symboliques =====
 +
 +//**NOTE: Les instructions contenues dans cette section concernent une utilisation sur des serveurs Linux et ne fonctionneront pas sur un serveur Windows.**//
 +
 +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.
 +
 +  - Créez une catégorie appelée "​modeles",​ ou n'​importe quel nom similaire.
 +  - Dans cette catégorie, créez une page pour chaque [[fr:namespace_templates|modèle de catégorie]] que vous souhaitez rendre disponible.
 +  - 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éée. Vous avez maintenant un modèle qui peut être modifié facilement par l'​interface wiki.
 +
 +Une autre manière consiste à créer un lien symbolique dans le répertoire lui-même. Ainsi vous créez un ''template.txt'' lequel est un lien de ''%%_template.txt%%'', dans son propre espace de noms.
 +
 +  cd /var/www/html/dokuwiki/data/pages/namespace/something
 +  ln -s _template.txt template.txt
 +  
 +For these softlinks to work, you might need the FollowSymLinks option set for this directory in your webserver's configuration.
 +
 +Pour que ces liens fonctionnent, vous pourriez avoir besoin de l'option FollowSymLinks définie pour ce répertoire dans la configuration de votre serveur Web.
 +
 +//**NOTE: Cette section contient des instructions à utiliser sur un serveur Windows et ne fonctionneront sous système Linux.**//
 +
 +Ouvrez l'invite de commande (cmd.exe) sur le serveur, et naviguez jusqu'à l'endroit où vous vous trouvez avec un modèle. Utilisez la commande MKLINK pour créer un lien symbolique.
 +
 +  cd c:\inetpub\wiki\data\pages\namespace\something
 +  mklink template.txt _template.txt
 +
  
 ===== Extensions ===== ===== Extensions =====
Ligne 135: Ligne 159:
 Des fonctionnalités supplémentaires sont implémentés par des extensions pour les modèles de catégories. Des fonctionnalités supplémentaires sont implémentés par des extensions pour les modèles de catégories.
  
-  * L'extension [[plugin: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 [[plugin: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 [[plugin: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 [[fr:acl|ACLS]] est autorisé.    * L'extension [[plugin: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 [[fr:acl|ACLS]] est autorisé. 
Ligne 176: Ligne 200:
  --- //[[shtrom-doku@ssji.net|Olivier Mehani]] 2010/01/05 10:19//  --- //[[shtrom-doku@ssji.net|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 [[:namespace_templates|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. 
- 
-  - Créez une catégorie appelée "modeles", ou n'importe quel nom similaire. 
-  - Dans cette catégorie, créez une page pour chaque [[fr::namespace_templates | modèle de catégorie]] que vous souhaitez rendre disponible. 
-  - 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. 
- 
-  - 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'' ((Lignes 811 et 812 dans la version 2009-02-14)). 
-  - À 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" ((ou le nom que vous aurez choisi à l'étape 1)) 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 
-<code>  global $INFO;</code> 
-puis vers la ligne 98 (celle avec trim() ), remplacez par  
-<code>  $id = ($INFO['perm'] == 255 ? trim($id,':.-') : trim($id,':._-';))</code> 
- 
-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. 
  
  
Ligne 221: Ligne 209:
  --- //Laynee 2008/08/25 13:04//\\  --- //Laynee 2008/08/25 13:04//\\
  --- //[[bertrand.v@univup.com|Bertrand Villien]] 2009-07-07 01:40//\\  --- //[[bertrand.v@univup.com|Bertrand Villien]] 2009-07-07 01:40//\\
- --- //[[user>Digitalin|Digitalin]] //2018-01-27 11:52//+ --- //[[user>Digitalin|Digitalin]] //2018-01-27 11:52// \\  
 + --- [[user>Digitalin|Digitalin]] //2018-05-03 22:03// \\ 
 + --- [[user>schplurtz|Schplurtz le Déboulonné]] //2019-05-01 18:51// 
  
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