Uživatelské nástroje

Nástroje pro tento web


cs:wiki:syntax

Rozdíly

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

Odkaz na výstup diff

cs:wiki:syntax [2018/09/23 17:30] (aktuální)
bahnfrank65 vytvořeno
Řá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]].
 +
 +===== Základní formátování textu =====
 +
 +DokuWiki podporuje **tučné** písmo, //​kurzivu//,​ __podtržené__ a ''​neproporcionální''​ texty. Všechny můžete samozřejmě **__//''​kombinovat''//​__**.
 +
 +  DokuWiki podporuje **tučné** písmo, //​kurzivu//,​ __podtržené__ a ''​neproporcionální''​ texty.
 +  Všechny můžete samozřejmě **__//''​kombinovat''//​__**.
 +
 +Můžete rovněž používat <​sub>​dolní index</​sub>​ i <​sup>​horní index</​sup>​.
 +
 +  Můžete rovněž používat <​sub>​dolní index</​sub>​ i <​sup>​horní index</​sup>​.
 +
 +Nějaký text lze označit jako <​del>​smazaný</​del>​.
 +
 +  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.
 +
 +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.
 +
 +  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.
 +
 +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.
 +
 +==== 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]]. Mailové adresy
 +  jako <​andi@splitbrain.org>​ rovněž fungují.
 +
 +==== Interní ====
 +
 +Interní odkazy se vytváří pomocí hranatých závorek. Vložíte [[doku>​pagename|název stránky]] ([[wiki stránka]]) a případně i [[wiki stránka|jiný popisek stránky]]. Názvy wiki stránek jsou převedeny automaticky na malá písmena. Speciální znaky nejsou povoleny.
 +
 +  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 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.
 +
 +  Můžete používat [[doku>​namespaces|jmenné prostory]] pomocí dvojtečky v názvu stránky.
 +
 +Pro další informace o jmenných prostorech se podívejte do jejich [[doku>​namespaces|dokumentace]].
 +
 +Odkazování na určitou sekci je rovněž možné. Jednoduše do odkazu přidáte za název stránky mřížku ''#''​ a název sekce (podobně jako v HTML). Tento odkaz vede na [[cs:​wiki:​syntax#​interni|sekci o interních odkazech]].
 +
 +  Tento odkaz vede na [[cs:​wiki:​syntax#​interni|sekci o interních odkazech]].
 +
 +Poznámky:
 +
 +  * 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 ====
 +
 +DokuWiki podporuje [[doku>​interwiki|Interwiki]] odkazy. Jedná se o rychlé odkazy mezi různými wiki. Například tento odkaz směřuje na stránku o wiki na Wikipedii: [[wp>​Wiki]].
 +
 +  DokuWiki podporuje [[doku>​interwiki|Interwiki]] odkazy. Jedná se o
 +  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 ====
 +
 +Odkaz na sdílenou složku jako [[\\server\disk|tento]] je rozpoznáván. Uvědomte si, že to je smysluplné pouze v homogenním prostředí,​ jako je [[wp>​Intranet|intranet]].
 +
 +  Odkaz na sdílenou složku jako [[\\server\disk|tento]] je rozpoznáván.
 +
 +Poznámky:
 +
 +  * 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 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>​
 +<?php
 +/**
 + * Customization of the english language file
 + * Copy only the strings that needs to be modified
 + */
 +$lang['​js'​]['​nosmblinks'​] = '';​
 +</​code>​
 +
 +==== Obrázkové odkazy ====
 +
 +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://​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.
 +
 +Je podporována kompletní syntax [[#​obrazky_a_jine_soubory|obrázků]] a [[#​odkazy|odkazů]] včetně změny rozměrů, interních a externích obrázků a URL a interwiki odkazů.
 +
 +===== Poznámky pod čarou =====
 +
 +Poznámky pod čarou ((Toto je poznámka pod čarou)) vložte do dvojitých závorek.
 +
 +  Poznámky pod čarou ((Toto je poznámka pod čarou)) vložte do dvojitých závorek.
 +
 +===== Sekce a nadpisy =====
 +
 +Abyste mohli rozumně strukturovat obsah, můžete použít až pět různých úrovní nadpisů. Pokud máte ve stránce více než tři úrovně nadpisů, automaticky se vygeneruje tabulka s obsahem. Toto chování lze vypnout tak, že někam do dokumentu vložíte text ''<​nowiki>​~~NOTOC~~</​nowiki>''​.
 +
 +==== Nadpis 3. úrovně ====
 +=== Nadpis 4. úrovně ===
 +== Nadpis 5. úrovně ==
 +
 +  ==== Nadpis 3. úrovně ====
 +  === Nadpis 4. úrovně ===
 +  == Nadpis 5. úrovně ==
 +
 +Pomocí čtyř nebo více pomlček vytvoříte vodorovnou čáru:
 +
 +----
 +
 +===== Obrázky a jiné soubory =====
 +
 +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}}
 +
 +Zmenšeno na danou šířku: ​          ​{{wiki:​dokuwiki-128.png?​50}}
 +
 +Zmenšeno na danou šířku i výšku: ​  ​{{wiki:​dokuwiki-128.png?​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}}
 +  Zmenšeno na danou šířku: ​          ​{{wiki:​dokuwiki-128.png?​50}}
 +  Zmenšeno na danou šířku i výšku: ​  ​{{wiki:​dokuwiki-128.png?​200x50}}
 +  Externí obrázek se změněnými rozměry: {{http://​php.net/​images/​php.gif?​200x50}}
 +
 +
 +Zarovnání obrázku volíte mezerami napravo nebo nalevo.
 +
 +{{ wiki:​dokuwiki-128.png}}
 +
 +{{wiki:​dokuwiki-128.png }}
 +
 +{{ wiki:​dokuwiki-128.png }}
 +
 +  {{ wiki:​dokuwiki-128.png}}
 +  {{wiki:​dokuwiki-128.png }}
 +  {{ wiki:​dokuwiki-128.png }}
 +
 +Samozřejmě můžete přidat také titulek, který se ve většině prohlížečů zobrazí jako vyskakovací bublina (tooltip).
 +
 +{{ wiki:​dokuwiki-128.png |Toto je titulek}}
 +
 +  {{ wiki:​dokuwiki-128.png |Toto je titulek}}
 +
 +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 =====
 +
 +DokuWiki podporuje číslované i nečíslované seznamy. Položku seznamu vytvoříte odsazením textu o dvě mezery a použitím hvězdičky ''​*''​ pro nečíslované seznamy, resp. pomlčky ''​-''​ pro seznamy číslované.
 +
 +  * Toto je seznam
 +  * Druhá položka
 +    * Můžete používat více úrovní
 +  * Další položka
 +
 +  - Další seznam, ale číslovaný
 +  - Jiná položka
 +    - Jednoduše odsazujte dále pro další úrovně
 +  - A je to!
 +
 +<​code>​
 +  * Toto je seznam
 +  * Druhá položka
 +    * Můžete používat více úrovní
 +  * Další položka
 +
 +  - Další seznam, ale číslovaný
 +  - Jiná položka
 +    - Jednoduše odsazujte dále pro další úrovně
 +  - A je to!
 +</​code>​
 +
 +Podívejte se také na [[doku>​faq:​lists|FAQ on list items]].
 +
 +===== Převod textu =====
 +
 +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á.
 +
 +  * 8-) %%  8-)  %%
 +  * 8-O %%  8-O  %%
 +  * :-( %%  :-(  %%
 +  * :-) %%  :-)  %%
 +  * =)  %%  =)   %%
 +  * :-/ %%  :-/  %%
 +  * :-\ %%  :-\  %%
 +  * :-? %%  :-?  %%
 +  * :-D %%  :-D  %%
 +  * :-P %%  :-P  %%
 +  * :-O %%  :-O  %%
 +  * :-X %%  :-X  %%
 +  * :-| %%  :-|  %%
 +  * ;-) %%  ;-)  %%
 +  * ^_^ %%  ^_^  %%
 +  * :?: %%  :?:  %%
 +  * :!: %%  :!:  %%
 +  * LOL %%  LOL  %%
 +  * FIXME %%  FIXME %%
 +  * DELETEME %% DELETEME %%
 +
 +==== 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)
 +"He thought '​It'​s a man's world'​..."​
 +
 +<​code>​
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought '​It'​s a man's world'​..."​
 +</​code>​
 +
 +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 =====
 +
 +Občas budete potřebovat označit nějaký text jako odpověď nebo komentář. Můžete využít následující syntaxe:
 +
 +<​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!
 +</​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.
 +
 +^ Nadpis 1           ^ Nadpis 2                        ^ Nadpis 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 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           ^
 +  | řá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 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!
 +
 +Svislé hlavičky tabulek jsou také možné.
 +
 +|              ^ Nadpis 1             ^ Nadpis 2           ^
 +^ Nadpis 3     | řádek 1 sloupec 2    | řádek 1 sloupec 3  |
 +^ Nadpis 4     | nespojené sloupce ​   |                    |
 +^ 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 3     | řádek 1 sloupec 2    | řádek 1 sloupec 3  |
 +  ^ Nadpis 4     | nespojené sloupce ​   |                    |
 +  ^ Nadpis 5     | řádek 2 sloupec 2    | řádek 2 sloupec 3  |
 +
 +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.
 +
 +^ 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  |
 +
 +Mimo syntaxe rowspan (%%:::%%) nesmí tyto buňky nic jiného obsahovat.
 +
 +  ^ 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ň 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.
 +
 +^           ​Tabulka se zarovnáním ​         ^^^
 +|       ​doprava| ​  na střed ​  ​|doleva ​       |
 +|doleva ​       |       ​doprava| ​  na střed ​  |
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +A takhle vypadá zdroj:
 +
 +  ^           ​Tabulka se zarovnáním ​         ^^^
 +  |       ​doprava| ​  na střed ​  ​|doleva ​       |
 +  |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>''​.
 +
 +<​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>​%%''​.
 +
 +  Tento text je odsazen o dvě mezery.
 +
 +<​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>​
 +
 +Tyto bloky byly vytvořeny tímto zdrojem:
 +
 +    Tento text je odsazen o dvě mezery.
 +
 +  <​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 ====
 +
 +[[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.
 + */
 +class HelloWorldApp {
 +    public static void main(String[] args) {
 +        System.out.println("​Hello World!"​);​ //Display the string.
 +    }
 +}
 +</​code>​
 +
 +Následující názvy jazyků jsou aktuálně rozpoznávány:​ //4cs, 6502acme, 6502kickass,​ 6502tasm, 68000devpac,​ abap, actionscript-french,​ actionscript,​ actionscript3,​ ada, algol68, apache, applescript,​ asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner,​ c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript,​ cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas,​ lotusscript,​ lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief,​ ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender,​ pli, plsql, postgresql, povray, powerbuilder,​ powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog,​ tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro,​ visualprolog,​ whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//
 +
 +==== Bloky kódu ke stažení ====
 +
 +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:
 +
 +<​code>​
 +<file php myexample.php>​
 +<?php echo "Hello world!";​ ?>
 +</​file>​
 +</​code>​
 +
 +<file php myexample.php>​
 +<?php echo "Hello world!";​ ?>
 +</​file>​
 +
 +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>​%%''​. (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é <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é <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 'The PHP version: ';
 +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 'The PHP version: ';
 +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ů =====
 +[[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. [[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//.
 +
 +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:​**
 +
 +FIXME
 +
 +
 +===== Ovládací makra =====
 +
 +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 =====
 +
 +Syntaxi DokuWiki lze rozšířit pomocí [[doku>​plugins|pluginů]]. Jak se nainstalované pluginy používají,​ je popsáno na příslušné stránce o každém pluginu. Následující syntaktické pluginy jsou k dispozici v této konkrétní instalaci DokuWiki:
 +
 +~~INFO:​syntaxplugins~~
  
cs/wiki/syntax.txt · Poslední úprava: 2018/09/23 17:30 autor: bahnfrank65