wiki:syntax
Rozdíly
Zde se zobrazují rozdíly mezi dvěma verzemi stránky.
| wiki:syntax [2025-09-08 08:15] – vytvořeno - upraveno správcem mimo DokuWiki 127.0.0.1 | wiki:syntax [Neznámé datum] (aktuální) – upraveno správcem (MartinR) mimo DokuWiki (Neznámé datum) 127.0.0.1 | ||
|---|---|---|---|
| Řádek 1: | Řádek 1: | ||
| + | ====== Syntaxe formátování ====== | ||
| + | |||
| + | [[doku> | ||
| + | |||
| + | ===== Základní formátování textu ===== | ||
| + | |||
| + | DokuWiki podporuje **tučné** písmo, // | ||
| + | |||
| + | DokuWiki podporuje **tučné** písmo, // | ||
| + | Všechny můžete samozřejmě **__//'' | ||
| + | |||
| + | Můžete rovněž používat < | ||
| + | |||
| + | Můžete rovněž používat < | ||
| + | |||
| + | Nějaký text lze označit jako < | ||
| + | |||
| + | Nějaký text lze označit jako < | ||
| + | |||
| + | **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í\\ 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í\\ mezery \\toto se stane bez nich. | ||
| + | |||
| + | Ruční zalomení řádku používejte uvážlivě jen tam, kde je to opravdu nutné. | ||
| + | |||
| + | ===== Odkazy ===== | ||
| + | |||
| + | [[doku> | ||
| + | |||
| + | ==== Externí ==== | ||
| + | |||
| + | Externí odkazy jsou rozpoznávány automaticky: | ||
| + | |||
| + | Externí odkazy jsou rozpoznávány automaticky: | ||
| + | jednoduše www.google.com - lze nastavit i název odkazu: | ||
| + | [[http:// | ||
| + | jako < | ||
| + | |||
| + | ==== Interní ==== | ||
| + | |||
| + | Interní odkazy se vytváří pomocí hranatých závorek. Vložíte [[doku> | ||
| + | |||
| + | Interní odkazy se vytváří pomocí hranatých závorek. Vložíte | ||
| + | [[doku> | ||
| + | i [[doku> | ||
| + | |||
| + | [[doku> | ||
| + | |||
| + | Můžete používat [[doku> | ||
| + | |||
| + | Můžete používat [[doku> | ||
| + | |||
| + | Pro další informace o jmenných prostorech se podívejte do jejich [[doku> | ||
| + | |||
| + | Odkazování na určitou sekci je rovněž možné. Jednoduše do odkazu přidáte za název stránky mřížku ''#'' | ||
| + | |||
| + | Tento odkaz vede na [[wiki: | ||
| + | |||
| + | Poznámky: | ||
| + | |||
| + | * Odkazy na [[wiki: | ||
| + | * DokuWiki ve výchozím nastavení nepoužívá [[wp> | ||
| + | * 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> | ||
| + | |||
| + | DokuWiki podporuje [[doku> | ||
| + | |||
| + | ==== 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í, | ||
| + | |||
| + | 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:// | ||
| + | <?php | ||
| + | /** | ||
| + | * Customization of the english language file | ||
| + | * Copy only the strings that needs to be modified | ||
| + | */ | ||
| + | $lang[' | ||
| + | </ | ||
| + | |||
| + | ==== 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 [[# | ||
| + | |||
| + | [[http:// | ||
| + | |||
| + | [[http:// | ||
| + | |||
| + | Poznámka: Formátování obrázku je jediná formátovací syntax, kterou lze použít uvnitř názvu odkazu. | ||
| + | |||
| + | Je podporována kompletní syntax [[# | ||
| + | |||
| + | ===== 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 ''< | ||
| + | |||
| + | ==== 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> | ||
| + | |||
| + | Původní velikost: | ||
| + | |||
| + | Zmenšeno na danou šířku: | ||
| + | |||
| + | Zmenšeno na danou šířku i výšku: | ||
| + | |||
| + | Externí obrázek se změněnými rozměry: {{http:// | ||
| + | |||
| + | Původní velikost: | ||
| + | Zmenšeno na danou šířku: | ||
| + | Zmenšeno na danou šířku i výšku: | ||
| + | Externí obrázek se změněnými rozměry: {{http:// | ||
| + | |||
| + | |||
| + | Zarovnání obrázku volíte mezerami napravo nebo nalevo. | ||
| + | |||
| + | {{ wiki: | ||
| + | |||
| + | {{wiki: | ||
| + | |||
| + | {{ wiki: | ||
| + | |||
| + | {{ wiki: | ||
| + | {{wiki: | ||
| + | {{ wiki: | ||
| + | |||
| + | Samozřejmě můžete přidat také titulek, který se ve většině prohlížečů zobrazí jako vyskakovací bublina (tooltip). | ||
| + | |||
| + | {{ wiki: | ||
| + | |||
| + | {{ wiki: | ||
| + | |||
| + | Viz výše pro [[# | ||
| + | |||
| + | ==== Podporované formáty médií ==== | ||
| + | |||
| + | DokuWiki může přímo vložit následující formáty médií. | ||
| + | |||
| + | | Obrázek | '' | ||
| + | | Video | '' | ||
| + | | Audio | '' | ||
| + | | Flash | '' | ||
| + | |||
| + | Pokud zadáte název souboru nepodporovaného formátu, zobrazí se místo toho obyčejný odkaz na soubor. | ||
| + | |||
| + | Přidáním ''? | ||
| + | |||
| + | {{wiki: | ||
| + | |||
| + | {{wiki: | ||
| + | |||
| + | ==== 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čů), | ||
| + | |||
| + | Zvažte například toto vložené mp4 video: | ||
| + | |||
| + | {{video.mp4|Vtipné video}} | ||
| + | |||
| + | Když nahrajete '' | ||
| + | |||
| + | 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 '' | ||
| + | |||
| + | ===== 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 '' | ||
| + | |||
| + | * 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! | ||
| + | |||
| + | < | ||
| + | * 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! | ||
| + | </ | ||
| + | |||
| + | Podívejte se také na [[doku> | ||
| + | |||
| + | ===== 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> | ||
| + | |||
| + | * 8-) %% 8-) %% | ||
| + | * 8-O %% 8-O %% | ||
| + | * :-( %% :-( %% | ||
| + | * :-) %% :-) %% | ||
| + | * =) %% =) %% | ||
| + | * :-/ %% :-/ %% | ||
| + | * :-\ %% :-\ %% | ||
| + | * :-? %% :-? %% | ||
| + | * :-D %% :-D %% | ||
| + | * :-P %% :-P %% | ||
| + | * :-O %% :-O %% | ||
| + | * :-X %% :-X %% | ||
| + | * :-| %% :-| %% | ||
| + | * ;-) %% ;-) %% | ||
| + | * ^_^ %% ^_^ %% | ||
| + | * :?: %% :?: %% | ||
| + | * :!: %% :!: %% | ||
| + | * LOL %% LOL %% | ||
| + | * FIXME %% FIXME %% | ||
| + | * DELETEME %% DELETEME %% | ||
| + | |||
| + | ==== Typografie ==== | ||
| + | |||
| + | [[doku> | ||
| + | |||
| + | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| + | "He thought ' | ||
| + | |||
| + | < | ||
| + | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| + | "He thought ' | ||
| + | </ | ||
| + | |||
| + | Stejným způsobem, můžeme vytvořit libovolné HTML, pokud je přidáno do [[doku> | ||
| + | |||
| + | Existují tři výjimky, které nepocházejí z tohoto souboru s entitami: | ||
| + | |||
| + | ===== Citace ===== | ||
| + | |||
| + | Občas budete potřebovat označit nějaký text jako odpověď nebo komentář. Můžete využít následující syntax: | ||
| + | |||
| + | < | ||
| + | Myslím, že bychom to měli udělat. | ||
| + | |||
| + | > Ne, neměli. | ||
| + | |||
| + | >> Ne fakt, řekl jsem, že bychom měli. | ||
| + | |||
| + | > Fakt? | ||
| + | |||
| + | >> Jistě! | ||
| + | |||
| + | >>> | ||
| + | </ | ||
| + | |||
| + | Myslím, že bychom to měli udělat. | ||
| + | |||
| + | > Ne, neměli. | ||
| + | |||
| + | >> Ne fakt, řekl jsem, že bychom měli. | ||
| + | |||
| + | > Fakt? | ||
| + | |||
| + | >> Jistě! | ||
| + | |||
| + | >>> | ||
| + | |||
| + | ===== Tabulky ===== | ||
| + | |||
| + | [[doku> | ||
| + | |||
| + | ^ 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 '' | ||
| + | |||
| + | ^ 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 '' | ||
| + | |||
| + | ^ Nadpis 1 ^ Nadpis 2 ^ Nadpis 3 ^ | ||
| + | | řádek 1 sloupec 1 | vertikálně spojené buňky | ||
| + | | řá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 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. | ||
| + | |||
| + | ^ | ||
| + | | | ||
| + | |doleva | ||
| + | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| + | |||
| + | A takhle vypadá zdroj: | ||
| + | |||
| + | ^ | ||
| + | | | ||
| + | |doleva | ||
| + | | 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í), | ||
| + | |||
| + | < | ||
| + | Toto je nějaký text obsahující URL jako: http:// | ||
| + | </ | ||
| + | Totéž platí pro %%// | ||
| + | |||
| + | < | ||
| + | Toto je nějaký text obsahující URL jako: http:// | ||
| + | </ | ||
| + | Totéž platí pro %%// | ||
| + | |||
| + | ===== Bloky kódu ===== | ||
| + | |||
| + | Do svých stránek můžete zahrnout i bloky, které nebudou interpretovány, | ||
| + | |||
| + | Tento text je odsazen o dvě mezery. | ||
| + | |||
| + | < | ||
| + | Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např. | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | Tohle je skoro to samé, jen to lze využít spíš, když chcete ukázat, že citujete nějaký soubor. | ||
| + | </ | ||
| + | |||
| + | Tyto bloky byly vytvořeny tímto zdrojem: | ||
| + | |||
| + | Tento text je odsazen o dvě mezery. | ||
| + | |||
| + | < | ||
| + | Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např. | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | Tohle je skoro to samé, jen to lze využít spíš, když chcete ukázat, že citujete nějaký soubor. | ||
| + | </ | ||
| + | |||
| + | ==== Zvýrazňování syntaxe ==== | ||
| + | |||
| + | [[wiki: | ||
| + | |||
| + | <code java> | ||
| + | /** | ||
| + | * The HelloWorldApp class implements an application that | ||
| + | * simply displays "Hello World!" | ||
| + | */ | ||
| + | class HelloWorldApp { | ||
| + | public static void main(String[] args) { | ||
| + | System.out.println(" | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | Následující názvy jazyků jsou aktuálně rozpoznávány: | ||
| + | |||
| + | Pro zvýraznění syntaxe jsou k dispozici další [[doku> | ||
| + | |||
| + | ==== Bloky kódu ke stažení ==== | ||
| + | |||
| + | Při použití syntaxe '' | ||
| + | |||
| + | < | ||
| + | <file php myexample.php> | ||
| + | <?php echo "Hello world!"; | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | <file php myexample.php> | ||
| + | <?php echo "Hello world!"; | ||
| + | </ | ||
| + | |||
| + | Pokud nechcete jakékoliv zvýraznění, | ||
| + | |||
| + | ===== Agregace RSS/ATOM kanálů ===== | ||
| + | [[doku> | ||
| + | |||
| + | ^ Parametr | ||
| + | | jakékoliv číslo | Maximální počet položek, které se zobrazí, standardně 8. | | ||
| + | | reverse | ||
| + | | author | ||
| + | | date | Zobrazí data položek. | ||
| + | | description | ||
| + | | nosort | ||
| + | | // | ||
| + | |||
| + | 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: | ||
| + | |||
| + | 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 '' | ||
| + | |||
| + | **Příklad: | ||
| + | |||
| + | {{rss> | ||
| + | |||
| + | {{rss> | ||
| + | |||
| + | |||
| + | ===== Ovládací makra ===== | ||
| + | |||
| + | Některé syntaxe ovlivňují, | ||
| + | |||
| + | ^ Makro ^ Popis ^ | ||
| + | | %%~~NOTOC~~%% | ||
| + | | %%~~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é %%< | ||
| + | |||
| + | ===== Syntaktické pluginy ===== | ||
| + | |||
| + | Syntax DokuWiki lze rozšířit pomocí [[doku> | ||
| + | |||
| + | ~~INFO: | ||
| + | |||
| + | --- // | ||