Mutualisation des contenus concernant les blocs

Topics

Dans les articles concernant les blocs, certains contenus sont répétés dans chacun des articles. Afin d’éviter cette répétition d’article en article, nous avons décidés de mutualiser ces contenus en créant des articles pour les informations qui concernent tous les blocs, et d’insérer des liens vers ces articles dans chaque article décrivant un bloc. De cette manière, dans les articles qui traitent des blocs se trouvent uniquement les informations spécifiques au bloc concerné, et toutes les informations qui concernent des fonctionnalités communes se trouvent dans ces articles « mutualisés ».

Pour mieux expliciter comment utiliser ces contenus mutualisés et les blocs réutilisables, voici une description du contenu d’un article concernant un bloc. L’utilisation de ce plan type implique un réagencement des blocs et/ou la suppression de nombreux blocs dans les articles sources en anglais pour ne garder que les éléments spécifiques au bloc concerné par l’article tout en renvoyant les lecteurs et lectrices vers les contenus mutualisés, via des blocs réutilisables.

Ne modifiez pas le contenu de ces blocs réutilisables. Ne les convertissez pas en blocs normaux, puisque l’objectif ici est aussi de simplifier la mise à jour des articles, au cas où les renvois devraient être modifiés.

Dans un premier temps, il vous faudra donc identifier tous les paragraphes et captures d’écran inutiles et les supprimer, puis dans un second temps, cerner les informations qu’il faudra ajouter, afin de suivre le plan type décrit ci-dessous.

Plan type d’un article concernant un bloc

Titre de l’article
Renvoi vers l’article listant tous les blocs
Introduction et comment ajouter un bloc
1. Barre d’outils du bloc
– Les outils communs
– Les outils spécifiques
2. Réglages du bloc
– Les réglages communs
– Les réglages spécifiques
– Les réglages avancés

Voyons en détail chaque élément.

Top ↑

Titre

Le titre de l’article est de la forme « Bloc Nom_du_bloc ». A vérifier dans l’outil d’insertion de blocs de la barre d’outils supérieure, là où sont présentés tous les blocs.

Top ↑

Renvoi vers la liste des blocs

Sous le titre, insérez le bloc réutilisable nommé Lien retour aux blocs qui renvoie vers l’article présentant tous les blocs proposés en natif.

Bloc réutilisable Lien retour aux blocs

Top ↑

Introduction

  1. Rédigez une courte introduction décrivant le bloc, comment il se présente, à quoi il sert, éventuellement ajoutez une capture d’écran d’un exemple ou laissez celle de la source…
  2. Insérez le bloc réutilisable Renvoi Ajout bloc, qui renvoie vers l’article Ajouter un nouveau bloc, ce qui évite d’expliquer comment ajouter un bloc dans chaque article décrivant un bloc.
Capture d’écran du bloc réutilisable Renvoi Ajout de bloc
Bloc réutilisable Renvoi Ajout bloc

Top ↑

La barre d’outils du bloc

  1. Veillez à mettre un titre de niveau h2 « Barre d’outils du bloc », suivi d’une capture d’écran de la barre d’outils.
  2. Puis insérez le bloc réutilisable Renvoi Barre d’outils des blocs, incluant un lien vers l’article Barre d’outils des blocs qui présente tous les outils communs aux différents blocs : outils de transformation de type ou de modification de style, de déplacement, outils d’alignement, contrôles de texte enrichis et options supplémentaires.
Capture d’écran du bloc réutilisable Renvoi Barre d’outils des blocs
Bloc réutilisable Renvoi Barre d’outils des blocs
  1. Présentez ensuite les outils spécifiques, insérez pour chaque outil (ou chaque groupe d’outils) spécifique un titre de niveau h3 en utilisant le libellé de l’outil, visible lors de son survol.

Par exemple pour le bloc Image, insérez un titre de niveau h3 « Recadrer » pour présenter l’outil de recadrage des images.

Top ↑

Les réglages du bloc

  1. Veillez à mettre un titre de niveau h2 « Réglages du bloc ».
  2. Insérez ensuite le bloc réutilisable Renvoi Réglages communs des blocs, incluant un lien vers l’article Réglages communs des blocs qui explicite comment afficher la colonne latérale des réglages et comment utiliser les réglages Typographie, Réglages de couleur, Styles.
Capture d’écran du bloc réutilisable Renvoi Réglages communs des blocs
Bloc réutilisable Renvoi Réglages communs des blocs
  1. Présentez ensuite tous les autres réglages non mentionnés dans l’article Réglages communs des blocs, et insérez pour chaque section de réglages un titre de niveau h3 reprenant le libellé utilisé dans la colonne latérale des réglages.

Par exemple pour le bloc Image, insérez un titre de niveau h3 « Réglages de l’image » pour décrire les différents réglages proposés.

  1. Enfin, ajoutez un titre de niveau h3 avec le libellé « Avancé », puis insérez le bloc réutilisable Renvoi Réglages avancés des blocs, incluant un lien vers l’article Réglages avancés des blocs qui décrit les réglages avancés des blocs (Ancre HTML, Classe(s) CSS additionnelle(s) et Attribut de titre) disponibles dans la section Avancé de la colonne latérale des réglages.
Capture d’écran du bloc réutilisable Renvoi Réglages avancés des blocs
Bloc réutilisable Renvoi Réglages avancés des blocs

Si vous rencontrez des difficultés à mettre en œuvre les renvois vers des articles mutualisés, n’hésitez pas à communiquer dans le canal #documentation-fr du slack WordPress-fr.

Dernière mise à jour :