Elementy treści: bloki, z których zbudowana jest każda strona
Korzystaj z zarządzanej biblioteki definicji, odpowiedzi, kroków, porównań, dowodów, powiadomień, nawigacji i bloków konwersji, aby każda sekcja zachowywała swoją funkcję niezależnie od autorów, stron, maszyn i systemów CMS.
Element to kontrakt treści
Nazwany, typowany, sparametryzowany blok określa, co może się w nim znaleźć, ile może zawierać, gdzie może wystąpić i co systemy mogą z nim zrobić.
- ✓Nazwany według celu — definicja, ostrzeżenie, porównanie, źródło i CTA opisują zadania, a nie style wizualne.
- ✓Ograniczony parametrami — etykiety, elementy, cytowania, warianty i limity zapobiegają dryfowaniu improwizowanych struktur.
- ✓Umieszczony według reguły — otwierająca odpowiedź, ostrzeżenie w treści, zamykający blok źródeł i CTA następnego kroku zajmują różne części dokumentu.
- ✓Renderowany według kanału — jeden element może stać się semantycznym HTML w Hugo, natywnym blokiem WordPress, danymi strukturalnymi lub rekordem kanału.
Czym jest element treści
Dowolny tekst przechowuje zdania. Element treści przechowuje zdania plus wyraźny opis tego, co te zdania robią.
Autor dodaje H2 zatytułowane „Czym jest churn?”, następnie akapit i ewentualnie pogrubia pierwsze zdanie. Czytelnik może wywnioskować, że to definicja. System treści widzi tylko nagłówek i prozę.
Nigdzie nie jest odnotowane, czy definicja jest kanoniczna, czy musi znajdować się blisko początku, jaki termin definiuje, jak długa może być ani czy inny kanał może ją ponownie wykorzystać.
Autor wstawia element definition z term, zwięzłym body i opcjonalnym kwalifikatorem. Kontrakt elementu kontroluje umiejscowienie, dostępne znaczniki, długość i prezentację.
Szablon może go renderować, audyt może go znaleźć, migracja może go mapować, a system odpowiedzi może odróżnić definicję od otaczającego wyjaśnienia.
Element to nazwany, typowany, sparametryzowany blok treści. „Nazwany” daje mu stabilną tożsamość. „Typowany” łączy go z zachowaniem. „Sparametryzowany” oznacza, że jego znaczące części są polami, a nie niezróżnicowaną bryłą. Niesie też reguły pozycjonowania, limity treści, warianty, wymagania dostępności, mapowania schematów i kontrole jakości.
Nie eliminuje to prozy. Definicja, ostrzeżenie czy przypis do źródła nadal wymagają precyzyjnego pisania. Eliminuje to niejednoznaczność co do zadania prozy. Język może się różnić, respektując kontrakt, tak jak różne rekordy zawierają różne dane, dzieląc jeden schemat.
Dlaczego elementy wygrywają z briefami treści
Brief tekstowy może opisać pożądaną stronę. Typowane elementy zachowują jej ważne decyzje, gdy brief opuści ekran redaktora.
Celem nie jest, by każda strona wyglądała identycznie. Chodzi o to, by powtarzające się funkcje działały przewidywalnie. Studium przypadku i strona glosariusza mogą mieć różny głos i układ, podczas gdy ich źródła pozostają możliwe do przeszukiwania, a bloki powiązanych treści pozostają zarządzane.
Reguła pierwszeństwa elementów
Jeśli cel elementu odpowiada temu, co robi sekcja, ten element jest obowiązkowy — nawet gdy nagłówek i akapit mogłyby wyświetlić te same słowa. Dowolny tekst jest rozwiązaniem awaryjnym, nie domyślnym.
Nie szukaj tylko etykiety w konspekcie. „Rozważania kliniczne” mogą ukrywać ostrzeżenie. „Na pierwszy rzut oka” może oznaczać kluczowe wnioski. Nazwij zadanie czytelnika: zdefiniuj, podsumuj, ostrzeż, porównaj, poinstruuj, udowodnij, nawiguj lub konwertuj.
Następnie sprawdź opisy celów. Pasujący cel ma pierwszeństwo przed niestandardowym nagłówkiem, ponieważ typ zachowuje funkcję poza widoczną stroną.
Dowolny tekst jest odpowiedni dla analiz, przejść, przykładów i wyjaśnień bez wielokrotnego użytku kontraktu. Powinien łączyć elementy i rozwijać argumentację, a nie udawać istniejącego komponentu.
Jeśli wzór dowolnego tekstu się powtarza, zarejestruj go do przeglądu biblioteki. Powtarzalność może ujawnić brakujący element, ale autorzy nie powinni tworzyć nieoficjalnych komponentów strona po stronie.
| Sformułowanie w konspekcie | Cel | Wymagany wybór | Co traci proza |
|---|---|---|---|
| „Czym jest X?” | Podać jedno ograniczone znaczenie | blok definicji | Definicja nie może być wiarygodnie oddzielona od kontekstu. |
| „Kiedy szukać pomocy” lub „przeciwwskazania” | Określić ryzyko, konsekwencję i bezpieczne działanie | blok ostrzeżenia | Warunek zatrzymania nie ma semantyki ostrzeżenia. |
| Praktyczna dygresja | Zaoferować opcjonalną poradę wykonawczą | blok porady | Dygresja konkuruje z wymaganymi krokami lub znika wśród nich. |
| Podsumowanie na górze | Wyeksponować poparte wnioski | kluczowe wnioski | Luźna lista nie ma umiejscowienia, limitu ani znaczenia podsumowania. |
| Lista do odhaczenia | Śledzić stany ukończenia | Element checklisty | Punktory nie odróżniają działań od obserwacji ani statusu. |
Przykład checklisty jest bez linku, ponieważ jej szczegółowa specyfikacja należy do późniejszej fali biblioteki. Decyzja o pierwszeństwie nadal obowiązuje: używaj zatwierdzonej implementacji checklisty, gdy CMS ją udostępnia; nie maskuj stanów ukończenia jako dekoracyjnych punktorów.
Typowane bloki a zwykły tekst
Widoczne zdanie jest identyczne. Wersja typowana zachowuje tożsamość i pola, które systemy niższego poziomu mogą wykorzystać bez zgadywania.
Churn klientów to utrata klientów lub subskrybentów w mierzonym okresie.
Zapisane jako
{ "heading": "Czym jest churn klientów?",
"html": "<p>Churn klientów to…</p>" }Wyjście maszynowe: nagłówek i ogólny HTML. Status definicji, termin, umiejscowienie i możliwość ponownego użycia są nieznane.
Churn klientów to utrata klientów lub subskrybentów w mierzonym okresie.
Zapisane jako
{ "type": "definition",
"term": "churn klientów",
"body": "Churn klientów to…",
"position": "opening" }Wyjście maszynowe: znana definicja z adresowalnymi polami, walidacją, semantycznym renderowaniem, mapowaniem schematu i kwalifikowalnością do kanałów.
Różnica jest funkcjonalna, nie kosmetyczna. Zastąp komponent nagłówkiem i akapitem, a czytelnik może niczego nie zauważyć, podczas gdy system traci walidację, analitykę, mapowanie schematu, logikę migracji i zapytania portfolio. Zamiana typowanego elementu na dowolny tekst to utrata funkcji.
Jedenaście grup elementów
Każda aktywna karta odzwierciedla metadane playbookFamily stron podrzędnych. Liczby opisują opublikowaną bibliotekę elementów; grupy zaplanowane na późniejsze fale są oznaczone jako takie.
Przeczytaj najpierw — reguła pierwszeństwa rządząca każdym innym elementem.
Rekord, który napędza tożsamość, odkrywalność i schemat.
Pierwszy ekran: odpowiedź, podsumowanie, definicja, orientacja.
Blok definicji · Blok bezpośredniej odpowiedzi · Znacznik aktualności · Hak wprowadzający · Blok kluczowych wniosków · Spis treści · Dla kogo to jest? Zasady bloku odbiorców
Bloki niosące argumentację.
Akordeon · Listy punktowane · Checklista · Niestandardowe listowania · Drzewo decyzyjne · Zalecenia i odradzenia · Zasady akapitów dowolnego tekstu · System nagłówków · Blok ikon · Blok obrazu · Infobox · Infobox · Listy kroków · Zakładki / Przełącznik persony · Oś czasu · Sekcje zygzakowe
Ustrukturyzowane fakty, z których może skorzystać zarówno czytelnik, jak i maszyna.
Osadzone kalkulatory · Bloki wykresów · Tabele porównawcze · Tabele cenowe · Bloki zalet i wad · Karty wyników · Tabele specyfikacji · Paski statystyk
Porady, notatki i ostrzeżenia — używane oszczędnie lub wcale.
Blok notatki · Powiadomienie · Blok porady · Blok ostrzeżenia
Obrazy, wideo, diagramy i ich tekstowe odpowiedniki.
Oznaczone zrzuty ekranu · Osadzone audio i podcasty · Diagramy i ilustracje · Galeria obrazów · Obrazy w tekście · Wideo w tekście · Osadzone wideo
Produkt, cena, dostępność i skład.
Bloki dostępności · Bloki składu · Bloki ofert · Karty produktów · Suwaki produktów
Autorstwo, recenzja, cytowanie i dowód społeczny.
Blok biogramu autora · Blok zastrzeżenia · Cytat wyróżniony i cytat eksperta · Blok „Zweryfikowane przez” · Bloki recenzji · Źródła i odniesienia · Referencje · Odznaki zaufania i certyfikacje · Dziennik aktualizacji
Linki, kotwice i następne działanie.
Linki kotwiczące · Bułka tarta · Bloki CTA · Linki do terminów glosariusza i podpowiedzi · Przycisk CTA w tekście · Moduły linków wewnętrznych · Mini baner · Przechwytywanie newslettera · Bloki powiązanych treści
Godziny, adres, mapa i rezerwacja.
Bloki rezerwacji · Bloki godzin i kontaktu · Bloki map · Bloki NAP
Jak strona się kończy i o co pyta dalej.
Jeden element, trzy formaty
Każdy element ma jeden koncepcyjny kontrakt oraz adaptery dla przenośnego Markdown, Hugo i WordPress.
Rozważmy poradę z tytułem i treścią opcjonalnej rady. Jej cel, dozwolona treść, rola dostępności, pozycja i reguły QA pozostają stałe. Zmienia się tylko notacja.
:::tip{title="Zachowaj stabilne zapytanie"}
Zmieniaj jedną zmienną na raz.
:::Czytelna w źródle i niezależna od motywu strony.
{{< callout type="tip" title="Zachowaj stabilne zapytanie" >}}
Zmieniaj jedną zmienną na raz.
{{< /callout >}}Adapter mapuje nazwane pola do zatwierdzonego komponentu.
<!-- wp:amicited/tip
{"title":"Zachowaj stabilne zapytanie"} -->
<p>Zmieniaj jedną zmienną na raz.</p>
<!-- /wp:amicited/tip -->Natywne kontrolki edytora zachowują ten sam typ i pola.
Przenośność nie polega na kopiowaniu wyrenderowanego HTML. Każdy adapter przyjmuje te same znaczące dane wejściowe, egzekwuje równoważne ograniczenia i produkuje dane wyjściowe odpowiednie dla kanału. Jeśli pole nie może być bezpiecznie mapowane, adapter musi zawieść widocznie lub udokumentować kontrolowane rozwiązanie awaryjne; nie może po cichu odrzucać znaczenia.
Co znajduje się na każdej stronie elementu
Każda szczegółowa strona to publiczne wskazówki i specyfikacja produkcyjna. Eliminuje domysły, które w innym przypadku powracają przy każdej implementacji.
| Obszar | Pytanie, na które odpowiada | Błąd, któremu zapobiega |
|---|---|---|
| Cel i nie-cel | Jakie zadanie wykonuje i jakie podobne zadanie należy gdzie indziej? | Porada niosąca wymagany krok lub definicja stająca się mini-artykułem. |
| Tabela parametrów | Które pola są wymagane, opcjonalne, typowane, powtarzalne i ograniczone? | Adaptery przyjmujące różne dane lub kilka pomysłów ukrytych w jednym polu. |
| Reguły pozycjonowania | Gdzie może się pojawić, jak często i obok czego? | Wnioski zakopane w środku strony lub źródła odłączone od twierdzeń. |
| Galeria wariantów | Które nazwane warianty istnieją i kiedy każdy z nich jest odpowiedni? | Jednorazowe rozwiązania wizualne podszywające się pod oficjalne warianty. |
| Dobry kontra zły | Co robi zgodny przykład, czego brakuje prawdopodobnej porażce? | Zespoły kopiujące składnię, ale pomijające cel. |
| Mapowanie schematu | Jak pola mapują się na HTML, dostępność, schemat, API i kanały? | Widoczna treść niezgodna z wyjściem maszynowym. |
| QA | Co automatyzacja może egzekwować, a co wymaga osądu? | Ważny blok publikujący niejasną, fałszywą, nieaktualną lub źle umieszczoną treść. |
Automatyzacja może sprawdzać wymagane pola, liczebności, długości, umiejscowienie, identyfikatory, URL-e i obsługę adapterów. Redakcyjna kontrola jakości musi sprawdzać dokładność, użyteczność, jakość dowodów, proporcjonalny nacisk i to, czy element jest odpowiedni dla zadania czytelnika.
Które elementy są wymagane
Obowiązkowe oznacza, że system oczekuje danej funkcji w zasadzie w każdym kompletnym typie wpisu. Nie oznacza, że każdy blok musi być duży lub identyczny.
- Frontmatter ustanawia tożsamość, własność, odkrywalność i połączenia.
- Wprowadzenie potwierdza zakres i dopasowanie do czytelnika.
- Kluczowe wnioski eksponują poparte wnioski na obszernych stronach.
- FAQ odpowiada na rzeczywiste pozostałe pytania.
- Źródła czynią faktyczne poparcie możliwym do zweryfikowania.
- Powiązane treści dostarczają kolejnej ścieżki nauki.
- CTA oferuje jedno proporcjonalne działanie.
- Użyj definicji, gdy termin potrzebuje ograniczonego znaczenia.
- Użyj bezpośredniej odpowiedzi dla jasnego głównego pytania.
- Użyj kroków dla uporządkowanej procedury i weryfikowalnego rezultatu.
- Użyj porównań, gdy czytelnicy oceniają alternatywy według spójnych kryteriów.
- Użyj porady dla opcjonalnego ulepszenia i ostrzeżenia dla materialnego ryzyka.
- Użyj oznaczonych multimediów, gdy obraz przekazuje coś, czego proza nie jest w stanie zrobić równie efektywnie.
Wyjątki mają znaczenie. Krótka definicja glosariusza może nie potrzebować osobnych kluczowych wniosków. Strona bez zewnętrznie popartego twierdzenia faktycznego może nie potrzebować widocznych odniesień. FAQ ze zmyślonymi pytaniami jest gorsze niż jego brak. Specyfikacje typów wpisów ustalają domyślne wartości; autorzy dokumentują uzasadnione pominięcia zamiast mechanicznie wypełniać sloty.
Zacznij od odpowiedniej specyfikacji typów wpisów, która porządkuje zwykłe elementy dla zadania czytelnika. Następnie stosuj pierwszeństwo sekcja po sekcji. Efektem nie jest ani pusta strona, ani sztywny formularz: to zarządzany montaż z miejscem na oryginalną argumentację, dowody, przykłady i głos.
Typowane elementy pozwalają agentowi składać zamiast wymyślać
Biblioteka elementów to miejsce, w którym system treści przestaje być dokumentem i staje się czymś, co maszyna może wykonać. Blok z zadeklarowanymi polami albo ma to, czego potrzebuje, albo wyraźnie tego nie ma.
Tabela porównawcza potrzebuje porównywalnych opcji, określonego wymiaru w każdym wierszu i daty weryfikacji. Gdy jedna z tych danych wejściowych nie istnieje, typowany blok daje agentowi miejsce, w którym może głośno zawieść.
Dowolna proza nie ma takiej właściwości. Poproszony o tabelę bez danych, agent i tak produkuje tabelę, a zmyślona komórka wygląda dokładnie jak zbadana.
Sprawdź bibliotekę według celu przed napisaniem nagłówka. Ta instrukcja jest wykonywana znacznie bardziej niezawodnie przez agenta niż przez osobę pod presją terminu, ponieważ agent naprawdę ponownie przeczyta całą bibliotekę za każdym razem.
To przypadek, w którym agent jest lepszym wykonawcą: reguła jest mechaniczna, a mechaniczne jest właśnie zadaniem agentów.
Każdy element jest zdefiniowany raz i wyrażony jako przenośna dyrektywa Markdown, shortcode Hugo i blok WordPress. Agent pracuje na przenośnej formie i nigdy nie musi wiedzieć, w którym CMS wyląduje wynik.
Oznacza to również, że zmiana CMS nie unieważnia systemu treści ani nie wymaga ponownego uczenia agenta.
Ponieważ elementy są typowane, korpus można przeszukiwać zapytaniami. Którym stronom brakuje bloku źródeł. Które tabele porównawcze nie mają daty weryfikacji. Które bezpośrednie odpowiedzi przekraczają swój przedział.
Taki audyt można przeprowadzić tylko na treści złożonej z nazwanych bloków. Proza nie jest przeszukiwalna, więc kontrola jakości oparta na prozie nie skaluje się poza liczbę stron, które człowiek jest w stanie przeczytać.
Każda strona elementu niesie tabelę parametrów z wymaganymi polami, minimum i maksimum, regułami pozycjonowania i listą kontrolną QA. To poziom precyzji, jakiego agent potrzebuje, aby budować bez zgadywania — a ta sama precyzja sprawia, że wynik jest sprawdzalny przez człowieka w ułamku czasu.
Elementy treści FAQ
Element treści to nazwany, typowany, sparametryzowany blok o zdefiniowanym celu, dozwolonych polach, regułach pozycjonowania, limitach długości, zachowaniu renderowania i kontrolach jakości. Przechowuje treść i funkcję.
Używaj dowolnego tekstu, gdy żaden element biblioteki nie pasuje do celu. Analizy, narracje, przejścia i unikalne wyjaśnienia często pozostają prozą; ustalone definicje, ostrzeżenia, porównania, źródła i CTA — nie.
Nie. Kontrakt standaryzuje strukturę i funkcję, nie wnioski ani głos. Autorzy nadal wybierają argumenty, dowody, przykłady i sformułowania.
Tak. Przenośny kontrakt jest niezależny od prezentacji. Adaptery mapują te same pola do natywnej składni i znaczników, zachowując walidację i semantykę.
Zbuduj jedną stronę z bloków, którymi możesz zarządzać na dużą skalę
Bezpłatne sprawdzenie · 7-dniowy okres próbny · wymagana karta kredytowa