Sekce FAQ: Formát, Schéma a Příklady

FAQ je závěrečný obsahový prvek, který zodpovídá malou, důkazy podloženou sadu otázek, které hlavní sekce stránky již nevyřešily. Jeho otázky používají jazyk čtenáře a každá odpověď o délce 30–60 slov stojí samostatně. Živý prvek níže je vykreslen z [[faq]] frontmatter této stránky, nikoli duplikován v těle Markdownu.

Viditelné otázky výše a jejich strukturovaná data FAQPage sdílejí jeden zdroj. Úprava záznamu ve frontmatter změní obě reprezentace, což zabraňuje tomu, aby se vyleštěná odpověď na stránce odchýlila od strojově čitelné verze.

Proč na tomto prvku záleží

Čtenáři se často dostanou na konec stránky s úzkou nejistotou, nikoli s potřebou dalšího úplného vysvětlení. Kupující může rozumět tomu, co produkt dělá, ale stále se ptát, zda nastavení vyžaduje platební kartu. Osoba postupující podle návodu může znát kroky, ale potřebuje potvrdit, co se stane, když chybí požadovaný vstup. FAQ dává těmto častým otázkám v pozdní fázi předvídatelné místo, aniž by nutil každého čtenáře projít další dlouhou sekcí.

Prvek funguje, protože formulace otázky je rozpoznávacím signálem. Čtenář, který skenuje „Mohu exportovat data?“, dokáže identifikovat svůj vlastní zájem rychleji, než dokáže interpretovat vágní nadpis jako „Doplňující informace“. Odpověď pak tento zájem okamžitě vyřeší. To je psychologie čtenáře, nikoli dekorace: komponenta zkracuje vzdálenost mezi konkrétní pochybností a jejím vyřešením.

FAQ také vytváří ohraničené páry otázka-odpověď pro strojovou extrakci. Strojová extrahovatelnost znamená, že software dokáže izolovat jednotku a zachovat její význam mimo celou stránku. Skutečná otázka následovaná samostatnou odpovědí je pro vyhledávací systémy, interní vyhledávání, podpůrné nástroje a AI agenty snáze identifikovatelná než odpověď skrytá v různorodém závěrečném odstavci. Hranice pomáhá pouze tehdy, když jazyk zůstává explicitní; „Ano, jak je popsáno výše“ je vizuálně uvnitř FAQ, ale při extrakci se stává nepoužitelným.

Frontmatter je publikačním zdrojem, protože stejné záznamy musí sloužit třem účelům: viditelnému bloku, strukturovaným datům FAQPage a analýze na úrovni korpusu. Analýza na úrovni korpusu znamená dotazování všech stránek jako kolekce – například nalezení každé odpovědi o zrušení nebo kontrola, které typy stránek běžně překračují šest otázek. Uchovávání záznamů v typovaných [[faq]] záznamech tyto kontroly umožňuje. Kopírování otázek do těla vytváří dvě upravitelné verze a vede k odchylkám.

Kdy to použít

Použijte FAQ, když výzkum odhalí několik opakujících se otázek, které jsou relevantní pro stránku, ale příliš úzké na to, aby ospravedlnily celé sekce. Dobří kandidáti objasňují okrajové případy, způsobilost, kompatibilitu, načasování, definice, které čtenáři běžně zaměňují, nákupní námitky nebo bezpečný další krok. Každá otázka musí pomoci stejnému publiku dokončit primární rozhodnutí nebo úkol stránky.

Výzkum otázek přichází před psaním. Sbírejte přesný jazyk z vyhledávacích návrhů, interního vyhledávání na webu, podpůrných tiketů, poznámek z prodejních hovorů, komunitních diskuzí a sledovaných AI promptů. Sledování promptů je užitečné, protože zaznamenává otázky, které se firma rozhodne monitorovat napříč AI enginy; opakované prompty mohou odhalit, jak se potenciální zákazníci ptají na kategorii, funkci nebo srovnání. Záznam je důkazem formulace a poptávky, nikoli povolením vnutit nesouvisející prompt na stránku.

Nepoužívejte FAQ pouze proto, že šablona nějaký poskytuje. Vymyšlené otázky jako „Proč je naše platforma úžasná?“ jsou rozpoznatelné jako marketingový text převlečený za otázku. Fragmenty klíčových slov jako „Výhody schématu FAQ?“ neznějí jako čtenář. Obojí oslabuje důvěru a stroje toho naučí málo o skutečné informační potřebě.

FAQ není odkladiště pro odstavce, které se nevešly do osnovy. Pokud odpověď představuje klíčový argument, vysvětluje požadovaný krok, nese nejsilnější důkazy stránky nebo potřebuje více než 60 slov, dělá skutečnou práci a pravděpodobně si zaslouží pojmenovanou sekci. Přesuňte ji do hlavní struktury. FAQ pak může zodpovědět menší následnou otázku, která zůstane.

Neopakujte článek ve formě otázek. „Co je X?“, „Proč je X důležité?“ a „Jak X funguje?“ jsou špatné závěrečné otázky, pokud jsou to již první tři sekce stránky. Opakování dělá stránku delší, aniž by zvyšovalo pokrytí, a riskuje mírně odlišné odpovědi na stejnou otázku.

Běžným téměř-zásahem je relevantní otázka, jejíž odpověď je zásadní. Na stránce symptomového typu může „Kdy je to vážné?“ vypadat jako přirozené FAQ, ale varovné signály ovlivňují bezpečnost a měly by být v hlavním těle, kde se s nimi setká každý čtenář. FAQ nemůže opakovat ani seznam varování, ani slabší shrnutí. Místo toho použijte úzkou nevyřešenou otázku, například zda jedna konkrétní okolnost mění doporučený další krok.

Kam to umístit

FAQ je závěrečný prvek, protože jeho úkolem je vyřešit zbytkové otázky poté, co stránka poskytla svou hlavní odpověď. Umístěte jej za věcný obsah, příklady a podpůrné důkazy. Zdroje umístěte těsně před něj, pokud na nich FAQ závisí; primární výzvu k akci a odkazy na související obsah umístěte za něj. Toto pořadí umožňuje čtenáři vyřešit konečné nejistoty před rozhodnutím, co dělat dál.

Neumísťujte produkční FAQ přímo pod hero, dovnitř úvodu, mezi kroky nebo mezi tvrzení a jeho důkaz. Živý blok v horní části této specifikace je demonstrace vyžadovaná knihovnou prvků, nikoli předepsané umístění pro běžné stránky.

Používejte jeden blok FAQ na stránku. Neměl by být umístěn vedle druhého accordionu, sekce „časté otázky“ obsahující stejný materiál nebo rekapitulace přepsané jako otázky. Vyhněte se umístění vedle velkého seznamu slovníkových pojmů: dvě husté sady krátkých položek soutěží o stejné skenovací chování. Pokud jsou obě nezbytné, ponechte definice v relevantních sekcích těla a vyhraďte závěrečný blok pro nevyřešené otázky.

Anatomie

Označený snímek obrazovky odděluje sémantické oblasti od vizuálního zpracování. Legenda zůstává na této stránce, aby její popisky zůstaly čitelné, když je obrázek změněn nebo nahrazen.

1. Nadpis sekce: Pojmenovává kolekci jako často kladené otázky; jde o skutečný nadpis v hierarchii dokumentu.
2. Otázka: Používá slova čtenáře jako úplnou tázací větu a končí otazníkem.
3. Ovládací prvek zobrazení/skrytí: U skládacích variant operovatelné tlačítko odhaluje, zda je odpověď rozbalena, a identifikuje řízenou oblast odpovědi.
4. Odpověď: Nejprve poskytuje přímou odpověď, poté jedno užitečné upřesnění, rozdíl nebo další krok.
5. Hranice položky: Vizuálně a programově udržuje každou otázku spojenou s přesně jednou odpovědí.
6. Záznam ve frontmatter: Nevizuální zdroj párující question a answer; napájí jak prezentaci, tak výstup FAQPage.

Příklady designu

Varianty mění prezentaci, nikoli vlastnictví obsahu. Každá verze čte stejné [[faq]] záznamy a zachovává stejné páry otázka-odpověď.

Standardní responzivní varianta

Desktop zobrazuje otázky a odpovědi v zarovnaných sloupcích; menší obrazovky používají ovládací prvky zobrazení/skrytí k úspoře vertikálního prostoru. Toto je výchozí, když designový systém poskytuje responzivní chování.

Sbalená mobilní varianta

Otázky zůstávají viditelné jako tlačítka a odpovědi se otevírají na místě. Ovládací prvek musí komunikovat rozbalený stav, zachovat přístupnost z klávesnice a udržet odpověď přilehlou v pořadí čtení.

Varianta pro dlouhé otázky

Přirozená otázka se může zalomit na dva řádky. Rozvržení musí zachovat otazník, cíl ovládání a zarovnání odpovědi bez ořezávání.

Stav bez FAQ

Pokud neexistují žádné prozkoumané otázky, nevykreslujte nic. Nezobrazujte prázdný nadpis, zástupný řádek ani generický generovaný obsah.

Parametry

Parametry jsou kontraktem obsahu. Limity existují, aby každý pár zůstal extrahovatelný a aby se závěrečný prvek nestal druhým článkem.

Odkaz na důkaz nemusí být veřejně viditelný, ale musí přežít editorskou revizi. Identifikátor podpůrného tiketu, odkaz na poznámku z hovoru, export dotazu nebo záznam sledovaného promptu stačí. „Spisovatele to napadlo“ nestačí.

Syntaxe a příklady kódu

Všechny tři formy považují položky FAQ za strukturovaná metadata stránky. Instrukce pro vykreslení neobsahuje duplicitní otázky ani odpovědi.

Přenosný Markdown direktiv

:::faq{source="frontmatter" heading="Často kladené otázky"}
:::

Přenosný dokumentový model ukládá záznamy jako metadata stránky:

[[faq]]
question = "Mohu exportovat sestavu jako CSV?"
answer = "Ano. Export vytvoří CSV obsahující aktuální datovou sadu sestavy. Před sdílením zkontrolujte rozsah exportu, protože obrazovkové filtry a oprávnění účtu mohou ovlivnit, které záznamy jsou zahrnuty."

Hugo shortcode

{{< faq-side-by-side title="Často kladené otázky" >}}{{< /faq-side-by-side >}}

Hugo shortcode čte .Page.Params.faq; nepřijímá JSON tělo. Přidávání inline položek by vytvořilo druhý zdroj a je pro tento prvek zakázáno.

WordPress blok nebo shortcode

<!-- wp:amicited/faq {"source":"post-meta","heading":"Často kladené otázky"} /-->

[amicited_faq source="post-meta" heading="Často kladené otázky"]

Ve WordPressu každá otázka a odpověď patří do opakovatelných metadat příspěvku, která používá jak renderer bloku, tak JSON-LD emitor. Vkládání stejných párů do HTML bloku nebo těla shortcode porušuje paritu, i když stránka vypadá správně.

Příklady

Dobrý příklad

Mohu změnit vykazované období po exportu sestavy?
Ano. Změňte vykazované období v sestavě a poté vytvořte nový export, aby soubor odrážel revidovaný rozsah. Existující CSV je statický snímek a neaktualizuje se automaticky, když se později změní filtry dashboardu.

Toto funguje, protože otázka zní jako něco, co by uživatel položil po setkání s exportním pracovním postupem. První věta odpovídá „ano“ a uvádí akci. Druhá vysvětluje důležitou hranici: dřívější soubor se sám neaktualizuje. S 30 slovy je odpověď úplná, aniž by se stala skrytým návodem.

Špatný příklad

Stažení exportu sestavy CSV?
Jak bylo zmíněno výše, naše výkonná platforma usnadňuje exporty. Další informace o všech skvělých možnostech, které máte k dispozici, naleznete v sekci o sestavách.

Otázka je fragmentem klíčového slova, nikoli mluveným jazykem. Odpověď neuvádí, zda je export možný, závisí na chybějícím kontextu, přidává nepodložené propagační tvrzení a posílá čtenáře jinam. Samotné přeformulování nestačí; autor musí ověřit skutečnou otázku a poskytnout skutečné chování.

Druhým špatným vzorem je 180slovná odpověď obsahující předpoklady, pět kroků a varování. I když je každá věta přesná, tento materiál patří do sekce postupu. FAQ by měl odpovědět na užší zbytkovou otázku nebo být odstraněn.

Schema markup a přístupnost

Schema markup je standardizovaný strojově čitelný kód, který identifikuje význam a vztahy obsahu stránky. Položky FAQ se mapují na Schema.org FAQPage. Každá viditelná otázka se stává Question v mainEntity; její odpověď se stává acceptedAnswer s typem Answer a hodnotou text. Web emituje tuto strukturu jako JSON-LD , JSON-based formát pro propojená strukturovaná data.

Značení se musí přesně shodovat s viditelným obsahem co do významu a znění. Nepřidávejte otázku pouze do schématu, nezkracujte viditelnou odpověď pouze ve značení a nenechávejte starou odpověď v JSON-LD po úpravě stránky. Pravidlo pouze-frontmatter těmto selháním předchází tím, že odvozuje oba výstupy ze stejného záznamu. Strukturovaná data popisují obsah; nekompenzují slabý, vymyšlený nebo skrytý obsah a negarantují bohatý výsledek vyhledávání.

Přístupnost závisí na chování zobrazení/skrytí. Zobrazení/skrytí je ovládací prvek, který ukazuje nebo skrývá přidružený obsah. Otázka by měla být nativní button, pokud přepíná odpověď, s aria-expanded odrážejícím aktuální stav a aria-controls odkazujícím na jedinečné ID odpovědi. ARIA, Accessible Rich Internet Applications, poskytuje stavy a vztahy, když samotné nativní HTML nestačí.

Uživatelé klávesnice musí být schopni dosáhnout na každou otázku, otevřít ji klávesou Enter nebo mezerníkem a pokračovat stránkou v logickém pořadí. Fokus musí zůstat viditelný. Odpověď by měla následovat svou otázku v pořadí dokumentu a nadpisy nesmí přeskakovat úrovně. Nespoléhejte se na otáčení šipky, barvu nebo animaci jako jediný signál rozbaleného stavu. Pokud jsou odpovědi na desktopu vždy viditelné, musí stále zůstat spojené se svými otázkami pomocí dt a dd nebo ekvivalentního sémantického vztahu.

Pravidla psaní

Používejte čtyři až šest otázek v typickém FAQ. Čtyři je praktické minimum, protože méně otázek málokdy ospravedlňuje samostatné závěrečné rozhraní; jednu až tři odpovědi lze obvykle umístit k příslušným sekcím těla. Šest je praktické maximum, protože delší sada se stává obtížně skenovatelnou a často signalizuje, že hlavní témata byla zadržena z článku. Výjimky vyžadují důkazy: regulovaný produkt může potřebovat více úzkých otázek způsobilosti, zatímco stručná stránka produktu může blok zcela vynechat.

Formulujte každou položku jako skutečnou otázku slovy čtenáře. Zachovejte užitečnou slovní zásobu ze zdroje, ale odstraňte osobní údaje, podrobnosti specifické pro daný účet a konverzační šum. Skutečné duplicity slučujte pouze tehdy, když jsou jejich odpovědi také stejné. „Mohu zrušit měsíční?“ a „Dostanu vrácení peněz?“ se mohou objevit ve stejném prodejním hovoru, ale představují různá rozhodnutí a nesmí být sloučeny.

Pište 30–60 slov na odpověď. První věta odpovídá na otázku; druhá rozvádí nejužitečnější podmínku, rozdíl, důvod nebo další krok. Pojmenujte předmět, aby odpověď přežila extrakci. Nikdy nepište „ano, dělá“, „viz výše“, „jak bylo diskutováno dříve“ nebo „kontaktujte nás pro více informací“ jako úplnou odpověď.

Používejte klidný, věcný tón. Definujte nezbytný technický termín v odpovědi, ale nehromaděte žargon. Zahrňte odkaz pouze tehdy, když cíl umožňuje další krok nebo poskytuje nezbytné podrobnosti; viditelná odpověď musí být stále úplná i bez jeho následování. Nezahrnujte reference, prodejní slogany, nesouvisející klíčová slova, vnořené tabulky, vícestupňové postupy nebo tvrzení bez podpory.

Každý typ příspěvku deklaruje kategorie záměrů, které musí jeho FAQ pokrývat. Kategorie záměru je druh rozhodnutí stojícího za otázkou, nikoli téma klíčového slova. Stránka symptomového typu může deklarovat kategorie příčina, samoléčba, závažnost a nákup, s alespoň jednou otázkou pokrývající varovné signály. Protože varovné signály ovlivňují bezpečnost, hlavní tělo je musí stále prezentovat; kontrola kategorie FAQ zajišťuje, že závěrečné otázky neprobírají pouze snadná komerční témata.

Tuto metodu spíše zobecňujte, než abyste tyto čtyři kategorie kopírovali všude. Srovnání může vyžadovat kategorie náklady na přechod, kompatibilita, smlouva a nejlepší shoda. Návod může vyžadovat kategorie předpoklady, obnova po selhání, ověření dokončení a údržba. Pokrytí je úspěšné, když deklarované kategorie odrážejí záměr vyhledávání stránky a skutečné důkazy, nikoli když každá stránka opakuje univerzální sadu otázek.

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

postTypes ve frontmatter zaznamenává registrovaná propojení. Tabulka převádí každé propojení na pravidlo pokrytí a umístění; nečiní FAQ povinným tam, kde výzkum nenajde užitečné zbytkové otázky.

„Obvykle“ znamená, že typ příspěvku běžně vytváří zbytkové otázky, nikoli že by je editoři měli vyrábět. Práh důkazů stále platí.

Kontrolní seznam QA

Recenzent kontroluje zdrojové záznamy před posouzením vizuálního stylu.

• Jediný zdroj: Každý viditelný pár pochází z [[faq]] frontmatter; žádná otázka ani odpověď není duplikována v těle Markdownu.
• Skutečná poptávka: Každá otázka má dohledatelný zdroj ve vyhledávacích návrzích, vyhledávání na webu, podpoře, prodeji, výzkumu nebo sledovaných AI promptech.
• Přirozená formulace: Každá otázka je gramaticky správná otázka v jazyce čtenáře, nikoli fragment klíčového slova nebo tvrzení o produktu.
• Přímá odpověď: První věta řeší otázku; druhá přidává nejužitečnější upřesnění nebo akci.
• Samostatný význam: Žádná odpověď nespoléhá na „výše“, „dříve“, „toto“ nebo jiný chybějící odkaz.
• Délka: Každá odpověď obsahuje 30–60 slov; každá otázka zůstává pod 120 znaky, pokud přirozená formulace skutečně nevyžaduje více.
• Počet: Blok běžně obsahuje čtyři až šest záznamů, se zaznamenaným důvodem pro jakoukoli výjimku.
• Žádné přesunuté sekce: Žádná odpověď neobsahuje klíčový argument, požadovaný postup, důležité varování nebo sadu důkazů, které patří do hlavního těla.
• Žádné opakování: Otázky neopakují již plně zodpovězené nadpisy a odpovědi znovu neshrmují článek.
• Deklarované pokrytí: Sada pokrývá požadované kategorie záměrů daného typu příspěvku, včetně kategorie rizika nebo varování tam, kde to téma vyžaduje.
• Správné umístění: Produkční blok následuje věcný obsah a zdroje a předchází primární CTA a souvisejícímu obsahu.
• Parita viditelného a schématu: FAQPage.mainEntity obsahuje stejné otázky a odpovědi jako vykreslený blok, bez skrytých nebo zastaralých položek.
• Přístupné ovládání: Přepínací tlačítka odhalují rozbalený stav, ID odpovědí jsou jedinečná, klávesnicová obsluha funguje, fokus je viditelný a pořadí dokumentu zůstává logické.
• Prázdný stav: Stránka bez kvalifikovaných otázek nevykresluje žádný nadpis FAQ ani zástupný obsah.
• Stav snímků obrazovky: Komentáře k zachycení zůstávají komentáři, dokud neexistují jejich pojmenované assety; žádná neexistující cesta není vykreslena jako obrázek.

FAQ

Živý příklad nahoře a data FAQPage jsou generována z pěti recenzovaných [[faq]] záznamů ve frontmatter této stránky. Pokrývají nezbytnost, zdroje, délku odpovědi, samostatné znění a paritu viditelného a schématu, aniž by zde udržovaly druhou kopii.