summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive.mdwn')
-rw-r--r--ikiwiki/directive.mdwn43
1 files changed, 43 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..8d3f075
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,43 @@
+[[!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 ]]
+"""]]