====== Wiki Syntax (zkráceno, upraveno) ====== Originální verze je dostupná na [[https://www.dokuwiki.org/cs: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 dolní index i horní index. Můžete rovněž používat dolní index i horní index. Nějaký text lze označit jako smazaný. Nějaký text lze označit jako smazaný. **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 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 rovněž fungují. ==== Interní ==== Interní odkazy se vytváří pomocí hranatých závorek. Vložíte [[nazev_stranky]] a případně i [[nazev_stranky|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 [[nazev_stranky]] a případně [[nazev_stranky|jiný popisek stránky]]. Názvy wiki stránek jsou převedeny automaticky na malá písmena. Speciální znaky nejsou povoleny. Poznámky: * Odkazy na [[start|existující stránky]] jsou ostylovány jinak než odkazy na [[neexistující]]. * 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š. ===== 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 ''~~NOTOC~~''. ==== 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://www.urel.feec.vutbr.cz/web_images/urel_logo.png?100}} 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://www.urel.feec.vutbr.cz/web_images/urel_logo.png?100}} 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}} 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. ===== 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! * 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! ===== 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 | buňky se nyní nespojí (jsou tu mezery) | | ^ 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 | buňky se nyní nespojí (jsou tu mezery) | | ^ Nadpis 5 | Řádek 2 Sloupec 2 | Řá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 | | xxxxxxxxxxxxxx | xxxxxxxxxxxxxx | xxxxxxxxxxxxxx | A takhle vypadá zdroják: ^ Tabulka se zarovnáním ^^^ | doprava| na střed |doleva | |doleva | doprava| na střed | | xxxxxxxxxxxxxx | xxxxxxxxxxxxxx | xxxxxxxxxxxxxx | ===== Neparsované bloky ===== 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''. Toto je již naformátovaný text, kde jsou všechny mezery zachovány: např. <-takto Tohle je skoro to samé, jen to lze využít spíš, když chcete ukázat, že citujete nějaký soubor. 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 ''%%''. 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á. Podívejte se na zdrojový text této stránky, jak se neparsované bloky používají. ===== 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ř. '''' nebo '''' . /* Funkce pro testovani, zda uplynula specifikovana doba */ bool HasDelayElapsed(uint16_t Delay, uint16_t *DelayCnt) { if (TickCnt >= *DelayCnt) { if ((TickCnt - *DelayCnt) >= Delay) return true; } else { if (((0xFFFF - *DelayCnt) + TickCnt) >= Delay) return true; } return false; }