Outils du site

Prendre une décision, c'est transformer le doute en incertitude. [Inconnu]

56-tools:dokuwiki:start

DokuWiki

Références

Présentation

dokuwiki est un logiciel libre (PHP) qui permet de créer des wikis assez facilement. Il n'utilise pas de bases de données.

Il offre :

Mise en route

Création de pages

La création et la suppression des pages peut être déroutante au début. Pour créer une page il existe plusieurs façons :

  • Créer un lien vers la page à créer, puis cliquer sur ce lien puis cliquer sur le bouton en haut à droit “Créer cette page”
  • Rechercher le nom de la page à créer. Dans la page des résultats de recherche, cliquer sur le bouton en haut à droit “Créer cette page”
La philosophie de dokuwiki semble être qu'une page n'a de sens que si elle est référencée dans le site. De ce fait on doit d'abord créer la référence à la page avant de créer la page

Suppression de pages

Pour supprimer une page, il faut l'éditer et en supprimer le contenu.

Penser à supprimer si besoin les références à cette page.

Les namespaces

Le namespace (espace de nommage) est ce qui permet d'organiser un site dokuwiki. C'est une manière de classifier les informations par domaine.

Un namespace est équivalent à un dossier.

Un namespace contient :

  • 0 ou plusieurs namespaces
  • 0 ou plusieurs pages

Un namespace se définit par un nom collé et précédant le nom de la page, le tout étant séparé par des “:” :

namespace_1:…:namespace-n:ma_page

Exemple :

Je peux parler d'administration Linux mais aussi d'aministration Windows, j'ai alors deux solutions :
  - créer deux pages : admin_linux.txt et admin_windows.txt :-( too bad!!!
  - créer deux namespaces :linux et windows puis deux pages linux:admin.txt et windows:admin.txt ^_^

Bien entendu, je peux définir des contexte (namespace) qui contiennent des contexte :
  * Linux 
    * administration 
    * développement 
      * C
      * Java
  * Cuisine 
    * Desserts 
    * Entrées 

Dans Dokuwiki les namespaces se traduisent par des dossier physique :

  • Linux:administration:ma_page

devient sur le disque dur :

  • Linux/administration/ma_page

Le nommage des namespace et des pages

Il semble que Dokuwiki remplace les majuscule par des minuscules dans les noms de pages, namespace et médias, à moins de cocher l'option “Camelcase” dans la configuration dokuwiki.

Pour ne pas être embêté, il est conseillé d'utiliser uniquement des noms en minuscule avec des “-” ou “_”.

Organiser les pages

A mesure qu'un site grandi il est nécessaire de le réorganiser.

Pour organiser les namespaces et les pages il existe des plugins qui rendent la tache plus facile.

Compléments

Ce wiki est réalisé grâce à dokuwiki.

Voici quelques informations pour customiser dokuwiki.

Voici une page type avec l'ensemble des tags et styles disponibles Démo Tags+CSS

Plus j'utilise DokuWiki, plus j'apprends à la connaitre et plus je l'apprécie par sa puissance et sa simplicité. =)
Dernière modification : 2017/10/06 23:40