====== Obsah stránky (TOC) ======

https://www.dokuwiki.org/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í [[wiki:syntax#ovladaci-makra|ovládacího makra]] **''%%~~NOTOC~~%%''**.

Pro úplné vypnutí TOC v celé wiki nastavte buď [[doku>config:maxtoclevel]] nebo [[doku>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 [[doku>config:toptoclevel]] na hodnotu 2.

===== Konfigurace =====

Existují konfigurační nastavení, která určují, které úrovně nadpisů se mají zobrazit v TOC ([[doku>config:toptoclevel]], [[doku>config:maxtoclevel]]) a kolik takových nadpisů je potřeba, aby se TOC na stránce zobrazil ([[doku>config:tocminheads]]).

  * [[doku>config:toptoclevel]] - nastaví nejvyšší úroveň nadpisu, která se má zobrazit v TOC
  * [[doku>config:maxtoclevel]] - nastaví nejnižší úroveň nadpisu, která se má zobrazit v TOC
  * [[doku>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 [[doku>devel:templates]]