Table of Contents
Une table des matières construite à partir des titres de chaque article, avec des liens de saut. Rien à insérer pendant la rédaction.
Extension
Table of Contents
Une table des matières construite à partir des titres de chaque article, avec des liens de saut. Rien à insérer pendant la rédaction.
Installation
Deux étapes
- Dans l’administration d’EmDash, ouvrez Registry, recherchez Table of Contents et cliquez sur Install. Il ne demande aucune autorisation.
- Ouvrez Table of Contents dans le menu de gauche, allez dans l’onglet Setup et collez le court bloc qu’il affiche dans le head de votre mise en page de base, généralement
src/layouts/Base.astro. Si quelqu’un d’autre a créé votre site, envoyez-lui ce bloc.
C’est tout. Chaque article ou page avec suffisamment de titres reçoit une table des matières, et les rédacteurs n’ont rien à faire. L’onglet Settings définit le titre, les niveaux de titres pris en compte, l’emplacement de la liste et si elle démarre repliée.
Pour choisir vous-même l’emplacement exact, placez “ dans votre modèle d’article. Pour exclure un titre, donnez-lui data-toc-skip.
FAQ
Que fait ce plugin ?
Il lit les titres d’un article ou d’une page dans le navigateur du lecteur et affiche en haut une liste de liens de saut. Cliquer sur une ligne fait défiler jusqu’à cette section, la section en cours est signalée pendant la lecture, et la barre d’adresse reçoit le lien de la section pour qu’il puisse être partagé. Les rédacteurs n’insèrent rien.
Quels titres sont utilisés ?
À votre choix : H2 uniquement, H2 et H3, ou H2 à H4. Les lignes H3 se placent sous leur H2. Le H1 n’est jamais utilisé, car c’est le titre de l’article.
Mes titres n’ont pas d’id. Cela fonctionne-t-il quand même ?
Oui. Le plugin donne à chaque titre un id construit à partir de son texte lorsqu’il n’en a pas, de sorte que les liens fonctionnent sur n’importe quel thème.
Puis-je le désactiver sur un article court ?
La liste ne s’affiche que lorsqu’une page a au moins le nombre de titres que vous avez défini, trois par défaut. Pour toute une zone du site, utilisez Show on avec un début d’adresse tel que /posts.
Où se place-t-elle ?
Avant le premier titre, après le premier paragraphe, ou en haut de la zone de contenu. Si vous la voulez ailleurs, placez un élément vide avec data-toc dans votre modèle et elle s’y placera.
Un titre se cache sous mon menu fixe après un saut
Réglez Sticky header height dans Settings sur la hauteur de votre barre de menu en pixels.
Collecte-t-il quoi que ce soit ?
Non. Le plugin n’a pas accès à votre contenu et n’effectue aucune requête en dehors de votre site. Le seul appel est celui de votre site qui récupère ses propres paramètres.
Ralentit-il le site ?
Le script pèse environ 5 Ko, se charge une fois la page prête et est mis en cache pendant une minute. Rien n’est chargé depuis d’autres serveurs.
Journal des modifications
0.1.0
- Première version. Une table des matières construite à partir des titres de chaque article ou page, avec des liens de saut, un défilement fluide et la section en cours signalée.
- Paramètres : titre, niveaux de titres pris en compte, nombre minimal de titres, position, numérotation, démarrage replié, affichage partout ou sur les adresses commençant par un chemin, hauteur de l’en-tête fixe, zone de contenu.
- Placez-la vous-même avec
data-toc. Excluez un titre avecdata-toc-skip. - L’onglet Setup indique si le site charge la table des matières.