Table des matières
Comment puis-je ajouter une barre latérale (sidebar)?
Si vous utilisez le nouveau thème par défaut (ou n'importe quel autre thème qui supporte le menu latéral), vous avez déjà un menu latéral fonctionnel. Si vous utilisez un thème différent, il y deux façons d'ajouter cette fonctionnalité :
- choisir un thème livré avec un menu latéral. Voir Thème étiqueté avec 'sidebar' (ne pas traduire). Certains greffons ne sont peut être pas étiquetés avec 'sidebar', alors n'hésitez pas à parcourir la liste complete.
- installer un greffon qui ajoute un menu lateral à votre thème plugins tagged with 'sidebar'.
Il est préférable d'utiliser la première méthode ; le thème étant conçu avec le menu latéral à l'esprit, sa mise en page sera optimisée.
Je possède un menu latéral. Comment le créer et l'éditer ?
La plupart des thèmes utilisent une page wiki normale nommée 'sidebar'. Certains thème propose une option de configuration permettant de changer son nom. Depuis la version Adora Belle il existe une option de configuration intégrée sidebar que certains thèmes utilisent. D'autres thèmes proposent de gérer plusieurs menus latéraux, pouvant dépendre de la catégorie.
Dans le cas le plus probable ou le menu latéral est la page 'sidebar', il vous suffit de la créer pour l'afficher. Allez http://votre-wiki.com/doku.php?id=sidebar
, cliquez sur 'Créer cette page', rédiger votre menu, cliquez sur 'Enregistrer'.
Comment ajouter un menu de navigation automatique ?
Il est préférable d'installer un greffon étiqueté 'menu' ou un greffon étiqueté 'navigation'
Vous devrez probablement ajouter la macro ~~NOCACHE~~
lorsque le thème utilise un menu lateral qui change d'apparence en fonction de la page ou de la catégorie.
Mon menu latéral s'affiche mal ou sur-ligne les mauvaises parties
Il ne se met pas à jour correctement ou il sur-ligne les mauvaises parties.
Beaucoup de thèmes proposent des éléments dynamiques dans le menu latéral, comme sur-ligner la page active ou proposer un sous-menu.
Dans ce cas vous devez ajouter la macro ~~NOCACHE~~
pour empêcher DokuWiki de mettre en cache le menu latéral.
Le ~~NOCACHE~~
n'est plus nécessaire pour corriger la mise en évidence des liens après la sortie de Hogfather, car la mise en oeuvre a été remaniée pour utiliser en amont le mécanisme du frontal JavaScript.
Menu latéral par espaces de noms (catégories de pages)
Le menu latéral s'applique par défaut à toutes les pages dans l'espace de noms où la page sidebar est créée. Vous pouvez ainsi choisir où vous souhaitez avoir un menu latéral.
:sidebar
s'applique par défaut dans toutes les pages du wiki:*
:foo:sidebar
s'applique pour toutes les pages dans l'espace de noms:foo:*
Mais vous pouvez également avoir un menu latéral spécifique par espaces de noms (catégories de pages), “la plus proche page sidebar étant utilisée” comme expliqué dans la page sidebar. Il n'y a aucune limite pour créer un menu latéral différent par espace de noms dans le plan du site qui permet d'organiser la navigation. Par exemple :
:foo:sidebar
menu latéral pour l'espace de nomsfoo:*
:bar:sidebar
menu latéral pour l'espace de nomsbar:*
:foo:bar:sidebar
menu latéral dans l'espace:foo:bar:*
:foo:bar:baz:sidebar
menu latéral dans l'espace de noms:foo:bar:baz:*
Vous devez cependant vérifier que le thème que vous avez choisi supporte cette fonctionnalité, voir des fonctionnalités étendues, comme le fait par exemple le thème Bootstrap3 pour d'autres menus (rightsidebar, navbar, pageheader,….), le mécanisme s'appuyant sur les inclusions d'accroches DokuWiki.
Le contenu du menu latéral reste vide
Vous devez remplir la page «sidebar» avec des liens statiques et/ou des appels d'extensions de navigation. En principe, la page «sidebar» est à éditer et à remplir comme toute autre page du wiki. N'oubliez pas l'option ~~NOCACHE~~ mentionnée ci-dessus.
Pour certains utilisateurs, le menu latéral n'apparaît pas
L'utilisateur à qui le menu latéral doit être affiché doit avoir l'autorisation de lecture de la page «sidebar». Voir les listes de contrôle d'accès (ACLs)