http://wiki.noordover.org : c'est nouveau et en phase de test !
[[ L'espace de nommage ]]
Cette notion semble complexe, il n'en est rien, en fait elle est plus simple que celle des noms de pages.
Le concept d'espace de nommage, ou espace de noms, de DokuWiki est très semblable au concept de la structure des répertoire des systèmes informatiques , mais au lieu de la barre de fraction ( ”\” sous Windows ou ”/” sous Linux), les deux points ( ”:” ) sont utilisés pour séparer les répertoires.
Ainsi ”c:\mes documents\mes courriers\ma lettre” localise sous Windows le fichier ”ma lettre” sur le disque ”c:”. Sous Linux on obtient la même information avec ”/mes_documents/mes_courriers/ma_lettre”, certes le disque n'est pas précisé mais c'est une information dont les systèmes Unix se passent aisément.
Sous DokuWiki on indique ”mes documents:mes courriers:ma lettre” - c'est tout ! Si vous avez bien saisi la notion de nom de page vous savez qu'une telle séquence mise entre doubles crochets ”[[mes documents:mes courriers:ma lettre]]” est un lien - conformément à la syntaxe wiki qui mène à la page enregistrée sur le disque dur du serveur web sous le nom ”ma_lettre.txt” à l'intérieur du répertoire ”mes_courriers” situé lui même dans le répertoire ”mes_documents” ce dernier étant dans le répertoire racine des pages sur le serveur.
Pour dire les choses simplement l'espace de nommage c'est le nom du répertoire courant - c'est tout … !
Nous pouvons donc dire que la page nommée ”mes documents:mes courriers:ma lettre” dans DokuWiki est située dans l'espace de nom ”mes courriers” lui même situé dans l'espace de nom ”mes documents” ce dernier étant localisé dans l'espace de nom … racine. On parle de chemin depuis la racine jusqu'au fichier.
Notez que les espaces de noms existent non seulement « théoriquement » à l’intérieur de la structure du wiki, mais également « physiquement » - la structure de répertoire sur le serveur ressemble exactement à la structure de l’espace de nom dans le wiki. Noter que le traitement des espaces de noms se fait par défaut de la même façon et pour les mêmes raisons que les noms de pages : les espaces sont éliminés, les accents et apostrophes enlevés, sauf modification dans le gestionnaire de configuration.
Créer des espaces de nommage c'est créer des répertoires
Sur DokuWiki la création d'un répertoire se justfie uniquement par la nécessité d'y héberger une page. C'est donc par l'opération de création de nouvelles pages que l'on crée “à la volée” de nouveaux répertoires (ou nouveaux espaces de noms). Pratiquement il n'y a aucun moyen de créer un répertoire vide - cela n'a d'ailleurs aucun intérêt.
Exemple : le nom de page ”a:b:c:nouvelle page” crée dans le répertoire racine des pages trois répertoires “emboîtés” ”a”, ”b” et ”c”, s'ils n'existent pas déjà , avant d'y mettre le fichier ”nouvelle_page.txt”. En pratique tous les répertoires et les pages du wiki sont situés dans le répertoire ”repertoire racine du site/data/pages/” du serveur. C'est ce répertoire qui est le répertoire racine pour les pages de DokuWiki, elles y sont toutes stockées sans exception, ainsi les utilisateurs ne risquent pas de polluer d'autres zones du site en créant de nouvelles pages.
OĂą suis-je ?
Dans DokuWiki il est toujours très facile de se localiser grâce au nom de page mais comment être certain que la nouvelle page que l'on veut créer va bien se trouver à l'endroit souhaité ?
Procéder de la façon suivante :
- un nom de page sans les deux points ( ”
:” ) crée la page dans l'espace de nom courant; - un nom de page précédé de deux points ( ”
:” ) se réfère toujours à l'espace de nom racine; - un nom de page précédé d'un point ( ”
.” ) se réfère à l'espace de nom situé en dessous de l'espace de nom courant;
Exemples
Les exemples de codes ci-dessous illustrent le cas d'une page située dans l'espace de nom “test” lui même situé dans l'espace de nom racine.
| Code inséré dans la page | Crée un page dans … | Nom de page obtenu | Commentaires |
|---|---|---|---|
[[ma page]] | → espace de nom courant | test:ma_page | on obtiendrait le même résultat avec [[test:ma page]] |
[[:ma page]] | → espace de nom racine | ma_page | cette syntaxe n'est en pratique utilisée que pour créer des pages dans l'espace de nom racine |
[[.testbis:ma page]] | → sous espace de nom ”testbis” de l'espace courant ”test” | test:testbis:ma_page | l'espace de nom ”testbis” est créé s'il n'existe déjà |
[[.ma page]] | → espace de nom courant | test:ma_page | est identique à [[ma page]] |
[[rep1:rep2:ma page]] | → espace de nom ”rep2” situé sous ”rep1” lui même situé dans l'espace de nom racine | rep1:rep2:ma_page | On aurait obtenu le même résultat avec ”[[:rep1:rep2:ma page]]” les deux espaces de nom sont créés s'ils n'existent déjà . |
Quoi que l'on fasse on crée toujours une page, jamais un répertoire vide. Faites des essais dans le bac à sable !
Supprimer un espace de nom
Cette suppression est automatique lorsque toutes les pages présentes dans un espace de nom sont supprimées.
Obtenir la liste des répertoires situés dans l'espace de nom racine
Utiliser le bouton ”Index” sur la page principale.