Pravidlá pre odseky s voľným textom: Kedy je obyčajná próza správna

Voľný text je obyčajná próza, ktorá nesie súvislé vysvetlenie, argumentáciu, rozprávanie alebo prechod. Je to záložná forma obsahu, nie predvolená voľba: pred napísaním odseku overte, že pasáž nemá presnejšie určenie, ktoré už reprezentuje nejaký pomenovaný prvok.

Praktické pravidlo je jednoduché: vyberajte podľa účelu, nie podľa vzhľadu. Odsek, ktorý definuje hlavný pojem stránky, je stále definíciou, aj keby obyčajná próza vyzerala prijateľne. Odsek obsahujúci tri usporiadané činnosti je stále postup. Voľný text používajte len vtedy, keď jeho hodnota pochádza z prepojeného uvažovania, ktoré by sa malo čítať ako vety v postupnosti.

Prečo na tomto prvku záleží

Odseky sú flexibilné, a práve preto sa dajú ľahko zneužiť. Takmer akýkoľvek materiál možno vtesnať do prózy: pokyny možno pochovať vo vete, porovnávacie kritériá roztrúsiť cez štyri odseky a varovania zjemniť na vedľajšiu poznámku. Slová môžu zostať gramaticky správne, zatiaľ čo obsah sa stáva ťažšie prehľadným, extrahovateľným, udržiavateľným a overiteľným.

Pomenovaný prvok dáva sľub o účele. Zoznam krokov sľubuje usporiadaný postup. Varovanie sľubuje materiálne riziko. Porovnávacia tabuľka sľubuje konzistentné atribúty naprieč alternatívami. Voľný text dáva užší sľub: vzťah medzi vetami je dôležitejší než opakované pole alebo samostatne skenovateľná jednotka. Čitatelia by mali byť schopní sledovať myšlienkový pochod od tvrdenia k dôvodu, príkladu, obmedzeniu a záveru.

Tento súvislý tvar pomáha aj vyhľadávacím a odpovedacím systémom. Samostatný odsek možno extrahovať ako pasáž, ak pomenúva svoju tému, uvádza úplné tvrdenie a ponecháva potrebné obmedzenia v blízkosti. Extrahovateľnosť strojom však nie je dôvodom na to, aby sa každá veta zmenila na drobný odsek. Fragmentovanie argumentu odstraňuje vzťahy, vďaka ktorým je tvrdenie presné.

Riadiacim pravidlám písania prvkov preto typované prvky získavajú prednosť pred voľným textom. Táto stránka pridáva záložné pravidlá: ako rozhodnúť, že próza je naozaj správna, aké dlhé by mali byť jej odseky a ako udržať jednu súvislú myšlienku v každom odseku.

Kedy ho použiť

Použite voľný text, keď pasáž plní jednu zo štyroch úloh:

• Vysvetlenie: rozvíja, prečo alebo ako niečo funguje, prostredníctvom prepojeného uvažovania.
• Analýza: interpretuje dôkazy, kompromisy, príčiny alebo dôsledky, ktoré nemožno zredukovať na nezávislé bunky.
• Rozprávanie: opisuje udalosti alebo prípad v poradí, ktorého význam závisí od kontextu a kauzality.
• Prechod: spája dve časti tým, že uzatvára predchádzajúci bod a rámcuje nasledujúci.

Pred písaním vykonajte kontrolu priority:

1. Pomenujte primárnu úlohu pasáže ako sloveso: definovať, odpovedať, varovať, inštruovať, porovnať, zhrnúť, dokázať, citovať, odporučiť alebo vysvetliť.
2. Vyhľadajte v knižnici prvkov túto úlohu a jej blízke synonymá.
3. Ak sa pomenovaný prvok zhoduje s primárnou úlohou, použite ho a dodržte jeho zmluvu.
4. Ak sa žiadny pomenovaný prvok nezhoduje a hodnotou je uvažovanie od vety k vete, použite voľný text.
5. Ak pasáž obsahuje oboje, umiestnite typovaný prvok ako prvý alebo vedľa prózy, ktorú riadi; neskrývajte typovaný účel vo vnútri odseku.

Napríklad „Vyberte Exportovať, zvoľte CSV a potom stiahnite súbor“ nie je odsek len preto, že sa zmestí na jeden riadok. Poradie ovplyvňuje výsledok, preto patrí do zoznamu krokov . „CSV zachováva tabuľkové hodnoty, ale nie vzorce, preto je vhodný na importovanie výsledkov do iného systému“ je vysvetľujúce uvažovanie a patrí do prózy.

Nepoužívajte voľný text na vyhýbanie sa práci s modelovaním obsahu. Paralelné voľby patria do odrážkového zoznamu ; hlavný pojem môže vyžadovať definičný box ; opakované atribúty naprieč alternatívami patria do porovnávacej tabuľky . Štylizovanie odseku tučnými popiskami tieto vzťahy nesprístupní.

Kam ho umiestniť

Umiestnite voľný text tam, kde stránka potrebuje uvažovanie medzi štrukturálnymi prvkami. Zvyčajná postupnosť je nadpis, úvodný odsek, podporný prvok, potom interpretácia. Úvodný odsek stanovuje tvrdenie a rozsah časti skôr, než sa čitateľ stretne s dôkazmi, príkladmi alebo ovládacími prvkami. Odsek po tabuľke alebo obrázku by mal vysvetliť záver, nie opakovať každú hodnotu.

Voľný text môže tiež spájať susedné prvky. Prechod za definíciou môže vysvetliť, prečo na rozlíšení záleží, skôr než stránka prejde k príkladom. Odsek pred postupom môže stanoviť predpoklady alebo rozhodovací kontext, ale samotné predpoklady a činnosti musia zostať vo svojich pomenovaných poliach alebo prvkoch.

Neumiestňujte osirotený odsek medzi nadpis a prvok, ktorý tento nadpis priamo napĺňa. Ak nadpis hovorí „Kroky,“ začnite prvkom krokov, pokiaľ nie je nevyhnutný krátky úvod. Neumiestňujte prózu medzi varovanie a činnosť, ktorú riadi, medzi tvrdenie a jeho citáciu ani medzi riadky tabuľky. Umiestnenie musí zachovať vzťah, ktorý odôvodnil zvolený typ.

Na úrovni stránky sa vyhýbajte dlhým súvislým blokom prózy. Tri až päť odsekov môže tvoriť súvislú podčasť, ale nová podtéma potrebuje opisný nadpis. Riešením vizuálnej monotónnosti je lepšia informačná architektúra, nie náhodné zvýraznenia alebo spam s jednou vetou na odsek.

Anatómia

Silný odsek voľného textu má štyri logické oblasti, aj keď sa vykresľujú ako jeden obyčajný prvok <p>:

1. Tématická veta: pomenúva tému a uvádza hlavné tvrdenie alebo posun odseku.
2. Rozvinutie: uvádza dôvod, mechanizmus, dôkaz alebo relevantný detail.
3. Príklad alebo obmedzenie: konkretizuje tvrdenie alebo stanovuje jeho hranicu, keď je to potrebné.
4. Odovzdanie: dokončí myšlienku alebo vytvorí prirodzené prepojenie na to, čo nasleduje.

Nie každý odsek potrebuje štyri samostatné vety. 42-slovný odsek môže spojiť tvrdenie a dôvod v prvej vete a druhú použiť na konkrétne ohraničenie. Anatómia opisuje logickú prácu, nie vzorec na vyplnenie prázdnych miest.

Príklady dizajnu

Voľný text by mal preberať bežnú typografiu článkov na webe. Jeho varianty sú založené na redakčnej funkcii, nie na dekoratívnom spracovaní.

Štandardný vysvetľujúci odsek

Používajte pohodlnú mieru, normálnu veľkosť tela a bežné medzery. Mal by pôsobiť tichšie ako zvýraznenia, tabuľky a nadpisy, pretože nesie spojivové tkanivo stránky.

Krátky prechod

Prechod môže mať 15 – 30 slov, keď uzatvára jednu myšlienku a pomenúva nasledujúcu. Nemal by byť zväčšený, centrovaný ani štylizovaný ako citácia len preto, že je krátky.

Kvalifikovaná analýza

Analytický odsek môže dosiahnuť 90 – 120 slov, ak by jeho rozdelenie oddelilo záver od jeho predpokladov alebo obmedzení. Dlhší tvar stále potrebuje jednu riadiacu myšlienku a čitateľnú dĺžku riadkov.

Úzke zobrazenie

Na mobile sa musia odseky zalomiť bez horizontálneho posúvania, zachovať viditeľnosť odkazov a vyhnúť sa riadkom takým širokým alebo odsadeným, že by sa čítací stĺpec zrútil.

Parametre

Voľný text nemá žiadne vlastné atribúty komponentu. Jeho zmluva je redakčná a mapuje sa na natívne označenie odseku.

Cieľové pásmo je 30 – 90 slov. Zámerný prechod môže použiť 15 – 30 slov. Odsek sa môže rozšíriť na 120 slov len vtedy, keď jedno tvrdenie potrebuje pripojené obmedzenie, hranicu dôkazu alebo kauzálny reťazec. Toto sú kontrolné pásma, nie automatické kritériá úspechu/neúspechu: koherencia má prioritu v rámci pevného stropu.

Voľný text neakceptuje parameter variant, color, icon, title ani columns. Ak autor tieto polia potrebuje, pasáž má pravdepodobne iný sémantický účel a musí zopakovať kontrolu priority.

Syntax a príklady kódu

Keďže voľný text je natívny obsah dokumentu, prenosný Markdown nepotrebuje žiadnu direktívu:

Caching reduces the work required to serve repeated requests, so it can improve response time without changing the page itself. The useful cache duration depends on how often the underlying content changes.

Hugo prijíma rovnaký markdown odsek. Nezabaľujte ho do shortcode len na zobrazenie obyčajnej prózy:

Caching reduces the work required to serve repeated requests, so it can improve response time without changing the page itself. The useful cache duration depends on how often the underlying content changes.

WordPress ukladá ekvivalentnú prózu v natívnom bloku odseku:

<!-- wp:paragraph -->
<p>Caching reduces the work required to serve repeated requests, so it can improve response time without changing the page itself. The useful cache duration depends on how often the underlying content changes.</p>
<!-- /wp:paragraph -->

Absencia vlastného obalu je zámerná. Importéry by mali zachovať hranicu odseku, inline odkazy, zvýraznenie, úseky kódu a smer jazyka. Nesmú spájať susedné odseky do jedného bloku ani rozdeľovať každú vetu do samostatného bloku.

Keď sa účel odseku počas úprav zmení, zmeňte aj jeho reprezentáciu. Postup objavený v próze sa stáva prvkom krokov; porovnateľné fakty sa stávajú tabuľkou; materiálne upozornenie sa stáva príslušným varovaním. Jednoduchosť zdroja nikdy nemá prednosť pred sémantickou presnosťou.

Príklady

Dobrý: jedna myšlienka rozvinutá prostredníctvom dôvodu a hranice

Kanonická URL konsoliduje signály duplicitných stránok len vtedy, keď majú prehľadávače prístup k deklarovanému cieľu. Ak je cieľ zablokovaný alebo presmerovaný inde, deklarácia sa stáva nejednoznačnou, preto je potrebné skontrolovať prehľadávateľnosť skôr, než sa kanonická URL považuje za účinnú.

Tento odsek riadi jednu myšlienku: kanonická deklarácia závisí od prístupného, konzistentného cieľa. Druhá veta neuvádza novú tému; vysvetľuje podmienku zlyhania a z toho vyplývajúcu kontrolu. Prevod na odrážky by oslabil kauzálny vzťah.

Dobrý: stručný prechod

Audit identifikuje, ktoré šablóny zlyhávajú. Ďalším krokom je oddeliť chyby zdieľaných šablón od výnimiek špecifických pre stránku.

Prechod uzatvára diagnostickú fázu a otvára fázu klasifikácie. Jeho stručnosť je zámerná a netvári sa, že ide o zhrnutie alebo sadu inštrukcií.

Zlý: niekoľko sémantických úloh skrytých v próze

Štruktúrované údaje pomáhajú strojom pochopiť stránku. Produktová schéma zahŕňa cenu a dostupnosť. Otvorte šablónu, pridajte polia, overte značenie a publikujte. Buďte opatrní, pretože neplatné ceny môžu zavádzať zákazníkov. Základné plány stoja menej než Pro plány.

Tento odsek obsahuje vysvetlenie, špecifikáciu polí, štyri usporiadané činnosti, varovanie a porovnanie. Žiadna jediná tématická veta nedokáže riadiť všetkých päť úloh. Musí byť rozložený na vysvetľujúcu prózu a príslušné pomenované prvky.

Zlý: umelá fragmentácia odseku

Register obsahu zaznamenáva stránky, ktoré web aktuálne publikuje.

Zaznamenáva tiež vlastníctvo.

Môže obsahovať údaje o výkonnosti.

Tieto informácie podporujú rozhodnutia auditu.

Každá veta súvisí s tou istou riadiacou myšlienkou. Rozdeľovanie vytvára falošné zdôraznenie a núti čitateľa rekonštruovať vzťah. Skombinujte ich: „Register obsahu zaznamenáva publikované stránky, vlastníctvo a relevantné údaje o výkonnosti, aby rozhodnutia auditu vychádzali z jedného zodpovedného zdroja.“

Zlý: jeden odsek obsahujúci dve nesúvisiace myšlienky

Pred zmenou sady promptov skontrolujte vzorku dopytov, pretože úzka vzorka môže vytvoriť zavádzajúcu základnú líniu. Vysvedčenie by malo používať aj schválené farby značky.

Druhá veta prechádza z platnosti merania na prezentáciu. Potrebuje samostatný odsek len vtedy, ak je detail dizajnu relevantný; inak by mal byť odstránený alebo umiestnený do príslušnej špecifikácie dizajnu.

Schema značenie a prístupnosť

Voľný text nemá vyhradený typ Schema.org. Zostáva viditeľným obsahom v rámci pravdivého Article, TechArticle, Product, FAQPage alebo iného podporovaného značenia na úrovni stránky. Nezabaľujte bežné odseky do vymyslených JSON-LD objektov a neopakujte celý odsek v štruktúrovaných údajoch len preto, aby vyzeral strojovo čitateľne.

Používajte sémantické prvky <p> pre odseky. Nenapodobňujte ich opakovanými prvkami <div>, zalomeniami riadkov, textom v obrázkoch alebo obsahom generovaným CSS. Zachovajte poradie zdroja, pretože asistívne technológie a extrakčné systémy sa spoliehajú na rovnakú postupnosť pri rekonštrukcii argumentu.

Odkazy musia opisovať svoj cieľ bez toho, aby sa odsek zmenil na reťazec konkurenčných kotiev. Zvýraznenie musí zostať zmysluplné aj bez farby. Vložený kód by mal používať sémantické značenie kódu. Ak sa jazyk alebo smer textu v rámci odseku zmení, označte túto zmenu v HTML, namiesto toho, aby ste žiadali čitateľa alebo čítačku obrazovky, aby to odvodili.

Čitateľná prezentácia je dôležitá, ale autori by ju nemali pevne zakódovať. Renderovací nástroj vlastní dĺžku riadku, veľkosť písma, výšku riadku, medzery, kontrast, pretekanie a zaostrenie. Pri 200% priblížení a na úzkom viewporte sa musí text zalomiť bez straty alebo horizontálneho posúvania. Význam odseku musí pretrvať aj po odstránení všetkých vlastných štýlov.

Pravidlá písania

Dôvod pred pravidlom: odseky fungujú, keď čitatelia dokážu udržať jednu tému a jeden logický posun v pracovnej pamäti. Preto píšte jednu myšlienku na odsek. „Myšlienka“ znamená riadiace tvrdenie plus vety potrebné na jeho vysvetlenie, podporu, príklad alebo obmedzenie – nie jednu vetu a nie jedno kľúčové slovo.

Začnite nový odsek, keď dôjde k niektorej z týchto zmien:

• Zmení sa téma alebo aktér.
• Odsek prechádza z vysvetlenia na inštrukciu, porovnanie, varovanie alebo odporúčanie.
• Zmení sa časový rámec alebo fáza procesu.
• Argumentácia prechádza z tvrdenia na skutočne samostatný dôsledok.
• Nové publikum, podmienka alebo výnimka potrebuje svoju vlastnú riadiacu vetu.

Usporiadajte vety v zámernom poradí: tvrdenie pred detailom, dôvod pred pravidlom, všeobecný prípad pred výnimkou a dôkaz pred záverom, pokiaľ typ príspevku explicitne nevyžaduje priamu odpoveď ako prvú. Pomenujte tému namiesto spoliehania sa na vágne otvorenia ako „Toto,“ „To“ alebo „Oni,“ keď môže byť odsek extrahovaný z kontextu.

Používajte pásma dĺžky odseku ako diagnostické signály:

• 15 – 30 slov: prechod, zámerné zdôraznenie alebo stručná odpoveď. Opakované krátke odseky vytvárajú trhaný rytmus a falošnú dôležitosť.
• 30 – 90 slov: bežné pásmo pre jednu rozvinutú myšlienku. Väčšina vysvetľujúcej prózy patrí sem.
• 90 – 120 slov: opodstatnená výnimka pre pripojené dôkazy, predpoklady alebo obmedzenia. Skontrolujte každú vetu z hľadiska jednotnosti.
• Viac ako 120 slov: rozdeľte, reštrukturalizujte alebo konvertujte materiál, pokiaľ nejde o citovaný alebo právne kontrolovaný text, ktorý musí zostať nedotknutý.

Dĺžka samotná nemôže určiť štruktúru. Dva 55-slovné odseky by sa mali spojiť, keď druhý len pokračuje v prvej myšlienke. Jeden 70-slovný odsek by sa mal rozdeliť, keď prechádza z vysvetlenia problému na predpisovanie riešení. Vykonajte test účelu pred testom počtu slov.

Uprednostňujte konkrétne podstatné mená, aktívne slovesá a explicitné vzťahy ako „pretože,“ „preto,“ „avšak“ a „iba keď.“ Odstráňte frázy na čistenie hrdla, opakované znenie H2, prázdne sľuby o tom, čo článok pokryje, a závery, ktoré len zopakujú úvod. Odsek by mal pridať uvažovanie, nie zaberať miesto medzi komponentmi.

Typy príspevkov, ktoré ho používajú

Každá dlhá stránka môže potrebovať prózu, ale tieto typy príspevkov sú na ňu odkázané pri špecifickej spojovacej práci. Zaradenie do postTypes nerobí z voľného textu povinné miesto; kontrola priority stále platí pre každú pasáž.

Komerčné a referenčné stránky môžu tiež používať voľný text, keď je potrebné uvažovanie. Popisy produktov, právne vyhlásenia, súhrny recenzií a podmienky cien nie sú automaticky „voľný text“ len preto, že sa zobrazujú ako odseky; stále sa na ne vzťahujú ich riadiace zmluvy stránky a prvku.

Kontrolný zoznam QA

Pred publikovaním overte každú položku:

• Pasáž prešla kontrolou priority a žiadny pomenovaný prvok nevyjadruje jej primárny účel presnejšie.
• Jej účelom je vysvetlenie, analýza, rozprávanie alebo prechod.
• Jedna riadiaca myšlienka riadi každú vetu.
• Prvá veta pomenúva tému a stanovuje posun odseku.
• Dôvody sú uvedené pred pravidlami a obmedzenia zostávajú pripojené k tvrdeniam, ktoré ohraničujú.
• Zmena témy, aktéra, časového rámca, publika alebo logického účelu začína nový odsek.
• Bežné odseky spadajú do rozsahu 30 – 90 slov; kratšie a dlhšie pásma majú jasný redakčný dôvod.
• Žiadny odsek nepresahuje 120 slov, pokiaľ nejde o kontrolovaný citovaný alebo právny text, ktorý musí zostať nedotknutý.
• Inštrukcie, varovania, porovnania, definície, súhrny, moduly dôkazov a opakované polia používajú svoje pomenované prvky.
• Krátke odseky nevytvárajú trhaný stĺpec ani falošný vizuálny dôraz.
• Dlhé odseky neskryli zoznam, postupnosť, tabuľku alebo druhú myšlienku.
• Zámenné a deiktické slová zostávajú jasné, ak je odsek extrahovaný zo svojho okolia.
• Odkazy sú opisné, obmedzené, platné a uvedené v front matter.
• Zdroj používa natívne odseky bez zbytočného shortcode alebo vlastného obalu.
• Poradie a význam odsekov pretrvávajú bez vizuálneho štylovania a pri úzkych alebo priblížených rozloženiach.
• Komentáre k screenshotom identifikujú budúce zachytenia bez odkazovania na neexistujúce vykreslené assety.

FAQ

Je voľný text predvoleným obsahovým prvkom? Nie. Je to záložná možnosť po tom, čo pasáž prejde kontrolou priority. Ak sa pomenovaný prvok zhoduje s primárnym účelom, tento prvok vyhráva, aj keď by sa odsek písal ľahšie.

Ako dlhý by mal byť odsek voľného textu? Väčšina by mala obsahovať 30 – 90 slov. Použite 15 – 30 slov na zámerný prechod a 90 – 120 len vtedy, keď jeden argument potrebuje svoje obmedzenie alebo dôkaz pripojený. Rozdeľte alebo prerobte čokoľvek dlhšie.

Znamená jedna myšlienka na odsek jednu vetu na odsek? Nie. Súvislá myšlienka môže vyžadovať tvrdenie, dôvod, príklad a obmedzenie. Počet viet nie je kritériom; rozhodujúca je zmena témy alebo logického účelu.

Kedy by sa mala próza stať zoznamom alebo tabuľkou? Použite zoznam pre paralelné nezávislé položky, zoznam krokov, keď poradie ovplyvňuje výsledok, a tabuľku, keď sa musia porovnávať rovnaké atribúty. Prózu ponechajte vtedy, keď význam nesú vzťahy medzi vetami.

Potrebuje voľný text špeciálne schema označenie? Nie. Používajte sémantické značenie odseku v rámci pravdivého typu schema stránky. Jasné poradie zdroja a sebestačné písanie poskytujú väčšiu hodnotu než vymyslené štruktúrované údaje.

Obyčajná próza si zaslúži svoje miesto, keď je obsahom prepojené uvažovanie. Vykonajte najprv kontrolu priority, udržujte jednu myšlienku v rámci odôvodneného dĺžkového pásma a nechajte každý typovaný účel používať svoj pomenovaný prvok.