DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:faq:sidebar

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é :

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.

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 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 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)

fr/faq/sidebar.txt · Dernière modification : 2023-12-10 13:12 de 2a01:e34:ecb6:b600:b283:feff:fe63:d54f

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki