Dokumentace

Kaloko

Stáhnout
Markdown s obrázky (.zip)Složka pro Docusaurus (.zip)Složka pro VitePress (.zip)Složka pro MkDocs (.zip)HTML pro offline čtení (.zip)PDFNovinky jako JSON
Stránky

Kontroly kondice

Všechny packy a všechny kontroly, které spouštějí, vypsané ze stejného kódu, jaký spouští CLI, takže seznam odpovídá verzi, kterou si nainstalujete. Kontroly kondice jen radí: plachta je ukazuje na kartě Kondice a verdikt kroku ani běhu nikdy nemění. Když na kontrole vašemu týmu záleží, převezměte ji jako kritérium (kaloko health adopt <krok>:<kontrola>); od té chvíle se počítá do přijetí.

Krok si packy zapne přes packs: [seo, a11y] v souboru scénáře (Přidat kritéria a packy). Druhy kontrol, jejich volby a id najdete v Kritéria, kontroly a packy.

Závažnost neúspěšné kontroly: chyba, když stránka zavře dveře lidem nebo vyhledávačům, jinak varování. Odpověď, kterou si evaluátor nebyl jistý, se ukáže jako nejisté.

Základy SEO (seo)

Co si ze stránky přečtou vyhledávače: titulek, popis, kanonickou adresu, hreflang, Open Graph, robots, viewport a strukturovaná data. Na kroku typu stack navíc porovná stránky mezi sebou.

Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.

IdKontrolaProč na ní záležíZávažnostKde platí
HC101Právě jeden nadpis H1Vyhledávače i čtečky obrazovky berou H1 jako název stránky; žádný nebo několik ho znejasní.varováníkaždý krok s packem
HC102Titulek má 10 až 70 znakůTitulek je modrý odkaz ve výsledcích hledání; příliš krátký nic neřekne, příliš dlouhý se ořízne.varováníkaždý krok s packem
HC103Popis stránky má 50 až 160 znakůMeta popis je úryvek pod odkazem; bez něj vyhledávač vybere náhodný text.varováníkaždý krok s packem
HC104Kanonický odkaz je uvedenýBez kanonické adresy si kopie stránky (parametry, filtry) konkurují ve vyhledávání.varováníkaždý krok s packem
HC105hreflang pro každý jazykhreflang říká vyhledávačům, kterou jazykovou verzi komu ukázat.varováníscénáře s více jazyky
HC106Open Graph titulek a popisSdílené odkazy na sítích a v chatech berou náhled z Open Graph.varováníkaždý krok s packem
HC107Stránka není vyřazená z indexaceZnačka robots s noindex stránku úplně vyřadí z výsledků hledání.chybakaždý krok s packem
HC108Viewport pro telefonyBez značky viewport ukazují telefony zmenšenou desktopovou stránku.chybakaždý krok s packem
HC109Atribut lang u htmlČtečky obrazovky podle <html lang> volí hlas a vyhledávače jazyk.varováníkaždý krok s packem
HC110Nic nepřetéká do stranyObsah širší než obrazovka nutí telefony posouvat stránku do strany a rozbíjí rozvržení.chybakaždý krok s packem
HC111V konzoli nejsou chybyChyby v konzoli často znamenají, že něco tiše nefunguje.chybakaždý krok s packem
HC112Strukturovaná data (JSON-LD) jsou na stránceStrukturovaná data říkají vyhledávačům a AI asistentům, co stránka je (produkt s cenou, článek, FAQ), a otevírají rozšířené výsledky hledání.varováníkaždý krok s packem
HC113Každý blok JSON-LD je platný JSONBlok, který nejde přečíst, se ignoruje celý: cena, drobečková navigace ani FAQ z něj se do výsledků hledání nedostanou.varováníkaždý krok s packem
HC121Titulky se v rámci jazyka neopakujíStránky se stejným titulkem vypadají pro vyhledávač jako duplicity; vybere jednu a ostatní schová.varováníkroky typu stack, napříč stránkami
HC122Meta popisy se v rámci jazyka neopakujíPopis zkopírovaný na více stránek hledajícímu nic neřekne o té, kterou se chystá otevřít.varováníkroky typu stack, napříč stránkami
HC123Nadpisy H1 se v rámci jazyka neopakujíDvě stránky se stejným H1 si konkurují ve stejném hledání a matou lidi, kteří přijdou na tu druhou.varováníkroky typu stack, napříč stránkami
HC124Každá stránka je svou kanonickou adresouKanonická adresa jinam žádá vyhledávač, aby stránku vynechal; když míří na chybovou stránku nebo noindex, vypadnou obě.varováníkroky typu stack, napříč stránkami
HC125Jazykové verze na sebe přes hreflang odkazují navzájemVyhledávač hreflang bez potvrzení z druhé strany ignoruje a ve výsledcích se ukáže špatný jazyk.varováníkroky typu stack, napříč stránkami
HC126Stránky ze sitemapy odpovídají 200, nepřesměrují a jdou indexovatSitemapa je seznam stránek, které chcete nechat najít; přesměrování, chyby a noindex v ní plýtvají procházením a podkopávají důvěru v celý seznam.varovánístacky načtené ze sitemapy
HC127Často zobrazované stránky nemají výrazně nižší míru proklikuLidé stránku ve výsledcích vidí, ale kliknou jinam: titulek a popis ve výsledcích neslibují to, co hledají.varovánístacky s daty o návštěvnosti

Odpovědní vyhledávače (aeo)

Co převezmou AI vyhledávače a asistenti: strukturovaná data FAQ, krátkou odpověď pod H1, llms.txt, meta popis a stránku tak, jak ji bez JavaScriptu dostane GPTBot. Levné signály ze stránky, ne pozice v žádném asistentovi.

Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.

IdKontrolaProč na ní záležíZávažnostKde platí
HC901Otázky a odpovědi na stránce mají strukturovaná data FAQPage nebo QAPageOdpovědní vyhledávače i rozšířené výsledky převezmou otázky a odpovědi mnohem spolehlivěji, když je stránka označí jako FAQPage nebo QAPage.varováníkaždý krok s packem
HC902Pod H1 je krátký odstavec s odpovědí (40 až 320 znaků)AI asistenti citují první jasnou odpověď, kterou najdou; krátký odstavec hned pod nadpisem je ten, který si vezmou.varováníkaždý krok s packem
HC903Soubor llms.txt je v kořeni webullms.txt dává jazykovým modelům krátkou mapu webu: co nabízí a které stránky číst.varováníkaždý krok s packem
HC904Stránka má meta popisBez meta popisu si vyhledávače i asistenti napíšou vlastní shrnutí z náhodného textu.varováníkaždý krok s packem
HC905I bez JavaScriptu dostane GPTBot titulek, kanonickou adresu, H1, strukturovaná data a většinu textuVětšina AI crawlerů JavaScript nespouští. Co se objeví až po skriptech, pro ně neexistuje, i když stránka v prohlížeči vypadá hotová.varováníkaždý krok s packem

Přístupnost (a11y)

Část WCAG 2.2 AA, kterou jde na stránce změřit, průchod tabulátorem (bez klikání a psaní) a strom přístupnosti. Audit se čtečkou obrazovky nenahradí.

Běží i na designových prostředích.

IdKontrolaProč na ní záležíZávažnostKde platí
HC301Obrázky mají alternativní textBez alt textu nevidomí ani vyhledávače nevědí, co obrázek ukazuje.chybakaždý krok s packem
HC302Odkazy a tlačítka mají přístupný názevTlačítko s ikonou bez názvu čtečka přečte jen jako „tlačítko“.chybakaždý krok s packem
HC303Formulářová pole mají popiskyUživatel čtečky uslyší u pole bez popisku jen „editační pole“.chybakaždý krok s packem
HC304Úrovně nadpisů se nepřeskakujíLidé se pohybují po nadpisech; skok z H2 na H4 zamlží strukturu.varováníkaždý krok s packem
HC305Text splňuje kontrast WCAG AAText s nízkým kontrastem se špatně čte na slunci i lidem se slabším zrakem.chybakaždý krok s packem
HC306Stránka má hlavní oblast (main)Uživatelé čteček skáčou rovnou na <main>, aby přeskočili navigaci.varováníkaždý krok s packem
HC307Id prvků jsou jedinečnáDuplicitní id rozbijí popisky, kotvy i skripty, které prvky hledají podle id.varováníkaždý krok s packem
HC308Pořadí tabulátoru odpovídá stránce a dojde ke každému prvkuKdo ovládá web klávesnicí, posouvá se tabulátorem; když fokus skáče nebo tlačítko vynechá, ztratí se nebo nemůže dál.varováníkaždý krok s packem
HC309Fokus klávesnice je dobře vidět (kontrast aspoň 3 : 1)Bez viditelného rámečku fokusu uživatel klávesnice neví, kde na stránce je.varováníkaždý krok s packem
HC310Klávesnice nikde neuvíznePrvek, který tabulátor nepustí ven (vložený přehrávač, vlastní menu), uživatele klávesnice uvězní.chybakaždý krok s packem
HC311Odkaz pro přeskočení na obsah nebo rychlá cesta k němuBez odkazu „Přeskočit na obsah“ musí uživatelé klávesnice a čteček na každé stránce protabovat celé menu.varováníkaždý krok s packem
HC312Ovládací prvky mají název ve stromu přístupnostiStrom přístupnosti je to, co čtečky skutečně čtou; prvek bez názvu ohlásí jen jako „tlačítko“.chybakaždý krok s packem
HC313Orientační oblasti jsou úplné a pojmenovanéUživatelé čteček skáčou mezi hlavičkou, navigací, obsahem a patičkou; neoznačené duplicity znějí všechny stejně.varováníkaždý krok s packem
HC314Role a atributy ARIA jsou platnéChybná ARIA je horší než žádná: čtečky jí věří a ohlašují, co na stránce není.varováníkaždý krok s packem

Použitelnost (usability)

Otázky pro evaluátor vybrané podle typu stránky kroku (page: landing, work, list, settings, form, doc) a popsaná formulářová pole.

Běží i na designových prostředích.

IdKontrolaProč na ní záležíZávažnostKde platí
HC201Účel stránky je jasný hned na první obrazovceNávštěvník se během pár vteřin rozhodne, jestli je na správném místě.varovánítypy stránek landing, doc
HC202Jedna jasná hlavní akceNěkolik stejně výrazných tlačítek lidi zdrží; žádné je nechá bez dalšího kroku.varovánítyp stránky landing
HC203Formulářová pole mají viditelný popisekPlaceholder při psaní zmizí a lidé zapomenou, co do pole patří.varováníkaždý krok s packem
HC204Odkazy a tlačítka říkají, co udělají„Klikněte zde“ nebo „Více“ neřekne, kam vede, zvlášť mimo kontext nebo ve čtečce.varováníkaždý krok s packem
HC205Z nadpisu je jasné, k čemu obrazovka jeLidé mezi obrazovkami přepínají celý den; s mlhavým nadpisem musí hledat, kde vlastně jsou.varovánítypy stránek work, list, settings, form
HC207Každá položka seznamu říká, co je zač a jak ji otevřítŘádek jen s identifikátorem nebo datem nutí lidi otevírat položky jednu po druhé.varovánítyp stránky list
HC208Každé nastavení říká, co změní a jak se uložíLidé odcházejí z nastavení a nevědí, jestli se změna projevila.varovánítyp stránky settings
HC206Je jasné, jak formulář odeslat a co bude dálKdyž není jasné odesílací tlačítko nebo další krok, lidé odešlou dvakrát nebo to vzdají.varovánítyp stránky form
HC209Text jde rychle projít: nadpisy a krátké odstavceČtenář dokumentace hledá svou otázku očima; souvislý text odpověď schová.varovánítyp stránky doc

Výkon (perf)

Laboratorní hodnoty změřené v prohlížeči průchodu: LCP, CLS, TTFB a velikost stránky. Skuteční návštěvníci na pomalejších telefonech mohou vidět jiná čísla.

Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.

IdKontrolaProč na ní záležíZávažnostKde platí
HC401Největší obsah se vykreslí do 2,5 sLCP je doba, než stránka působí hotově; Google ho používá při řazení.varováníkaždý krok s packem
HC402Rozvržení se při načítání nehýbe (CLS pod 0,1)Obsah, který při načítání poskakuje, svádí k ťuknutí vedle.varováníkaždý krok s packem
HC403Server odpoví do 800 msPomalý první bajt zdrží všechno ostatní na stránce.varováníkaždý krok s packem
HC404Stránka má do 3 MBTěžké stránky jsou pomalé a drahé na mobilních datech.varováníkaždý krok s packem

Konzole (console)

Evaluátor přečte chyby v konzoli kroku a řekne, jestli se týkají toho, co krok přijímá, nebo jde o šum cizích skriptů.

Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.

IdKontrolaProč na ní záležíZávažnostKde platí
HC501Chyby v konzoli se netýkají toho, co krok přijímáOdděluje skutečné chyby od šumu cizích skriptů (analytika, rozšíření).chybakaždý krok s packem

Chybové stránky (errors)

Pro stránky 404, 410, 500 a údržbu: skutečný chybový stav, cesta zpět a žádné technické podrobnosti navenek. Patří na kroky, které jsou chybovými stránkami.

Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.

IdKontrolaProč na ní záležíZávažnostKde platí
HC601Odpovídá chybovým stavem (4xx/5xx), ne „měkkou“ 200Chybějící stránka s odpovědí 200 se zaindexuje jako obsah a skryje rozbité odkazy před monitoringem.chybajen chybové stránky (expect_status nebo stránka s odpovědí 4xx/5xx)
HC602Odkazuje zpět na úvodSlepá ulička návštěvníka ztratí.varováníkaždý krok s packem
HC603Navigace nebo hledání zůstává dostupnéLidé na chybové stránce chtějí najít, pro co přišli.varováníkaždý krok s packem
HC604Žádný výpis chyby, SQL ani ladicí stránkaVýpisy chyb prozradí cesty, verze a dotazy, které pomáhají útočníkům.chybakaždý krok s packem
HC605Chybu vysvětlí lidsky a nabídne cestu dálKlidné vysvětlení udrží lidi na webu, místo aby odešli.varováníjen chybové stránky (expect_status nebo stránka s odpovědí 4xx/5xx)
HC606V konzoli nejsou chybySkripty, které na chybové stránce padají, často rozbijí i její navigaci.chybakaždý krok s packem

Jazykové verze (locale)

Pro vícejazyčné weby: html lang, vlastní hreflang stránky, jazyk textu a desetinný oddělovač cen odpovídají procházenému jazyku. Jen ve scénářích, které uvádějí locales.

Běží i na designových prostředích.

IdKontrolaProč na ní záležíZávažnostKde platí
HC1001html lang odpovídá procházenému jazykuČtečky podle html lang volí hlas a vyhledávače jazyk; německou stránku označenou jako anglickou čtečka přečte anglickým přízvukem.varováníkaždý krok s packem
HC1002Vlastní hreflang stránky odpovídá jazyku, kódy jsou platné a sedí k adresámŠpatný vlastní hreflang nebo kód typu en_UK způsobí, že vyhledávač celou sadu jazykových verzí přeskočí.varováníkaždý krok s packem
HC1003Text je v jazyce procházené verzeNepřeložená stránka v jazykové verzi ztratí návštěvníky a pro vyhledávač vypadá jako duplicita zdrojového jazyka.varováníkaždý krok s packem
HC1004Ceny používají desetinný oddělovač daného jazykaZápis 12.50 € působí na německého nebo českého zákazníka divně a 12,50 $ na amerického; vypadá to, že obchod nebyl dělaný pro ně.varováníkaždý krok s packem
HC1005Každá stránka má v každém jazyce vlastní verzi (hreflang)Stránka bez překladu pošle návštěvníky toho jazyka jinam a vyhledávač jim ukáže, co zbude; když víc stránek míří na jednu verzi, jde obvykle o náhradu výpisem nebo úvodní stránkou.varovánístacky s items.variants: hreflang

Obrazovky aplikací (app)

Nativní aplikace na Androidu, iOS a desktopu: popsané ovládací prvky, dotykové plochy, oříznutý text, pády a jasný další krok.

IdKontrolaProč na ní záležíZávažnostKde platí
HC701Každý ovládací prvek má přístupný popisekVoiceOver a TalkBack přečtou prvek bez popisku jen jako „tlačítko“.chybakaždý krok s packem
HC702Dotykové plochy aspoň 48 dp / 44 ptMalé plochy se minou, hlavně palcem a u starších lidí.varováníkaždý krok s packem
HC703Žádné oříznuté texty (…)Oříznutý text skryje ceny, jména nebo pokyny, často jen v delších jazycích.varováníkaždý krok s packem
HC704Aplikace nespadla ani nezamrzlaPád nebo hlášení „aplikace nereaguje“ ukončí práci.chybakaždý krok s packem
HC705Účel obrazovky a další krok jsou jasnéNa malé obrazovce potřebují lidé hned vidět, co dál.varováníkaždý krok s packem

Reference designu (design)

Implementace proti schválené verzi designu: pixely, struktura a tokeny. Jediný pack, který se vždy počítá do přijetí, proto má id AC.

IdKontrolaProč na ní záležíZávažnostKde platí
AC801Vypadá jako reference designu (rozdíl pod 3 % pixelů)Viditelné rozdíly od schváleného designu znamenají, že se postavilo jinak, než se domluvilo.akceptační kritériumkaždý krok s packem
AC802Stejná struktura jako reference designuChybějící nadpisy, akce nebo pole mění, co lidé mohou udělat, i když to vypadá podobně.akceptační kritériumkaždý krok s packem
AC803Barvy, písma, velikosti a mezery pocházejí z tokenůRuční hodnoty se odchylují od design systému a zdražují pozdější změny.akceptační kritériumkaždý krok s packem

Kontroly webu (site)

Jednou za web a běh, ne za krok: robots.txt, sitemapy, které uvádí, llms.txt a přesměrování na https a na jednu podobu domény. Vypnuté, dokud scénář nenastaví health: { site: true }, protože posílají vlastní požadavky. Nejde je převzít jako kritéria.

IdKontrolaProč na ní záležíZávažnostKde platí
HC1101robots.txt odpovídá 200 a každý řádek dává smyslRoboti přeskočí řádky, kterým nerozumí, takže překlep jako „Disalow“ potichu otevře nebo zavře část webu; chyba serveru procházení úplně zastaví.varováníjednou za web
HC1102robots.txt neblokuje procházené úvodní stránkyDisallow, který zakryje úvodní stránku nebo kořen jazykové verze, vyřadí web z vyhledávání; často jde o nastavení ze stagingu, které se dostalo na produkci.chyba na production, jinde varováníjednou za web
HC1103robots.txt neblokuje AI robotyGPTBot, ClaudeBot, PerplexityBot a další se řídí robots.txt; když jsou zablokovaní, web se v odpovědích AI neobjeví a asistenti jeho stránky uživatelům neotevřou.varováníjednou za web, jen na production
HC1104Sitemapy odpovídají, jsou platné a uvádějí úplné adresy z vlastní doményRozbitou nebo useknutou sitemapu, relativní adresy nebo cizí doménu vyhledávač ignoruje; vymyšlená data lastmod ho naučí ignorovat i je.varováníjednou za web
HC1105Soubor llms.txt je v kořeni webullms.txt dává jazykovým modelům krátkou mapu webu: co nabízí a které stránky číst.varováníjednou za web
HC1106http:// přesměruje na https:// jedním skokemKaždé přesměrování navíc stojí čas při každé první návštěvě a stránka dostupná přes http:// dělí odkazy i pozice mezi dvě adresy.varováníjednou za web
HC1107Druhá podoba domény (s www nebo bez) přesměruje jedním skokemKdyž odpovídá example.com i www.example.com, vidí vyhledávač dvě kopie webu; řetěz přesměrování zdrží každou návštěvu, která přijde druhou cestou.varováníjednou za web
Na této stránceNa této stránce