DokuWiki

Modifiez cette page et cliquez sur « Enregistrer ». Voyez le guide de mise en page pour une aide à propos du formatage. Veuillez ne modifier cette page que si vous pouvez l'améliorer. Si vous souhaitez faire des tests, faites vos premiers pas dans le bac à sable.

====== Comment puis-je ajouter une barre latérale (sidebar)? ======

Si vous utilisez [[:fr:template:dokuwiki|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 [[:fr:template?plugintag=sidebar#extension__table|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 [[:fr:plugins?plugintag=sidebar#extension__table|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 [[:fr:page|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 [[fr:config:sidebar]] que certains thèmes utilisent. D'autres thèmes proposent de gérer plusieurs menus latéraux, pouvant dépendre de la [[:fr:namespaces|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 [[:fr:plugins?plugintag=menu#extension__table|greffon étiqueté 'menu']] ou un [[:fr:plugins?plugintag=navigation#extension__table|greffon étiqueté 'navigation']]

Vous devrez probablement ajouter [[:fr:wiki:syntax#macros|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 [[:fr:wiki:syntax#macros|la macro]] ''%%~~NOCACHE~~%%'' pour empêcher DokuWiki de mettre en [[:fr:caching|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 [[fr:config:sidebar|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 noms ''foo:*''
  * '':bar:sidebar'' menu latéral pour l'espace de noms ''bar:*''
  * '':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 [[template:bootstrap3#dokuwiki_hooks|Bootstrap3]]
pour d'autres menus (rightsidebar, navbar, pageheader,….), le mécanisme s'appuyant sur les [[fr:include_hooks|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 [[fr:acl|listes de contrôle d'accès (ACLs)]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain. Y E A P Q Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International