Éléments de contenu : les blocs qui composent chaque page
Utilisez une bibliothèque encadrée de blocs de définitions, réponses, étapes, comparaisons, preuves, notifications, navigation et conversion pour que chaque section conserve sa fonction à travers les auteurs, les pages, les machines et les CMS.
Un élément est un contrat de contenu
Un bloc nommé, typé et paramétré définit ce qui lui appartient, combien il peut contenir, où il peut apparaître et ce que les systèmes peuvent en faire.
- ✓Nommé par objectif — définition, avertissement, comparaison, source et CTA décrivent des rôles plutôt que des styles visuels.
- ✓Délimité par paramètres — étiquettes, éléments, citations, variantes et limites empêchent les structures improvisées de dériver.
- ✓Positionné par règle — une réponse d'ouverture, un avertissement dans le flux, un bloc de sources en fermeture et un CTA pour l'étape suivante occupent différentes parties d'un document.
- ✓Rendu par canal — un même élément peut devenir du HTML sémantique dans Hugo, un bloc WordPress natif, des données structurées ou un enregistrement de flux.
Ce qu'est un élément de contenu
Le texte libre stocke des phrases. Un élément de contenu stocke des phrases plus un compte rendu explicite de ce que ces phrases font.
Un auteur ajoute un H2 intitulé « Qu'est-ce que le churn ? », le fait suivre d'un paragraphe, et peut mettre la première phrase en gras. Un lecteur peut en déduire qu'il s'agit d'une définition. Le système de contenu ne voit qu'un titre et de la prose.
Rien n'enregistre si la définition est canonique, si elle doit être près de l'ouverture, quel terme elle définit, combien de temps elle peut durer, ou si un autre canal peut la réutiliser.
L'auteur insère un élément definition avec un term, un body concis et un qualificatif optionnel. Le contrat de l'élément contrôle le placement, le balisage accessible, la longueur et la présentation.
Un modèle peut le restituer, un audit peut le trouver, une migration peut le mapper, et un système de réponse peut distinguer la définition de l'explication environnante.
Un élément est un bloc de contenu nommé, typé et paramétré. « Nommé » lui donne une identité stable. « Typé » le connecte à un comportement. « Paramétré » signifie que ses parties significatives sont des champs plutôt qu'un blob indifférencié. Il comporte également des règles de position, des limites de contenu, des variantes, des exigences d'accessibilité, des mappages de schémas et des contrôles qualité.
Cela n'élimine pas la prose. Une définition, un avertissement ou une note de source nécessite toujours une écriture précise. Cela élimine l'ambiguïté sur le rôle de la prose. La langue peut varier tout en honorant le contrat, tout comme différents enregistrements contiennent des données différentes tout en partageant un même schéma.
Pourquoi les éléments surpassent les briefs de contenu
Un brief en prose peut décrire la page souhaitée. Les éléments typés préservent ses décisions importantes après que le brief a quitté l'écran du rédacteur.
L'objectif n'est pas que chaque page se ressemble. Il s'agit que les fonctions répétées se comportent de manière prévisible. Une étude de cas et une page de glossaire peuvent avoir des voix et des mises en page différentes tandis que leurs sources restent interrogeables et que leurs blocs de contenu connexe restent encadrés.
La règle de précédence des éléments
Si l'objectif d'un élément correspond à ce que fait la section, cet élément est obligatoire — même si un titre et un paragraphe pourraient afficher les mêmes mots. Le texte libre est la solution de repli, pas la valeur par défaut.
Ne cherchez pas uniquement l'étiquette dans le plan. « Considérations cliniques » peut cacher un avertissement. « En un coup d'œil » peut signifier des points clés. Nommez la tâche du lecteur : définir, résumer, avertir, comparer, instruire, prouver, naviguer ou convertir.
Consultez ensuite les énoncés d'objectif. Un objectif correspondant prend le pas sur un titre personnalisé car le type préserve la fonction en dehors de la page visible.
Le texte libre est approprié pour les analyses, les transitions, les exemples et les explications sans contrat réutilisable. Il doit connecter les éléments et développer l'argumentation, non pas imiter un composant existant.
Si un motif de texte libre se répète, enregistrez-le pour un examen de la bibliothèque. La répétition peut révéler un élément manquant, mais les auteurs ne doivent pas créer de composants non officiels page par page.
| Libellé du plan | Objectif | Choix requis | Ce que la prose perd |
|---|---|---|---|
| « Qu'est-ce que X ? » | Donner un sens délimité | encadré de définition | La définition ne peut pas être séparée de manière fiable du contexte. |
| « Quand consulter » ou « contre-indications » | Énoncer le risque, la conséquence et l'action sécurisée | encadré d'avertissement | Une condition d'arrêt n'a pas de sémantique d'avertissement. |
| Un aparté pratique | Offrir un conseil d'exécution facultatif | encadré conseil | L'aparté entre en concurrence avec les étapes obligatoires ou disparaît à l'intérieur de celles-ci. |
| Le résumé en haut | Faire apparaître les conclusions étayées | points clés | Une liste sans contrainte n'a pas de sens de placement, de limite ou de résumé. |
| Une liste à cocher | Suivre les états d'achèvement | Élément liste de contrôle | Les puces ne distinguent pas les actions des observations ou du statut. |
L'exemple de la liste de contrôle n'est pas lié car sa spécification détaillée appartient à une vague ultérieure de la bibliothèque. La décision de précédence s'applique quand même : utilisez une implémentation approuvée de liste de contrôle là où le CMS la fournit ; ne déguisez pas les états d'achèvement en puces décoratives.
Blocs typés vs texte brut
La phrase visible est identique. La version typée conserve l'identité et les champs que les systèmes en aval peuvent utiliser sans deviner.
Le churn client est la perte de clients ou d'abonnés au cours d'une période mesurée.
Stocké comme
{ "heading": "Qu'est-ce que le churn client ?",
"html": "<p>Le churn client est…</p>" }Sortie machine : titre et HTML générique. Le statut de définition, le terme, le placement et la réutilisation sont inconnus.
Le churn client est la perte de clients ou d'abonnés au cours d'une période mesurée.
Stocké comme
{ "type": "definition",
"term": "churn client",
"body": "Le churn client est…",
"position": "ouverture" }Sortie machine : une définition connue avec des champs adressables, une validation, un rendu sémantique, un mappage de schéma et une éligibilité aux flux.
La différence est fonctionnelle, pas cosmétique. Remplacez le composant par un titre et un paragraphe, le lecteur peut ne rien remarquer, tandis que le système perd la validation, les analyses, le mappage de schéma, la logique de migration et les requêtes de portefeuille. Remplacer un élément typé par du texte libre est une perte de fonction.
Les onze groupes d'éléments
Chaque carte active reflète les métadonnées playbookFamily des pages enfants. Les décomptes décrivent la bibliothèque d'éléments publiée, prévue pour les vagues ultérieures.
À lire en premier — la règle de précédence qui régit tous les autres éléments.
L'enregistrement qui pilote l'identité, la découverte et le schéma.
Le premier écran : réponse, résumé, définition, orientation.
Encadré de définition · Bloc de réponse directe · Cachet de fraîcheur · Accroche d'introduction · Encadré de points clés · Table des matières · À qui s'adresse ce contenu ? Règles du bloc d'audience
Les blocs qui portent l'argumentation.
Accordéon · Listes à puces · Liste de contrôle · Listings personnalisés · Arbre de décision · À faire et à ne pas faire · Règles des paragraphes en texte libre · Système de titres · Boîte à icônes · Boîte à images · Infobox · Infobox · Listes d'étapes · Onglets / Commutateur de persona · Chronologies · Sections en zigzag
Faits structurés qu'un lecteur et une machine peuvent tous deux utiliser.
Intégrations de calculateurs · Blocs de graphiques · Tableaux comparatifs · Tableaux de prix · Blocs avantages et inconvénients · Tableaux de bord · Tableaux de spécifications · Bandos statistiques
Conseils, notes et avertissements — utilisés avec parcimonie ou pas du tout.
Encadré de note · Notification · Encadré conseil · Encadré d'avertissement
Images, vidéos, diagrammes et leurs équivalents textuels.
Captures d'écran annotées · Intégrations audio et podcast · Diagrammes et illustrations · Galerie d'images · Images en ligne · Vidéo en ligne · Intégrations vidéo
Produit, prix, disponibilité et composition.
Blocs de disponibilité · Blocs de composition · Encadrés d'offre · Fiches produits · Curseurs de produits
Paternité, relecture, citation et preuve sociale.
Bloc biographie auteur · Bloc de clause de non-responsabilité · Citation en exergue et citation d'expert · Bloc révisé par · Blocs d'avis · Sources et références · Témoignages · Badges de confiance et certifications · Journal des mises à jour
Liens, ancres et action suivante.
Liens d'ancrage · Fil d'Ariane · Blocs CTA · Liens de termes de glossaire et infobulles · Bouton CTA en ligne · Modules de liens internes · Mini-bannière · Capture de newsletter · Blocs de contenu connexe
Horaires, adresse, carte et réservation.
Blocs de réservation · Blocs d'horaires et de contact · Blocs cartographiques · Blocs NAP
Comment une page se termine et ce qu'elle demande ensuite.
Un élément, trois formats
Chaque élément a un contrat conceptuel unique et des adaptateurs pour le Markdown portable, Hugo et WordPress.
Considérez un conseil avec un titre et un corps de recommandation facultative. Son objectif, son contenu autorisé, son rôle d'accessibilité, sa position et ses règles qualité restent constants. Seule la notation change.
:::tip{title="Gardez la requête stable"}
Changez une variable à la fois.
:::Lisible dans la source et indépendant du thème du site.
{{< callout type="tip" title="Gardez la requête stable" >}}
Changez une variable à la fois.
{{< /callout >}}L'adaptateur mappe les champs nommés vers le composant approuvé.
<!-- wp:amicited/tip
{"title":"Gardez la requête stable"} -->
<p>Changez une variable à la fois.</p>
<!-- /wp:amicited/tip -->Les contrôles natifs de l'éditeur préservent le même type et les mêmes champs.
La portabilité ne consiste pas à copier du HTML rendu. Chaque adaptateur accepte la même entrée significative, applique des contraintes équivalentes et produit une sortie adaptée au canal. Si un champ ne peut pas être mappé en toute sécurité, l'adaptateur doit échouer visiblement ou documenter un repli contrôlé ; il ne doit pas supprimer silencieusement le sens.
Ce que contient chaque page d'élément
Chaque page détaillée est un guide public et une spécification de production. Elle élimine les incertitudes qui autrement reviennent à chaque implémentation.
| Domaine | Question répondue | Échec évité |
|---|---|---|
| Objectif et non-objectif | Quel rôle remplit-il, et quel rôle similaire appartient ailleurs ? | Un conseil contenant une étape obligatoire ou une définition devenant un mini-article. |
| Tableau des paramètres | Quels champs sont obligatoires, facultatifs, typés, répétables et limités ? | Des adaptateurs acceptant des données différentes ou plusieurs idées cachées dans un seul champ. |
| Règles de position | Où peut-il apparaître, à quelle fréquence et à côté de quoi ? | Des points clés enterrés au milieu de la page ou des sources détachées des affirmations. |
| Galerie des variantes | Quelles variations nommées existent et quand chacune est-elle appropriée ? | Des solutions visuelles ponctuelles se faisant passer pour des variantes officielles. |
| Bon versus mauvais | Que fait un exemple conforme qu'un échec plausible manque ? | Des équipes copiant la syntaxe tout en manquant l'objectif. |
| Mappage de schéma | Comment les champs sont-ils mappés vers HTML, accessibilité, schéma, API et flux ? | Un contenu visible en désaccord avec la sortie machine. |
| AQ | Que peut automatiser l'automatisation et qu'est-ce qui nécessite du jugement ? | Un bloc valide publié avec un contenu vague, faux, obsolète ou mal placé. |
L'automatisation peut vérifier les champs obligatoires, les décomptes, les longueurs, le placement, les identifiants, les URL et la compatibilité des adaptateurs. L'assurance qualité éditoriale doit vérifier l'exactitude, l'utilité, la qualité des preuves, l'emphase proportionnée et si l'élément est adapté à la tâche du lecteur.
Quels éléments sont requis
Obligatoire signifie que le système attend la fonction dans essentiellement chaque type de publication complet. Cela ne signifie pas que chaque bloc doit être volumineux ou identique.
- Frontmatter établit l'identité, la propriété, la découverte et les relations.
- Introduction confirme la portée et l'adéquation au lecteur.
- Points clés font apparaître les conclusions étayées sur les pages substantielles.
- FAQ résout les vraies questions résiduelles.
- Sources rendent le support factuel traçable.
- Contenu connexe fournit la prochaine voie d'apprentissage.
- CTA propose une action proportionnée.
- Utilisez une définition quand un terme nécessite un sens délimité.
- Utilisez une réponse directe pour une question principale claire.
- Utilisez des étapes pour une procédure ordonnée et un résultat vérifiable.
- Utilisez des comparaisons lorsque les lecteurs évaluent des alternatives selon des critères cohérents.
- Utilisez un conseil pour une amélioration facultative et un avertissement pour un risque matériel.
- Utilisez des médias annotés lorsque le visuel communique quelque chose que la prose ne peut pas faire aussi efficacement.
Les exceptions comptent. Une courte définition de glossaire peut ne pas nécessiter de points clés séparés. Une page sans affirmation factuelle soutenue par des sources externes peut ne pas nécessiter de références visibles. Une FAQ avec des questions inventées est pire que pas de FAQ du tout. Les spécifications des types de publications définissent des valeurs par défaut ; les auteurs documentent les omissions justifiées au lieu de remplir mécaniquement les cases.
Commencez par la spécification des types de publications pertinente, qui ordonne les éléments habituels pour la tâche du lecteur. Appliquez ensuite la règle de précédence section par section. Le résultat n'est ni une page vierge ni un formulaire rigide : c'est un assemblage encadré avec de la place pour l'argumentation originale, les preuves, les exemples et la voix.
Les éléments typés permettent à un agent d'assembler au lieu d'inventer
La bibliothèque d'éléments est l'endroit où un système de contenu cesse d'être un document et devient quelque chose qu'une machine peut exécuter. Un bloc avec des champs déclarés a soit ce dont il a besoin, soit il ne l'a pas visiblement.
Un tableau comparatif a besoin d'options comparables, d'une dimension indiquée par ligne et d'une date de vérification. Quand l'une de ces entrées n'existe pas, un bloc typé donne à l'agent un endroit où échouer de manière visible.
La prose libre n'a pas cette propriété. Si on demande un tableau sans données derrière, un agent produit quand même un tableau, et la cellule inventée ressemble exactement à une cellule documentée.
Consultez la bibliothèque par objectif avant d'écrire un titre. Cette instruction est suivie beaucoup plus fidèlement par un agent que par une personne sous pression, car un agent relira véritablement toute la bibliothèque à chaque fois.
C'est un cas où l'agent est le meilleur opérateur : la règle est mécanique, et le mécanique est ce pour quoi les agents sont faits.
Chaque élément est défini une fois et exprimé sous forme de directive Markdown portable, de shortcode Hugo et de bloc WordPress. L'agent travaille avec la forme portable et n'a jamais besoin de savoir dans quel CMS la sortie atterrit.
Cela signifie aussi que changer de CMS n'invalide pas le système de contenu et ne nécessite pas de réapprendre à l'agent.
Parce que les éléments sont typés, le corpus peut être interrogé. Quelles pages manquent d'un bloc de sources. Quels tableaux comparatifs n'ont pas de date de vérification. Quelles réponses directes dépassent leur limite.
Vous ne pouvez effectuer cet audit que sur du contenu assemblé à partir de blocs nommés. La prose n'est pas interrogeable, donc le contrôle qualité basé sur la prose ne passe pas à l'échelle au-delà du nombre de pages qu'une personne peut lire.
Chaque page d'élément comporte un tableau de paramètres avec les champs obligatoires, les minimums et maximums, les règles de position et une liste de contrôle qualité. C'est le niveau de précision dont un agent a besoin pour construire sans deviner — et cette même précision rend la sortie vérifiable par un humain en une fraction du temps.
FAQ sur les éléments de contenu
Un élément de contenu est un bloc nommé, typé et paramétré avec un objectif défini, des champs autorisés, des règles de position, des limites de longueur, un comportement de rendu et des contrôles qualité. Il stocke le contenu et la fonction.
Utilisez le texte libre quand aucun élément de la bibliothèque ne correspond à l'objectif. Les analyses, les récits, les transitions et les explications uniques restent souvent en prose ; les définitions établies, les avertissements, les comparaisons, les sources et les CTA ne le sont pas.
Non. Le contrat standardise la structure et la fonction, pas les conclusions ni la voix. Les auteurs choisissent toujours leurs arguments, preuves, exemples et formulations.
Oui. Le contrat portable est indépendant de la présentation. Les adaptateurs mappent les mêmes champs vers la syntaxe et le balisage natifs tout en préservant la validation et la sémantique.
Construisez une page à partir de blocs que vous pouvez gouverner à grande échelle
Vérification gratuite · Essai de 7 jours · carte de crédit requise