Obsahové prvky: bloky, z ktorých je postavená každá stránka
Používajte riadenú knižnicu definícií, odpovedí, krokov, porovnaní, dôkazov, oznámení, navigácie a konverzných blokov, aby si každá sekcia zachovala svoju funkciu naprieč autormi, stránkami, strojmi a CMS systémami.
Prvok je obsahový kontrakt
Pomenovaný, typovaný, parametrizovaný blok definuje, čo do neho patrí, koľko môže obsahovať, kde sa môže nachádzať a čo s ním systémy môžu robiť.
- ✓Pomenovaný podľa účelu — definícia, varovanie, porovnanie, zdroj a CTA opisujú úlohy, nie vizuálne štýly.
- ✓Ohraničený parametrami — štítky, položky, citácie, varianty a limity zabraňujú driftu improvizovaných štruktúr.
- ✓Umiestnený podľa pravidiel — úvodná odpoveď, varovanie v texte, záverečný blok zdrojov a CTA s ďalším krokom zaberajú rôzne časti dokumentu.
- ✓Vykreslený podľa kanála — jeden prvok sa môže stať sémantickým HTML v Hugo, natívnym WordPress blokom, štruktúrovanými dátami alebo záznamom vo feede.
Čo je obsahový prvok
Voľný text ukladá vety. Obsahový prvok ukladá vety plus explicitný popis toho, čo tieto vety robia.
Autor pridá H2 s názvom „Čo je churn?“, nasleduje odsek a prvá veta môže byť zvýraznená tučne. Čitateľ môže odvodiť, že ide o definíciu. Systém obsahu vidí len nadpis a prózu.
Nič nezaznamenáva, či je definícia kanonická, či musí byť v úvode, ktorý pojem definuje, aká dlhá môže byť alebo či ju môže iný kanál znovu použiť.
Autor vloží prvok definition s term, stručným body a voliteľným kvalifikátorom. Kontrakt prvku riadi umiestnenie, prístupné značenie, dĺžku a prezentáciu.
Šablóna ho vie vykresliť, audit nájsť, migrácia namapovať a odpovedajúci systém vie rozlíšiť definíciu od okolitého vysvetlenia.
Prvok je pomenovaný, typovaný, parametrizovaný obsahový blok. „Pomenovaný“ mu dáva stabilnú identitu. „Typovaný“ ho spája so správaním. „Parametrizovaný“ znamená, že jeho zmysluplné časti sú polia namiesto nediferencovanej zhluku. Prináša tiež pravidlá umiestnenia, obsahové limity, varianty, požiadavky na prístupnosť, mapovanie schém a kontroly kvality.
Toto neeliminuje prózu. Definícia, varovanie alebo poznámka o zdroji stále potrebujú presné písanie. Eliminuje to nejednoznačnosť o úlohe prózy. Jazyk sa môže meniť pri dodržaní kontraktu, rovnako ako rôzne záznamy obsahujú rôzne dáta pri zdieľaní jednej schémy.
Prečo prvky porážajú obsahové zadania
Textové zadanie vie opísať želanú stránku. Typované prvky uchovávajú jej dôležité rozhodnutia aj potom, čo zadanie opustí obrazovku editora.
Cieľom nie je, aby každá stránka vyzerala identicky. Je to, aby sa opakované funkcie správali predvídateľne. Prípadová štúdia a stránka slovníka môžu mať rôzne hlasy a rozloženia, pričom ich zdroje zostávajú dopytovateľné a ich bloky súvisiaceho obsahu zostávajú riadené.
Pravidlo priority prvkov
Ak účel prvku zodpovedá tomu, čo sekcia robí, je tento prvok povinný – aj keď by nadpis a odsek mohli zobraziť rovnaké slová. Voľný text je záložné riešenie, nie predvolené.
Nehľadajte len štítok v osnove. „Klinické aspekty“ môžu skrývať varovanie. „Na prvý pohľad“ môže znamenať kľúčové poznatky. Pomenujte úlohu čitateľa: definovať, zhrnúť, varovať, porovnať, inštruovať, dokázať, navigovať alebo konvertovať.
Potom skontrolujte vyhlásenia o účele. Zodpovedajúci účel má prioritu pred vlastným nadpisom, pretože typ zachováva funkciu aj mimo viditeľnej stránky.
Voľný text je vhodný pre analýzy, prechody, príklady a vysvetlenia bez opätovne použiteľného kontraktu. Mal by spájať prvky a rozvíjať argumentáciu, nie napodobňovať existujúci komponent.
Ak sa vzor voľného textu opakuje, zaznamenajte ho na preskúmanie do knižnice. Opakovanie môže odhaliť chýbajúci prvok, ale autori by nemali vytvárať neoficiálne komponenty stránku po stránke.
| Znenie osnovy | Účel | Požadovaná voľba | Čo próza stráca |
|---|---|---|---|
| „Čo je X?“ | Poskytnúť jeden ohraničený význam | definičný blok | Definíciu nemožno spoľahlivo oddeliť od kontextu. |
| „Kedy vyhľadať pomoc“ alebo „kontraindikácie“ | Uviesť riziko, dôsledok a bezpečný postup | varovný blok | Stav zastavenia nemá sémantiku varovania. |
| Praktická vsuvka | Poskytnúť voliteľnú radu k vykonaniu | blok tipov | Vsuvka konkuruje povinným krokom alebo v nich zaniká. |
| Zhrnutie v hornej časti | Zobraziť podložené závery | kľúčové poznatky | Voľný zoznam nemá umiestnenie, limit ani význam zhrnutia. |
| Zoznam na odškrtávanie | Sledovať stavy dokončenia | Prvok kontrolného zoznamu | Odrážky nerozlišujú akcie od pozorovaní ani stavov. |
Príklad kontrolného zoznamu je neodkazovaný, pretože jeho detailná špecifikácia patrí do neskoršej vlny knižnice. Rozhodnutie o priorite však stále platí: použite schválenú implementáciu kontrolného zoznamu tam, kde ju CMS poskytuje; nemaškrujte stavy dokončenia ako dekoratívne odrážky.
Typované bloky vs obyčajný text
Viditeľná veta je identická. Typovaná verzia si zachováva identitu a polia, ktoré môžu nadväzujúce systémy využiť bez hádania.
Odchod zákazníkov je strata zákazníkov alebo predplatiteľov počas meraného obdobia.
Uložené ako
{ "heading": "What is customer churn?",
"html": "<p>Customer churn is…</p>" }Strojový výstup: nadpis a generické HTML. Status definície, pojem, umiestnenie a opätovné použitie sú neznáme.
Odchod zákazníkov je strata zákazníkov alebo predplatiteľov počas meraného obdobia.
Uložené ako
{ "type": "definition",
"term": "customer churn",
"body": "Customer churn is…",
"position": "opening" }Strojový výstup: známa definícia s adresovateľnými poľami, validáciou, sémantickým vykreslením, mapovaním schém a oprávnenosťou pre feedy.
Rozdiel je funkčný, nie kozmetický. Nahraďte komponent nadpisom a odsekom a čitateľ si možno nič nevšimne, zatiaľ čo systém stratí validáciu, analytiku, mapovanie schém, migračnú logiku a dopyty portfólia. Výmena typovaného prvku za voľný text je strata funkcie.
Jedenásť skupín prvkov
Každá živá karta zrkadlí metadáta playbookFamily podstránok. Počty opisujú publikovanú knižnicu prvkov; ďalšie sú naplánované do neskorších vĺn.
Prečítajte ako prvé – pravidlo priority, ktoré riadi každý ďalší prvok.
Záznam, ktorý riadi identitu, objaviteľnosť a schému.
Prvá obrazovka: odpoveď, zhrnutie, definícia, orientácia.
Definičný blok · Blok priamej odpovede · Pečiatka aktuálnosti · Úvodný háčik · Blok kľúčových poznatkov · Obsah · Pre koho je to určené? Pravidlá publika
Bloky, ktoré nesú argumentáciu.
Akordeón · Odrážkové zoznamy · Kontrolný zoznam · Vlastné výpisy · Rozhodovací strom · Čo robiť a čo nerobiť · Pravidlá pre odseky voľného textu · Systém nadpisov · Ikonový blok · Obrázkový blok · Infobox · Infobox · Zoznamy krokov · Záložky / Prepínač osoby · Časové osi · Cik-cak sekcie
Štruktúrované fakty, ktoré môže použiť čitateľ aj stroj.
Vložená kalkulačka · Grafové bloky · Porovnávacie tabuľky · Cenové tabuľky · Bloky výhod a nevýhod · Hodnotiace karty · Tabuľky špecifikácií · Štatistické pásy
Tipy, poznámky a varovania – používané striedmo alebo vôbec.
Obrázky, videá, diagramy a ich textové ekvivalenty.
Anotované screenshoty · Vložené audio a podcasty · Diagramy a ilustrácie · Galéria obrázkov · Inline obrázky · Inline videá · Vložené videá
Produkt, cena, dostupnosť a zloženie.
Bloky dostupnosti · Bloky zloženia · Ponukové bloky · Produktové karty · Produktové posúvače
Autorstvo, recenzia, citácie a sociálny dôkaz.
Blok životopisu autora · Blok vyhlásenia · Vytiahnutý citát a citát experta · Blok recenzované · Bloky recenzií · Zdroje a referencie · Referencie · Odznaky dôvery a certifikácie · Denník aktualizácií
Odkazy, kotvy a ďalšia akcia.
Kotviace odkazy · Omrvinky · CTA bloky · Odkazy na slovníkové pojmy a tooltipy · Inline CTA tlačidlo · Moduly interných odkazov · Mini banner · Záchyt newslettera · Bloky súvisiaceho obsahu
Otvoracie hodiny, adresa, mapa a rezervácia.
Rezervačné bloky · Bloky otváracích hodín a kontaktu · Mapové bloky · NAP bloky
Ako stránka končí a čo pýta ďalej.
Jeden prvok, tri formáty
Každý prvok má jeden konceptuálny kontrakt a adaptéry pre prenosný Markdown, Hugo a WordPress.
Predstavte si tip s názvom a telom voliteľnej rady. Jeho účel, povolený obsah, rola prístupnosti, umiestnenie a pravidlá QA zostávajú konštantné. Mení sa len notácia.
:::tip{title="Keep the query stable"}
Change one variable at a time.
:::Čitateľné v zdroji a nezávislé od témy stránky.
{{< callout type="tip" title="Keep the query stable" >}}
Change one variable at a time.
{{< /callout >}}Adaptér mapuje pomenované polia do schváleného komponentu.
<!-- wp:amicited/tip
{"title":"Keep the query stable"} -->
<p>Change one variable at a time.</p>
<!-- /wp:amicited/tip -->Natívne ovládacie prvky editora zachovávajú rovnaký typ a polia.
Prenosnosť nie je kopírovanie vykresleného HTML. Každý adaptér akceptuje rovnaký zmysluplný vstup, vynucuje ekvivalentné obmedzenia a vytvára výstup primeraný kanálu. Ak pole nemožno bezpečne namapovať, adaptér musí zlyhať viditeľne alebo zdokumentovať riadený fallback; nesmie ticho zahodiť význam.
Čo je na každej stránke prvku
Každá podrobná stránka je verejným návodom a produkčnou špecifikáciou. Odstraňuje dohady, ktoré by sa inak vracali v každej implementácii.
| Oblasť | Zodpovedaná otázka | Zabránené zlyhanie |
|---|---|---|
| Účel a ne-účel | Akú úlohu plní a ktorá podobná úloha patrí inde? | Tip nesúci povinný krok alebo definícia stávajúca sa mini-článkom. |
| Tabuľka parametrov | Ktoré polia sú povinné, voliteľné, typované, opakovateľné a obmedzené? | Adaptéry akceptujúce rôzne dáta alebo viacero myšlienok skrytých v jednom poli. |
| Pravidlá umiestnenia | Kde sa môže objaviť, ako často a vedľa čoho? | Poznatky pochované v strede stránky alebo zdroje oddelené od tvrdení. |
| Galéria variantov | Ktoré pomenované variácie existujú a kedy je každá vhodná? | Vizuálne jednorazovky maskované ako oficiálne varianty. |
| Dobré versus zlé | Čo robí vyhovujúci príklad, čo pravdepodobné zlyhanie vynecháva? | Tímy kopírujúce syntax, pričom im uniká účel. |
| Mapovanie schém | Ako sa polia mapujú na HTML, prístupnosť, schému, API a feedy? | Viditeľný obsah v rozpore so strojovým výstupom. |
| QA | Čo môže automatizácia vynútiť a čo vyžaduje úsudok? | Platný blok publikovaný s vágnym, nepravdivým, zastaraným alebo nevhodne umiestneným obsahom. |
Automatizácia môže kontrolovať povinné polia, počty, dĺžky, umiestnenie, identifikátory, URL a podporu adaptérov. Redakčná QA musí kontrolovať presnosť, užitočnosť, kvalitu dôkazov, proporčné zdôraznenie a to, či je prvok vhodný pre úlohu čitateľa.
Ktoré prvky sú povinné
Povinný znamená, že systém očakáva funkciu v podstate v každom kompletnom type príspevku. Neznamená to, že každý blok musí byť veľký alebo identický.
- Frontmatter vytvára identitu, vlastníctvo, objaviteľnosť a prepojenia.
- Úvod potvrdzuje rozsah a vhodnosť pre čitateľa.
- Kľúčové poznatky zobrazujú podložené závery na podstatných stránkach.
- FAQ rieši skutočné zostávajúce otázky.
- Zdroje robia faktickú podporu dohľadateľnou.
- Súvisiaci obsah poskytuje ďalšiu cestu učenia.
- CTA ponúka jednu proporcionálnu akciu.
- Použite definíciu, keď pojem potrebuje ohraničený význam.
- Použite priamu odpoveď pre jasnú primárnu otázku.
- Použite kroky pre usporiadaný postup a overiteľný výsledok.
- Použite porovnania, keď čitatelia hodnotia alternatívy podľa konzistentných kritérií.
- Použite tip pre voliteľné zlepšenie a varovanie pre materiálne riziko.
- Použite anotované médiá, keď vizuál komunikuje niečo, čo próza nedokáže rovnako efektívne.
Výnimky sú dôležité. Krátka definícia v slovníku nemusí potrebovať samostatné kľúčové poznatky. Stránka bez externe podloženého faktického tvrdenia nemusí potrebovať viditeľné referencie. FAQ s vymyslenými otázkami je horšie ako žiadne. Špecifikácie typov príspevkov stanovujú predvolené hodnoty; autori dokumentujú odôvodnené vynechania namiesto mechanického vypĺňania políčok.
Začnite s relevantnou špecifikáciou typov príspevkov, ktorá usporiada obvyklé prvky pre úlohu čitateľa. Potom aplikujte pravidlo priority sekciu po sekcii. Výsledkom nie je prázdna stránka ani rigidný formulár: je to riadená zostava s priestorom pre originálnu argumentáciu, dôkazy, príklady a hlas.
Typované prvky umožňujú agentovi skladať namiesto vymýšľania
Knižnica prvkov je miesto, kde obsahový systém prestáva byť dokumentom a stáva sa niečím, čo stroj vie vykonať. Blok s deklarovanými poľami buď má, čo potrebuje, alebo viditeľne nemá.
Porovnávacia tabuľka potrebuje porovnateľné možnosti, uvedenú dimenziu na každý riadok a dátum overenia. Keď jeden z týchto vstupov neexistuje, typovaný blok dáva agentovi priestor na hlasné zlyhanie.
Voľná próza takúto vlastnosť nemá. Požiadaný o tabuľku bez údajov, agent aj tak tabuľku vytvorí a vymyslená bunka vyzerá rovnako ako preskúmaná.
Skontrolujte knižnicu podľa účelu pred písaním nadpisu. Tento pokyn nasleduje agent oveľa spoľahlivejšie ako človek pod termínom, pretože agent skutočne znovu prečíta celú knižnicu zakaždým.
Toto je prípad, kde je agent lepším operátorom: pravidlo je mechanické a mechanické je to, na čo sú agenti určení.
Každý prvok je definovaný raz a vyjadrený ako prenosná Markdown direktíva, Hugo shortcode a WordPress blok. Agent pracuje s prenosnou formou a nikdy nemusí vedieť, do ktorého CMS výstup padne.
To tiež znamená, že zmena CMS nezneplatní obsahový systém ani nevyžaduje znovuučenie agenta.
Pretože prvky sú typované, korpus možno dopytovať. Ktoré stránky nemajú blok zdrojov. Ktoré porovnávacie tabuľky nemajú dátum overenia. Ktoré priame odpovede presahujú svoj limit.
Takýto audit môžete spustiť len na obsahu zostavenom z pomenovaných blokov. Próza nie je dopytovateľná, takže kontrola kvality založená na próze neškáluje za počet stránok, ktoré človek dokáže prečítať.
Každá stránka prvku nesie tabuľku parametrov s povinnými poľami, minimami a maximami, pravidlami umiestnenia a kontrolným zoznamom QA. To je úroveň presnosti, ktorú agent potrebuje na zostavenie bez hádania – a rovnaká presnosť robí výstup skontrolovateľným človekom v zlomku času.
Obsahové prvky FAQ
Obsahový prvok je pomenovaný, typovaný, parametrizovaný blok s definovaným účelom, povolenými poľami, pravidlami umiestnenia, limitmi dĺžky, správaním pri vykreslení a kontrolami kvality. Ukladá obsah a funkciu.
Voľný text používajte, keď žiadny prvok z knižnice nezodpovedá účelu. Analýzy, rozprávanie, prechody a jedinečné vysvetlenia často zostávajú prózou; zavedené definície, varovania, porovnania, zdroje a CTA nie.
Nie. Kontrakt štandardizuje štruktúru a funkciu, nie závery ani hlas. Autori si stále vyberajú argumenty, dôkazy, príklady a slovné vyjadrenie.
Áno. Prenosný kontrakt je nezávislý od prezentácie. Adaptéry mapujú rovnaké polia do natívnej syntaxe a značenia pri zachovaní validácie a sémantiky.
Postavte jednu stránku z blokov, ktoré môžete riadiť vo veľkom meradle
Bezplatná kontrola · 7-dňová skúška · vyžadovaná platobná karta