Contentelementen: de bouwstenen van elke pagina
Gebruik een beheerde bibliotheek van definities, antwoorden, stappen, vergelijkingen, bewijs, meldingen, navigatie- en conversieblokken, zodat elke sectie zijn functie behoudt over auteurs, pagina's, machines en CMS'en heen.
Een element is een contentcontract
Een benoemd, getypeerd, geparametriseerd blok definieert wat erin hoort, hoeveel het mag bevatten, waar het mag verschijnen en wat systemen ermee mogen doen.
- ✓Benoemd naar doel — definitie, waarschuwing, vergelijking, bron en CTA beschrijven taken in plaats van visuele stijlen.
- ✓Begrensd door parameters — labels, items, citaten, varianten en limieten voorkomen dat geïmproviseerde structuren afdrijven.
- ✓Geplaatst volgens regel — een openingsantwoord, waarschuwing in de tekst, afsluitend bronnenblok en volgende-stap-CTA bezetten verschillende delen van een document.
- ✓Gerenderd per kanaal — één element kan semantische HTML worden in Hugo, een native WordPress-blok, gestructureerde data of een feedrecord.
Wat een contentelement is
Vrije tekst slaat zinnen op. Een contentelement slaat zinnen op plus een expliciete beschrijving van wat die zinnen doen.
Een auteur voegt een H2 toe met de titel "Wat is churn?", gevolgd door een alinea, en geeft de eerste zin mogelijk vetgedrukt weer. Een lezer kan afleiden dat het een definitie is. Het contentsysteem ziet alleen een kop en proza.
Niets registreert of de definitie canoniek is, of deze bij de opening moet staan, welke term hij definieert, hoe lang hij mag zijn, of een ander kanaal hem mag hergebruiken.
De auteur voegt een definition-element in met een term, een beknopte body en een optionele kwalificatie. Het elementcontract regelt plaatsing, toegankelijke opmaak, lengte en presentatie.
Een sjabloon kan het renderen, een audit kan het vinden, een migratie kan het mappen en een antwoordsysteem kan de definitie onderscheiden van de omringende uitleg.
Een element is een benoemd, getypeerd, geparametriseerd contentblok. "Benoemd" geeft het een stabiele identiteit. "Getypeerd" verbindt het met gedrag. "Geparametriseerd" betekent dat de betekenisvolle delen velden zijn in plaats van een ongedifferentieerde klomp. Het bevat ook positioneringsregels, contentlimieten, varianten, toegankelijkheidseisen, schemamapping en kwaliteitscontroles.
Dit elimineert proza niet. Een definitie, waarschuwing of bronnotitie vereist nog steeds precieze formulering. Het elimineert dubbelzinnigheid over de taak van het proza. Taal kan variëren terwijl het contract wordt nageleefd, net zoals verschillende records verschillende gegevens bevatten terwijl ze één schema delen.
Waarom elementen beter zijn dan contentbriefings
Een proza-briefing kan de gewenste pagina beschrijven. Getypeerde elementen behouden de belangrijke beslissingen nadat de briefing het scherm van de redacteur verlaat.
Het doel is niet dat elke pagina er identiek uitziet. Het is dat herhaalde functies voorspelbaar werken. Een casestudy en een woordenlijstpagina kunnen verschillende stemmen en lay-outs hebben terwijl hun bronnen opvraagbaar blijven en hun gerelateerde-contentblokken beheerd blijven.
De voorrangsregel voor elementen
Als het doel van een element overeenkomt met wat de sectie doet, is dat element verplicht — zelfs als een kop en alinea dezelfde woorden zouden kunnen weergeven. Vrije tekst is de terugvaloptie, niet de standaard.
Zoek niet alleen naar het label in de structuur. "Klinische overwegingen" kan een waarschuwing verbergen. "In één oogopslag" kan belangrijkste conclusies betekenen. Benoem de lezerstaak: definiëren, samenvatten, waarschuwen, vergelijken, instrueren, bewijzen, navigeren of converteren.
Controleer vervolgens de doelen. Een overeenkomend doel heeft voorrang op een aangepaste kop, omdat het type de functie behoudt buiten de zichtbare pagina.
Vrije tekst is juist voor analyses, overgangen, voorbeelden en uitleg zonder herbruikbaar contract. Het moet elementen verbinden en het argument ontwikkelen, niet een bestaande component nabootsen.
Als een patroon in vrije tekst zich herhaalt, leg het dan vast voor bibliotheekbeoordeling. Herhaling kan een ontbrekend element onthullen, maar auteurs moeten geen officieuze componenten pagina voor pagina creëren.
| Koptekst in de structuur | Doel | Vereiste keuze | Wat proza verliest |
|---|---|---|---|
| "Wat is X?" | Geef één afgebakende betekenis | definitiekader | De definitie kan niet betrouwbaar worden gescheiden van de context. |
| "Wanneer hulp zoeken" of "contra-indicaties" | Risico, consequentie en veilige handeling benoemen | waarschuwingskader | Een stopconditie heeft geen waarschuwingssemantiek. |
| Een praktische kanttekening | Optioneel uitvoeringsadvies bieden | tipkader | De kanttekening concurreert met of verdwijnt in verplichte stappen. |
| De samenvatting bovenaan | Onderbouwde conclusies tonen | belangrijkste conclusies | Een losse lijst heeft geen plaatsing, limiet of samenvattende betekenis. |
| Een lijst om af te vinken | Voortgangsstatus bijhouden | Checklist-element | Opsommingstekens maken geen onderscheid tussen acties, observaties of status. |
Het checklist-voorbeeld is niet gelinkt omdat de detailspecificatie bij een latere bibliotheekgolf hoort. De voorrangsbeslissing is nog steeds van toepassing: gebruik een goedgekeurde checklist-implementatie waar het CMS deze biedt; verhul voltooiingsstatussen niet als decoratieve opsommingstekens.
Getypeerde blokken vs platte tekst
De zichtbare zin is identiek. De getypeerde versie behoudt identiteit en velden die downstream-systemen kunnen gebruiken zonder te raden.
Klantverloop is het verlies van klanten of abonnees gedurende een gemeten periode.
Opgeslagen als
{ "heading": "Wat is klantverloop?",
"html": "<p>Klantverloop is…</p>" }Machine-output: kop en generieke HTML. Definitiestatus, term, plaatsing en hergebruik zijn onbekend.
Klantverloop is het verlies van klanten of abonnees gedurende een gemeten periode.
Opgeslagen als
{ "type": "definition",
"term": "klantverloop",
"body": "Klantverloop is…",
"position": "opening" }Machine-output: een bekende definitie met adresseerbare velden, validatie, semantische rendering, schemamapping en feedgeschiktheid.
Het verschil is functioneel, niet cosmetisch. Vervang de component door een kop en alinea en de lezer merkt mogelijk niets, terwijl het systeem validatie, analyses, schemamapping, migratielogica en portfoliocontroles verliest. Het vervangen van een getypeerd element door vrije tekst is functieverlies.
De elf elementgroepen
Elke live kaart weerspiegelt de playbookFamily-metadata van de onderliggende pagina. Aantallen beschrijven de gepubliceerde elementbibliotheek, gepland voor latere golven.
Eerst lezen — de voorrangsregel die elk ander element beheert.
Het record dat identiteit, vindbaarheid en schema aanstuurt.
Het eerste scherm: antwoord, samenvatting, definitie, oriëntatie.
Definitiekader · Direct Antwoordblok · Versheidsstempel · Intro-Haak · Conclusiekader · Inhoudsopgave · Voor Wie Is Dit? Doelgroepblokregels
De blokken die het argument dragen.
Accordeon · Opsommingslijsten · Checklist · Aangepaste Lijsten · Beslissingsboom · Do's en Don'ts · Regels voor Vrije Tekstparagrafen · Kopsysteem · Icoonkader · Afbeeldingskader · Infobox · Infobox · Stappenlijsten · Tabbladen / Persona-Wisselaar · Tijdlijnen · Zigzag-Secties
Gestructureerde feiten die zowel een lezer als een machine kan gebruiken.
Calculator-Inserts · Grafiekblokken · Vergelijkingstabellen · Prijsstabellen · Voor- en Nadelenblokken · Scorekaarten · Specificatietabellen · Statistiekbanden
Tips, notities en waarschuwingen — spaarzaam of helemaal niet gebruiken.
Afbeeldingen, video, diagrammen en hun tekstuele equivalenten.
Geanoteerde Screenshots · Audio- en Podcast-Inserts · Diagrammen en Illustraties · Afbeeldingsgalerij · Inline Afbeeldingen · Inline Video · Video-Inserts
Product, prijs, beschikbaarheid en samenstelling.
Beschikbaarheidsblokken · Samenstellingsblokken · Aanbiedingskaders · Productkaarten · Productschuivers
Auteurschap, beoordeling, citatie en sociaal bewijs.
Auteursbioblock · Disclaimerkader · Pull-citaat en Expertcitaat · Beoordeeld-door-blok · Beoordelingsblokken · Bronnen en Verwijzingen · Getuigenissen · Vertrouwensbadges en Certificeringen · Updatelog
Links, ankers en de volgende actie.
Ankerlinks · Kruimelpaden · CTA-Blokken · Woordenlijstterm-Links en Tooltips · Inline CTA-Knop · Interne Linkmodules · Minibanner · Nieuwsbriefregistratie · Gerelateerde Contentblokken
Openingstijden, adres, kaart en boeking.
Boekingsblokken · Openingstijden en Contactblokken · Kaartblokken · NAP-Blokken
Hoe een pagina eindigt en wat er daarna wordt gevraagd.
Eén element, drie formaten
Elk element heeft één conceptueel contract en adapters voor draagbare Markdown, Hugo en WordPress.
Neem een tip met een titel en body van optioneel advies. Het doel, de toegestane inhoud, de toegankelijkheidsrol, de positie en de kwaliteitscontroleregels blijven constant. Alleen de notatie verandert.
:::tip{title="Houd de query stabiel"}
Wijzig één variabele tegelijk.
:::Leesbaar in bron en onafhankelijk van een sitethema.
{{< callout type="tip" title="Houd de query stabiel" >}}
Wijzig één variabele tegelijk.
{{< /callout >}}De adapter wijst benoemde velden toe aan de goedgekeurde component.
<!-- wp:amicited/tip
{"title":"Houd de query stabiel"} -->
<p>Wijzig één variabele tegelijk.</p>
<!-- /wp:amicited/tip -->Native editorbesturing behoudt hetzelfde type en dezelfde velden.
Draagbaarheid is niet het kopiëren van gerenderde HTML. Elke adapter accepteert dezelfde betekenisvolle invoer, handhaaft gelijkwaardige beperkingen en produceert kanaalgeschikte output. Als een veld niet veilig kan worden toegewezen, moet de adapter zichtbaar falen of een gecontroleerde terugval documenteren; het mag betekenis niet stilzwijgend weggooien.
Wat er op elke elementpagina staat
Elke detailpagina is openbare richtlijn en een productiespecificatie. Het verwijdert gissingen die anders in elke implementatie terugkeren.
| Gebied | Beantwoorde vraag | Voorkomen fout |
|---|---|---|
| Doel en niet-doel | Welke taak voert het uit, en welke vergelijkbare taak hoort elders? | Een tip die een verplichte stap bevat of een definitie die een mini-artikel wordt. |
| Parametertabel | Welke velden zijn verplicht, optioneel, getypeerd, herhaalbaar en beperkt? | Adapters die verschillende gegevens accepteren of meerdere ideeën verborgen in één veld. |
| Positieregels | Waar mag het verschijnen, hoe vaak en waarnaast? | Conclusies die halverwege de pagina begraven liggen of bronnen los van beweringen. |
| Variantengalerij | Welke benoemde variaties bestaan er en wanneer is elke geschikt? | Visuele eenmalige oplossingen die zich voordoen als officiële varianten. |
| Goed versus fout | Wat doet een correct voorbeeld dat een plausibele fout mist? | Teams die syntax kopiëren maar het doel missen. |
| Schema-mapping | Hoe worden velden toegewezen aan HTML, toegankelijkheid, schema, API's en feeds? | Zichtbare content die niet overeenkomt met machine-output. |
| Kwaliteitscontrole | Wat kan automatisering afdwingen en wat vereist beoordeling? | Een geldig blok dat publiceert met vage, onjuiste, verouderde of misplaatste content. |
Automatisering kan verplichte velden, aantallen, lengtes, plaatsing, identificatiecodes, URL's en adapterondersteuning controleren. Redactionele kwaliteitscontrole moet nauwkeurigheid, bruikbaarheid, bewijskwaliteit, proportionele nadruk en of het element juist is voor de taak van de lezer controleren.
Welke elementen zijn vereist
Verplicht betekent dat het systeem de functie verwacht in vrijwel elk volledig posttype. Het betekent niet dat elk blok groot of identiek moet zijn.
- Frontmatter vestigt identiteit, eigenaarschap, vindbaarheid en koppelingen.
- Introductie bevestigt reikwijdte en of de lezer past.
- Belangrijkste conclusies tonen onderbouwde conclusies op substantiële pagina's.
- FAQ beantwoordt echte resterende vragen.
- Bronnen maken feitelijke ondersteuning traceerbaar.
- Gerelateerde content biedt de volgende leerroute.
- CTA biedt één proportionele actie.
- Gebruik een definitie wanneer een term een afgebakende betekenis nodig heeft.
- Gebruik een direct antwoord voor een duidelijke primaire vraag.
- Gebruik stappen voor een geordende procedure en verifieerbaar resultaat.
- Gebruik vergelijkingen wanneer lezers alternatieven beoordelen op consistente criteria.
- Gebruik een tip voor optionele verbetering en een waarschuwing voor materieel risico.
- Gebruik geannoteerde media wanneer het visuele iets communiceert dat proza niet zo efficiënt kan.
Uitzonderingen zijn belangrijk. Een korte woordenlijstdefinitie heeft mogelijk geen aparte conclusies nodig. Een pagina zonder extern onderbouwde feitelijke bewering heeft mogelijk geen zichtbare verwijzingen nodig. Een FAQ met verzonnen vragen is slechter dan geen. Posttypespecificaties stellen standaarden in; auteurs documenteren gerechtvaardigde weglatingen in plaats van mechanisch hokjes te vullen.
Begin met de relevante posttypes-specificatie, die de gebruikelijke elementen ordent voor de taak van de lezer. Pas vervolgens de voorrang sectie voor sectie toe. Het resultaat is noch een lege pagina, noch een rigide formulier: het is een beheerde samenstelling met ruimte voor originele argumentatie, bewijs, voorbeelden en stem.
Getypeerde elementen laten een agent assembleren in plaats van verzinnen
De elementbibliotheek is waar een contentsysteem ophoudt een document te zijn en wordt wat een machine kan uitvoeren. Een blok met gedeclareerde velden heeft ofwel wat het nodig heeft, of het heeft dat zichtbaar niet.
Een vergelijkingstabel heeft vergelijkbare opties, een vermelde dimensie per rij en een verificatiedatum nodig. Wanneer een van die invoerwaarden niet bestaat, geeft een getypeerd blok de agent een plek om luid te falen.
Vrij proza heeft die eigenschap niet. Gevraagd om een tabel zonder onderliggende gegevens, produceert een agent nog steeds een tabel, en de verzonnen cel ziet er precies uit als een onderzochte.
Doorzoek de bibliotheek op doel voordat je een kop schrijft. Die instructie wordt veel betrouwbaarder opgevolgd door een agent dan door een persoon onder tijdsdruk, omdat een agent elke keer oprecht de hele bibliotheek opnieuw zal lezen.
Dit is een geval waarin de agent de betere operator is: de regel is mechanisch, en mechanisch is waar agents voor zijn.
Elk element wordt eenmalig gedefinieerd en uitgedrukt als een draagbare Markdown-richtlijn, een Hugo-shortcode en een WordPress-blok. De agent werkt met de draagbare vorm en hoeft nooit te weten in welk CMS de output terechtkomt.
Dat betekent ook dat het wijzigen van een CMS het contentsysteem niet ongeldig maakt en niet vereist dat de agent opnieuw wordt getraind.
Omdat elementen getypeerd zijn, kan het corpus worden doorzocht. Welke pagina's missen een bronnenblok. Welke vergelijkingstabellen hebben geen verificatiedatum. Welke directe antwoorden overschrijden hun limiet.
Je kunt die audit alleen uitvoeren op content die is samengesteld uit benoemde blokken. Proza is niet doorzoekbaar, dus proza-gebaseerde kwaliteitscontrole schaalt niet verder dan het aantal pagina's dat een persoon kan lezen.
Elke elementpagina heeft een parametertabel met verplichte velden, minima en maxima, positie regels en een kwaliteitscontrolelijst. Dat is het precisieniveau dat een agent nodig heeft om te bouwen zonder te gissen — en dezelfde precisie maakt de output beoordeelbaar door een mens in een fractie van de tijd.
Contentelementen FAQ
Een contentelement is een benoemd, getypeerd, geparametriseerd blok met een gedefinieerd doel, toegestane velden, positie regels, lengtebeperkingen, weergavegedrag en kwaliteitscontroles. Het slaat content en functie op.
Gebruik vrije tekst wanneer geen bibliotheekelement overeenkomt met het doel. Analyse, verhalen, overgangen en unieke uitleg blijven vaak proza; gevestigde definities, waarschuwingen, vergelijkingen, bronnen en CTA's niet.
Nee. Het contract standaardiseert structuur en functie, niet conclusies of stem. Auteurs kiezen nog steeds argumenten, bewijs, voorbeelden en formulering.
Ja. Het draagbare contract is onafhankelijk van presentatie. Adapters wijzen dezelfde velden toe aan native syntax en opmaak terwijl validatie en semantiek behouden blijven.
Bouw één pagina uit blokken die je op schaal kunt beheren
Gratis check · 7 dagen proefperiode · creditcard vereist