Boîte de définition : Format, règles et exemples

Une boîte de définition donne au terme principal de la page une explication unique, précise et délimitée avant que l’article ne le développe. C’est un élément d’ouverture : un composant de contenu réutilisable qui apparaît près du début, car un lecteur ne devrait pas avoir à déduire le terme central à partir d’exemples, d’avantages ou de contexte.

Cet exemple concret est l’élément complet, pas un aperçu d’une définition plus bas dans la page. Son titre est facultatif ; son corps ne l’est pas. Le contrat de production ci-dessous détermine quand l’élément est approprié, ce que signifie chaque champ et comment le même contenu s’adapte aux différents systèmes de publication.

Pourquoi cet élément est important

Les lecteurs commencent rarement une page d’information en lisant chaque mot dans l’ordre. Ils parcourent le titre, les premières lignes, les titres et les blocs visuellement distincts pour décider si la page répond à leur question. Une définition enfouie dans un paragraphe d’introduction oblige le lecteur à séparer la réponse du contexte, des affirmations et de la mise en scène. La boîte supprime ce travail : sa délimitation dit « voici la définition ».

Cette délimitation donne également à la définition une position stable et adressable. Les rédacteurs savent où la vérifier, les modèles savent où la restituer, et les révisions futures n’obligent pas le lecteur ni un contrôle qualité à chercher dans plusieurs paragraphes d’ouverture. Un placement cohérent est important dans une bibliothèque car la même tâche informationnelle ne doit pas se déplacer de façon imprévisible d’une page à l’autre.

L’extractibilité machine est la capacité d’un logiciel à isoler une unité de contenu sans en perdre le sens. Une définition typée avec un titre et un corps peut être indexée, comparée, citée ou transformée indépendamment. Une phrase qui se trouve simplement définir un terme dans du texte libre se dissout dans le texte environnant : le logiciel doit deviner où la définition commence, où elle se termine et si l’affirmation qui précède en fait partie. Suivez les règles d’écriture des éléments pour que l’identité sémantique survive même lorsque le design visuel change.

Le texte doit toujours fonctionner sans la boîte. Le style crée un contraste pour les humains ; un sujet, un verbe et une signification distinctive autonomes créent l’extractibilité pour les machines. « C’est une méthode pour les améliorer » échoue lorsqu’il est retiré de son paragraphe. « Le content pruning est le processus de suppression, consolidation ou mise à jour des pages qui ne servent plus un objectif de recherche ou commercial utile » survit.

Quand l’utiliser

Utilisez une boîte de définition lorsque la page est organisée autour d’un seul terme et que ce terme peut être défini avec précision en une courte déclaration. Elle est obligatoire pour les formats de terme de glossaire et Qu’est-ce-que-X. Elle est également obligatoire pour les contenus de type diagnostic ou pathologie : le lecteur doit savoir ce qu’est la pathologie nommée avant d’envisager les causes, les tests ou les remèdes.

Les pages axées sur les symptômes et les guides pratiques utilisent rarement cet élément. Ajoutez-la uniquement lorsqu’une définition courte résout une ambiguïté réelle nécessaire à la tâche. Par exemple, un guide intitulé « Comment corriger la cannibalisation de mots-clés » peut définir la cannibalisation de mots-clés avant les étapes, car le diagnostic détermine quel correctif appliquer. Un guide intitulé « Comment changer une balise title » n’a pas besoin d’une boîte définissant une balise title si le public et l’instruction d’ouverture rendent déjà l’objet non ambigu.

N’utilisez pas de boîte de définition pour :

• Une introduction générale, un historique, une affirmation de bénéfice ou une explication de pourquoi le sujet est important. Ces passages développent l’article ; ils ne définissent pas le terme.
• Un résumé de la page. Un résumé rassemble plusieurs conclusions, tandis qu’une définition énonce la signification d’un seul terme.
• Une promesse produit comme « AmICited est le moyen le plus simple d’améliorer la visibilité ». C’est un positionnement, pas une définition vérifiable.
• Un avertissement, une mise en garde, un prérequis ou un conseil. Son rôle communicatif diffère même si un thème pourrait le faire ressembler au même panneau coloré.
• Un terme secondaire introduit au milieu de l’article. Définissez ce terme dans la phrase où il apparaît pour la première fois, ou donnez-lui sa propre page s’il mérite un traitement approfondi.
• Une citation dont l’autorité se substitue à la clarté. Attribuez une définition formelle dans le texte environnant lorsque l’attribution est nécessaire ; gardez la boîte lisible comme une déclaration directe.

L’erreur fréquente est une « introduction à la définition » : « Le taux d’attrition client est l’un des concepts les plus importants pour les entreprises par abonnement, et le comprendre peut transformer la croissance. » Cela dit que le concept est important mais ne dit jamais ce qu’il est. La boîte ne peut pas rendre précise une mise en scène vide.

Où le placer

Le placement encode la priorité. Placez la boîte de définition immédiatement après le paragraphe d’introduction ou la courte introduction, comme premier bloc de contenu. L’introduction établit pourquoi le lecteur est sur la page ; la boîte fixe ensuite le sens avant que les causes, exemples, avantages, étapes ou comparaisons n’en dépendent.

Ne placez pas de navigation, de table des matières, de points clés à retenir, de galerie d’images ou d’appel à l’action promotionnel entre l’introduction et la définition. Ces blocs obligent le lecteur à traverser du contenu non pertinent avant de recevoir le sens du terme. Le fil d’Ariane et le héros de page sont des éléments de modèle plutôt que du contenu rédigé, ils peuvent donc précéder l’introduction.

Utilisez une seule boîte de définition par page. Cette règle existe parce que le composant identifie l’objet définitionnel principal de la page. Deux boîtes créent deux termes principaux concurrents et rendent l’extraction ambiguë. Si les deux termes sont véritablement principaux, divisez le sujet en deux pages et reliez-les dans le texte. Si le second terme est subordonné, définissez-le en ligne plutôt que de le styliser comme une deuxième réponse canonique.

Un bloc de réponse directe peut coexister avec une définition uniquement lorsqu’il répond à une question principale différente. Sur une page de diagnostic, la définition peut énoncer ce qu’est la pathologie tandis que la réponse directe énonce la première action recommandée. Lorsque la question principale de la page est « Qu’est-ce que X ? », la réponse directe et la définition sont la même réponse. Fusionnez-les en une seule boîte de définition ; des versions adjacentes ne font que répéter le texte et se concurrencer pour l’extraction.

Anatomie

L’élément comporte deux zones rédigées et une relation structurelle. La capture d’écran doit montrer l’élément rendu sans intégrer de texte explicatif dans l’image ; la légende ci-dessous reste sélectionnable, accessible et maintenable lorsque le design change.

Légende du rendu

1. Titre facultatif : Généralement « Qu’est-ce que X ? » Il identifie le terme exact et ne doit pas ajouter une seconde affirmation.
2. Corps obligatoire : Une définition autonome qui nomme le terme, le place dans une catégorie utile et énonce ce qui le distingue.
3. Position d’ouverture : La boîte suit l’introduction et précède la première section explicative. Cette relation fait partie du contrat même si ce n’est pas un champ.

La bordure, l’arrière-plan, le remplissage, le traitement des icônes et la typographie appartiennent au moteur de rendu. Les auteurs fournissent le sens, pas les éléments visuels. L’élément doit rester compréhensible si tout le style décoratif est supprimé.

Exemples de design

La galerie couvre les variantes de contenu prises en charge plutôt que d’inventer différents types sémantiques. Chaque capture devrait réutiliser la même définition lorsque c’est possible afin que les réviseurs puissent juger du traitement du titre, du retour à la ligne du corps et du comportement selon la fenêtre d’affichage au lieu de comparer des textes différents.

Avec titre : La variante préférée lorsque le terme est inconnu, ambigu, abrégé ou différent du titre exact de la page.

Sans titre : Autorisé lorsque le titre de la page et l’introduction qui précède immédiatement rendent le sujet indubitable. Le corps doit toujours nommer le terme ; l’omission du titre ne permet jamais à des pronoms comme « il » de remplacer le sujet.

Longueur maximale : Le moteur de rendu affiche le corps complet. Il ne doit pas tronquer, réduire, faire défiler ou réduire la police pour s’adapter au contenu au maximum éditorial.

Fenêtre étroite : Le titre et le corps conservent leur ordre, une longueur de ligne lisible et une limite visible. Aucune signification ne peut dépendre d’une icône se déplaçant à côté du texte.

Paramètres

Les paramètres séparent le contenu de la présentation. Leurs limites maintiennent la comparabilité des définitions entre les pages et empêchent le composant de se transformer en un encart générique.

Paramètres de la boîte de définition

Le moteur de rendu peut dériver le terme pour l’indexation, mais les auteurs ne doivent jamais rédiger un corps qui dépend de l’affichage de ce champ dérivé. Une définition copiée doit nommer son sujet explicitement.

Syntaxe et exemples de code

Les trois formes portent le même titre et le même corps. La directive Markdown portable est la forme canonique rédigée ; Hugo et WordPress sont des adaptateurs. Les exemples utilisent délibérément un texte identique pour qu’un test de migration puisse comparer les valeurs, pas seulement l’apparence.

Directive Markdown portable

:::definition
## Qu'est-ce que le content pruning ?

Le content pruning est le processus de suppression, consolidation ou mise à jour des pages qui ne servent plus un objectif de recherche ou commercial utile.
:::

Le premier titre correspond à title ; tout ce qui suit correspond à body. Omettre le titre pour la variante sans titre, mais garder le terme dans le corps.

Shortcode Hugo

{{< callout type="note" title="Qu'est-ce que le content pruning ?" >}}Le content pruning est le processus de suppression, consolidation ou mise à jour des pages qui ne servent plus un objectif de recherche ou commercial utile.{{< /callout >}}

Le site réutilise le moteur de rendu d’encart existant pour le traitement Hugo visible. Le contrat de définition provient toujours de la source portable typée : note est ici un adaptateur de rendu, pas une permission de mettre des notes ordinaires dans les boîtes de définition.

Bloc ou shortcode WordPress

[definition title="Qu'est-ce que le content pruning ?"]Le content pruning est le processus de suppression, consolidation ou mise à jour des pages qui ne servent plus un objectif de recherche ou commercial utile.[/definition]

Une implémentation WordPress peut exposer les mêmes champs sous forme de bloc personnalisé. Les valeurs stockées restent title et body ; les contrôles d’édition, couleurs et espacements sont des paramètres de présentation et ne doivent pas altérer le sens de la définition.

Exemples

Cet exemple est bon car il nomme le terme, identifie la condition et énonce la conséquence distinctive. Il n’affirme pas que chaque paire de pages partageant un mot se fait concurrence ; l’expression « même intention de recherche » fournit la limite nécessaire. Le corps est utile sans le titre et assez court pour être cité intégralement.

Cet exemple est mauvais car il ne définit jamais la cannibalisation de mots-clés. Il offre de l’importance, un public, une urgence et un effet vague, mais aucune catégorie ou condition distinctive. Remplacer « l’un des plus importants » par « une situation où plusieurs pages se font concurrence pour la même intention de recherche » transforme la promotion en signification.

Un second mauvais modèle est la surcharge de la boîte : une définition suivie de causes, de cinq exemples, d’un avertissement et d’un outil recommandé. Même si la première phrase est exacte, le matériel supplémentaire détruit la limite stable. Gardez la définition ; déplacez les causes et les exemples dans la section suivante, l’avertissement dans son élément correct et la recommandation au point où le lecteur peut agir.

Balisage Schema et accessibilité

Une boîte de définition ne crée pas automatiquement une entité Schema.org autonome. Sur un article ordinaire, son texte reste partie intégrante de l’Article ou TechArticle englobant. Sur une page de glossaire, une implémentation de publication peut mapper le terme et la définition vers un vocabulaire approprié uniquement lorsque le site a adopté cette politique de schema. N’inventez pas de type DefinitionBox : il n’existe pas dans Schema.org.

De même, ne dupliquez pas le corps dans JSON-LD simplement parce que la boîte semble importante. Le balisage Schema doit décrire la page fidèlement, et dupliquer le texte visible dans une propriété non apparentée crée du bruit plutôt qu’un sens plus fort. Si une propriété schema est renseignée, sa valeur doit correspondre à la définition visible dans sa substance et être mise à jour avec elle.

L’élément n’a besoin d’aucun rôle ARIA interactif. Rendez-le dans l’ordre normal du document en tant que zone étiquetée ou conteneur sémantique, avec le titre avant le corps. N’utilisez pas role="alert", car une définition statique n’est pas une information urgente ou nouvellement arrivée. N’utilisez pas la couleur ou une icône comme seul signal que le bloc est une définition. Si le titre est implémenté comme un en-tête, son niveau doit suivre la hiérarchie de la page ; le ## de la source est une convention de mappage de champ, pas une instruction pour créer un saut d’en-tête invalide.

Le comportement au clavier est un comportement de lecture ordinaire : la boîte elle-même n’est pas focalisable. Tout lien à l’intérieur suit la sémantique normale des liens et nécessite une ancre descriptive. La sortie du lecteur d’écran doit préserver le même ordre titre-puis-corps visible à l’écran.

Règles d’écriture

Rédigez la définition avant d’écrire ses avantages. Commencez par le terme lui-même, puis utilisez un verbe de liaison tel que « est », « signifie » ou « se produit lorsque ». Énoncez la catégorie utile la plus proche et la caractéristique qui sépare le terme des concepts voisins. Cette séquence existe car une catégorie sans distinction est trop large, tandis qu’une distinction sans catégorie laisse le lecteur incertain du type de chose qu’est le terme.

Limitez le corps à environ 300 caractères maximum, espaces inclus. Privilégiez une seule phrase. Une seconde phrase courte n’est acceptable que lorsqu’une limite nécessaire ne peut pas être exprimée clairement dans la première. La limite est éditoriale, pas une invitation à comprimer la ponctuation, supprimer les articles ou accumuler les propositions. Si la précision nécessite plus d’espace, placez le cœur exact dans la boîte et qualifiez-le immédiatement après.

Utilisez un ton neutre et déclaratif. Évitez « important », « puissant », « révolutionnaire », « vous devez savoir » et autres jugements similaires. Évitez les définitions circulaires comme « l’optimisation de contenu est l’acte d’optimiser le contenu ». Développez les abréviations à leur première utilisation, sauf si l’abréviation elle-même est le terme de la page. Utilisez le même nom canonique que celui qui apparaît dans le titre de la page.

Ne placez jamais ce qui suit dans le corps :

• Plus d’un terme principal ou une liste de termes connexes.
• Avantages, historique, causes, symptômes, exemples, étapes, arguments de vente ou appels à l’action.
• Tableaux, images, vidéos, formulaires, boutons, notes de bas de page ou encarts imbriqués.
• Superlatifs non étayés, statistiques inventées ou affirmations nécessitant un paragraphe de preuves.
• Un second titre, une liste à puces ou une citation en bloc.
• Pronoms dont le sens dépend de l’introduction précédente.

Un lien d’attribution est l’exception, pas l’objectif. Utilisez-le uniquement lorsqu’une définition légale, scientifique ou basée sur une norme dépend d’une source nommée. Placez les citations longues et les désaccords entre sources dans le texte ordinaire, où le lecteur peut voir la nuance plutôt que de prendre un libellé contesté pour une définition universelle.

Types de posts qui l’utilisent

Les postTypes dans le frontmatter enregistrent les jonctions déclarées. Le tableau traduit ces jonctions en règles éditoriales. Les formats de type diagnostic/pathologie et axés sur les symptômes sont décrits ici comme modèles d’utilisation, mais ils ne sont pas liés en tant que types de posts distincts du playbook car ils ne figurent pas dans le registre canonique actuel.

Exigences par type de post

Pour les pages de type diagnostic ou pathologie, utilisez toujours la boîte et placez-la avant les symptômes, causes, gravité ou remèdes. Pour les pages axées sur les symptômes, utilisez-la uniquement lorsque le nom du symptôme a une définition véritablement courte et stable. Si la boîte ne fait que reformuler le titre — « Un site web lent est un site web qui est lent » — omettez-la et commencez par le seuil diagnostique ou le problème observable dans le texte.

Liste de vérification QA

Un relecteur vérifie le sens avant l’apparence. Une boîte soignée contenant une introduction vague reste une définition ratée.

• Un seul terme principal : La page et la boîte définissent exactement un concept principal.
• Position correcte : La boîte est le premier bloc de contenu rédigé après l’introduction, sans table des matières, points clés, galerie ou promotion insérés avant elle.
• Une seule occurrence : Aucune seconde boîte de définition ne concurrence la réponse canonique.
• Définition réelle : Le corps énonce ce qu’est le terme ou quand la condition existe ; il ne dit pas seulement pourquoi le terme est important.
• Formulation autonome : Le corps nomme son sujet et a un sens lorsqu’il est copié sans le texte environnant ni le style.
• Précision : La catégorie, la caractéristique distinctive et toute limite essentielle sont exactes. La formulation ne généralise pas excessivement.
• Longueur : Le corps ne dépasse pas environ 300 caractères et reste lisible plutôt que compressé.
• Contenu propre : Aucun avantage, historique, exemple, étape, argument commercial, média, tableau ou élément imbriqué n’apparaît à l’intérieur.
• Décision sur la réponse directe : Si la page demande « Qu’est-ce que X ? », la boîte de définition est le seul élément de réponse directe. Si les deux éléments apparaissent, ils répondent à des questions clairement différentes.
• Sémantique accessible : Le titre précède le corps, l’ordre des en-têtes est valide, la couleur n’est pas le seul identifiant, et aucun rôle d’alerte ou cible de focus inutile n’est présent.
• Parité portable : Les mappages Markdown, Hugo et WordPress conservent le même titre et la même définition.
• Retenue des données structurées : Toute valeur schema correspond au texte visible, et aucun type Schema.org inventé n’est utilisé.
• État des captures d’écran : Les commentaires restent des instructions de capture sans rendu jusqu’à ce que les fichiers nommés existent ; aucun chemin d’image inexistant n’est référencé comme image.

FAQ

Le modèle de l’académie affiche les cinq questions révisées stockées dans le frontmatter [[faq]] de cette page. Ensemble, elles couvrent la nécessité, la coexistence avec les réponses directes, les liens et citations, la limite de longueur et la règle d’une par page.