dw:syntaxe-formatovani
Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
| Obě strany předchozí revizePředchozí verze | |||
| dw:syntaxe-formatovani [05. 10. 2022 - 02:13] – upraveno správcem mimo DokuWiki (Unknown date) 127.0.0.1 | dw:syntaxe-formatovani [20. 10. 2022 - 19:30] (aktuální) – odstraněno kytka | ||
|---|---|---|---|
| Řádek 1: | Řádek 1: | ||
| - | ====== Syntaxe formátování ====== | ||
| - | |||
| - | 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: | ||
| - | |||
| - | ===== Typografické rady ===== | ||
| - | |||
| - | * [[https:// | ||
| - | |||
| - | ===== 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 ===== | ||
| - | |||
| - | DokuWiki podporuje mnoho různých způsobů, jak vytvářet odkazy. | ||
| - | |||
| - | ==== Externí ==== | ||
| - | |||
| - | Externí odkazy jsou rozpoznávány automaticky: | ||
| - | |||
| - | Externí odkazy jsou rozpoznávány automaticky: | ||
| - | jednoduše www.google.com - lze nastavit i jména odkazů: | ||
| - | [[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> | ||
| - | [[wiki stránka|jiný popisek stránky]]. | ||
| - | |||
| - | [[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 [[cs: | ||
| - | |||
| - | Poznámky: | ||
| - | |||
| - | * Odkazy na [[cs: | ||
| - | * 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> | ||
| - | rychlé odkazy mezi různými wiki. Například tento odkaz směřuje na stránku | ||
| - | o wiki na Wikipedii: [[wp> | ||
| - | |||
| - | ==== 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 " | ||
| - | * 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í syntaxe, kterou lze použít uvnitř jména 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: znaménko násobení (640 × 480), " | ||
| - | |||
| - | ===== Citace ===== | ||
| - | |||
| - | 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. | ||
| - | |||
| - | > 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í, | ||
| - | |||
| - | |||
| - | ===== Vkládání HTML a PHP ===== | ||
| - | |||
| - | Čistý HTML či PHP kód můžete do svých dokumentů začlenit pomocí tagů '' | ||
| - | |||
| - | Příklad HTML: | ||
| - | |||
| - | < | ||
| - | < | ||
| - | Toto je nějaké <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | Toto je nějaké <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | |||
| - | Příklad PHP: | ||
| - | |||
| - | < | ||
| - | <php> | ||
| - | echo 'The PHP version: '; | ||
| - | echo phpversion(); | ||
| - | echo ' (generated inline HTML)'; | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <php> | ||
| - | echo 'The PHP version: '; | ||
| - | echo phpversion(); | ||
| - | echo ' (inline HTML)'; | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | |||
| - | **Poznámka: | ||
| - | |||
| - | ===== 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 ===== | ||
| - | |||
| - | Syntaxi DokuWiki lze rozšířit pomocí [[doku> | ||
| - | |||
| - | ~~INFO: | ||
| - | |||
dw/syntaxe-formatovani.1664928794.txt.gz · Poslední úprava: (upraveno mimo DokuWiki)