Sommaire et fil d'Ariane

Objectif : donner à une longue page une liste « sur cette page » et montrer aux visiteurs où ils sont.
Durée : 4 minutes
Il vous faut : une page avec plusieurs titres

1. Ancrez d'abord vos titres. Un sommaire liste les blocs Header qui ont un Anchor ID ; les titres sans ancre lui sont invisibles.
2. Modifiez chaque bloc Header à lister et remplissez Anchor ID. Utilisez des mots en minuscules reliés par des traits d'union : how-we-run-a-project.
3. Sélectionnez Add Block, puis TOC. Réglez le TOC Title — On this page est l'usage.
4. Placez-le vers le haut de la page, au-dessus du contenu qu'il décrit.
5. Sélectionnez Add Block, puis Breadcrumb. Réglez le Home label et décidez si le Current page item est inclus.
6. Enregistrez, puis vérifiez le résultat.

La liste, vous ne la tapez jamais. Le bloc TOC lit les blocs Header ancrés de la même page et bâtit la liste à partir d'eux, dans l'ordre de la page.

Elle ne se périme donc jamais : renommez un titre et l'entrée suit ; ajoutez une section et elle apparaît ; retirez l'ancre et elle disparaît. Cela veut aussi dire qu'un TOC vide n'est pas un bloc cassé — c'est une page sans titres ancrés.

• Une ancre est aussi une cible de lien. Dès qu'un titre en a une, vous pouvez pointer directement vers cette section depuis n'importe où.
• Gardez les ancres stables. En changer une casse tous les liens que quelqu'un a enregistrés vers cette section — même règle que pour le slug d'une page.
• Un sommaire sur une page courte est du bruit. Si le lecteur voit tous les titres sans faire défiler, la liste répète ce qui est déjà visible.
• Le fil d'Ariane est dérivé du chemin de la page : il reflète où la page se trouve réellement. Si la trace paraît fausse, c'est l'adresse de la page qu'il faut corriger.
• Les titres imbriqués dans des cards ou d'autres blocs ne sont pas listés. Le sommaire est une carte des sections de la page, pas de chaque titre qu'elle contient.