Obsah stránky (TOC)
Zkratka TOC = Table Of Contents
TOC automaticky generuje z nadpisů stránky přehledný obsah stránky.
Obsah stránky zobrazuje přehled stránky výpisem nadpisů jednotlivých sekcí v přehledném rámečku, který se obvykle nachází v pravém horním rohu obsahu. Umožňuje uživatelům rychlý pohled na strukturu stránky a rychle přejít na požadovanou část stránky.
Obsah stránky se zobrazí pouze tehdy, pokud je na stránce přítomen minimální počet kvalifikovaných nadpisů. Více informací viz Konfigurace níže.
Tipy
Vypnutí TOC
Obsah stránky lze na konkrétní stránce vypnout pomocí ovládacího makra ~~NOTOC~~.
Pro úplné vypnutí TOC v celé wiki nastavte buď config:maxtoclevel nebo config:tocminheads na hodnotu 0.
Nezobrazovat název stránky v TOC
Horní nadpis stránky, často sloužící jako její název, lze ho vyloučit z TOC nastavením config:toptoclevel na hodnotu 2.
Konfigurace
Existují konfigurační nastavení, která určují, které úrovně nadpisů se mají zobrazit v TOC (config:toptoclevel, config:maxtoclevel) a kolik takových nadpisů je potřeba, aby se TOC na stránce zobrazil (config:tocminheads).
- config:toptoclevel - nastaví nejvyšší úroveň nadpisu, která se má zobrazit v TOC
- config:maxtoclevel - nastaví nejnižší úroveň nadpisu, která se má zobrazit v TOC
- config:tocminheads - nastaví minimální počet kvalifikovaných nadpisů potřebných pro zobrazení TOC
Např. ve wiki s následujícím nastavením:
- toptoclevel = 2, tj.
=====(v HTML odpovídá <h2>) - maxtoclevel = 4, tj.
===(v HTML odpovídá <h4>) - tocminheads = 3
Stránka musí obsahovat alespoň tři nadpisy úrovní 2–4, aby se TOC zobrazil.
Vývoj
- Viz devel:templates