Skip to content

Navigation dynamique basée sur les collections

zer0-mistakes fournit un repli de navigation sans configuration : lorsqu'aucune entrée _data/navigation.yml personnalisée n'existe pour la barre de navigation, le thème découvre automatiquement vos collections Jekyll et génère un menu de navigation fonctionnel au premier lancement.

La barre de navigation supérieure avec le menu déroulant « Quick Start » ouvert, révélant les liens enfants générés automatiquement (Machine Setup, Jekyll Setup, GitHub Setup)

Pourquoi cela existe

Les nouveaux sites n'ont pas encore de données de navigation. Sans ce repli, les visiteurs verraient une barre de navigation vide. Le repli dynamique génère automatiquement des liens utiles afin que chaque nouveau site démarre avec une structure navigable.

Fonctionnement

graph TD
    A[Page render] --> B{navigation.yml entry?}
    B -- Yes --> C[Render static nav from data file]
    B -- No --> D[menu-collections.html fallback]
    D --> E[Iterate site.collections]
    E --> F[Skip hidden/system collections]
    F --> G[Render collection links]

Includes clés

Fichier Rôle
_includes/navigation/navbar.html Barre de navigation principale — vérifie les données, se rabat sur les collections
_includes/navigation/menu-collections.html Génère un lien par collection

Logique de la barre de navigation (simplifiée)

{% raw %}{% if site.data.navigation.main %}
  {% include navigation/nav_list.html nav=site.data.navigation.main %}
{% else %}
  {% include navigation/menu-collections.html %}
{% endif %}{% endraw %}

Configurer une navigation statique

Une fois prêt à figer le menu, créez _data/navigation.yml :

main:
  - title: "Home"
    url: "/"
  - title: "Docs"
    url: "/docs/"
  - title: "Posts"
    url: "/posts/"

Le repli est silencieusement désactivé dès que ce fichier est présent.

Exclure des collections du repli

Les collections préfixées par _ dans la configuration du site peuvent être masquées en définissant output: false ou en les ajoutant à la liste d'exclusion à l'intérieur de menu-collections.html :

{% raw %}{% unless collection.label == "notes" or collection.label == "quickstart" %}
  ...
{% endunless %}{% endraw %}

La barre latérale utilise une clé _data/navigation.yml distincte (docs, sidebar, etc.) et n'est pas affectée par le repli dynamique. Consultez le guide Navigation latérale pour plus de détails.

Voir aussi

Voir aussi

  • [[Features]]
  • [[Navigation]]