Ce qui était autrefois probablement considéré comme un territoire de plugins est maintenant une réalité dans le cadre du projet Gutenberg. Hier, l’équipe a fusionné une demande d’extraction pour une table des matières (TOC) dans la base de code du plugin. C’était une contribution du développeur Zebulan Stanphill, qui a commencé il y a près d’un an.

Le bloc TOC peut sembler un peu niche. Cependant, il est manifestement nécessaire. Il existe au moins deux plugins de blocs autonomes pour gérer la fonctionnalité, et plusieurs plugins de bibliothèques de blocs la couvrent. La semaine dernière, un lecteur interrogé sur une telle solution. Bientôt, le plugin Gutenberg et, éventuellement, WordPress le couvriront, lui et d’autres.

Le bloc n’est actuellement pas disponible dans le plugin sur WordPress.org. Il n’a pas encore été officiellement expédié. Pour le tester, les utilisateurs devront soit cloner le Dépôt Gutenberg GitHub ou récupérez un fichier ZIP du bêta nocturne. Il devrait atterrir dans Gutenberg 10.1 dans les prochaines semaines pour ceux qui veulent attendre.

L’inclusion de ces blocs plus de niche est une bonne direction pour le projet – un Bloc de notes de bas de page est également une possibilité. Bien que cela puisse donner l’impression de marcher sur les orteils des développeurs de plugins, WordPress doit se diversifier. Il y a beaucoup de place pour les développeurs tiers pour construire d’autres blocs. L’expérience est dégradée lorsque les utilisateurs doivent passer au crible une multitude de plugins pour trouver quelque chose de essentiel à leur processus d’écriture. Il y a des limites sur les blocs qui devraient finalement être inclus dans la plate-forme. Cependant, WordPress publie des logiciels. Les fonctionnalités d’écriture avancées, telles que les tables des matières et les notes de bas de page, font partie intégrante de la configuration par défaut.

Le bloc Table des matières

Ce bloc est un peu différent des autres blocs auxquels les utilisateurs sont habitués. Une table des matières est une liste de tous les titres d’un document. Dans le cas de WordPress et des pages Web en général, une table des matières renvoie à ces en-têtes. Cela permet aux utilisateurs de parcourir la page. Le bloc dépend d’autres blocs du contenu, un concept légèrement nouveau pour l’éditeur de blocs.

Lors de l’ajout du bloc pour la première fois à une page vide, il affichera un message d’aide.

État initial du bloc Table des matières, affichant un message d'aide pour ajouter des titres avec des ancres HTML.
Bloc TOC initial lorsqu’aucun bloc d’en-tête n’est présent.

Les utilisateurs doivent commencer à ajouter des blocs d’en-tête dans leur message pour utiliser le bloc de table des matières. Une fois qu’ils sont ajoutés, chaque titre est affiché sous forme d’élément de liste. Le bloc imbrique également correctement les éléments de liste pour les sous-en-têtes – un H3 entre dans une sous-liste sous un H2, par exemple.

Le bloc de table des matières se remplit automatiquement à mesure que de nouveaux en-têtes sont ajoutés au contenu de l'article dans l'éditeur.
Les en-têtes deviennent des éléments de liste dans le bloc TOC.

C’est le moment où les choses deviennent plus complexes. Sur le Web, une table des matières doit être liée à ces en-têtes afin que les lecteurs puissent accéder à la section qu’ils souhaitent consulter. À l’heure actuelle, cela ne se fait pas automatiquement. Peut-être le fera-t-il à l’avenir, mais les utilisateurs doivent ajouter manuellement des ancres HTML pour que la partie de liaison fonctionne. Idéalement, le message d’aide initial serait lié au page de documentation sur la façon de procéder pour les nouveaux utilisateurs.

L’ajout d’ancres HTML est facile. Cependant, cela pourrait être une tonne de travail pour de longs messages avec des dizaines de titres.

Pour ajouter l’ancre, les utilisateurs doivent cliquer sur chaque titre et accéder au panneau d’options de bloc. Sous l’onglet Avancé, entrez un ID unique. Il est plus facile de nommer cela d’après le texte lui-même. Un bloc de titre avec « Un nouveau monde » obtient une ancre de a-new-world. Cela aide également lorsque d’autres créent des liens profonds vers des articles, créant de plus jolies URL, telles que yoursite.com/blog/post-name/#a-new-world.

Ajout de liens d'ancrage pour les blocs d'en-tête, qui apparaissent sous forme de liens dans le bloc de table des matières.
Ajout d’ancres aux blocs d’en-tête.

Le bloc TOC n’a aucun paramètre de conception. Si les utilisateurs doivent modifier les couleurs ou d’autres éléments liés à la conception, il est préférable de l’envelopper dans un autre bloc, tel que Groupe ou Couverture.

Regroupement du bloc Table des matières en un bloc Groupe dans l'éditeur WordPress.
Emballage de la table des matières dans un bloc de groupe.

Si vous ajoutez un en-tête pour le bloc Groupe ou avant le bloc Table des matières, il sera ajouté à la liste. Il est préférable d’utiliser le bloc Paragraphe comme un faux en-tête et modifiez la taille de la police.

Dans l’ensemble, le bloc fonctionne bien. À l’exception de l’insertion manuelle des ancres, c’est un ajout bienvenu. Peut-être qu’un auteur de plugin viendra et écrira le code pour le rendre automatique.


Source link