Seznamy s odrážkami: Pravidla psaní, struktura a příklady

Seznam s odrážkami je neuspořádaná množina souvisejících, nezávislých bodů. Umožňuje čtenáři rozpoznat kategorii jednou a poté procházet jednotlivé členy, aniž by je musel vytahovat z odstavce. Používejte odrážky pouze tehdy, když položky patří na stejnou logickou úroveň a jejich pořadí nemění význam.

• Začněte každou položku ve stejném gramatickém tvaru.
• Udržujte každou položku ve stejné délkové kategorii.
• Uveďte množinu ještě před první odrážkou.
• Po poslední odrážce se vraťte k úvaze.

Tento vykreslený příklad je skutečný seznam: čtyři související pravidla, všechna formulovaná jako rozkazovací věty, žádné není závislé na pozici. Odstavec výše stanovuje kategorii; věta níže vysvětluje, co množina dokazuje. Odrážky zlepšují přístup k argumentu, aniž by ho nahrazovaly.

Proč na tomto prvku záleží

Čtenáři neprocházejí odstavec jako pytel vět. Hledají tvrzení, sledují vztah mezi myšlenkami a rozhodují se, zda vysvětlení stojí za pozornost. Seznam s odrážkami toto chování při čtení mění. Jeho vertikální rytmus signalizuje: „tyto body jsou související; můžete je prozkoumat jeden po druhém.“ To snižuje úsilí potřebné k nalezení relevantního požadavku, možnosti, příznaku nebo charakteristiky.

Stejná hranice zlepšuje strojovou extrahovatelnost: schopnost vyhledávače, AI systému nebo transformátoru obsahu izolovat položky při zachování jejich sdíleného kontextu. Sémantický neuspořádaný seznam explicitně odhaluje kolekci a její členy. Paralelní úvodní slova také pomáhají stroji odvodit, že položky plní stejnou roli. „Vyžaduje administrátorský přístup,“ „Vyžaduje ověřenou doménu“ a „Vyžaduje aktivní předplatné“ tvoří jasnější množinu než tři položky, které se střídají mezi otázkami, fragmenty a komentářem.

Odrážky nejsou automaticky přehlednější než próza. Odstavec vyjadřuje příčinu, kontrast, upřesnění, posloupnost a závěr prostřednictvím vět a přechodů. Převod do odrážek může tyto vztahy vymazat. Seznam pak vypadá jednodušeji, ale sděluje méně. To je hlavní riziko tohoto prvku: vizuální skenovatelnost může maskovat ztracenou argumentaci.

Přednost mají pravidla psaní prvků . Identifikujte, co pasáž dělá, než zvolíte její vzhled. Shrnutí závěrů patří do klíčových poznatků , i když tento prvek také vykresluje odrážky. Uspořádané instrukce patří do seznamu kroků . Seznam s odrážkami je správným prvkem pouze tehdy, když je jeho účelem prezentovat neuspořádanou množinu souvisejících položek v rámci okolní argumentace.

Kdy jej použít

Používejte seznam s odrážkami, když jeden uvozovací text může přesně zastřešit tři nebo více položek a každá položka zůstává užitečná při samostatném čtení. Silné využití zahrnuje požadavky, charakteristiky, příklady z jedné kategorie, neseřazené možnosti, příznaky selhání, kritéria pro zařazení a stručná doporučení stejné priority.

Než převedete prózu do seznamu, proveďte tři testy:

1. Test rovnocennosti: Může každá položka odpovědět na stejnou implicitní otázku?
2. Test pořadí: Mohou dvě sousední položky změnit místo, aniž by se změnila instrukce nebo závěr?
3. Test kontextu: Poskytuje uvozovací text dostatek kontextu pro každou položku, aniž by ji nutil se opakovat?

Pokud všechny tři projdou, odrážky pravděpodobně pomohou. Pokud test pořadí selže, použijte číslované instrukce nebo chronologickou prózu. Pokud test rovnocennosti selže, rozdělte materiál do samostatných odstavců nebo nadpisů. Pokud test kontextu selže, každý bod potřebuje vlastní vysvětlení.

Zvláštní pozornost si zaslouží hraniční případy:

• Soubor akcí není seznamem s odrážkami, pokud jedna akce odemyká další; jde o uspořádaný postup.
• Soubor tvrzení není seznamem, pokud druhé upřesňuje první a třetí vyvozuje závěr; jde o argumentaci.
• Soubor produktů není nutně seznamem, pokud čtenáři potřebují hodnocení kritérium po kritériu; použijte srovnávací tabulku .
• Soubor dokončovacích bran není pouze informační, pokud musí čtenář každou z nich ověřit; jde o kontrolní seznam.
• Dvě alternativy jen zřídka ospravedlňují odrážky. Napište „Použijte X, když …; použijte Y, když …“, pokud každá nevyžaduje rozsáhlé vysvětlení.

Nepoužívejte odrážky k záchraně příliš dlouhého odstavce, aniž byste nejprve diagnostikovali, proč je dlouhý. Odstavec může obsahovat několik tvrzení, chybějící nadpisy nebo nerozvinutý kauzální řetězec. Nejprve opravte tuto strukturu. Odrážky nejsou univerzální úklidová operace.

Kam jej umístit

Umístěte seznam s odrážkami bezprostředně za úplný uvozovací text, který pojmenuje množinu a vysvětlí, proč ji čtenář potřebuje. „Migrace vyžaduje:“ je gramatické, ale slabé, protože neuvádí důsledek. „Před migrací shromážděte tyto čtyři vstupy, aby rollback mohl obnovit původní stav:“ říká čtenáři, co položky jsou a proč na nich záleží.

Umístěte interpretaci bezprostředně za seznam, pokud položky podporují rozhodnutí nebo tvrzení. Závěrečný odstavec by měl identifikovat vzor, prioritu, výjimku nebo další akci vytvořenou množinou. Seznam může ukončit malou referenční část, pokud je jeho účel čistě výčtový, ale nesmí ponechat argumentaci viset ve vzduchu.

Přesná pravidla umístění:

• Uveďte uvozovací text a seznam ve stejné sekci; nikdy nenuťte čtenáře překračovat nadpis, aby zjistil, co odrážky vyjmenovávají.
• Udržujte důkaz vedle tvrzení, které podporuje. Nevkládejte seznam mezi tvrzení a jeho citaci, výpočet nebo upřesnění.
• Neumisťujte neuspořádaný seznam přímo vedle uspořádaného seznamu bez přechodu, který vysvětlí změnu významu.
• Nestavte dva seznamy s odrážkami těsně za sebou. Přidejte interpretaci, slučte skutečně související položky nebo opatřete každou kolekci popisným podnadpisem.
• Neumisťujte obecný seznam s odrážkami bezprostředně pod rámeček s klíčovými poznatky, pokud oba shrnují stejný materiál.
• Nevkládejte výzvu k akci do poslední odrážky. Ukončete kolekci, vysvětlete závěr a poté uveďte akci samostatně.

Prvek se může na dlouhé stránce objevit několikrát, ale próza musí nést vztahy mezi těmito seznamy. Pokud se každá sekce stane nadpisem plus odrážkami, stránka trpí selháním osiřelých seznamů: kolekce existují, ale nic nevysvětluje, jak spolu souvisí.

Anatomie

Kompletní seznam s odrážkami má pět sémantických oblastí:

1. Kontext: předcházející tvrzení nebo vysvětlení, které činí kolekci relevantní.
2. Uvozovací text: úplná věta, která pojmenovává sdílenou kategorii.
3. Kontejner seznamu: jeden sémantický neuspořádaný seznam, který stanovuje vztah položek.
4. Položky: související tvrzení s paralelní gramatikou a konzistentní úrovní podrobnosti.
5. Interpretace: následující věta nebo odstavec, který znovu propojuje množinu s argumentací.

Značka, odsazení a mezery činí hierarchii viditelnou, ale nedefinují ji. Zdrojová struktura musí zůstat neuspořádaným seznamem, i když chybí styly, skripty a vizuální značky.

Příklady designu

Designový systém podporuje tři varianty. Jejich obsahový kontrakt zůstává stejný; mění se pouze hustota a rozvržení.

Výchozí

Používejte výchozí jednosloupcovou variantu pro úplná tvrzení a většinu redakčního obsahu. Poskytuje každé položce dostatek prostoru pro skenování, zatímco udržuje množinu vizuálně propojenou.

Kompaktní

Používejte kompaktní mezery pro popisky, krátké požadavky nebo hodnoty o 3–12 slovech. Kompaktní není povolení ke stlačení úvah do fragmentů; okolní próza stále poskytuje kontext.

Dvousloupcový

Používejte dva sloupce pouze pro šest až deset krátkých, nezávislých položek, které zůstávají srozumitelné v pořadí čtení renderovacího nástroje. Při úzké šířce se rozvržení musí zhroutit do jednoho sloupce. Nepoužívejte jej pro vysvětlené body, ruční řazení napříč sloupci nebo položky, jejichž pořadí naznačuje hodnocení.

Žádná varianta nesmí nahrazovat nativní sémantiku seznamu dekorativními ikonami a nesouvisejícími kontejnery. Vizuální přizpůsobení musí zachovat jednu kolekci a jednu položku na tvrzení.

Parametry

Níže uvedené limity zabraňují tomu, aby se seznamy rozrůstaly do okamžiku, kdy by z nich měly být sekce. „Zdroj“ identifikuje, kde je kanonická hodnota vytvořena.

Renderer neodvozuje název z uvozovacího textu. Název pojmenovává znovupoužitelný blok nebo blok definovaný typem příspěvku; uvozovací text dokončuje vztah na úrovni věty mezi okolní prózou a položkami. Většina vložených seznamů název nepotřebuje.

Syntaxe a příklady kódu

Všechna tři mapování zachovávají stejný uvozovací text, položky, variantu a interpretaci. Přenositelná direktiva je kanonická. Příklady pro Hugo a WordPress popisují platformní adaptéry; neopravňují k použití stylů specifických pro stránku.

Přenositelná Markdown direktiva

:::bullet-list{variant=default}
Před publikováním zkontrolujte tyto podmínky:

- Tvrzení uvádí svůj rozsah a časové období.
- Zdroj podporuje přesné použité znění.
- Stránka vysvětluje jakékoli podstatné omezení.

Společně tyto kontroly udržují obhajitelné tvrzení, aby se nestalo přehnaným.
:::

Hugo shortcode

{{< bullet-list variant="default" >}}
Před publikováním zkontrolujte tyto podmínky:

- Tvrzení uvádí svůj rozsah a časové období.
- Zdroj podporuje přesné použité znění.
- Stránka vysvětluje jakékoli podstatné omezení.

Společně tyto kontroly udržují obhajitelné tvrzení, aby se nestalo přehnaným.
{{< /bullet-list >}}

Dokud projekt nezaregistruje tento adaptér, vykreslujte obsah jako běžný sémantický Markdown, místo abyste vymýšleli lokální shortcode. Zdroj stále splňuje redakční kontrakt.

WordPress

<!-- wp:amicited/bullet-list {"variant":"default"} -->
<p>Před publikováním zkontrolujte tyto podmínky:</p>
<ul>
  <li>Tvrzení uvádí svůj rozsah a časové období.</li>
  <li>Zdroj podporuje přesné použité znění.</li>
  <li>Stránka vysvětluje jakékoli podstatné omezení.</li>
</ul>
<p>Společně tyto kontroly udržují obhajitelné tvrzení, aby se nestalo přehnaným.</p>
<!-- /wp:amicited/bullet-list -->

Pokud vlastní blok neexistuje, nativní WordPress bloky Seznam a Odstavec jsou správným přístupným řešením. Variantu obalu zachovejte pouze tehdy, když ji téma podporuje.

Příklady

Dobrý: paralelní kontroly publikace

Před schválením srovnání ověřte, že každá možnost dostává stejné zacházení:

• Aplikujte stejná hodnotící kritéria na každou možnost.
• Používejte důkazy z ekvivalentních časových období.
• Uveďte podstatná omezení vedle ovlivněného tvrzení.
• Oddělte měřená fakta od redakčního úsudku.

Tyto položky fungují, protože odpovídají na jednu otázku – co dělá srovnání spravedlivým – a každá začíná rozkazovacím slovesem následovaným jedním předmětem. Jejich délky jsou podobné, jejich pořadí je zaměnitelné a závěrečná věta vysvětluje společný standard.

Špatný: argument rozbitý do odrážek

• Čtenáři procházejí stránky.
• Protože je procházení běžné, jsou seznamy užitečné.
• Ale seznamy odstraňují přechody.
• Proto používejte seznamy opatrně a testujte přístupnost, která je také důležitá pro čtečky obrazovky a má několik implementačních detailů.

Toto je špatné, protože položky nejsou rovnocenné. Tvoří premisu, odvození, upřesnění a závěr, takže jejich přesun mění argumentaci. Jejich gramatika a délka také kolísají. Přepracování pasáže na odrážky odstranilo spojovací úvahy, zatímco ponechalo přechodová slova, která odhalují skrytý odstavec. Napište to jako prózu: čtenáři procházejí stránky, takže seznamy jim mohou pomoci najít související body; seznamy však odstraňují přechody, což znamená, že autor musí zachovat úvahy před i za množinou.

Schema markup a přístupnost

Běžný seznam s odrážkami nepotřebuje samostatný schema markup. Zůstává viditelným obsahem v rámci obalujícího typu Article, TechArticle, popisu produktu nebo jiného typu na úrovni stránky. Nevytvářejte markup ItemList jen proto, že HTML obsahuje <ul>; strukturovaná data by měla představovat smysluplnou kolekci entit, ne každý vizuální výčet.

ItemList může být vhodný, když je seznam sám o sobě hlavní, konečnou kolekcí – například deklarovaná množina zahrnutých lokalit nebo hodnocených produktů – a každá viditelná položka odpovídá skutečnému ListItem. U neuspořádané kolekce nevymýšlejte hodnocení ani nenaznačujte preferenci pomocí position. Výstup schema musí odpovídat viditelnému počtu a názvům. Většina redakčních odrážek přímo nevyživuje žádnou schema vlastnost.

Přístupnost začíná u <ul> a jednoho <li> na položku. Nepište znaky odrážek do odstavců, nevkládejte zalomení řádků k napodobení položek ani nepoužívejte řadu elementů <div> jen proto, že CSS umí kreslit značky. Čtečky obrazovky oznamují nativní hranice seznamu a počty položek, což dává uživatelům stejný kategorický signál, který dostávají vidící čtenáři.

Udržujte vnoření na jedné úrovni a pouze tehdy, když každá podsložka patří ke své nadřazené. Vnořený seznam potřebuje alespoň dvě položky; jediná odsazená položka je obvykle další věta. Ujistěte se, že vlastní ikony nemají žádný konkurenční přístupný název, pokud jsou dekorativní. Odkazy musí popisovat svůj cíl a význam nesmí záviset na barvě, tvaru nebo sloupcové pozici značky. Dvousloupcový výstup musí zachovat předvídatelné zdrojové a klávesnicové pořadí čtení.

Pravidla psaní

Zvolte jednu ze tří délkových kategorií a používejte ji v celém seznamu:

• Popisky: 3–12 slov. Používejte pro nástroje, požadavky, příznaky nebo stručné členy kategorie.
• Úplná tvrzení: 8–25 slov. Používejte pro pravidla, výhody, kritéria a doporučení, která stojí samostatně.
• Vysvětlené body: 20–45 slov. Používejte, když každá položka potřebuje jeden důvod nebo upřesnění; delší vysvětlení přesuňte do prózy nebo podsekcí.

Běžně používejte tři až sedm položek. Dvě položky se vejdou do věty nebo kontrastu. Osm až deset položek vyžaduje jasný důvod, promyšlené seskupení a obvykle kompaktní nebo dvousloupcovou variantu. Více než deset nutí čtenáře vytvářet si vlastní kategorie; rozdělte množinu nebo zaveďte podnadpisy.

Paralelní konstrukce je povinná. Začněte každou položku stejným slovním druhem a zachovejte stejný implicitní podmět. Dobré sady používají rozkazovací slovesa („Potvrďte,“ „Zaznamenejte,“ „Otestujte“), podstatná jména („Přístup,“ „Důkazy,“ „Vlastnictví“) nebo úplné oznamovací věty. Nezačínejte jednu položku slovesem, druhou „Měli byste“ a třetí otázkou.

Slaďte tón, čas, interpunkci, velikost písmen a podrobnost. Používejte větnou velikost písmen. Celé věty ukončete tečkami; u krátkých fragmentů tečky vynechejte. Rozlišovací slova umístěte brzy, místo abyste opakovali dlouhý identický začátek. Tučné písmo může označovat krátký popisek následovaný vysvětlením, ale každá položka musí používat stejný vzor popisku.

Do běžného seznamu s odrážkami nikdy nevkládejte:

• Uspořádané akce, jejichž pořadí ovlivňuje výsledek.
• Několik odstavců, více nadpisů nebo nezávislý mini-článek na položku.
• Tabulky, formuláře, video přehrávače, reference nebo propagační karty.
• Nekvalifikovaná tvrzení, která se spoléhají na kontext mimo položku, aby zůstala přesná.
• Směs požadavků, příkladů, závěrů a výzev k akci.

Vyvarujte se selhání osiřelých seznamů. Dochází k němu, když je téměř každý odstavec převeden na odrážky, takže nezbývá próza pro stanovení příčiny, konfliktu, důkazu nebo závěru. Praktickým kontrolním signálem jsou tři po sobě jdoucí sekce, které každá obsahují krátký uvozovací text a seznam, ale žádný interpretační odstavec. Obnovte nejsilnější tvrzení do prózy, slučte překrývající se kolekce a ponechte pouze ty seznamy, které projdou testy rovnocennosti, pořadí a kontextu.

Typy příspěvků, které jej používají

Následující řádky jsou řízeny frontmatter postTypes. „Použití“ popisuje roli odrážek, nikoli požadavek na jejich vynucení na každé stránce.

QA kontrolní seznam

Před publikováním ověřte každou položku:

• Uvozovací text pojmenovává jednu kategorii a vysvětluje, proč na množině záleží.
• Každá položka odpovídá na stejnou implicitní otázku a je na stejné logické úrovni.
• Přeskupení položek by nezměnilo instrukci, chronologii ani argumentaci.
• Všechny položky používají paralelní gramatiku, tón, čas, velikost písmen a interpunkci.
• Každá položka zůstává v jedné zvolené délkové kategorii a seznam obsahuje 3–7 položek, nebo odůvodněnou výjimku.
• Seznam používá sémantický výstup <ul> a <li> namísto dekorativních znaků odrážek.
• Vnořené položky končí na jedné úrovni, zatímco sloupce zachovávají předvídatelné pořadí čtení.
• Odkazy jsou popisné, ověřené a omezené na jeden primární cíl na položku.
• Odstavec po seznamu uvádí interpretaci, pokud množina podporuje argumentaci.
• Seznam nekopíruje typovaný souhrn, kontrolní seznam, seznam kroků, tabulku nebo jiný účelově specifický prvek.
• Stránka obsahuje dostatek prózy k nesení úvah mezi kolekcemi a vyhýbá se selhání osiřelých seznamů.
• Přenositelná Markdown, Hugo a WordPress mapování zachovávají stejné položky a význam.

FAQ

Kolik položek by měl seznam s odrážkami obsahovat? Běžně používejte tři až sedm. Dělejší sady seskupte nebo rozdělte, místo abyste nutili čtenáře kategorizovat je bez pomoci.

Jak dlouhá by měla být každá odrážka? Vyberte jednu kategorii pro celý seznam: 3–12, 8–25 nebo 20–45 slov. Důležitější je konzistence než dosažení maxima.

Měly by položky odrážek končit interpunkcí? U celých vět používejte tečky, u krátkých fragmentů žádnou koncovou interpunkci. Aplikujte volbu konzistentně.

Mohou seznamy s odrážkami obsahovat odkazy? Ano, ale používejte popisné kotvy a běžně ne více než jeden primární odkaz na položku.

Kdy by se měly odrážky změnit na číslované kroky? Používejte číslování, když pořadí ovlivňuje výsledek. Neuspořádané odrážky slibují, že na pořadí nezáleží.

Seznamy s odrážkami fungují, když odhalují skutečnou kolekci a próza nadále vykonává úvahy. Cílem není maximalizovat skenovatelnost na každém řádku; je to usnadnit nalezení souvisejících bodů, aniž by se zničily vztahy, které je činí smysluplnými.