Definitiekader: opmaak, regels en voorbeelden

Een definitiekader geeft het belangrijkste begrip van de pagina één exacte, afgebakende uitleg voordat het artikel het verder uitwerkt. Het is een openingselement: een herbruikbare contentcomponent die aan het begin verschijnt, omdat een lezer het centrale begrip niet uit voorbeelden, voordelen of achtergrondinformatie hoeft af te leiden.

Dat live voorbeeld is het volledige element, geen teaser voor een definitie verderop in de pagina. De titel is optioneel; de inhoud niet. Het productiecontract hieronder bepaalt wanneer het element hoort, wat elk veld betekent en hoe dezelfde content wordt gemapt over publicatiesystemen heen.

Waarom dit element belangrijk is

Lezers beginnen zelden een informatieve pagina door elk woord in volgorde te lezen. Ze scannen de titel, openingsregels, koppen en visueel afgescheiden blokken om te beslissen of de pagina hun vraag beantwoordt. Een definitie die in een inleidende alinea is weggestopt, dwingt de lezer het antwoord te scheiden van context, beweringen en sfeerbepaling. Het kader neemt dat werk uit handen: de grens zegt ‘dit is de definitie’.

Die grens geeft de definitie ook een stabiele, adresseerbare positie. Redacteuren weten waar ze deze moeten controleren, sjablonen weten waar ze deze moeten weergeven en toekomstige herzieningen dwingen de lezer of een kwaliteitscontrole niet om verschillende openingsparagrafen te doorzoeken. Consistente plaatsing is belangrijk binnen een bibliotheek, omdat dezelfde informatietaak niet onvoorspelbaar van pagina tot pagina mag verschuiven.

Machine-extraheerbaarheid is het vermogen van software om een contenteenheid te isoleren zonder de betekenis ervan te verliezen. Een getypeerde definitie met een titel en inhoud kan onafhankelijk worden geïndexeerd, vergeleken, geciteerd of getransformeerd. Een zin die toevallig een term definieert in vrije tekst, lost op in de omringende proza: software moet raden waar de definitie begint, waar deze eindigt en of de voorgaande bewering er deel van uitmaakt. Volg de schrijfregels voor elementen zodat de semantische identiteit blijft bestaan, zelfs wanneer het visuele ontwerp verandert.

De formulering moet nog steeds werken zonder het kader. Styling creëert contrast voor mensen; een zelfstandig onderwerp, werkwoord en onderscheidende betekenis creëren extraheerbaarheid voor machines. ‘Het is een methode om ze te verbeteren’ faalt wanneer het uit de alinea wordt gehaald. ‘Content pruning is het proces van het verwijderen, samenvoegen of bijwerken van pagina’s die geen nuttig zoek- of bedrijfsdoel meer dienen’ overleeft.

Wanneer te gebruiken

Gebruik een definitiekader wanneer de pagina is georganiseerd rond één term en die term precies kan worden gedefinieerd in een korte verklaring. Het is verplicht voor woordenlijstterm- en wat-is-X-indelingen. Het is ook verplicht voor diagnose- of aandoeninggerichte content: een lezer moet weten wat de genoemde aandoening is voordat hij oorzaken, tests of remedies overweegt.

Symptoomgerichte pagina’s en handleidingen gebruiken het element zelden. Voeg het alleen toe wanneer één korte definitie een wezenlijke dubbelzinnigheid oplost die nodig is voor de taak. Een handleiding met de titel ‘Zo los je keyword cannibalization op’ kan keyword cannibalization definiëren vóór de stappen, omdat de diagnose bepaalt welke oplossing van toepassing is. Een handleiding met de titel ‘Een title-tag wijzigen’ heeft geen kader nodig dat een title-tag definieert als het publiek en de openingsinstructie het object al ondubbelzinnig maken.

Gebruik geen definitiekader voor:

• Een brede inleiding, geschiedenis, voordeelclaim of uitleg waarom het onderwerp belangrijk is. Die passages ontwikkelen het artikel; ze definiëren de term niet.
• Een samenvatting van de pagina. Een samenvatting verzamelt verschillende conclusies, terwijl een definitie de betekenis van één term weergeeft.
• Een productbelofte zoals ‘AmICited is de makkelijkste manier om zichtbaarheid te verbeteren.’ Dat is positionering, geen toetsbare definitie.
• Een waarschuwing, kanttekening, vereiste of tip. De communicatieve functie verschilt, zelfs als een thema het eruit laat zien als hetzelfde gekleurde paneel.
• Een secundaire term die halverwege het artikel wordt geïntroduceerd. Definieer die term in de zin waarin hij voor het eerst verschijnt, of geef hem een eigen pagina wanneer hij een uitgebreide behandeling verdient.
• Een citaat waarvan het gezag de plaats inneemt van duidelijkheid. Vermeld een formele definitie in de omringende proza wanneer bronvermelding nodig is; houd het kader leesbaar als een directe uitspraak.

De meest voorkomende bijna-misser is een ‘inleiding tot de definitie’: ‘Klantverloop is een van de belangrijkste concepten voor abonnementsbedrijven, en het begrijpen ervan kan groei transformeren.’ Dit zegt dat het concept belangrijk is maar nooit wat het is. Het kader kan geen lege sfeerbepaling precies maken.

Waar te plaatsen

Plaatsing codeert prioriteit. Zet het definitiekader direct na de inleidende alinea of korte introductie, als het eerste contentblok. De inleiding vestigt waarom de lezer op de pagina is; het kader bepaalt vervolgens de betekenis voordat oorzaken, voorbeelden, voordelen, stappen of vergelijkingen ervan afhankelijk zijn.

Plaats geen navigatie, inhoudsopgave, kernpunten, afbeeldingsgalerij of promotionele call-to-action tussen de inleiding en de definitie. Die blokken dwingen de lezer om niet-gerelateerd materiaal te doorkruisen voordat hij de betekenis van de term ontvangt. Broodkruimelpaden en de paginabanner zijn sjabloon-chroom in plaats van gemaakte content, dus deze mogen aan de inleiding voorafgaan.

Gebruik één definitiekader per pagina. De regel bestaat omdat de component het primaire definitieobject van de pagina identificeert. Twee kaders creëren twee concurrerende hoofdtermen en maken extractie dubbelzinnig. Als beide termen echt primair zijn, splits het onderwerp dan in twee pagina’s en verbind ze in proza. Als de tweede term ondergeschikt is, definieer deze dan inline in plaats van hem op te maken als een tweede canoniek antwoord.

Een direct-antwoordblok kan alleen naast een definitie bestaan wanneer het een andere hoofdvraag beantwoordt. Op een diagnosepagina kan de definitie aangeven wat de aandoening is, terwijl het direct-antwoordblok de aanbevolen eerste actie vermeldt. Wanneer de hoofdvraag van de pagina ‘Wat is X?’ is, zijn het directe antwoord en de definitie hetzelfde antwoord. Vouw ze samen tot één definitiekader; naast elkaar geplaatste versies herhalen alleen de formulering en concurreren om extractie.

Anatomie

Het element heeft twee gemaakte gebieden en één structurele relatie. De schermafbeelding moet het weergegeven element tonen zonder verklarende tekst in de afbeelding te verwerken; de legenda hieronder blijft selecteerbaar, toegankelijk en onderhoudbaar wanneer het ontwerp verandert.

Weergegeven legenda

1. Optionele titel: Meestal ‘Wat is X?’ Het identificeert de exacte term en mag geen tweede bewering toevoegen.
2. Verplichte inhoud: Eén zelfstandige definitie die de term benoemt, in een nuttige categorie plaatst en aangeeft wat hem onderscheidt.
3. Openingspositie: Het kader volgt op de inleiding en gaat aan het eerste uitleggende gedeelte vooraf. Deze relatie maakt deel uit van het contract, ook al is het geen veld.

Rand, achtergrond, opvulling, pictogrambehandeling en typografie behoren tot de renderer. Auteurs leveren betekenis, geen visuele elementen. Het element moet begrijpelijk blijven als elke decoratieve stijl wordt verwijderd.

Ontwerpvoorbeelden

De galerij behandelt de ondersteunde inhoudsvarianten in plaats van verschillende semantische typen te verzinnen. Elke opname moet waar mogelijk dezelfde definitie hergebruiken, zodat beoordelaars de titelafhandeling, inhoudsomslag en viewport-gedrag kunnen beoordelen in plaats van niet-gerelateerde tekst te vergelijken.

Met titel: De voorkeursvariant wanneer de term onbekend, dubbelzinnig, afgekort of anders is dan de exacte paginatitel.

Zonder titel: Toegestaan wanneer de paginakop en de direct voorafgaande inleiding het onderwerp ondubbelzinnig maken. De inhoud moet de term nog steeds benoemen; het weglaten van de titel staat nooit voornaamwoorden zoals ‘het’ toe om het onderwerp te vervangen.

Maximale lengte: De renderer wikkelt de volledige inhoud. Deze mag niet worden afgekapt, ingeklapt, voorzien van scrollen of verkleind om tekst op het redactionele maximum te accommoderen.

Smalle viewport: Titel en inhoud behouden hun volgorde, leesbare regelbreedte en zichtbare grens. Geen betekenis mag afhangen van een pictogram dat naast de tekst beweegt.

Parameters

De parameters scheiden content van presentatie. De limieten houden definities vergelijkbaar over pagina’s heen en voorkomen dat het component verandert in een universele callout.

Parameters van het definitiekader

De renderer mag de term voor indexering afleiden, maar auteurs mogen nooit een inhoud schrijven die afhankelijk is van dat afgeleide veld dat wordt weergegeven. Een gekopieerde definitie moet het onderwerp expliciet noemen.

Syntax en codevoorbeelden

Alle drie de vormen dragen dezelfde titel en inhoud. De draagbare Markdown-directive is de canonieke auteursvorm; Hugo en WordPress zijn adapters. De voorbeelden gebruiken opzettelijk identieke formulering zodat een migratietest waarden kan vergelijken, niet alleen het uiterlijk.

Draagbare Markdown-directive

:::definition
## Wat is content pruning?

Content pruning is het proces van het verwijderen, samenvoegen of bijwerken van pagina's die geen nuttig zoek- of bedrijfsdoel meer dienen.
:::

De eerste kop wijst naar title; alles erna wijst naar body. Laat de kop weg voor de titelloze variant, maar behoud de term in de inhoud.

Hugo-shortcode

{{< callout type="note" title="Wat is content pruning?" >}}Content pruning is het proces van het verwijderen, samenvoegen of bijwerken van pagina's die geen nuttig zoek- of bedrijfsdoel meer dienen.{{< /callout >}}

De site hergebruikt de bestaande callout-renderer voor de zichtbare Hugo-behandeling. Het definitiecontract komt nog steeds uit de getypeerde draagbare bron: note is hier een weergave-adapter, geen toestemming om gewone notities in definitiekaders te plaatsen.

WordPress-blok of shortcode

[definition title="Wat is content pruning?"]Content pruning is het proces van het verwijderen, samenvoegen of bijwerken van pagina's die geen nuttig zoek- of bedrijfsdoel meer dienen.[/definition]

Een WordPress-implementatie kan dezelfde velden als een aangepast blok tonen. De opgeslagen waarden blijven title en body; editor-instellingen, kleuren en witruimte zijn presentatie-instellingen en mogen de betekenis van de definitie niet wijzigen.

Voorbeelden

Dit is goed omdat het de term benoemt, de aandoening identificeert en het onderscheidende gevolg vermeldt. Het beweert niet dat elk paar pagina’s dat een woord deelt, concurreert; de formulering ‘dezelfde zoekintentie’ levert de nodige begrenzing. De inhoud is nuttig zonder de titel en kort genoeg om intact te citeren.

Dit is slecht omdat het keyword cannibalization nooit definieert. Het biedt belangrijkheid, publiek, urgentie en een vaag effect, maar geen categorie of onderscheidende conditie. Het vervangen van ’een van de belangrijkste’ door ’een situatie waarin meerdere pagina’s strijden om dezelfde zoekintentie’ verandert promotie in betekenis.

Een tweede slecht patroon is het overladen van het kader: een definitie gevolgd door oorzaken, vijf voorbeelden, een waarschuwing en een aanbevolen tool. Zelfs als de eerste zin correct is, vernietigt het extra materiaal de stabiele grens. Houd de definitie; verplaats oorzaken en voorbeelden naar de volgende sectie, de waarschuwing naar het juiste element, en de aanbeveling naar het punt waar de lezer ernaar kan handelen.

Schema-markup en toegankelijkheid

Een definitiekader creëert niet automatisch een zelfstandige Schema.org-entiteit. In een gewoon artikel blijft de tekst deel uitmaken van de omringende Article of TechArticle. Op een woordenlijstpagina kan een publicatie-implementatie de term en definitie mappen naar een geschikte woordenschat, alleen wanneer de site dat schema-beleid heeft overgenomen. Verzin geen DefinitionBox-type: het bestaat niet in Schema.org.

Vermenigvuldig de inhoud evenmin in JSON-LD alleen omdat het kader er belangrijk uitziet. Schema-markup moet de pagina waarheidsgetrouw beschrijven, en het dupliceren van zichtbare proza in een niet-gerelateerde eigenschap creëert ruis in plaats van sterkere betekenis. Als een schema-eigenschap wordt gevuld, moet de waarde overeenkomen met de zichtbare definitie in inhoud en ermee worden bijgewerkt.

Het element heeft geen interactieve ARIA-rol nodig. Geef het weer in de normale documentvolgorde als een gelabeld gebied of semantische container, met de titel vóór de inhoud. Gebruik geen role="alert", omdat een statische definitie geen urgente of nieuw gearriveerde informatie is. Gebruik geen kleur of pictogram als enig signaal dat het blok een definitie is. Als de titel is geïmplementeerd als een kop, moet het niveau de paginahiërarchie volgen; de ## in de bron is een veld-mappingconventie, geen instructie om een ongeldige kop-sprong te maken.

Het toetsenbordgedrag is gewoon leesgedrag: het kader zelf is niet focusbaar. Elke link binnenin volgt normale linksemantiek en heeft een beschrijvend anker nodig. Schermlezeruitvoer moet dezelfde titel-dan-inhoud-volgorde behouden die zichtbaar is op het scherm.

Schrijfregels

Schrijf de definitie voordat je de voordelen schrijft. Begin met de term zelf, gebruik dan een koppelwerkwoord zoals ‘is’, ‘betekent’ of ’treedt op wanneer’. Vermeld de dichtstbijzijnde nuttige categorie en het kenmerk dat de term scheidt van verwante concepten. Deze volgorde bestaat omdat categorie zonder onderscheid breed is, terwijl onderscheid zonder categorie de lezer onzeker laat over wat voor soort ding de term is.

Houd de inhoud maximaal ongeveer 300 tekens, inclusief spaties. Geef de voorkeur aan één zin. Een tweede korte zin is alleen acceptabel wanneer een noodzakelijke grens niet duidelijk in de eerste kan worden uitgedrukt. De limiet is redactioneel, geen uitnodiging om interpunctie te comprimeren, lidwoorden te verwijderen of clausules op elkaar te stapelen. Als nauwkeurigheid meer ruimte vereist, zet dan de exacte kern in het kader en kwalificeer deze onmiddellijk erna.

Gebruik een neutrale, declaratieve toon. Vermijd ‘belangrijk’, ‘krachtig’, ‘baanbrekend’, ‘moet u weten’ en soortgelijke oordelen. Vermijd cirkeldefinities zoals ‘contentoptimalisatie is het optimaliseren van content’. Schrijf afkortingen uit bij eerste gebruik, tenzij de afkorting zelf de paginaterm is. Gebruik dezelfde canonieke naam die in de paginatitel voorkomt.

Plaats nooit het volgende in de inhoud:

• Meer dan één primaire term of een lijst met verwante termen.
• Voordelen, geschiedenis, oorzaken, symptomen, voorbeelden, stappen, productpitches of calls-to-action.
• Tabellen, afbeeldingen, video’s, formulieren, knoppen, voetnoten of geneste callouts.
• Ongestoffeerde superlatieven, verzonnen statistieken of beweringen die een alinea bewijs vereisen.
• Een tweede kop, opsommingslijst of blokcitaat.
• Voornaamwoorden waarvan de betekenis afhangt van de voorafgaande inleiding.

Eén verwijzingslink is de uitzondering, niet het doel. Gebruik deze alleen wanneer een juridische, wetenschappelijke of op standaarden gebaseerde definitie afhankelijk is van een genoemde bron. Plaats uitgebreide citaten en meningsverschillen tussen bronnen in gewone proza, waar de lezer de kwalificatie kan zien in plaats van een betwiste formulering voor een universele definitie te houden.

Posttypes die het gebruiken

De postTypes-frontmatter registreert de geregistreerde koppelingen. De tabel vertaalt die koppelingen naar redactionele regels. Diagnose-/aandoeninggerichte en symptoomgerichte indelingen worden hier beschreven als gebruikspatronen, maar ze zijn niet gekoppeld als afzonderlijke playbook-posttypes omdat ze niet in het huidige canonieke register staan.

Posttype-vereisten

Gebruik voor diagnose- of aandoeninggerichte pagina’s het kader altijd en plaats het vóór symptomen, oorzaken, ernst of remedies. Gebruik het voor symptoomgerichte pagina’s alleen wanneer de symptoomnaam een echt korte, stabiele definitie heeft. Als het kader alleen de titel zou herhalen—‘Een trage website is een website die traag is’—laat het dan weg en begin met de diagnostische drempel of het waarneembare probleem in proza.

QA-checklist

Een beoordelaar controleert betekenis vóór uiterlijk. Een gepolijst kader met een vage inleiding is nog steeds een mislukte definitie.

• Eén hoofdterm: De pagina en het kader definiëren precies één primair concept.
• Correcte positie: Het kader is het eerste gemaakte contentblok na de inleiding, met geen inhoudsopgave, kernpunten, galerij of promotie ervoor geplaatst.
• Eén voorkomen: Geen tweede definitiekader concurreert met het canonieke antwoord.
• Werkelijke definitie: De inhoud vermeldt wat de term is of wanneer de aandoening bestaat; het zegt niet alleen waarom de term belangrijk is.
• Zelfstandige formulering: De inhoud benoemt het onderwerp en is begrijpelijk wanneer gekopieerd zonder omringende proza of opmaak.
• Precisie: Categorie, onderscheidend kenmerk en eventuele essentiële grens zijn accuraat. De formulering generaliseert niet te veel.
• Lengte: De inhoud is niet meer dan ongeveer 300 tekens en blijft leesbaar in plaats van gecomprimeerd.
• Schone inhoud: Geen voordelen, geschiedenis, voorbeelden, stappen, productclaims, media, tabellen of geneste elementen verschijnen erin.
• Direct-antwoordbeslissing: Als de pagina vraagt ‘Wat is X?’, is het definitiekader het enige direct-antwoordelement. Als beide elementen verschijnen, beantwoorden ze duidelijk verschillende vragen.
• Toegankelijke semantiek: Titel gaat aan inhoud vooraf, kopvolgorde is geldig, kleur is niet de enige identificatie, en er is geen alert-rol of onnodig focusdoel aanwezig.
• Draagbare gelijkheid: Markdown-, Hugo- en WordPress-mappingen behouden dezelfde titel en definitie.
• Gestructureerde-gegevensbeperking: Elke schema-waarde komt overeen met de zichtbare tekst en er wordt geen verzonnen Schema.org-type gebruikt.
• Schermafbeeldingsstatus: Opmerkingen blijven niet-renderende vastleginstructies totdat de genoemde bestanden bestaan; geen niet-bestaand afbeeldingspad wordt gerefereerd als afbeelding.

FAQ

De academiesjabloon geeft de vijf beoordeelde vragen weer die zijn opgeslagen in de [[faq]]-frontmatter van deze pagina. Samen behandelen ze noodzaak, co-existentie met directe antwoorden, links en citaten, de lengtelimiet en de één-per-pagina-regel.