meta données pour cette page
La structuration de l'espace des pages pour les documents du wiki
(Préambule concernant la manière de nommer les pages, et la conséquence que cela a sur la structuration du Wiki)
Dans notre implémentation de DokuWiki, nous utilisons une barre latérale, appelée “sidebar”. Cette barre indexe automatiquement et dynamiquement le contenu de chaque catégorie de Premier niveau (détaillées juste après). Il est important de comprendre que, dans la sidebar, le nom d'affichage de chaque page n'est pas le nom réel de la page mais le premier titre écrit dans le texte de la page en question. Il est donc indispensable que le contenu de chaque page du TomoWiki commence par son nom, écrit en titre du plus haut niveau (Titre de niveau 1, dont la syntaxe est un texte encadré par 6 signes “égal” de part et d'autre).
En l'absence de base donnée dans DokuWiki, il est impératif, de respecter une organisation et une structuration strictes de l'espace des noms des différentes pages du wiki. Ces pages peuvent être des pages d'information au visiteurs, des pages principales de documents, des pages annexes de ces mêmes documents, …
DokuWiki utilise et gère le catégories pour une structuration hiérarchique de l'espace des pages et de leurs médias.
La vue “Plan du site” montre l'organisation hiérarchique réelle de ces catégories et pages :
Attention : La sidebar “fusionne” les catégories avec leurs pages d' “accueil” :
Pour Les-Tomos l'idée est d'utiliser plusieurs niveaux de catégories avec :
Premier niveau
- Une catégorie de premier niveau, réservée aux administrateurs du wiki : la catégorie
tomowiki
pour y placer, la page d'accueil, la charte et toutes les pages destinées à informer les visiteurs ou contributeurs
- Quelques rubriques générales de premier niveau qui permettent de distinguer les documents selon leur nature. Là aussi, leur création est réservée aux administrateurs du wiki, si vous pensez que le document que vous souhaitez publier aurait sa place dans un catégorie de premier niveau qui n'existe pas, parlez-en à l'équipe !
Les rubriques identifiées à ce jour sont :
- Documents de Synthèse
- Méthodes et techniques (de culture), comme les lasagnes, les purins, les greffes
- Tutoriels et pas à pas
- Équipements et outils, comme serres, pouponnières, …
- Encyclopédie
Deuxième niveau et au delà
Concernant le nommage, il est préférable de raccourcir les noms de toutes les sous-catégories. Cela a pour avantage de raccourcir les URL. En revanche, pour chaque catégorie, on crée une page du même nom, qui contient, au minimum, un titre 1 contenant le nom complet de la page. Ceci a pour but que l'affichage dans la sidebar soit lisible et qu'on arrive à naviguer efficacement. Au besoin, la page liée à la catégorie peut contenir du texte, par exemple, Les ennemis de la tomate de l'arsenal du jardinier bio est la page qui correspond à la catégorie “etajb”, le nom de la page est donc etajb, comme on peut le voir dans l'URL qui y mène : tomowiki/doku.php/documents_de_synthese/etajb
En revanche, dans TomoWiki, quand on fait référence à cette page, c'est son premier titre qui apparaîtra.
Exemple de nommage d'une arborescence complexe
Pour cet exemple j'utilise le document de synthèse “Les ennemis de la tomate et l'arsenal du jardinier bio” qui est en cours d'alimentation :
- Les traits rouges, bleus et noirs relient les catégories et les pages liées à celles-ci. On voit donc que la catégorie “etajb” est bien relié à la page “Les ennemis de la tomate et l'arsenal du jardinier bio” (dont le nom réel est etajb“ comme expliqué précédemment. On peut les considérer comme les pages d' “accueil” de chacune de ces catégories
- Les pages dont le nom se situe à côté d'un trait vert sont des documents des sous-catégories “betes”, “desequilibres” et “lmca”
- Les pages dont le nom est surligné en jaune sont des pages qui sont déjà créées en vue de servir de pages d' “accueil” reliées à des catégories.
En pointant sur “Les maladies cryptogamiques du sol” on voit qu'en bout d'URL il y à “lmcs” Dès qu'une page ayant pour URL …/etajb/et/lmcs/maladie_cryptogamique_du_sol_xxxxxxxxx aura été créée, alors, la sous-catégorie “lmcs” existera, et quand on cliquera dessus (dans la sidebar) on arrivera sur la page d' “accueil”.
Cette page a été consultée 1002 fois.