Innehållselement: blocken som varje sida byggs av
Använd ett styrt bibliotek av definitioner, svar, steg, jämförelser, bevis, meddelanden, navigations- och konverteringsblock så att varje avsnitt behåller sin funktion oavsett skribent, sida, maskin eller CMS.
Ett element är ett innehållskontrakt
Ett namngivet, typat, parametriserat block definierar vad som hör hemma i det, hur mycket det får innehålla, var det får förekomma och vad system får göra med det.
- ✓Namngivet efter syfte — definition, varning, jämförelse, källa och CTA beskriver funktioner snarare än visuella stilar.
- ✓Avgränsat av parametrar — etiketter, poster, citat, varianter och gränser förhindrar att improviserade strukturer driver iväg.
- ✓Placerat enligt regel — ett inledande svar, en varning i flödet, ett avslutande källblock och en nästa-steg CTA upptar olika delar av ett dokument.
- ✓Renderat per kanal — ett element kan bli semantisk HTML i Hugo, ett naturligt WordPress-block, strukturerad data eller en flödespost.
Vad ett innehållselement är
Fritext lagrar meningar. Ett innehållselement lagrar meningar plus en explicit beskrivning av vad dessa meningar gör.
En skribent lägger till en H2 som heter "Vad är churn?", följer upp med ett stycke och kanske fetstilar den första meningen. En läsare kan ana att det är en definition. Innehållssystemet ser bara en rubrik och prosa.
Ingenting registrerar om definitionen är kanonisk, om den måste vara nära inledningen, vilken term den definierar, hur lång den får vara eller om en annan kanal får återanvända den.
Skribenten infogar ett definition-element med en term, en kortfattad body och en valfri kvalificerare. Elementkontraktet styr placering, tillgänglig markup, längd och presentation.
En mall kan rendera det, en granskning kan hitta det, en migrering kan mappa det och ett svarsystem kan skilja definitionen från omgivande förklaring.
Ett element är ett namngivet, typat, parametriserat innehållsblock. "Namngivet" ger det en stabil identitet. "Typat" kopplar det till beteende. "Parametriserat" innebär att dess meningsfulla delar är fält istället för en odifferentierad klump. Det bär också med sig positionsregler, innehållsgränser, varianter, tillgänglighetskrav, schemamappningar och kvalitetssäkringskontroller.
Detta eliminerar inte prosa. En definition, varning eller källhänvisning kräver fortfarande precis skrivning. Det eliminerar otydlighet om prosans funktion. Språket kan variera medan kontraktet hedras, precis som olika poster innehåller olika data medan de delar ett schema.
Varför element slår innehållsbriefar
En prosabrief kan beskriva den önskade sidan. Typade element bevarar dess viktiga beslut efter att briefen lämnat redaktörens skärm.
Målet är inte att varje sida ska se identisk ut. Det är att återkommande funktioner ska bete sig förutsägbart. En fallstudie och en ordlista kan ha olika röst och layout medan deras källor förblir sökbara och deras relaterade innehållsblock förblir styrda.
Elementets prioritetsregel
Om ett elements syfte matchar vad avsnittet gör, är detta element obligatoriskt – även om en rubrik och ett stycke skulle kunna visa samma ord. Fritext är reserven, inte standardvalet.
Sök inte bara efter etiketten i dispositionen. "Kliniska överväganden" kan dölja en varning. "Översikt" kan betyda viktiga slutsatser. Namnge läsarens uppgift: definiera, sammanfatta, varna, jämföra, instruera, bevisa, navigera eller konvertera.
Kontrollera sedan syftesbeskrivningar. Ett matchande syfte har företräde framför en anpassad rubrik eftersom typen bevarar funktionen utanför den synliga sidan.
Fritext är rätt för analys, övergångar, exempel och förklaringar utan återanvändbart kontrakt. Den ska koppla samman element och utveckla argumentet, inte imitera en befintlig komponent.
Om ett fritextmönster upprepas, dokumentera det för biblioteksgranskning. Upprepning kan avslöja ett saknat element, men skribenter bör inte skapa inofficiella komponenter sida för sida.
| Dispositionsformulering | Syfte | Obligatoriskt val | Vad prosa förlorar |
|---|---|---|---|
| "Vad är X?" | Ge en avgränsad betydelse | definitionsruta | Definitionen kan inte tillförlitligt separeras från sammanhanget. |
| "När ska man söka hjälp" eller "kontraindikationer" | Ange risk, konsekvens och säker åtgärd | varningsruta | Ett stoppvillkor har ingen varningssemantik. |
| En praktisk sidoanteckning | Erbjuda valfria utföranderåd | tipsruta | Sidoanteckningen konkurrerar med eller försvinner inuti obligatoriska steg. |
| Sammanfattningen överst | Lyfta fram underbyggda slutsatser | viktiga slutsatser | En lös lista har ingen placering, gräns eller sammanfattningsbetydelse. |
| En lista att bocka av | Spåra slutförandestatus | Checklisteelement | Punktlistor skiljer inte åtgärder från observationer eller status. |
Checklistexemplet är olänkat eftersom dess detaljspecifikation tillhör en senare biblioteksvåg. Prioritetsbeslutet gäller ändå: använd en godkänd checklisteimplementation där CMS:et tillhandahåller den; klä inte slutförandestatus som dekorativa punkter.
Typade block vs vanlig text
Den synliga meningen är identisk. Den typade versionen behåller identitet och fält som nedströms system kan använda utan att gissa.
Kundbortfall är förlusten av kunder eller prenumeranter under en mätperiod.
Lagras som
{ "heading": "What is customer churn?",
"html": "<p>Customer churn is…</p>" }Maskinutdata: rubrik och generisk HTML. Definitionsstatus, term, placering och återanvändning är okända.
Kundbortfall är förlusten av kunder eller prenumeranter under en mätperiod.
Lagras som
{ "type": "definition",
"term": "customer churn",
"body": "Customer churn is…",
"position": "opening" }Maskinutdata: en känd definition med adresserbara fält, validering, semantisk rendering, schemamappning och flödesberättigande.
Skillnaden är funktionell, inte kosmetisk. Ersätt komponenten med en rubrik och ett stycke och läsaren kanske inte märker något, medan systemet förlorar validering, analys, schemamappning, migreringslogik och portföljfrågor. Att byta ett typelement mot fritext är en funktionsförlust.
De elva elementgrupperna
Varje levande kort speglar barndatasidans playbookFamily-metadata. Antalen beskriver det publicerade elementbiblioteket; ytterligare specifikationer är planerade för senare vågor.
Läs först — prioritetsregeln som styr alla andra element.
Posten som driver identitet, upptäckbarhet och schema.
Den första skärmen: svar, sammanfattning, definition, orientering.
Definitionsruta · Direkt svarsblock · Färskhetsstämpel · Introduktionskrok · Ruta för viktiga slutsatser · Innehållsförteckning · Vem är detta för? Målgruppsblockregler
Blocken som bär argumentet.
Accordion · Punktlistor · Checklista · Anpassade listningar · Beslutsträd · Gör och gör inte · Regler för fritextstycken · Rubriksystem · Ikonruta · Bildruta · Inforuta · Inforuta · Steglistor · Flikar/Personaväljare · Tidslinjer · Sicksack-sektioner
Strukturerade fakta som både en läsare och en maskin kan använda.
Inbäddade miniräknare · Diagramblock · Jämförelsetabeller · Prissättningstabeller · För- och nackdelar-block · Poängkort · Specifikationstabeller · Statistikband
Tips, anteckningar och varningar — används sparsamt eller inte alls.
Bilder, video, diagram och deras textekvivalenter.
Kommenterade skärmdumpar · Ljud- och poddinbäddningar · Diagram och illustrationer · Bildgalleri · Inline-bilder · Inline-video · Videoinbäddningar
Produkt, pris, tillgänglighet och sammansättning.
Tillgänglighetsblock · Sammansättningsblock · Erbjudanderutor · Produktkort · Produktreglage
Författarskap, granskning, citat och sociala bevis.
Författarbiografiblock · Ansvarsfriskrivningsblock · Pull-citat och expertcitat · Granskat-av-block · Recensionsblock · Källor och referenser · Rekommendationer · Förtroendemärken och certifieringar · Uppdateringslogg
Länkar, ankare och nästa åtgärd.
Ankarlänkar · Brödsmulor · CTA-block · Ordlistetermlänkar och verktygstips · Inline CTA-knapp · Interna länkmoduler · Minibanner · Nyhetsbrevsinsamling · Relaterade innehållsblock
Öppettider, adress, karta och bokning.
Bokningsblock · Öppettider och kontaktblock · Kartblock · NAP-block
Hur en sida slutar och vad den frågar härnäst.
Ett element, tre format
Varje element har ett konceptuellt kontrakt och adaptrar för portabel Markdown, Hugo och WordPress.
Betrakta ett tips med en titel och brödtext med valfria råd. Dess syfte, tillåtna innehåll, tillgänglighetsroll, position och kvalitetssäkringsregler förblir konstanta. Endast notationen ändras.
:::tip{title="Keep the query stable"}
Change one variable at a time.
:::Läsbart i källkod och oberoende av sidans tema.
{{< callout type="tip" title="Keep the query stable" >}}
Change one variable at a time.
{{< /callout >}}Adaptern mappar namngivna fält till den godkända komponenten.
<!-- wp:amicited/tip
{"title":"Keep the query stable"} -->
<p>Change one variable at a time.</p>
<!-- /wp:amicited/tip -->Inbyggda redigeringskontroller bevarar samma typ och fält.
Portabilitet är inte att kopiera renderad HTML. Varje adapter accepterar samma meningsfulla indata, upprätthåller motsvarande begränsningar och producerar kanalanpassad utdata. Om ett fält inte kan mappas säkert måste adaptern misslyckas synligt eller dokumentera en kontrollerad reserv; den får inte kasta bort betydelse tyst.
Vad som finns på varje elementsida
Varje detaljsida är en offentlig vägledning och en produktionsspecifikation. Den eliminerar gissningar som annars återkommer i varje implementation.
| Område | Fråga som besvaras | Problem som förhindras |
|---|---|---|
| Syfte och icke-syfte | Vilken uppgift utför det, och vilken liknande uppgift hör hemma någon annanstans? | En tipsruta som bär ett obligatoriskt steg eller en definition som blir en mini-artikel. |
| Parametertabell | Vilka fält är obligatoriska, valfria, typade, repeterbara och begränsade? | Adaptrar som accepterar olika data eller flera idéer gömda i ett fält. |
| Positionsregler | Var får det förekomma, hur ofta och bredvid vad? | Slutsatser begravda mitt i sidan eller källor frikopplade från påståenden. |
| Variantgalleri | Vilka namngivna varianter finns och när är varje lämplig? | Visuella engångslösningar som utger sig för att vara officiella varianter. |
| Bra vs dåligt | Vad gör ett korrekt exempel som ett troligt misslyckande missar? | Team som kopierar syntax samtidigt som de missar syftet. |
| Schemamappning | Hur mappas fält till HTML, tillgänglighet, schema, API:er och flöden? | Synligt innehåll som inte överensstämmer med maskinutdata. |
| Kvalitetssäkring | Vad kan automation upprätthålla och vad kräver omdöme? | Ett giltigt block som publiceras med vagt, falskt, inaktuellt eller felplacerat innehåll. |
Automation kan kontrollera obligatoriska fält, antal, längder, placering, identifierare, URL:er och adapterstöd. Redaktionell kvalitetssäkring måste kontrollera noggrannhet, användbarhet, beviskvalitet, proportionell betoning och om elementet är rätt för läsarens uppgift.
Vilka element är obligatoriska
Obligatoriskt innebär att systemet förväntar sig funktionen i i stort sett varje komplett posttyp. Det betyder inte att varje block måste vara stort eller identiskt.
- Frontmatter etablerar identitet, ägarskap, upptäckbarhet och kopplingar.
- Introduktion bekräftar omfattning och läsaranpassning.
- Viktiga slutsatser lyfter fram underbyggda slutsatser på omfattande sidor.
- FAQ besvarar verkliga kvarstående frågor.
- Källor gör faktastöd spårbart.
- Relaterat innehåll tillhandahåller nästa inlärningsväg.
- CTA erbjuder en proportionerlig åtgärd.
- Använd en definition när en term behöver en avgränsad betydelse.
- Använd ett direkt svar för en tydlig primärfråga.
- Använd steg för en ordnad procedur och verifierbart resultat.
- Använd jämförelser när läsare utvärderar alternativ på konsekventa kriterier.
- Använd en tipsruta för valfri förbättring och en varning för materiell risk.
- Använd kommenterad media när det visuella kommunicerar något som prosa inte kan göra lika effektivt.
Undantag är viktiga. En kort ordlistasdefinition kanske inte behöver separata slutsatser. En sida utan externt underbyggda faktapåståenden kanske inte behöver synliga referenser. En FAQ med påhittade frågor är sämre än ingen alls. Posttypspecifikationer anger standardvärden; författare dokumenterar motiverade utelämnanden istället för att fylla fack mekaniskt.
Börja med relevant posttyps-specifikation, som ordnar de vanliga elementen för läsarens uppgift. Tillämpa sedan prioritet sektion för sektion. Resultatet är varken en tom sida eller en stel form: det är en styrd sammansättning med utrymme för originella argument, bevis, exempel och röst.
Typade element låter en agent sammanställa istället för att uppfinna
Elementbiblioteket är där ett innehållssystem slutar vara ett dokument och blir något en maskin kan exekvera. Ett block med deklarerade fält har antingen vad det behöver eller synligt inte har det.
En jämförelsetabell behöver jämförbara alternativ, en angiven dimension per rad och ett verifieringsdatum. När en av dessa indata inte finns ger ett typat block agenten någonstans att misslyckas högljutt.
Fri prosa har ingen sådan egenskap. Ombedd att skapa en tabell utan bakomliggande data producerar en agent ändå en tabell, och den påhittade cellen ser precis ut som en forskningsbaserad.
Kontrollera biblioteket efter syfte innan du skriver en rubrik. Den instruktionen följs mycket mer tillförlitligt av en agent än av en person under deadline, eftersom en agent verkligen kommer att läsa om hela biblioteket varje gång.
Detta är ett fall där agenten är den bättre operatören: regeln är mekanisk, och mekaniskt är vad agenter är till för.
Varje element definieras en gång och uttrycks som ett portabelt Markdown-direktiv, en Hugo-shortcode och ett WordPress-block. Agenten arbetar mot den portabla formen och behöver aldrig veta vilket CMS utmatningen hamnar i.
Det innebär också att ett byte av CMS inte ogiltigförklarar innehållssystemet eller kräver omskolning av agenten.
Eftersom element är typade kan korpusen frågas. Vilka sidor saknar ett källblock. Vilka jämförelsetabeller har inget verifieringsdatum. Vilka direkta svar överskrider sitt band.
Du kan bara köra den granskningen på innehåll sammansatt av namngivna block. Prosa är inte frågbar, så prosabaserad kvalitetskontroll skalas inte bortom det antal sidor en person kan läsa.
Varje elementsida har en parametertabell med obligatoriska fält, minimum och maximum, positionsregler och en kvalitetssäkringskontrollista. Det är den precisionsnivå en agent behöver för att bygga utan att gissa — och samma precision gör utmatningen granskningsbar av en människa på en bråkdel av tiden.
Innehållselement FAQ
Ett innehållselement är ett namngivet, typat, parametriserat block med ett definierat syfte, tillåtna fält, positionsregler, längdbegränsningar, renderingsbeteende och kvalitetskontroller. Det lagrar innehåll och funktion.
Använd fritext när inget bibliotekselement matchar syftet. Analys, berättelser, övergångar och unika förklaringar förblir ofta prosa; etablerade definitioner, varningar, jämförelser, källor och CTA:er gör det inte.
Nej. Kontraktet standardiserar struktur och funktion, inte slutsatser eller röst. Författare väljer fortfarande argument, bevis, exempel och formuleringar.
Ja. Det portabla kontraktet är oberoende av presentation. Adaptrar mappar samma fält till inbyggd syntax och markup samtidigt som validering och semantik bevaras.
Bygg en sida av block du kan styra i stor skala
Gratis kontroll · 7 dagars provperiod · kreditkort krävs