summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
blob: 8d3f0758013161dbe6ce9f6ecafa019947606e6a (plain)

[[!meta robots="noindex, follow"]] Direktivy se podobají [[wiki odkazům|ikiwiki/WikiLink]], až na to, že začínají vykřičníkem a mohou obsahovat parametry. Obecný formát vypadá následovně:

\[[!direktiva param="hodnota" param="hodnota"]]

Direktivy se aplikují před zpracováním zbytku stránky a mohou stránku nejrůznějším způsobem měnit.

Uvozovky okolo hodnot mohou být vynechány v případě, že je hodnotou jediné slovo. Některé direktivy mohou používat parametry bez hodnot. Například:

\[[!tag foo]]

Direktiva nemusí být zapsána celá na jednom řádku. Pokud je to čitelnější, můžete ji roztáhnout přes více řádků:

\[[!direktiva foo="baldersnatch"
bar="supercalifragilisticexpialidocious" baz=11]]

Více řádků uvozeného textu lze použít i v hodnotě. Chcete-li v uvozeném textu použít (anglické) uvozovky, obklopte text trojitými uvozovkami:

\[[!direktiva text="""
1. "něco"
2. "cosi"
3. "cokoliv"
"""]]

ikiwiki podporuje i starší zápis direktiv, který vyžaduje, aby se v direktivě nacházela mezera, což ji odliší od [[wiki odkazů|ikiwiki/wikilink]]. Tento zápis má několik nevýhod: vyžaduje za direktivou bez parametrů mezeru (například \[[pagecount ]]) a naopak neumožňuje mezery ve [[wiki odkazech|ikiwiki/wikilink]]. Zápis direktiv s ! na začátku je v ikiwiki výchozí, ale chcete-li použít starší způsob zápisu, stačí vypnout volbu prefix_directives.

[[!if test="enabled(listdirectives)" then=""" Následuje seznam direktiv povolených v této wiki:

[[!listdirectives ]] """]]