Obsahové elementy: bloky, z nichž je každá stránka postavena
Používejte řízenou knihovnu definic, odpovědí, kroků, srovnání, důkazů, upozornění, navigace a konverzních bloků, aby si každá sekce zachovala svou funkci napříč autory, stránkami, stroji a CMS.
Element je obsahová smlouva
Pojmenovaný, typovaný, parametrizovaný blok definuje, co do něj patří, kolik toho může obsahovat, kde se může vyskytovat a co s ním systémy mohou dělat.
- ✓Pojmenován podle účelu — definice, varování, srovnání, zdroj a CTA popisují úkoly spíše než vizuální styly.
- ✓Ohraničen parametry — štítky, položky, citace, varianty a limity zabraňují improvizovaným strukturám v odchylování.
- ✓Umístěn pravidlem — úvodní odpověď, varování v toku, závěrečný blok zdrojů a CTA pro další krok zabírají různé části dokumentu.
- ✓Vykreslen kanálem — jeden element se může stát sémantickým HTML v Hugo, nativním blokem WordPress, strukturovanými daty nebo záznamem v kanálu.
Co je obsahový element
Volný text ukládá věty. Obsahový element ukládá věty plus explicitní popis toho, co ty věty dělají.
Autor přidá H2 s názvem „Co je churn?“, následuje odstavec a první větu může zvýraznit tučně. Čtenář může odvodit, že jde o definici. Obsahový systém vidí pouze nadpis a prózu.
Nikde není zaznamenáno, zda je definice kanonická, zda musí být blízko úvodu, který pojem definuje, jak dlouhá může být nebo zda ji může jiný kanál znovu použít.
Autor vloží element definition s term (pojmem), stručným body (tělem) a volitelným kvalifikátorem. Smlouva elementu řídí umístění, přístupné značení, délku a prezentaci.
Šablona jej může vykreslit, audit najít, migrace namapovat a odpovídací systém může rozlišit definici od okolního vysvětlení.
Element je pojmenovaný, typovaný, parametrizovaný obsahový blok. „Pojmenovaný“ mu dává stabilní identitu. „Typovaný“ jej spojuje s chováním. „Parametrizovaný“ znamená, že jeho smysluplné části jsou pole namísto nediferencované hmoty. Nese také pravidla umístění, obsahové limity, varianty, požadavky na přístupnost, mapování schémat a kontroly kvality.
To neeliminuje prózu. Definice, varování nebo poznámka ke zdroji stále vyžadují přesné psaní. Eliminuje to nejednoznačnost ohledně úkolu prózy. Jazyk se může lišit při dodržení smlouvy, stejně jako různé záznamy obsahují různá data při sdílení jednoho schématu.
Proč elementy překonávají obsahová zadání
Zadání v próze může popsat požadovanou stránku. Typované elementy uchovávají její důležitá rozhodnutí i poté, co zadání opustí editorovu obrazovku.
Cílem není, aby každá stránka vypadala identicky. Je to, aby se opakované funkce chovaly předvídatelně. Případová studie a stránka se slovníkem mohou mít různé hlasy a rozvržení, zatímco jejich zdroje zůstanou dotazovatelné a jejich bloky souvisejícího obsahu zůstanou řízeny.
Pravidlo priority elementů
Pokud účel elementu odpovídá tomu, co sekce dělá, je tento element povinný – i když by nadpis a odstavec mohly zobrazit stejná slova. Volný text je záložní možnost, nikoli výchozí.
Nehledejte pouze štítek v osnově. „Klinické úvahy“ mohou skrývat varování. „Na první pohled“ může znamenat klíčové poznatky. Pojmenujte úkol čtenáře: definovat, shrnout, varovat, porovnat, instruovat, dokázat, navigovat nebo konvertovat.
Poté zkontrolujte prohlášení o účelu. Odpovídající účel má přednost před vlastním nadpisem, protože typ uchovává funkci i mimo viditelnou stránku.
Volný text je správný pro analýzu, přechody, příklady a vysvětlení bez znovupoužitelného kontraktu. Měl by spojovat elementy a rozvíjet argument, nikoli napodobovat existující komponentu.
Pokud se vzor volného textu opakuje, zaznamenejte jej k posouzení knihovny. Opakování může odhalit chybějící element, ale autoři by neměli vytvářet neoficiální komponenty stránku po stránce.
| Znění v osnově | Účel | Požadovaná volba | Co próza ztrácí |
|---|---|---|---|
| „Co je X?“ | Poskytnout jeden ohraničený význam | definiční rámeček | Definici nelze spolehlivě oddělit od kontextu. |
| „Kdy vyhledat pomoc“ nebo „kontraindikace“ | Uvést riziko, důsledek a bezpečný postup | varovný rámeček | Podmínka zastavení nemá varovnou sémantiku. |
| Praktická odbočka | Nabídnout nepovinnou radu k provedení | rámeček tipu | Odbočka konkuruje povinným krokům nebo v nich zaniká. |
| Shrnutí nahoře | Zobrazit podložené závěry | klíčové poznatky | Volný seznam nemá umístění, limit ani význam shrnutí. |
| Seznam k odškrtávání | Sledovat stavy dokončení | Element checklistu | Odrazky nerozlišují akce od pozorování nebo stavu. |
Příklad checklistu není propojen, protože jeho podrobná specifikace patří do pozdější vlny knihovny. Rozhodnutí o prioritě přesto platí: používejte schválenou implementaci checklistu tam, kde ji CMS poskytuje; nemaskujte stavy dokončení jako dekorativní odrážky.
Typované bloky vs prostý text
Viditelná věta je identická. Typovaná verze si uchovává identitu a pole, která mohou downstream systémy používat bez hádání.
Odliv zákazníků je ztráta zákazníků nebo předplatitelů během měřeného období.
Uloženo jako
{ "heading": "Co je odliv zákazníků?",
"html": "<p>Odliv zákazníků je…</p>" }Strojový výstup: nadpis a obecné HTML. Status definice, pojem, umístění a opětovné použití jsou neznámé.
Odliv zákazníků je ztráta zákazníků nebo předplatitelů během měřeného období.
Uloženo jako
{ "type": "definition",
"term": "odliv zákazníků",
"body": "Odliv zákazníků je…",
"position": "opening" }Strojový výstup: známá definice s adresovatelnými poli, validací, sémantickým vykreslením, mapováním schématu a způsobilostí pro kanály.
Rozdíl je funkční, nikoli kosmetický. Nahraďte komponentu nadpisem a odstavcem – čtenář si možná ničeho nevšimne, zatímco systém ztratí validaci, analytiku, mapování schématu, migrační logiku a portfolio dotazy. Nahrazení typovaného elementu volným textem je ztráta funkce.
Jedenáct skupin elementů
Každá živá karta odpovídá metadatům playbookFamily podřízených stránek. Počty popisují publikovanou knihovnu elementů; další jsou plánovány pro pozdější vlny.
Čtěte jako první – pravidlo priority, které řídí každý další element.
Záznam, který řídí identitu, objevitelnost a schéma.
První obrazovka: odpověď, shrnutí, definice, orientace.
Definiční rámeček · Blok přímé odpovědi · Razítko aktuálnosti · Úvodní háček · Rámeček klíčových poznatků · Obsah · Pro koho je to určeno? Pravidla publika
Bloky, které nesou argumentaci.
Akordeon · Odrážkové seznamy · Checklist · Vlastní výpisy · Rozhodovací strom · Dělat a nedělat · Pravidla pro odstavce volného textu · Systém nadpisů · Ikona · Obrázek · Infoblok · Infoblok · Seznamy kroků · Karty / Přepínač osob · Časové osy · Cik-cak sekce
Strukturovaná fakta, která může využít čtenář i stroj.
Vložené kalkulačky · Grafové bloky · Srovnávací tabulky · Cenové tabulky · Bloky kladů a záporů · Karty hodnocení · Tabulky specifikací · Statistické pásy
Tipy, poznámky a varování – používejte střídmě nebo vůbec.
Rámeček poznámky · Oznámení · Rámeček tipu · Varovný rámeček
Obrázky, videa, diagramy a jejich textové ekvivalenty.
Anotované snímky obrazovky · Vložená audio a podcasty · Diagramy a ilustrace · Galerie obrázků · Inline obrázky · Inline video · Vložená videa
Produkt, cena, dostupnost a složení.
Bloky dostupnosti · Bloky složení · Nabídkové rámečky · Produktové karty · Produktové posuvníky
Autorství, recenze, citace a sociální důkaz.
Blok životopisu autora · Blok prohlášení · Vytahovací citace a citace experta · Blok recenzováno · Bloky recenzí · Zdroje a reference · Reference · Odznaky důvěry a certifikace · Protokol aktualizací
Odkazy, kotvy a další akce.
Kotvící odkazy · Drobečková navigace · CTA bloky · Odkazy na slovníkové pojmy a bublinové nápovědy · Inline CTA tlačítko · Moduly interních odkazů · Mini banner · Záchyt newsletteru · Bloky souvisejícího obsahu
Otevírací doba, adresa, mapa a rezervace.
Rezervační bloky · Bloky otevírací doby a kontaktu · Mapové bloky · NAP bloky
Jak stránka končí a na co se ptá dál.
Jeden element, tři formáty
Každý element má jeden konceptuální kontrakt a adaptéry pro přenositelný Markdown, Hugo a WordPress.
Uvažujte tip s nadpisem a tělem nepovinné rady. Jeho účel, povolený obsah, role přístupnosti, umístění a pravidla QA zůstávají konstantní. Mění se pouze zápis.
:::tip{title="Udržujte dotaz stabilní"}
Change one variable at a time.
:::Čitelný ve zdroji a nezávislý na tématu webu.
{{< callout type="tip" title="Keep the query stable" >}}
Change one variable at a time.
{{< /callout >}}Adaptér mapuje pojmenovaná pole do schválené komponenty.
<!-- wp:amicited/tip
{"title":"Keep the query stable"} -->
<p>Change one variable at a time.</p>
<!-- /wp:amicited/tip -->Nativní ovládací prvky editoru zachovávají stejný typ a pole.
Přenositelnost není kopírování vykresleného HTML. Každý adaptér přijímá stejný smysluplný vstup, vynucuje ekvivalentní omezení a produkuje výstup přiměřený kanálu. Pokud pole nelze bezpečně namapovat, musí adaptér viditelně selhat nebo zdokumentovat řízenou záložní variantu; nesmí tiše zahazovat význam.
Co je na každé stránce elementu
Každá detailní stránka je veřejným návodem a produkční specifikací. Odstraňuje dohady, které by se jinak vracely při každé implementaci.
| Oblast | Zodpovězená otázka | Zabráněné selhání |
|---|---|---|
| Účel a ne-účel | Jakou práci vykonává a jaká podobná práce patří jinam? | Tip nesoucí povinný krok nebo definice stávající se mini-článkem. |
| Tabulka parametrů | Která pole jsou povinná, volitelná, typovaná, opakovatelná a omezená? | Adaptéry přijímající různá data nebo několik myšlenek skrytých v jednom poli. |
| Pravidla umístění | Kde se může objevit, jak často a vedle čeho? | Poznatky pohřbené uprostřed stránky nebo zdroje oddělené od tvrzení. |
| Galerie variant | Které pojmenované varianty existují a kdy je každá vhodná? | Vizuální jednorázovky vydávané za oficiální varianty. |
| Dobré versus špatné | Co dělá vyhovující příklad, co pravděpodobné selhání postrádá? | Týmy kopírující syntaxi, zatímco jim uniká účel. |
| Mapování schématu | Jak se pole mapují na HTML, přístupnost, schéma, API a kanály? | Viditelný obsah nesouhlasící se strojovým výstupem. |
| QA | Co může vynutit automatizace a co vyžaduje úsudek? | Platný blok publikovaný s vágním, nepravdivým, zastaralým nebo nevhodně umístěným obsahem. |
Automatizace může kontrolovat povinná pole, počty, délky, umístění, identifikátory, URL a podporu adaptérů. Redakční QA musí kontrolovat přesnost, užitečnost, kvalitu důkazů, proporční důraz a to, zda je element vhodný pro úkol čtenáře.
Které elementy jsou povinné
Povinný znamená, že systém očekává danou funkci v podstatě u každého úplného typu příspěvku. Neznamená to, že každý blok musí být velký nebo identický.
- Frontmatter stanovuje identitu, vlastnictví, objevitelnost a propojení.
- Úvod potvrzuje rozsah a vhodnost pro čtenáře.
- Klíčové poznatky zobrazují podložené závěry na rozsáhlých stránkách.
- FAQ řeší skutečné zbývající otázky.
- Zdroje činí faktickou podporu dohledatelnou.
- Související obsah poskytuje další cestu učení.
- CTA nabízí jednu přiměřenou akci.
- Použijte definici, když pojem potřebuje ohraničený význam.
- Použijte přímou odpověď pro jasnou primární otázku.
- Použijte kroky pro seřazený postup a ověřitelný výsledek.
- Použijte srovnání, když čtenáři hodnotí alternativy podle konzistentních kritérií.
- Použijte tip pro nepovinné zlepšení a varování pro materiální riziko.
- Použijte anotovaná média, když vizuál sděluje něco, co próza nedokáže stejně efektivně.
Výjimky jsou důležité. Krátká definice ve slovníku nemusí potřebovat samostatné poznatky. Stránka bez externě podložených faktických tvrzení nemusí potřebovat viditelné reference. FAQ s vymyšlenými otázkami je horší než žádné. Specifikace typů příspěvků nastavují výchozí hodnoty; autoři dokumentují oprávněná vynechání namísto mechanického vyplňování polí.
Začněte se specifikací relevantních typů příspěvků, která řadí obvyklé elementy pro úkol čtenáře. Poté aplikujte pravidlo priority sekci po sekci. Výsledkem není ani prázdná stránka, ani rigidní formulář: je to řízená skladba s prostorem pro originální argumentaci, důkazy, příklady a hlas.
Typované elementy umožňují agentovi skládat místo vymýšlení
Knihovna elementů je místo, kde obsahový systém přestává být dokumentem a stává se něčím, co může stroj vykonat. Blok s deklarovanými poli buď má, co potřebuje, nebo to viditelně nemá.
Srovnávací tabulka potřebuje srovnatelné možnosti, uvedenou dimenzi pro každý řádek a datum ověření. Když jeden z těchto vstupů neexistuje, typovaný blok dává agentovi prostor hlasitě selhat.
Volná próza takovou vlastnost nemá. Požádán o tabulku bez podkladových dat, agent stejně tabulku vyrobí a vymyšlená buňka vypadá stejně jako ta prozkoumaná.
Zkontrolujte knihovnu podle účelu před napsáním nadpisu. Tento pokyn následuje agent mnohem spolehlivěji než člověk pod tlakem termínu, protože agent při každém použití skutečně znovu přečte celou knihovnu.
Toto je případ, kdy je agent lepším operátorem: pravidlo je mechanické a mechanické je to, k čemu agenti slouží.
Každý element je definován jednou a vyjádřen jako přenositelná direktiva Markdown, Hugo shortcode a WordPress blok. Agent pracuje proti přenositelné formě a nikdy nemusí vědět, do kterého CMS výstup putuje.
To také znamená, že změna CMS nezneplatní obsahový systém ani nevyžaduje přeučení agenta.
Protože jsou elementy typované, lze korpus dotazovat. Kterým stránkám chybí blok zdrojů. Které srovnávací tabulky nemají datum ověření. Které přímé odpovědi překračují svůj limit.
Takový audit lze provést pouze na obsahu sestaveném z pojmenovaných bloků. Próza není dotazovatelná, a proto se kontrola kvality založená na próze neškáluje za počet stránek, které člověk dokáže přečíst.
Každá stránka elementu nese tabulku parametrů s povinnými poli, minimy a maximy, pravidly umístění a kontrolním seznamem QA. To je úroveň přesnosti, kterou agent potřebuje k tvorbě bez hádání – a stejná přesnost činí výstup přezkoumatelným člověkem za zlomek času.
Obsahové elementy FAQ
Obsahový element je pojmenovaný, typovaný, parametrizovaný blok s definovaným účelem, povolenými poli, pravidly umístění, délkovými limity, chováním při vykreslování a kontrolami kvality. Ukládá obsah i funkci.
Volný text použijte, když žádný element z knihovny neodpovídá účelu. Analýza, vyprávění, přechody a jedinečná vysvětlení často zůstávají prózou; zavedené definice, varování, srovnání, zdroje a CTA nikoli.
Ne. Smlouva standardizuje strukturu a funkci, nikoli závěry nebo hlas. Autoři si stále volí argumenty, důkazy, příklady a formulace.
Ano. Přenositelná smlouva je nezávislá na prezentaci. Adaptéry mapují stejná pole do nativní syntaxe a značení při zachování validace a sémantiky.
Postavte jednu stránku z bloků, které můžete řídit ve velkém
Bezplatná kontrola · 7denní zkušební verze · vyžadována platební karta