Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- cs:wiki:syntax [2016-11-07 14:48] – [Tabulka] 195.113.1.54
+++ cs:wiki:syntax [2021-10-27 21:17] (aktuální) – ece
@@ Řádek 1: / Řádek 1: @@
 ====== Wiki Syntax ======
-[[DokuWiki]] podporuje jednoduchý jazyk tak, aby datové soubory byly čitelné a co nejpřehlednější. Na této stránce najdete kompletní popis syntaxe, kterou můžete použít při editaci stránek. Zdrojový text této stránky jednoduše zobrazíte kliknutím na tlačítko //Upravit stránku// na začátku nebo na konci stránky. Chcete-li něco vyzkoušet, použijte [[playground:playground|pískoviště]]. Jednodušší prvky jsou přístupné také pomocí [[doku>toolbar|tlačítek]].
+[[doku>DokuWiki]] podporuje jednoduchý jazyk tak, aby datové soubory byly čitelné a co nejpřehlednější. Na této stránce najdete kompletní popis syntaxe, kterou můžete použít při editaci stránek. Zdrojový text této stránky jednoduše zobrazíte kliknutím na tlačítko //Upravit stránku// na začátku nebo na konci stránky. Chcete-li něco vyzkoušet, použijte [[playground:playground|pískoviště]]. Jednodušší prvky jsou přístupné také pomocí [[doku>toolbar|tlačítek]].
 ===== Základní formátování textu =====
@@ Řádek 19: / Řádek 18: @@
   Nějaký text lze označit jako <del>smazaný</del>.
-**Odstavce** se oddělují pomocí prázdných řádků. Pokud chcete **zalomit řádek** bez nového odstavce, použijte dvě zpětná lomítka následovaná bílými znaky nebo koncem řádku.
+**Odstavce** se oddělují pomocí prázdných řádků. Pokud chcete **zalomit řádek** bez nového odstavce, použijte dvě zpětná lomítka následovaná mezerami nebo koncem řádku.
 Toto je nějaký text se zalomením řádků\\ Všimněte si,
 že dvě zpětná lomítka jsou rozpoznána na konci řádku,\\
-nebo pokud následují\\ bílé znaky \\toto se stane bez nich.
+nebo pokud následují\\ mezery \\toto se stane bez nich.
   Toto je nějaký text se zalomením řádků\\ Všimněte si,
   že dvě zpětná lomítka jsou rozpoznána na konci řádku,\\
-  nebo pokud následují\\ bílé znaky \\toto se stane bez nich.
+  nebo pokud následují\\ mezery \\toto se stane bez nich.
 Ruční zalomení řádku používejte uvážlivě jen tam, kde je to opravdu nutné.
 ===== Odkazy =====
-[[DokuWiki]] podporuje mnoho různých způsobů, jak vytvářet odkazy.
+[[doku>DokuWiki]] podporuje mnoho různých způsobů, jak vytvářet odkazy.
 ==== Externí ====
-Externí odkazy jsou rozpoznávány automaticky: http://www.google.com nebo jednoduše www.google.com - lze nastavit i jména odkazů: [[http://www.google.com|Tento odkaz ukazuje na google]]. Mailové adresy jako <andi@splitbrain.org> rovněž fungují.
+Externí odkazy jsou rozpoznávány automaticky: http://www.google.com nebo jednoduše www.google.com - lze nastavit i jména odkazů: [[http://www.google.com|Tento odkaz ukazuje na Google]]. E-mailové adresy jako <andi@splitbrain.org> rovněž fungují.
   Externí odkazy jsou rozpoznávány automaticky: http://www.google.com nebo
   jednoduše www.google.com - lze nastavit i jména odkazů:
-  [[http://www.google.com|Tento odkaz ukazuje na google]]. Mailové adresy
+  [[http://www.google.com|Tento odkaz ukazuje na Google]]. E-mailové adresy
   jako <andi@splitbrain.org> rovněž fungují.
 ==== Interní ====
@@ Řádek 58: / Řádek 49: @@
   Interní odkazy se vytváří pomocí hranatých závorek. Vložíte
   [[doku>pagename|název stránky]] ([[wiki stránka]]) a případně
-  [[wiki stránka|jiný popisek stránky]]. Názvy wiki stránek jsou
+  [[wiki stránka|jiný popisek stránky]].
-  převedeny automaticky na malá písmena. Speciální znaky nejsou povoleny.
+[[doku>pagename|Názvy wiki stránek]] jsou převedeny automaticky na malá písmena. Speciální znaky nejsou povoleny.
 Můžete používat [[doku>namespaces|jmenné prostory]] pomocí dvojtečky v názvu stránky.
@@ Řádek 74: / Řádek 65: @@
 Poznámky:
-  * Odkazy na [[cs:wiki:syntax|existující stránky]] jsou ostylovány jinak než odkazy na [[neexistující]].
+  * Odkazy na [[cs:wiki:syntax|existující stránky]] jsou zobrazeny jiným stylem než odkazy na [[neexistující]].
   * DokuWiki ve výchozím nastavení nepoužívá [[wp>CamelCase]] k automatickému vytváření odkazů, ale tuto funkci je možné zapnout v souboru s [[doku>config|nastavením]]. Rada: Pokud je slovo DokuWiki odkazem, je CamelCase zapnut.
   * Jakmile se změní název sekce, změní se pochopitelně i odkaz na tuto sekci. Tudíž na odkazování mezi sekcemi nespoléhejte až příliš.
 ==== Interwiki ====
@@ Řádek 86: / Řádek 76: @@
   rychlé odkazy mezi různými wiki. Například tento odkaz směřuje na stránku
   o wiki na Wikipedii: [[wp>Wiki]].
 ==== Sdílené složky ve Windows ====
@@ Řádek 98: / Řádek 86: @@
   * Přímé procházení sdílenými složkami funguje z bezpečnostních důvodů pouze ve výchozím nastavení Microsoft Internet Exploreru, a to ještě jen v "lokální zóně".
-  * V Mozille a Firefoxu to lze zapnout pomocí volby [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], ale není to doporučeno.
+  * V Mozille a Firefoxu to lze povolit pomocí volby uvedené ve znalostní bázi [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. Nicméně, stále bude existovat upozornění JavaScriptu na pokus o otevření sdílené složky Windows. Chcete-li odebrat toto upozornění (pro všechny uživatele), vložte následující řádek do ''conf/lang/en/lang.php'' (více informací na stránce [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php>
-  * Viz [[bug>151]] pro více informací.
+<?php
+/**
+ * Customization of the english language file
+ * Copy only the strings that needs to be modified
+ */
+$lang['js']['nosmblinks'] = '';
+</code>
 ==== Obrázkové odkazy ====
@@ Řádek 106: / Řádek 99: @@
 Také je možno používat obrázek jako odkaz na jinou interní či externí stránky, a to zkombinováním syntaxe pro odkazy a [[#obrazky_a_jine_soubory|obrázky]] (viz níže) například takto:
-  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
+  [[http://php.net|{{wiki:dokuwiki-128.png}}]]
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
+[[http://php.net|{{wiki:dokuwiki-128.png}}]]
 Poznámka: Formátování obrázku je jediná formátovací syntaxe, kterou lze použít uvnitř jména odkazu.
@@ Řádek 119: / Řádek 112: @@
   Poznámky pod čarou ((Toto je poznámka pod čarou)) vložte do dvojitých závorek.
 ===== Sekce a nadpisy =====
@@ Řádek 136: / Řádek 128: @@
 ----
 ===== Obrázky a jiné soubory =====
@@ Řádek 143: / Řádek 133: @@
 Interní a externí [[doku>images|obrázky]] můžete vkládat pomocí složených závorek. Volitelně jim můžete nastavit i rozměry.
-Původní velikost                  {{wiki:dokuwiki-128.png}}
+Původní velikost:                  {{wiki:dokuwiki-128.png}}
-Zmenšeno na danou šířku           {{wiki:dokuwiki-128.png?50}}
+Zmenšeno na danou šířku:           {{wiki:dokuwiki-128.png?50}}
-Zmenšeno na danou šířku i výšku   {{wiki:dokuwiki-128.png?200x50}}
+Zmenšeno na danou šířku i výšku:   {{wiki:dokuwiki-128.png?200x50}}
-Externí obrázek se změněnými rozměry: {{http://de3.php.net/images/php.gif?200x50}}
+Externí obrázek se změněnými rozměry: {{http://php.net/images/php.gif?200x50}}
-  Původní velikost                  {{wiki:dokuwiki-128.png}}
+  Původní velikost:                  {{wiki:dokuwiki-128.png}}
-  Zmenšeno na danou šířku           {{wiki:dokuwiki-128.png?50}}
+  Zmenšeno na danou šířku:           {{wiki:dokuwiki-128.png?50}}
-  Zmenšeno na danou šířku i výšku   {{wiki:dokuwiki-128.png?200x50}}
+  Zmenšeno na danou šířku i výšku:   {{wiki:dokuwiki-128.png?200x50}}
-  Externí obrázek se změněnými rozměry: {{http://de3.php.net/images/php.gif?200x50}}
+  Externí obrázek se změněnými rozměry: {{http://php.net/images/php.gif?200x50}}
@@ Řádek 174: / Řádek 164: @@
   {{ wiki:dokuwiki-128.png |Toto je titulek}}
-Pokud zadáte název souboru (interního či externího), který nemá příponu jako obrázek (''gif, jpeg, png''), dostate místo toho obyčejný odkaz na soubor.
 Viz výše pro [[#obrázkové odkazy|odkazování obrázkem]].
+==== Podporované formáty médií ====
+DokuWiki může přímo vložit následující formáty médií.
+| Obrázek | ''gif'', ''jpg'', ''png''  |
+| Video   | ''webm'', ''ogv'', ''mp4'' |
+| Audio   | ''ogg'', ''mp3'', ''wav''  |
+| Flash   | ''swf''                    |
+Pokud zadáte název souboru nepodporovaného formátu, zobrazí se místo toho obyčejný odkaz na soubor.
+Přidáním ''?linkonly'' poskytnete normální odkaz na medium, bez zobrazení v textu.
+  {{wiki:dokuwiki-128.png?linkonly}}
+{{wiki:dokuwiki-128.png?linkonly}} To je jen odkaz na obrázek.
+==== Náhradní formáty ====
+Bohužel, některé prohlížeče nechápou všechny video a audio formáty. Pro zmírnění tohoto problému (zvýšení kompatibility prohlížečů), můžete nahrát svůj soubor v několika různých formátech.
+Zvažte například toto vložené mp4 video:
+  {{video.mp4|Vtipné video}}
+Když nahrajete ''video.webm'' a ''video.ogv'' vedle odkazovaného ''video.mp4'', DokuWiki tyto soubory automaticky přidá jako alternativní formáty tak, aby jeden z těchto tří souborů byl prohlížečem rozpoznán.
+Navíc DokuWiki podporuje úvodní obrázek (plakát), který se zobrazí před spuštěním videa. Tento obrázek musí mít stejný název jako má video a musí být ve formátu JPG nebo PNG. Ve výše uvedeném příkladu bude funkční soubor ''video.jpg''.
 ===== Seznamy =====
@@ Řádek 209: / Řádek 222: @@
 </code>
+Podívejte se také na [[doku>faq:lists|FAQ on list items]].
+===== Převod textu =====
-===== Smajlíci =====
+DokuWiki umí převést některé předem definované znaky nebo řetězce na obrázky či jiný text nebo HTML.
+Převod textu na obrázky se provádí hlavně u smajlíků. Převod textu na HTML entity se používá pro typografické nahrazení, lze ale nakonfigurovat i pro jiné HTML použití.
+==== Smajlíci ====
 DokuWiki převede běžně používané [[wp>emoticon|smajlíky]] do jejich obrázkové podoby. Další smajlíky můžete vložit do adresáře ''smiley'' a nastavit v souboru ''conf/smileys.conf''. Tady je přehled smajlíků, které DokuWiki standardně rozpoznává.
@@ Řádek 236: / Řádek 255: @@
   * DELETEME %% DELETEME %%
+==== Typografie ====
+[[doku>DokuWiki]] umí převést některé obyčejné znaky na odpovídající typograficky správné entity. Zde je příklad rozpoznávaných znaků.
-===== Typografie =====
-[[DokuWiki]] umí převést některé obyčejné znaky na odpovídající typograficky správné entity. Zde je příklad rozpoznávaných znaků.
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
@@ Řádek 250: / Řádek 267: @@
 </code>
-Poznámka: Tento převod lze vypnout v [[doku>config#typography|nastavení]] a v [[doku>entities|souboru s entitami]].
+Stejným způsobem, můžeme vytvořit libovolné HTML, pokud je přidáno do [[doku>entities|souboru s entitami]].
+Existují tři výjimky, které nepocházejí z tohoto souboru s entitami: znaménko násobení (640 × 480), "jednoduché" a "dvojité uvozovky". Tyto výjimky mohou být zakázány v [[doku>config:typography|konfiguraci]].
 ===== Citace =====
@@ Řádek 257: / Řádek 275: @@
 Občas budete potřebovat označit nějaký text jako odpověď nebo komentář. Můžete využít následující syntaxe:
-  Myslím, že bychom to měli udělat.
+<code>
-  > Ne, neměli.
-  >> Ne fakt, řekl jsem, že bychom měli.
-  > Fakt?
-  >> Jistě!
-  >>> No tak to teda uděláme!
 Myslím, že bychom to měli udělat.
@@ Řádek 279: / Řádek 286: @@
 >> Jistě!
->>> No tak to teda uděláme!
+>>> No tak to tedy uděláme!
+</code>
+Myslím, že bychom to měli udělat.
+> Ne, neměli.
+>> Ne fakt, řekl jsem, že bychom měli.
+> Fakt?
+>> Jistě!
+>>> No tak to tedy uděláme!
 ===== Tabulky =====
-[[DokuWiki]] podporuje jednoduchou syntaxi pro vytváření tabulek.
+[[doku>DokuWiki]] podporuje jednoduchou syntaxi pro vytváření tabulek.
-^ Nadpis 1           ^ Nadpis 2                                         ^ Nadpis 3           ^
+^ Nadpis 1           ^ Nadpis 2                        ^ Nadpis 3           ^
-| Řádek 1 Sloupec 1  | Řádek 1 Sloupec 2                                | Řádek 1 Sloupec 3  |
+| řádek 1 sloupec 1  | řádek 1 sloupec 2               | řádek 1 sloupec 3  |
-| Řádek 2 Sloupec 1  | spojené sloupce (všimněte si dvou svislých čar)                      ||
+| řádek 2 sloupec 1  | spojené sloupce (všimněte si dvou svislých čar)     ||
-| Řádek 3 Sloupec 1  | Řádek 3 Sloupec 2                                | Řádek 3 Sloupec 3  |
+| řádek 3 sloupec 1  | řádek 3 sloupec 2               | řádek 3 sloupec 3  |
 Normální řádky tabulky musí začínat a končit svislou čárou ''|'', řádky v hlavičce stříškou ''^''.
-  ^ Nadpis 1      ^ Nadpis 2       ^ Nadpis 3          ^
+  ^ Nadpis 1           ^ Nadpis 2                        ^ Nadpis 3           ^
-  | Řádek 1 Sloupec 1    | Řádek 1 Sloupec 2     | Řádek 1 Sloupec 3        |
+  | řádek 1 sloupec 1  | řádek 1 sloupec 2               | řádek 1 sloupec 3  |
-  | Řádek 2 Sloupec 1    | (všimněte si dvou svislých čar) ||
+  | řádek 2 sloupec 1  | spojené sloupce (všimněte si dvou svislých čar)     ||
-  | Řádek 3 Sloupec 1    | Řádek 3 Sloupec 2     | Řádek 3 Sloupec 3        |
+  | řádek 3 sloupec 1  | řádek 3 sloupec 2               | řádek 3 sloupec 3  |
 Ponecháte-li buňky vodorovně vedle sebe úplně prázdné, spojí se jako v příkladu výše (colspan). Pozor, abyste měli vždy stejný počet oddělovačů buněk!
@@ Řádek 304: / Řádek 321: @@
 Svislé hlavičky tabulek jsou také možné.
-|              ^ Nadpis 1            ^ Nadpis 2          ^
+|              ^ Nadpis 1             ^ Nadpis 2           ^
-^ Nadpis 3    | Řádek 1 Sloupec 2          | Řádek 1 Sloupec 3        |
+^ Nadpis 3     | řádek 1 sloupec 2    | řádek 1 sloupec 3  |
-^ Nadpis 4    | buňky se nyní nespojí (jsou tu mezery) |                    |
+^ Nadpis 4     | nespojené sloupce    |                    |
-^ Nadpis 5    | Řádek 2 Sloupec 2          | Řádek 2 Sloupec 3        |
+^ Nadpis 5     | řádek 2 sloupec 2    | řádek 2 sloupec 3  |
 Jak vidíte, formátování buňky ovlivňuje oddělovač před buňkou:
-  |              ^ Nadpis 1            ^ Nadpis 2          ^
+  |              ^ Nadpis 1             ^ Nadpis 2           ^
-  ^ Nadpis 3    | Řádek 1 Sloupec 2          | Řádek 1 Sloupec 3        |
+  ^ Nadpis 3     | řádek 1 sloupec 2    | řádek 1 sloupec 3  |
-  ^ Nadpis 4    | buňky se nyní nespojí (jsou tu mezery) |                    |
+  ^ Nadpis 4     | nespojené sloupce    |                    |
-  ^ Nadpis 5    | Řádek 2 Sloupec 2          | Řádek 2 Sloupec 3        |
+  ^ Nadpis 5     | řádek 2 sloupec 2    | řádek 2 sloupec 3  |
-Poznámka: Svislé spojování buněk (rowspan) není možné.
+Můžete mít vertikálně spojené buňky (rowspan) přidáním ''%%:::%%'' do buněk umístěných pod slučovanou buňku.
-Obsah buněk můžete také zarovnat. Prostě přidejte alespoň dva bílé znaky na druhý konec textu: Přidejte dvě mezery nalevo pro zarovnání doprava, dvě mezery napravo pro zarovnání doleva nebo aspoň dvě mezery na oba konce pro zarovnání na střed.
+^ Nadpis 1           ^ Nadpis 2                  ^ Nadpis 3           ^
+| řádek 1 sloupec 1  | vertikálně spojené buňky  | řádek 1 sloupec 3  |
+| řádek 2 sloupec 1  | :::                       | řádek 2 sloupec 3  |
+| řádek 3 sloupec 1  | :::                       | řádek 2 sloupec 3  |
-^           Tabulka se zarovnáním           ^^^
+Mimo syntaxe rowspan (%%:::%%) nesmí tyto buňky nic jiného obsahovat.
-|         doprava|    na střed    |doleva          |
-|doleva          |         doprava|    na střed    |
+  ^ Nadpis 1           ^ Nadpis 2                  ^ Nadpis 3           ^
+  | řádek 1 sloupec 1  | vertikálně spojené buňky  | řádek 1 sloupec 3  |
+  | řádek 2 sloupec 1  | :::                       | řádek 2 sloupec 3  |
+  | řádek 3 sloupec 1  | :::                       | řádek 2 sloupec 3  |
+Obsah buněk můžete také zarovnat. Prostě přidejte alespoň dvě mezery na druhý konec textu: Přidejte dvě mezery nalevo pro zarovnání doprava, dvě mezery napravo pro zarovnání doleva nebo aspoň dvě mezery na oba konce pro zarovnání na střed.
+^           Tabulka se zarovnáním          ^^^
+|       doprava|   na střed   |doleva        |
+|doleva        |       doprava|   na střed   |
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
-A takhle vypadá zdroják:
+A takhle vypadá zdroj:
-  ^           Tabulka se zarovnáním           ^^^
+  ^           Tabulka se zarovnáním          ^^^
-  |         doprava|    na střed    |doleva          |
+  |       doprava|   na střed   |doleva        |
-  |doleva          |         doprava|    na střed    |
+  |doleva        |       doprava|   na střed   |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+Poznámka: Svislé zarovnání není podporováno.
+===== Předformátovaný text =====
+Pokud potřebujete zobrazit text přesně tak, jak je napsaný (bez formátování), uzavřete danou oblast do značek ''%%<nowiki>%%'', nebo dokonce jednodušeji do znaků dvojitých procent ''<nowiki>%%</nowiki>''.
-===== Neparsované bloky =====
+<nowiki>
+Toto je nějaký text obsahující URL jako: http://www.splitbrain.org a **formátování**, ale parser s ním vůbec nic neudělá.
+</nowiki>
+Totéž platí pro %%//__tento__ text// se smajlíkem ;-)%%.
+  <nowiki>
+  Toto je nějaký text obsahující URL jako: http://www.splitbrain.org a **formátování**, ale parser s ním vůbec nic neudělá.
+  </nowiki>
+  Totéž platí pro %%//__tento__ text// se smajlíkem ;-)%%.
+===== Bloky kódu =====
+Do svých stránek můžete zahrnout i bloky, které nebudou interpretovány, když je odsadíte o alespoň dvě mezery (podobně jako v předchozích příkladech), nebo použitím tagů ''%%<code>%%'' či ''%%<file>%%''.
-Do svých stránek můžete zahrnout i bloky, které nebudou interpretovány, když je odsadíte o alespoň dvě mezery (podobně jako v předchozích příkladech), nebo použitím tagů ''code'' či ''file''.
+  Tento text je odsazen o dvě mezery.
 <code>
-Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např.
+Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např.              <-takto
-              <-takto
 </code>
@@ Řádek 348: / Řádek 391: @@
 </file>
-Aby parser kompletně ignorovat nějaký text (tj. vůbec jej neformátoval), uzavřete danou oblast do tagů ''nowiki'' nebo jednoduše do dvojitých procent ''<nowiki>%%</nowiki>''.
+Tyto bloky byly vytvořeny tímto zdrojem:
-<nowiki>
+    Tento text je odsazen o dvě mezery.
-Toto je nějaký text obsahující URL jako: http://www.splitbrain.org a **formátování**, ale parser s ním vůbec nic neudělá.
-</nowiki>
-Podívejte se na zdrojový text této stránky, jak se neparsované bloky používají.
+  <code>
+  Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např.              <-takto
+  </code>
+  <file>
+  Tohle je skoro to samé, jen to lze využít spíš, když chcete ukázat, že citujete nějaký soubor.
+  </file>
-===== Zvýrazňování syntaxe =====
+==== Zvýrazňování syntaxe ====
-[[DokuWiki]] umí zvýrazňovat a obarvovat zdrojové kódy, aby se daly lépe číst. Používá přitom [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter. Díky tomu DokuWiki podporuje všechny jazyky, které umí zvýrazňovat GeSHi. Syntax je stejná jako v bloku kódu v minulé sekci, jen se tentokrát dovnitř tagu vloží název jazyka. Např. ''<nowiki><code java></nowiki>''.
+[[wiki:DokuWiki]] umí zvýrazňovat a obarvovat zdrojové kódy, aby se daly lépe číst. Používá přitom [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter. Díky tomu DokuWiki podporuje všechny jazyky, které umí zvýrazňovat GeSHi. Syntax je stejná jako v bloku kódu v minulé sekci, jen se tentokrát dovnitř tagu vloží název jazyka. Např. ''<nowiki><code java></nowiki>''.
 <code java>
 /**
  * The HelloWorldApp class implements an application that
  * simply displays "Hello World!" to the standard output.
@@ Řádek 373: / Řádek 419: @@
 </code>
-Následující názvy jazyků jsou aktuálně rozpoznávány: //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80//
+Následující názvy jazyků jsou aktuálně rozpoznávány: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//
+Pro zvýraznění syntaxe jsou k dispozici další [[doku>syntax_highlighting|pokročilé možnosti]], například zvýraznění řádků nebo přidání čísel řádků.
+==== Bloky kódu ke stažení ====
-===== Agregace RSS/ATOM kanálů =====
+Při použití syntaxe ''%%<code>%%'' nebo ''%%<file>%%'', jak je uvedeno výše, můžete chtít zpřístupnit uvedený kód ke stažení. To lze provést zadáním názvu souboru po kódu jazyka, například takto:
-[[DokuWiki]] je schopna integrovat data z externích XML kanálů. Pro jejich parsování se využívá [[http://simplepie.org/|SimplePie]]. Všechny formáty, kterým rozumí SimplePie, lze tudíž použít v DokuWiki. Jak bude výsledný výpis vypadat, můžete ovlivnit několika dalšími parametry (oddělenými mezerami):
+<code>
+<file php myexample.php>
+<?php echo "Hello world!"; ?>
+</file>
+</code>
-^ Parametr  ^ Popis ^
+<file php myexample.php>
-| //jakékoliv číslo// | maximální počet položek, které se zobrazí, standardně 8 |
+<?php echo "Hello world!"; ?>
-| reverse    | obrácené pořadí - zobrazí poslední položku v kanálu nejdřív |
+</file>
-| author     | ukáže jména autorů |
-| date       | ukáže data položek |
-| description| ukáže popisy položek. Pokud je [[doku>config#htmlok|HTML]] vynuto, všechny tagy se ořežou. |
-| //n//[dhm] | obnovovací perioda, kde d=dny, h=hodiny, m=minuty. (např. 12h = 12 hodin). |
-Obnovovací perioda je standardně nastavena na 4 hodiny. Jakákoliv hodnota menší než 10 minut bude chápána jako právě 10 minut. [[DokuWiki]] se obecně snaží poskytnout cachovanou verzi stránky, což je očividně nevhodné, obsahuje-li stránka dynamický externí obsah. Tento parametr říká [[DokuWiki]], aby znovu zpracovala danou stránku, pokud od posledního zpracování uběhlo více času, než je //obnovovací perioda//.
-**Příklad:**
-  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+Pokud nechcete jakékoliv zvýraznění, ale chcete soubor ke stažení, zadejte jako kód jazyka pomlčku (''-''): ''%%<code - myfile.foo>%%''.
 ===== Vkládání HTML a PHP =====
-Čistý HTML či PHP kód můžete do svých dokumentů začlenit pomocí tagů ''html'' resp. ''php'' takto:
+Čistý HTML či PHP kód můžete do svých dokumentů začlenit pomocí tagů ''%%<html>%%'' resp. ''%%<php>%%''. (Pokud potřebujete uzavřít kód do bloku, napište tagy velkými písmeny: ''%%<HTML>%%'' resp. ''%%<PHP>%%''.)
+Příklad HTML:
 <code>
 <html>
-Toto je nějaké <font color="red" size="+1">HTML</font>
+Toto je nějaké <span style="color:red;font-size:150%;">HTML</span>.
 </html>
+<HTML>
+<p style="border:2px dashed red;">A toto je nějaký HTML blok.</p>
+</HTML>
 </code>
 <html>
-Toto je nějaké <font color="red" size="+1">HTML</font>
+Toto je nějaké <span style="color:red;font-size:150%;">HTML</span>.
 </html>
+<HTML>
+<p style="border:2px dashed red;">A toto je nějaký HTML blok.</p>
+</HTML>
+Příklad PHP:
 <code>
 <php>
-echo 'Logo generované pomocí PHP:';
+echo 'The PHP version: ';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
+echo phpversion();
+echo ' (generated inline HTML)';
 </php>
+<PHP>
+echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
 </code>
 <php>
-echo 'Logo generované pomocí PHP:';
+echo 'The PHP version: ';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
+echo phpversion();
+echo ' (inline HTML)';
 </php>
+<PHP>
+echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
+**Poznámka:** Vkládání HTML a PHP je ve výchozím nastavení vypnuto. Pokud je právě vypnuto, HTML či PHP kód se místo vykonání zobrazí jako obyčejný text.
+===== Agregace RSS/ATOM kanálů =====
+[[doku>DokuWiki]] je schopna integrovat data z externích XML kanálů. Pro jejich parsování se využívá [[http://simplepie.org/|SimplePie]]. Všechny formáty, kterým rozumí SimplePie, lze tudíž použít v DokuWiki. Jak bude výsledný výpis vypadat, můžete ovlivnit několika dalšími parametry (oddělenými mezerami):
+^ Parametr        ^ Popis                                                                      ^
+| jakékoliv číslo | Maximální počet položek, které se zobrazí, standardně 8.                   |
+| reverse         | Obrácené pořadí - zobrazí poslední položku v informačním kanálu jako první.|
+| author          | Zobrazí jména autorů.                                                      |
+| date            | Zobrazí data položek.                                                      |
+| description     | Zobrazí popisy položek. Pokud je [[doku>config:htmlok|HTML]] vypnuto, všechny tagy se ořežou. |
+| nosort          | Neseřadí položky v informačním kanálu.                                     |
+| //n//[dhm]      | Obnovovací perioda, kde d=dny, h=hodiny, m=minuty. (např. 12h = 12 hodin). |
+Obnovovací perioda je standardně nastavena na 4 hodiny. Jakákoliv hodnota menší než 10 minut bude chápána jako právě 10 minut. [[wiki:DokuWiki]] se obecně snaží poskytnout cachovanou verzi stránky, což je očividně nevhodné, obsahuje-li stránka dynamický externí obsah. Tento parametr říká [[wiki:DokuWiki]], aby znovu zpracovala danou stránku, pokud od posledního zpracování uběhlo více času, než je //obnovovací perioda//.
+Ve výchozím nastavení bude informační kanál seřazen podle data, nejnovější položky jako první. Můžete je seřadit obráceně (nejstarší položky jako první), pomocí parametru ''reverse'' nebo zobrazit informační kanál parametrem ''nosort'' (bez řazení).
+**Příklad:**
+  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
+{{rss>http://slashdot.org/index.rss 5 author date 1h }}
+===== Ovládací makra =====
-**Poznámka**: Vkládání HTML a PHP je ve výchozím nastavení vypnuto. Pokud je právě vypnuto, HTML či PHP kód se místo vykonání zobrazí jako obyčejný text.
+Některé syntaxe ovlivňují, jak DokuWiki vykreslí stránku, ale nejsou samy o sobě schopny vytvořit jakýkoli obsah. Jsou dostupná následující ovládací makra:
+^ Makro           ^ Popis ^
+| %%~~NOTOC~~%%   | Pokud je toto makro na stránce nalezeno, nebude vytvořena žádná tabulka s obsahem. |
+| %%~~NOCACHE~~%% | DokuWiki ve výchozím nastavení ukládá veškerý výstup do mezipaměti. Když to není žádoucí (např. při použití výše uvedené %%<php>%% syntaxe), přidání tohoto makra donutí DokuWiki vykreslit stránku při každém volání. |
 ===== Syntaktické pluginy =====