Aller au contenu principal


Le menu Navigation des "livres"

Ce billet trace les 4 étapes suivies pour créer le menu de navigation qui s'affiche au bas des pages faisant partie d'un "livre" ("book" dans le jargon Drupal" : pages qui traitent d'un même thème pour mon site) et dont l'image ci-dessous est une illustration :

 

Cliquer pour agrandir l'image

Billet créé le :
26 nov 2020

 

  1. Activer le module "book" ;

  2. Créer au moins un livre et deux pages ;

  3. Adapter (définir) les templates (gabarits) aux besoins du site ;

  4. Adapter (définir) le style du menu.

 

1. Activer le module Book

Ce module faisant partie du cœur de Drupal, il suffit de l'activer (par le lien /admin/modules).

2. Créer un livre ou des pages d'un livre

Dans la page "ajouter un contenu", nous disposons dans la partie droite (cf : illustration ci-jointe) d'un formulaire permettant de manipuler la hiérarchie des livres.

Dans la zone déroulante, un clic sur "créer un nouveau livre" fait de la page en cours la racine d'un nouveau livre dont le nom sera le titre de la page.

Cliquez pour agrandir l'image

3. Adapter les templates

Les templates "book-tree.html.twig" et "book-navigation.html.twig" sont les modèles utilisés pour l'affichage du menu. Ils se trouvent par défaut dans le dossier "/core/themes/claro/templates/classy/navigation" (ou "/core/themes/classy/template/navigation"  pour une version <10 de Drupal).

Ils doivent être copiés dans le dossier "template" de votre thème pour être adaptés.

book-tree.html.twig  rend l'affichage de la zone 1 de l'image figurant dans l'introduction de ce billet ;

book-navigation.html.twig rend l'affichage de la zone 2 ;

L'affichage de la zone 3 provient du plugin jQuery "tooltip" appliqué sur les éléments "title" des liens.

4. Adapter le style

Pour cela, il faut adapter (ou définir) des classes CSS. Dans mon installation, elles sont regroupées dans le fichier "breadcrumb.css"