Casetă de definiție: Format, reguli și exemple

O casetă de definiție oferă termenului principal al paginii o explicație exactă și delimitată înainte ca articolul să îl dezvolte. Este un element de deschidere: o componentă de conținut reutilizabilă care apare aproape de început, deoarece cititorul nu ar trebui să fie nevoit să deducă termenul central din exemple, beneficii sau context.

Acest exemplu live este elementul complet, nu un预告 pentru o definiție mai jos pe pagină. Titlul său este opțional; corpul său nu este. Contractul de producție de mai jos stabilește când aparține elementul, ce înseamnă fiecare câmp și cum se mapează același conținut între sistemele de publicare.

De ce contează acest element

Rareori cititorii încep o pagină informațională citind fiecare cuvânt în ordine. Ei scanează titlul, primele rânduri, titlurile și blocurile distincte vizual pentru a decide dacă pagina răspunde întrebării lor. O definiție îngropată într-un paragraf introductiv îl obligă pe cititor să separe răspunsul de context, afirmații și pregătirea terenului. Caseta elimină această muncă: granița sa spune „aceasta este definiția".

Această graniță oferă, de asemenea, definiției o poziție stabilă și adresabilă. Editorii știu unde să o revizuiască, șabloanele știu unde să o redea, iar revizuirile viitoare nu îl obligă pe cititor sau pe un control de calitate să caute prin mai multe paragrafe de început. Plasarea consecventă contează în întreaga bibliotecă, deoarece aceeași sarcină informațională nu ar trebui să se mute imprevizibil de la o pagină la alta.

Extractibilitatea automată este capacitatea software-ului de a izola o unitate de conținut fără a-i pierde sensul. O definiție tipizată, cu titlu și corp, poate fi indexată, comparată, citată sau transformată independent. O propoziție care doar întâmplător definește un termen în interiorul textului liber se dizolvă în textul înconjurător: software-ul trebuie să ghicească unde începe definiția, unde se termină și dacă afirmația precedentă face parte din ea. Urmează regulile de redactare a elementelor pentru ca identitatea semantică să supraviețuiască chiar și atunci când designul vizual se schimbă.

Textul trebuie să funcționeze și fără casetă. Stilizarea creează contrast pentru oameni; un subiect, verb și sens distinctiv autonome creează extractibilitate pentru mașini. „Este o metodă de îmbunătățire a acestora" eșuează atunci când este separat de paragraful său. „Pruning-ul de conținut este procesul de eliminare, consolidare sau actualizare a paginilor care nu mai servesc un scop util de căutare sau de afaceri" supraviețuiește.

Când să îl folosești

Folosește o casetă de definiție atunci când pagina este organizată în jurul unui singur termen și acel termen poate fi definit precis într-o declarație scurtă. Este obligatorie pentru formatele de termen de glosar și ce-este-X. Este, de asemenea, obligatorie pentru conținutul de tip diagnostic sau afecțiune: cititorul trebuie să știe ce este afecțiunea denumită înainte de a lua în considerare cauze, teste sau remedii.

Paginile axate pe simptome și ghidurile practice folosesc rar acest element. Adaugă-l doar atunci când o definiție scurtă rezolvă o ambiguitate reală necesară pentru sarcină. De exemplu, un ghid intitulat „Cum să repari canibalizarea de cuvinte cheie" poate defini canibalizarea de cuvinte cheie înaintea pașilor, deoarece diagnosticul determină care soluție se aplică. Un ghid intitulat „Cum să schimbi o etichetă title" nu are nevoie de o casetă care să definească o etichetă title dacă publicul și instrucțiunile de deschidere fac deja obiectul neambiguu.

Nu folosi o casetă de definiție pentru:

• O introducere largă, istoric, afirmație despre beneficii sau explicație a motivului pentru care subiectul contează. Aceste pasaje dezvoltă articolul; nu definesc termenul.
• Un rezumat al paginii. Un rezumat adună mai multe concluzii, în timp ce o definiție enunță sensul unui singur termen.
• O promisiune de produs, precum „AmICited este cea mai simplă modalitate de a îmbunătăți vizibilitatea." Aceasta este poziționare, nu o definiție verificabilă.
• Un avertisment, precauție, condiție prealabilă sau sfat. Sarcina sa comunicativă este diferită, chiar și atunci când o temă l-ar face să pară același panou colorat.
• Un termen secundar introdus la jumătatea articolului. Definește acel termen în propoziția în care apare prima dată sau dă-i propria pagină atunci când merită un tratament susținut.
• Un citat a cărui autoritate înlocuiește claritatea. Atribuie o definiție formală în textul înconjurător atunci când atribuirea este necesară; păstrează caseta lizibilă ca declarație directă.

Ceea ce aproape întotdeauna nu este corect este o „introducere la definiție": „Rata de pierdere a clienților este unul dintre cele mai importante concepte pentru afacerile cu abonamente, iar înțelegerea ei poate transforma creșterea." Aceasta spune că conceptul contează, dar nu spune niciodată ce este. Caseta nu poate face precisă o pregătire goală a terenului.

Unde să îl plasezi

Plasarea codifică prioritatea. Pune caseta de definiție imediat după paragraful introductiv sau introducerea scurtă, ca prim bloc de conținut. Introducerea stabilește de ce se află cititorul pe pagină; apoi caseta fixează sensul înainte ca orice cauze, exemple, beneficii, pași sau comparații să depindă de el.

Nu plasa navigare, un cuprins, concluzii cheie, o galerie de imagini sau un îndemn promoțional între introducere și definiție. Aceste blocuri îl forțează pe cititor să traverseze materiale irelevante înainte de a primi sensul termenului. Breadcrumb-urile și hero-ul paginii fac parte din șablon, nu din conținutul creat de autor, deci pot preceda introducerea.

Folosește o singură casetă de definiție pe pagină. Regula există deoarece componenta identifică obiectul definițional principal al paginii. Două casete creează doi termeni principali concurenți și fac extracția ambiguă. Dacă ambii termeni sunt într-adevăr principali, împarte subiectul în două pagini și conectează-le în text. Dacă al doilea termen este subordonat, definește-l în linie, fără a-l stiliza ca un al doilea răspuns canonic.

Un bloc de răspuns direct poate coexista cu o definiție doar atunci când răspunde la o întrebare principală diferită. Pe o pagină de diagnostic, definiția poate enunța ce este afecțiunea, în timp ce răspunsul direct enunță prima acțiune recomandată. Atunci când întrebarea principală a paginii este „Ce este X?", răspunsul direct și definiția sunt același răspuns. Combină-le într-o singură casetă de definiție; versiunile adiacente doar repetă textul și concurează pentru extracție.

Anatomie

Elementul are două zone create de autor și o relație structurală. Captura de ecran trebuie să arate elementul redat fără a include text explicativ în imagine; legenda de mai jos rămâne selectabilă, accesibilă și ușor de întreținut atunci când designul se schimbă.

Legendă redată

1. Titlu opțional: De obicei „Ce este X?" Identifică termenul exact și nu trebuie să adauge o a doua afirmație.
2. Corp obligatoriu: O definiție autonomă care denumește termenul, îl plasează într-o categorie utilă și enunță ce îl diferențiază.
3. Poziție de deschidere: Caseta urmează după introducere și precedă prima secțiune explicativă. Această relație face parte din contract, chiar dacă nu este un câmp.

Chenarul, fundalul, padding-ul, tratamentul pictogramei și tipografia aparțin motorului de redare. Autorii furnizează sens, nu elemente vizuale. Elementul trebuie să rămână comprehensibil dacă fiecare stil decorativ este eliminat.

Exemple de design

Galeria acoperă variantele de conținut suportate, fără a inventa tipuri semantice diferite. Fiecare captură ar trebui să refolosească aceeași definiție acolo unde este posibil, astfel încât evaluatorii să poată judeca gestionarea titlului, împachetarea corpului și comportamentul pe diferite viewporturi, în loc să compare text diferit.

Cu titlu: Varianta preferată atunci când termenul este necunoscut, ambiguu, prescurtat sau diferit de titlul exact al paginii.

Fără titlu: Permisă atunci când titlul paginii și introducerea imediat precedentă fac subiectul de nerecunoscut. Corpul trebuie totuși să denumească termenul; omiterea titlului nu permite niciodată pronumelor precum „acesta" să înlocuiască subiectul.

Lungime maximă: Motorul de redare împachetează corpul complet. Nu trebuie să trunchieze, să colapseze, să deruleze sau să reducă fontul pentru a acomoda textul la maximum editorial.

Viewport îngust: Titlul și corpul își păstrează ordinea, lungimea lizibilă a rândurilor și granița vizibilă. Niciun sens nu poate depinde de o pictogramă care se mută lângă text.

Parametri

Parametrii separă conținutul de prezentare. Limitele lor mențin definițiile comparabile între pagini și împiedică transformarea componentei într-un callout cu scop general.

Parametrii casetei de definiție

Motorul de redare poate deriva termenul pentru indexare, dar autorii nu trebuie să scrie niciodată un corp care depinde de afișarea acelui câmp derivat. O definiție copiată trebuie să își denumească subiectul explicit.

Sintaxă și exemple de cod

Toate cele trei forme poartă același titlu și corp. Directiva portabilă Markdown este forma canonică de autor; Hugo și WordPress sunt adaptoare. Exemplele folosesc în mod deliberat aceeași formulare, astfel încât un test de migrare să poată compara valorile, nu doar aspectul.

Directivă portabilă Markdown

:::definition
## Ce este pruning-ul de conținut?

Pruning-ul de conținut este procesul de eliminare, consolidare sau actualizare a paginilor care nu mai servesc un scop util de căutare sau de afaceri.
:::

Primul titlu se mapează la title; tot ce urmează după el se mapează la body. Omite titlul pentru varianta fără titlu, dar păstrează termenul în corp.

Shortcode Hugo

{{< callout type="note" title="Ce este pruning-ul de conținut?" >}}Pruning-ul de conținut este procesul de eliminare, consolidare sau actualizare a paginilor care nu mai servesc un scop util de căutare sau de afaceri.{{< /callout >}}

Site-ul reutilizează motorul de redare callout existent pentru tratamentul Hugo vizibil. Contractul de definiție provine tot din sursa portabilă tipizată: note este aici un adaptor de redare, nu o permisiune de a pune note obișnuite în casetele de definiție.

Bloc sau shortcode WordPress

[definition title="Ce este pruning-ul de conținut?"]Pruning-ul de conținut este procesul de eliminare, consolidare sau actualizare a paginilor care nu mai servesc un scop util de căutare sau de afaceri.[/definition]

O implementare WordPress poate expune aceleași câmpuri ca un bloc personalizat. Valorile stocate rămân title și body; controalele editorului, culorile și spațierea sunt setări de prezentare și nu trebuie să modifice sensul definiției.

Exemple

Acesta este un exemplu bun deoarece denumește termenul, identifică condiția și enunță consecința distinctivă. Nu susține că fiecare pereche de pagini care împart un cuvânt concurează; sintagma „aceeași intenție de căutare" oferă granița necesară. Corpul este util fără titlu și suficient de scurt pentru a fi citat integral.

Acesta este un exemplu prost deoarece nu definește niciodată canibalizarea de cuvinte cheie. Oferă importanță, public, urgență și un efect vag, dar nicio categorie sau condiție distinctivă. Înlocuirea „una dintre cele mai importante" cu „o situație în care mai multe pagini concurează pentru aceeași intenție de căutare" transformă promovarea în sens.

Un al doilea model prost este supraîncărcarea casetei: o definiție urmată de cauze, cinci exemple, un avertisment și un instrument recomandat. Chiar dacă prima propoziție este corectă, materialul suplimentar distruge granița stabilă. Păstrează definiția; mută cauzele și exemplele în secțiunea următoare, avertismentul în elementul său corect și recomandarea la punctul în care cititorul poate acționa pe baza ei.

Marcare schema și accesibilitate

O casetă de definiție nu creează automat o entitate Schema.org independentă. Pe un articol obișnuit, textul său rămâne parte din Article sau TechArticle înconjurător. Pe o pagină de glosar, o implementare de publicare poate mapa termenul și definiția către un vocabular adecvat doar atunci când site-ul a adoptat acea politică de schemă. Nu inventa un tip DefinitionBox: acesta nu există în Schema.org.

De asemenea, nu duplica corpul în JSON-LD doar pentru că caseta arată importantă. Marcarea schema trebuie să descrie pagina corect, iar duplicarea textului vizibil într-o proprietate fără legătură creează zgomot, nu un sens mai puternic. Dacă o proprietate schema este populată, valoarea sa trebuie să se potrivească cu definiția vizibilă ca substanță și să se actualizeze odată cu ea.

Elementul nu are nevoie de un rol ARIA interactiv. Redă-l în ordinea normală a documentului ca o regiune etichetată sau un container semantic, cu titlul înaintea corpului. Nu folosi role="alert", deoarece o definiție statică nu este o informație urgentă sau nou sosită. Nu folosi culoarea sau o pictogramă ca unic semnal că blocul este o definiție. Dacă titlul este implementat ca titlu (heading), nivelul său trebuie să urmeze ierarhia paginii; ## din sursă este o convenție de mapare a câmpurilor, nu o instrucțiune de a crea un salt invalid de titlu.

Comportamentul la tastatură este comportamentul obișnuit de citire: caseta în sine nu este focusabilă. Orice link din interior urmează semantica normală a linkurilor și are nevoie de o ancoră descriptivă. Ieșirea pentru cititoarele de ecran trebuie să păstreze aceeași ordine titlu-apoi-corp vizibilă pe ecran.

Reguli de redactare

Scrie definiția înainte de a scrie beneficiile sale. Începe cu termenul propriu-zis, apoi folosește un verb de legătură precum „este", „înseamnă" sau „apare atunci când". Enunță cea mai apropiată categorie utilă și caracteristica care separă termenul de conceptele învecinate. Această secvență există deoarece categoria fără distincție este largă, iar distincția fără categorie îl lasă pe cititor nesigur ce fel de lucru este termenul.

Păstrează corpul la maximum aproximativ 300 de caractere, incluzând spațiile. De preferință o singură propoziție. O a doua propoziție scurtă este acceptabilă doar atunci când o graniță necesară nu poate fi exprimată clar în prima. Limita este editorială, nu o invitație de a comprima punctuația, elimina articolele sau îngrămădi propoziții. Dacă acuratețea necesită mai mult spațiu, pune nucleul exact în casetă și califică-l imediat după aceea.

Folosește un ton neutru, declarativ. Evită „important", „puternic", „revoluționar", „trebuie să știi" și judecăți similare. Evită definițiile circulare precum „optimizarea de conținut este acțiunea de a optimiza conținutul". Extinde abrevierile la prima utilizare, cu excepția cazului în care abrevierea însăși este termenul paginii. Folosește același nume canonic care apare în titlul paginii.

Nu plasa niciodată în corpul casetei:

• Mai mult de un termen principal sau o listă de termeni înrudiți.
• Beneficii, istoric, cauze, simptome, exemple, pași, prezentări de produse sau îndemnuri la acțiune.
• Tabele, imagini, videoclipuri, formulare, butoane, note de subsol sau callout-uri imbricate.
• Superlative nesuportate, statistici inventate sau afirmații care necesită un paragraf de dovezi.
• Un al doilea titlu, listă cu puncte sau citat bloc.
• Pronume al căror sens depinde de introducerea precedentă.

Un link de atribuire este excepția, nu ținta. Folosește-l doar atunci când o definiție legală, științifică sau bazată pe standarde depinde de o sursă numită. Plasează citările extinse și dezacordurile între surse în textul obișnuit, unde cititorul poate vedea calificarea, în loc să confunde o formulare contestată cu o definiție universală.

Tipuri de postări care îl folosesc

Frontmatter-ul postTypes înregistrează asocierile confirmate. Tabelul traduce aceste asocieri în reguli editoriale. Formatele de tip diagnostic/afecțiune și axate pe simptome sunt descrise aici ca modele de utilizare, dar nu sunt legate ca tipuri separate de postări din playbook, deoarece nu se află în registrul canonic actual.

Cerințe pe tip de postare

Pentru paginile de tip diagnostic sau afecțiune, folosește caseta întotdeauna și plaseaz-o înaintea simptomelor, cauzelor, severității sau remediilor. Pentru paginile axate pe simptome, folosește-o doar atunci când numele simptomului are o definiție cu adevărat scurtă și stabilă. Dacă caseta ar repeta doar titlul — „Un site lent este un site care este lent" — omite-o și începe cu pragul de diagnostic sau problema observabilă în text.

Listă de verificare QA

Un evaluator verifică sensul înaintea aspectului. O casetă lustruită care conține o introducere vagă este tot o definiție eșuată.

• Un singur termen principal: Pagina și caseta definesc exact un concept principal.
• Poziție corectă: Caseta este primul bloc de conținut creat de autor după introducere, fără cuprins, concluzii cheie, galerie sau promoție inserată înaintea sa.
• O singură apariție: Nicio a doua casetă de definiție nu concurează cu răspunsul canonic.
• Definiție reală: Corpul enunță ce este termenul sau când există condiția; nu spune doar de ce contează termenul.
• Formulare autonomă: Corpul își denumește subiectul și are sens atunci când este copiat fără textul sau stilizarea din apropiere.
• Precizie: Categoria, caracteristica distinctivă și orice graniță esențială sunt corecte. Formularea nu generalizează excesiv.
• Lungime: Corpul nu depășește aproximativ 300 de caractere și rămâne lizibil, nu comprimat.
• Conținut curat: Fără beneficii, istoric, exemple, pași, afirmații despre produse, media, tabele sau elemente imbricate în interior.
• Decizia privind răspunsul direct: Dacă pagina întreabă „Ce este X?", caseta de definiție este singurul element de răspuns direct. Dacă ambele elemente apar, ele răspund la întrebări clar diferite.
• Semantică accesibilă: Titlul precedă corpul, ordinea titlurilor este validă, culoarea nu este singurul identificator și nu este prezent niciun rol de alertă sau țintă de focus inutilă.
• Paritate portabilă: Mapările Markdown, Hugo și WordPress păstrează același titlu și aceeași definiție.
• Restricție privind datele structurate: Orice valoare schema se potrivește cu textul vizibil și nu se folosește niciun tip Schema.org inventat.
• Starea capturilor de ecran: Comentariile rămân instrucțiuni de captură care nu se redau până când fișierele denumite există; nicio cale de imagine inexistentă nu este referită ca imagine.

FAQ

Șablonul de academie redă cele cinci întrebări analizate stocate în frontmatter-ul [[faq]] al acestei pagini. Împreună, ele acoperă necesitatea, coexistența cu răspunsurile directe, linkurile și citările, limita de lungime și regula unei casete pe pagină.