Elementi di contenuto: i blocchi con cui è costruita ogni pagina
Usa una libreria governata di blocchi di definizioni, risposte, passaggi, confronti, prove, avvisi, navigazione e conversione, così ogni sezione mantiene la sua funzione attraverso autori, pagine, macchine e CMS.
Un elemento è un contratto di contenuto
Un blocco denominato, tipizzato e parametrizzato definisce cosa gli appartiene, quanto può contenere, dove può apparire e cosa i sistemi possono farci.
- ✓Denominato per scopo — definizione, avviso, confronto, fonte e CTA descrivono compiti anziché stili visivi.
- ✓Delimitato da parametri — etichette, elementi, citazioni, varianti e limiti impediscono che strutture improvvisate vadano alla deriva.
- ✓Posizionato per regola — una risposta iniziale, un avviso nel flusso, un blocco fonti in chiusura e un CTA per il passo successivo occupano parti diverse del documento.
- ✓Renderizzato per canale — un elemento può diventare HTML semantico in Hugo, un blocco WordPress nativo, dati strutturati o un record di feed.
Cos'è un elemento di contenuto
Il testo libero memorizza frasi. Un elemento di contenuto memorizza frasi più una descrizione esplicita di cosa quelle frasi fanno.
Un autore aggiunge un H2 chiamato "Cos'è il churn?", lo segue con un paragrafo e può applicare il grassetto alla prima frase. Un lettore può dedurre che si tratta di una definizione. Il sistema di contenuti vede solo un'intestazione e prosa.
Niente registra se la definizione è canonica, se deve essere vicino all'apertura, quale termine definisce, quanto può essere lunga o se un altro canale può riutilizzarla.
L'autore inserisce un elemento definition con un term, un body conciso e un qualificatore opzionale. Il contratto dell'elemento controlla posizionamento, markup accessibile, lunghezza e presentazione.
Un template può renderizzarlo, un audit può trovarlo, una migrazione può mapparlo e un sistema di risposta può distinguere la definizione dalla spiegazione circostante.
Un elemento è un blocco di contenuto denominato, tipizzato e parametrizzato. "Denominato" gli conferisce un'identità stabile. "Tipizzato" lo collega a un comportamento. "Parametrizzato" significa che le sue parti significative sono campi invece di un blob indifferenziato. Porta anche regole di posizione, limiti di contenuto, varianti, requisiti di accessibilità, mappature schema e controlli QA.
Questo non elimina la prosa. Una definizione, un avviso o una nota fonte richiedono comunque una scrittura precisa. Elimina l'ambiguità sul compito della prosa. Il linguaggio può variare rispettando il contratto, proprio come diversi record contengono dati diversi condividendo uno stesso schema.
Perché gli elementi superano i brief di contenuto
Un brief in prosa può descrivere la pagina desiderata. Gli elementi tipizzati preservano le sue decisioni importanti dopo che il brief lascia lo schermo dell'editor.
L'obiettivo non è che ogni pagina appaia identica. È che le funzioni ripetute si comportino in modo prevedibile. Una pagina di caso studio e una di glossario possono avere voci e layout diversi mentre le loro fonti rimangono interrogabili e i loro blocchi di contenuti correlati rimangono governati.
La regola di precedenza degli elementi
Se lo scopo di un elemento corrisponde a ciò che la sezione fa, quell'elemento è obbligatorio — anche se un'intestazione e un paragrafo potrebbero mostrare le stesse parole. Il testo libero è il ripiego, non l'impostazione predefinita.
Non cercare solo l'etichetta nell'indice. "Considerazioni cliniche" può nascondere un avviso. "A colpo d'occhio" può significare punti chiave. Dai un nome al compito del lettore: definire, riassumere, avvisare, confrontare, istruire, provare, navigare o convertire.
Poi verifica le dichiarazioni di scopo. Uno scopo corrispondente ha precedenza su un'intestazione personalizzata perché il tipo preserva la funzione al di fuori della pagina visibile.
Il testo libero è giusto per analisi, transizioni, esempi e spiegazioni senza un contratto riutilizzabile. Dovrebbe collegare elementi e sviluppare l'argomentazione, non impersonare un componente esistente.
Se un pattern di testo libero si ripete, registralo per una revisione della libreria. La ripetizione può rivelare un elemento mancante, ma gli autori non dovrebbero creare componenti non ufficiali pagina per pagina.
| Formulazione nell'indice | Scopo | Scelta obbligatoria | Cosa perde la prosa |
|---|---|---|---|
| "Cos'è X?" | Fornire un significato delimitato | riquadro definizione | La definizione non può essere separata in modo affidabile dal contesto. |
| "Quando cercare aiuto" o "controindicazioni" | Indicare rischio, conseguenza e azione sicura | riquadro avviso | Una condizione di stop non ha semantica di avviso. |
| Un suggerimento pratico | Offrire consigli facoltativi di esecuzione | riquadro suggerimento | Il suggerimento compete con o scompare all'interno dei passaggi obbligatori. |
| Il riepilogo all'inizio | Evidenziare conclusioni supportate | punti chiave | Un elenco generico non ha posizionamento, limite o significato di riepilogo. |
| Un elenco da spuntare | Tracciare stati di completamento | Elemento checklist | Gli elenchi puntati non distinguono azioni da osservazioni o stato. |
L'esempio della checklist non è collegato perché la sua specifica dettagliata appartiene a una successiva ondata della libreria. La decisione di precedenza si applica comunque: usa un'implementazione approvata di checklist laddove il CMS la fornisce; non camuffare stati di completamento come elenchi puntati decorativi.
Blocchi tipizzati vs testo semplice
La frase visibile è identica. La versione tipizzata mantiene identità e campi che i sistemi downstream possono usare senza indovinare.
Il churn dei clienti è la perdita di clienti o abbonati durante un periodo misurato.
Memorizzato come
{ "heading": "Cos'è il churn dei clienti?",
"html": "<p>Il churn dei clienti è…</p>" }Output macchina: intestazione e HTML generico. Stato della definizione, termine, posizionamento e riutilizzo sono sconosciuti.
Il churn dei clienti è la perdita di clienti o abbonati durante un periodo misurato.
Memorizzato come
{ "type": "definition",
"term": "customer churn",
"body": "Il churn dei clienti è…",
"position": "opening" }Output macchina: una definizione nota con campi indirizzabili, validazione, rendering semantico, mappatura schema e idoneità al feed.
La differenza è funzionale, non estetica. Sostituisci il componente con un'intestazione e un paragrafo e il lettore potrebbe non notare nulla, mentre il sistema perde validazione, analisi, mappatura schema, logica di migrazione e interrogazioni portfolio. Sostituire un elemento tipizzato con testo libero è una perdita di funzionalità.
Gli undici gruppi di elementi
Ogni card attiva rispecchia i metadati playbookFamily delle pagine figlie. I conteggi descrivono la libreria di elementi pubblicata, pianificata per ondate successive.
Leggi prima — la regola di precedenza che governa ogni altro elemento.
Il record che guida identità, scoperta e schema.
La prima schermata: risposta, riepilogo, definizione, orientamento.
Riquadro Definizione · Blocco Risposta Diretta · Timbro di Freschezza · Gancio Introduttivo · Riquadro Punti Chiave · Indice dei Contenuti · A Chi è Destinato? Regole del Blocco Pubblico
I blocchi che portano avanti l'argomentazione.
Accordion · Elenchi Puntati · Checklist · Elenchi Personalizzati · Albero Decisionale · Cose da Fare e da Non Fare · Regole per Paragrafi in Testo Libero · Sistema di Intestazioni · Iconbox · Imagebox · Infobox · Infobox · Elenchi di Passaggi · Schede / Cambio Persona · Timeline · Sezioni Zigzag
Fatti strutturati che un lettore e una macchina possono entrambi utilizzare.
Incorporamenti Calcolatrice · Blocchi Grafico · Tabelle Comparative · Tabelle Prezzi · Blocchi Pro e Contro · Scorecard · Tabelle Specifiche · Bande Statistiche
Suggerimenti, note e avvisi — usati con parsimonia o per niente.
Riquadro Nota · Notifica · Riquadro Suggerimento · Riquadro Avviso
Immagini, video, diagrammi e loro equivalenti testuali.
Screenshot Annotati · Incorporamenti Audio e Podcast · Diagrammi e Illustrazioni · Galleria Immagini · Immagini Inline · Video Inline · Incorporamenti Video
Prodotto, prezzo, disponibilità e composizione.
Blocchi Disponibilità · Blocchi Composizione · Riquadri Offerta · Card Prodotto · Slider Prodotto
Paternità, revisione, citazione e prova sociale.
Blocco Biografia Autore · Blocco Disclaimer · Citazione in Evidenza e Citazione Esperto · Blocco Revisionato Da · Blocchi Recensioni · Fonti e Riferimenti · Testimonianze · Badge di Fiducia e Certificazioni · Registro Aggiornamenti
Link, ancoraggi e l'azione successiva.
Link Ancoraggio · Briciole di Pane · Blocchi CTA · Link e Tooltip Termini Glossario · Pulsante CTA Inline · Moduli Link Interni · Mini Banner · Cattura Newsletter · Blocchi Contenuti Correlati
Orari, indirizzo, mappa e prenotazione.
Blocchi Prenotazione · Blocchi Orari e Contatto · Blocchi Mappa · Blocchi NAP
Come una pagina termina e cosa chiede dopo.
Un elemento, tre formati
Ogni elemento ha un contratto concettuale e adattatori per Markdown portabile, Hugo e WordPress.
Considera un suggerimento con un titolo e un corpo di consigli facoltativi. Il suo scopo, contenuto consentito, ruolo di accessibilità, posizione e regole QA rimangono costanti. Cambia solo la notazione.
:::tip{title="Mantieni stabile la query"}
Cambia una variabile alla volta.
:::Leggibile nel sorgente e indipendente dal tema del sito.
{{< callout type="tip" title="Mantieni stabile la query" >}}
Cambia una variabile alla volta.
{{< /callout >}}L'adattatore mappa i campi nominati nel componente approvato.
<!-- wp:amicited/tip
{"title":"Mantieni stabile la query"} -->
<p>Cambia una variabile alla volta.</p>
<!-- /wp:amicited/tip -->I controlli nativi dell'editor preservano lo stesso tipo e campi.
La portabilità non significa copiare HTML renderizzato. Ogni adattatore accetta lo stesso input significativo, applica vincoli equivalenti e produce output appropriato al canale. Se un campo non può essere mappato in sicurezza, l'adattatore deve fallire in modo visibile o documentare un ripiego controllato; non deve scartare il significato in silenzio.
Cosa c'è in ogni pagina elemento
Ogni pagina dettaglio è una guida pubblica e una specifica di produzione. Rimuove i dubbi che altrimenti tornano in ogni implementazione.
| Area | Domanda a cui risponde | Errore prevenuto |
|---|---|---|
| Scopo e non-scopo | Che compito svolge e quale compito simile appartiene altrove? | Un suggerimento che contiene un passaggio obbligatorio o una definizione che diventa un mini-articolo. |
| Tabella parametri | Quali campi sono obbligatori, opzionali, tipizzati, ripetibili e limitati? | Adattatori che accettano dati diversi o più idee nascoste in un unico campo. |
| Regole di posizione | Dove può apparire, quanto spesso e accanto a cosa? | Punti chiave sepolti a metà pagina o fonti scollegate dalle affermazioni. |
| Galleria varianti | Quali varianti denominate esistono e quando è appropriata ciascuna? | Varianti visive singole che si spacciano per varianti ufficiali. |
| Buono contro cattivo | Cosa fa un esempio conforme che un errore plausibile perde? | Team che copiano la sintassi mentre perdono lo scopo. |
| Mappatura schema | Come si mappano i campi in HTML, accessibilità, schema, API e feed? | Contenuto visibile in disaccordo con l'output macchina. |
| QA | Cosa può imporre l'automazione e cosa richiede giudizio? | Un blocco valido pubblicato con contenuti vaghi, falsi, obsoleti o fuori posto. |
L'automazione può verificare campi obbligatori, conteggi, lunghezze, posizionamento, identificatori, URL e supporto degli adattatori. Il QA editoriale deve verificare accuratezza, utilità, qualità delle prove, enfasi proporzionata e se l'elemento è giusto per il compito del lettore.
Quali elementi sono obbligatori
Obbligatorio significa che il sistema si aspetta la funzione in essenzialmente ogni tipologia di articolo completa. Non significa che ogni blocco debba essere grande o identico.
- Frontmatter stabilisce identità, proprietà, scoperta e collegamenti.
- Introduzione conferma l'ambito e l'idoneità per il lettore.
- Punti chiave evidenziano conclusioni supportate su pagine sostanziali.
- FAQ risolve genuine domande residue.
- Fonti rendono verificabile il supporto fattuale.
- Contenuti correlati forniscono il percorso di apprendimento successivo.
- CTA offre un'azione proporzionata.
- Usa una definizione quando un termine necessita di un significato delimitato.
- Usa una risposta diretta per una chiara domanda primaria.
- Usa passaggi per una procedura ordinata e un risultato verificabile.
- Usa confronti quando i lettori valutano alternative su criteri coerenti.
- Usa un suggerimento per un miglioramento facoltativo e un avviso per un rischio materiale.
- Usa media annotati quando il visivo comunica qualcosa che la prosa non può fare altrettanto efficientemente.
Le eccezioni contano. Una breve definizione da glossario potrebbe non aver bisogno di punti chiave separati. Una pagina senza affermazioni fattuali supportate esternamente potrebbe non aver bisogno di riferimenti visibili. Una FAQ con domande inventate è peggio di nessuna FAQ. Le specifiche delle tipologie di articolo impostano valori predefiniti; gli autori documentano omissioni giustificate invece di riempire slot meccanicamente.
Inizia con la specifica delle tipologie di articolo pertinente, che ordina gli elementi usuali per il compito del lettore. Poi applica la precedenza sezione per sezione. Il risultato non è né una pagina vuota né un modulo rigido: è un assemblaggio governato con spazio per argomentazioni originali, prove, esempi e voce.
Gli elementi tipizzati permettono a un agente di assemblare invece di inventare
La libreria elementi è il punto in cui un sistema di contenuti smette di essere un documento e diventa qualcosa che una macchina può eseguire. Un blocco con campi dichiarati o ha ciò che gli serve o visibilmente non ce l'ha.
Una tabella comparativa ha bisogno di opzioni confrontabili, una dimensione dichiarata per riga e una data di verifica. Quando uno di questi input non esiste, un blocco tipizzato dà all'agente un punto in cui fallire rumorosamente.
La prosa libera non ha questa proprietà. Se a un agente viene chiesta una tabella senza dati dietro, produce comunque una tabella, e la cella inventata sembra identica a una ricercata.
Controlla la libreria per scopo prima di scrivere un'intestazione. Questa istruzione è seguita in modo molto più affidabile da un agente che da una persona con una scadenza, perché un agente rileggerà genuinamente l'intera libreria ogni volta.
Questo è un caso in cui l'agente è l'operatore migliore: la regola è meccanica, e meccanico è ciò per cui gli agenti sono fatti.
Ogni elemento è definito una volta ed espresso come direttiva Markdown portabile, shortcode Hugo e blocco WordPress. L'agente lavora sulla forma portabile e non deve mai sapere in quale CMS finisce l'output.
Questo significa anche che cambiare CMS non invalida il sistema di contenuti né richiede di re-insegnare all'agente.
Poiché gli elementi sono tipizzati, il corpus può essere interrogato. Quali pagine mancano di un blocco fonti. Quali tabelle comparative non hanno una data di verifica. Quali risposte dirette superano il loro limite.
Puoi eseguire quell'audit solo su contenuti assemblati da blocchi denominati. La prosa non è interrogabile, quindi il controllo qualità basato sulla prosa non scala oltre il numero di pagine che una persona può leggere.
Ogni pagina elemento porta una tabella parametri con campi obbligatori, minimi e massimi, regole di posizione e una checklist QA. Questo è il livello di precisione di cui un agente ha bisogno per costruire senza indovinare — e la stessa precisione rende l'output verificabile da un umano in una frazione del tempo.
Elementi di contenuto FAQ
Un elemento di contenuto è un blocco denominato, tipizzato e parametrizzato con uno scopo definito, campi consentiti, regole di posizione, limiti di lunghezza, comportamento di rendering e controlli di qualità. Memorizza contenuto e funzione.
Usa testo libero quando nessun elemento della libreria corrisponde allo scopo. Analisi, narrazione, transizioni e spiegazioni uniche rimangono spesso in prosa; definizioni stabilite, avvisi, confronti, fonti e CTA no.
No. Il contratto standardizza struttura e funzione, non conclusioni o voce. Gli autori scelgono ancora argomentazioni, prove, esempi e parole.
Sì. Il contratto portabile è indipendente dalla presentazione. Gli adattatori mappano gli stessi campi in sintassi e markup nativi preservando validazione e semantica.
Costruisci una pagina con blocchi che puoi governare su larga scala
Verifica gratuita · Prova di 7 giorni · carta di credito richiesta