====== Práce se seznamy ======

https://www.dokuwiki.org/faq:lists

===== Položky seznamu na více řádků =====

:?: Jak mohu do položky seznamu vložit blok kódu nebo více řádků?

:!: Syntaxe seznamu očekává, že každá položka bude na jednom řádku, a přerušení číslovaného seznamu způsobí restart číslování od 1. To například znemožňuje vložit tabulku do jedné položky. Nicméně je možné vložit blok kódu, soubor nebo zalomení řádku. Bloky kódu musí začínat na stejném řádku jako položka, pro zalomení řádku použijte syntaxi ''%%\\%%''.

Příklad:

<file>
  - první položka
  - druhá položka se zalomením\\ druhý řádek
  - třetí položka s kódem: <code>
nějaký kód
sem patří
</code>
  - čtvrtá položka
</file>

Výsledek:

  - první položka
  - druhá položka se zalomením\\ druhý řádek
  - třetí položka s kódem: <code>
nějaký kód
sem patří
</code>
  - čtvrtá položka

Stejný trik lze použít i pro jiné syntaxe, jako jsou tabulky, pomocí pluginu [[plugin:wrap]].

Pro vložení prázdného řádku mezi položky číslovaného seznamu použijte:

<code>
  - Položka seznamu 1 \\ \\           //(zalomení, zalomení, mezera)
  - Položka seznamu 2
  - Položka seznamu 3
</code>

Výsledek:

  - Položka seznamu 1 \\ \\
  - Položka seznamu 2
  - Položka seznamu 3

Pro lepší vizuální oddělení můžete přidat nezalomitelnou mezeru např.
<code>\\ \\~~</code>
kde ''~~'' je definováno jako nezalomitelná mezera v souboru ''conf/entities.conf''.

===== Pokračování číslování seznamu =====

:?: Lze vytvořit dva číslované seznamy, kde druhý pokračuje v číslování tam, kde první skončil?

:!: Ne, to není možné s výchozí syntaxí. Jakmile jeden seznam skončí, číslování se restartuje:

<code>
  - první položka
  - druhá položka

Už to není seznam

  - třetí položka? ne, je to první položka druhého seznamu
</code>

===== Stylování číslování číslovaných seznamů =====

:?: Nelíbí se mi výchozí číslování číslovaných seznamů. Jak ho mohu změnit?

:!: Formát číslování je definován pomocí CSS. Výchozí šablona definuje formátování pro první 4 úrovně číslovaných seznamů:

<code css>
div.dokuwiki ol { list-style-type: decimal; }
div.dokuwiki ol ol { list-style-type: upper-roman; }
div.dokuwiki ol ol ol { list-style-type: lower-alpha; }
div.dokuwiki ol ol ol ol { list-style-type: lower-greek; }
</code>

Seznam všech hodnot pro ''list-style-type'' najdete např. na [[https://developer.mozilla.org/en-US/docs/Web/CSS/list-style-type|MDN]].

===== Stylování odrážek nečíslovaných seznamů =====

:!: Formát odrážek je také definován pomocí CSS. Výchozí nastavení vypadá takto:

<code css>
div.dokuwiki ul {
  line-height: 1.5em;
  list-style-type: square;
  list-style-image: none;
  margin: 0 0 1em 3.5em;
  color: __text_alt__;
}
</code>

Můžete ho nahradit např. tímto:

<code css>
div.dokuwiki ul { list-style-type: disc; }
div.dokuwiki ul ul { list-style-type: circle; }
div.dokuwiki ul ul ul { list-style-type: square; }
div.dokuwiki ul ul ul ul { list-style-type: square; }
</code>

Bohužel lze vybírat pouze mezi symboly ''circle'', ''disc'' a ''square''. Pokud chcete použít jiný Unicode symbol (např. z [[wpde>Unicodeblock Dingbats]]) bez použití obrázků, zkuste:

<code css>
div.dokuwiki ul .li:before {content: '➤';}
div.dokuwiki ul ul .li:before {content: '♫';}
div.dokuwiki ul ul ul .li:before {content: '☛';}
div.dokuwiki ul ul ul ul .li:before {content: '⤷';}
div.dokuwiki ul ul ul ul ul .li:before {content: '✩';}
</code>

Snadno to přepíšete ve svém [[doku>devel:css#user_styles|userstyle.css]].

===== Pluginy pro seznamy =====

Existuje několik pluginů, které implementují alternativní syntaxi pro seznamy, včetně definičních seznamů, a mohou umožnit to, co výchozí syntaxe nedokáže. Viz [[https://www.dokuwiki.org/plugins?plugintag=list|pluginy označené jako „list“]].