https://www.dokuwiki.org/accessibility

Přístupnost znamená, že věci fungují pro všechny – včetně lidí s různými zdravotními postiženími a omezeními.

Je také součástí legislativy mnoha zemí. Existuje například směrnice o přístupnosti webu ve všech zemích EU, Americans with Disabilities Act (ADA) a Section 508 v USA, stejně jako mnoho dalších.

Většina těchto zákonů nebo politik vyžaduje, aby web splňoval Web Content Accessibility Guidelines (WCAG) 2.1 úrovně AA nebo její variantu. Znalost toho, jak moc je software v souladu s WCAG, může být velkou výhodou – a důvodem, proč je některý software používán, pořizován nebo doporučován, zatímco jiný ne.

To, že je něco v souladu s WCAG, neznamená, že neexistují žádné bariéry nebo že nikdo není vyloučen – ale je to dobrý začátek a mezinárodně uznávaný standard.

Instance DokuWiki se skládá minimálně z jádra, obsahu, který do wiki vložíte, a volitelně z rozšíření (pluginy a případně jiný šablon). Každá z těchto částí má jinou úroveň přístupnosti.

Verze Hogfather s výchozí šablonou a bez pluginů byla v březnu 2021 auditována z hlediska souladu s WCAG. Zpráva z WCAG auditu ukazuje, že DokuWiki aktuálně není plně v souladu s WCAG.

Průběh řešení nalezených problémů můžete sledovat nebo se dokonce zapojit do jejich řešení na projektu „Accessibility Audit“ na GitHubu.

V současnosti neexistuje způsob, jak zjistit, zda jsou používaná rozšíření přístupná – kromě toho, že si je sami otestujete.

Bylo by užitečné, kdyby autoři pluginů a šablon alespoň sami deklarovali úroveň přístupnosti svých rozšíření.

I když je jádro plně v souladu s WCAG, obsah, který do wiki vložíte, může způsobit problémy s přístupností a učinit vaši wiki nevyhovující.

Zde je několik tipů, jak udržet obsah co nejpřístupnější:

• Používejte formátování tak, jak bylo zamýšleno – kvůli správné sémantice. Např. nepoužívejte nadpisy jen kvůli zvětšení a tučnosti textu, pokud to není skutečný nadpis. Nepoužívejte tabulky k vizuálnímu zvýraznění textu.
• Odkazy by měly mít text, který jasně vyjadřuje jejich účel.
• Nadpisy by měly přesně popisovat téma nebo účel.
• Nadpisy by ideálně neměly přeskočit žádnou úroveň a měly by společně odrážet strukturu stránky. Např. po nadpisu úrovně 3 by měl následovat nadpis úrovně 2, 3 nebo 4.
• Titulek stránky (text, který se zobrazuje na záložce prohlížeče) by měl popisovat téma nebo účel hlavního obsahu. Toho lze dosáhnout pomocí volby useheading – ta použije první nadpis hlavního obsahu jako titulek stránky.
• Obrázky, které nejsou pouze dekorativní, by měly mít alternativní text, který vyjadřuje stejný význam jako obrázek. Alternativní text lze přidat přímo do syntaxe obrázku, např. {{file.png|alternativní text}}, nebo jej popsat v okolním textu.
• Pokud je obrázek součástí odkazu a v odkazu není jiný text, je nutné přidat alternativní text přímo do syntaxe – měl by popisovat účel odkazu.
• Videa by měla mít titulky a zvukový popis (pokud obsahují důležité vizuální prvky, které nejsou jinak popsány).
• Ujistěte se, že je správně deklarován jazyk. Pokud wiki obsahuje stránky v různých jazycích, použijte plugin Translation (ale jen pokud je aktivována volba translateui). Pokud wiki obsahuje více jazyků na jedné stránce, použijte plugin Wrap s jazykovou syntaxí. Např. <wrap :en>This text is explicitly marked as English.</wrap>.

Správné používání nadpisů H1-H6 z hlediska přístupnosti má několik klíčových pravidel, která jsou definována v rámci WCAG (Web Content Accessibility Guidelines).

Nadpisy musí následovat v logickém sestupném pořadí. To znamená, že po H1 může následovat pouze H2, po H2 může následovat H2 nebo H3, ale nikdy ne H4.

Správný příklad struktury:

<h1>Hlavní nadpis stránky</h1>
<h2>První hlavní sekce</h2>
<h3>Podsekce</h3>
<h2>Druhá hlavní sekce</h2>
<h3>Další podsekce</h3>
<h4>Pod-podsekce</h4>

Nelze přeskočit hierarchické úrovně nadpisů. Například po H2 nemůže přímo následovat H4 bez H3.

• Pouze jeden H1 na stránce
• Měl by reprezentovat hlavní téma celé stránky
• Umisťuje se na začátek hlavního obsahu
• Musí být jedinečný v rámci celého webu

• H2 označuje hlavní sekce pod H1
• H3-H6 se používají pro podsekce v sestupném pořadí
• Každý nadpis by měl být použit minimálně každých 300 slov

WCAG definuje tři hlavní požadavky týkající se nadpisů:

1. 1.3.1 Info and Relationships (úroveň A) - Informace a vztahy musí být jasně strukturovány
2. 2.4.6 Headings and Labels (úroveň AA) - Nadpisy musí jasně popisovat svůj účel
3. 2.4.10 Section Headings (úroveň AAA) - Obsah by měl být organizován pomocí sekcí s nadpisy

• Používejte pouze skutečné HTML nadpisy (<h1> až <h6>)
• Text, který není nadpisem, nesmí být označen jako nadpis
• Nadpisy musí být přesné a informativní jako popisky sekcí

Čtečky obrazovky umožňují navigaci podle nadpisů, což je klíčový způsob orientace pro nevidomé uživatele. Správná struktura nadpisů vytváří jasný obsah stránky.

Nadpisy poskytují strukturální osnovu obsahu webové stránky, což pomáhá všem uživatelům rychle pochopit organizaci informací.

• Začněte vždy H1 na začátku hlavního obsahu
• Nadpisy by měly být stručné a výstižné
• Každý nadpis musí přesně popisovat obsah následující sekce
• Vytvořte jasnou hierarchii - nadpisy by měly poskytovat logickou strukturu dokumentu

Dodržování těchto pravidel zajistí, že vaše webové stránky budou přístupné pro všechny uživatele, včetně těch, kteří používají asistivní technologie.