no way to compare when less than two revisions
Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
— | orsoftdoku:syntaxdoku [2012/02/16 14:14] (aktuální) – vytvořeno - upraveno mimo DokuWiki 127.0.0.1 | ||
---|---|---|---|
Řádek 1: | Řádek 1: | ||
+ | ====== Orsoft Doku - wiki syntaxe článku ====== | ||
+ | |||
+ | |||
+ | Jednotlivé články (help stránky) jsou popsány pomocí Wiki syntaxe, což jsou textové formátovací znaky, které systém DOkuWiki reprezentuje v grafické podobě. | ||
+ | |||
+ | |||
+ | Pro editaci článků jsou použity dva editory: | ||
+ | |||
+ | |||
+ | * DW Edit - původní textový editor DokuWiki. Zde lze psát článek pomocí Wiki syntaxe. | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | * FCK Edit - wysiwyg editor FCKEdit, který je trochu podobný editaci ve Wordu. | ||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | **Upozornění - pomocí FCKEditoru lze použít v článku též formátování textu, které není podporované Wiki syntaxí.** | ||
+ | |||
+ | |||
+ | Přepínání mezi oběma editory je pomocí tlačítka pod editačním oknem. | ||
+ | |||
+ | |||
+ | {{orsoftdoku: | ||
+ | |||
+ | |||
+ | |||
+ | ===== Popis Wiki syntaxe ===== | ||
+ | |||
+ | |||
+ | [[: | ||
+ | |||
+ | |||
+ | ===== Základní formátování textu ===== | ||
+ | |||
+ | |||
+ | DokuWiki podporuje **tučné** | ||
+ | |||
+ | |||
+ | < | ||
+ | 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** | ||
+ | |||
+ | |||
+ | Toto je nějaký text se zalomením řádků\\ | ||
+ | |||
+ | |||
+ | < | ||
+ | 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 ===== | ||
+ | |||
+ | |||
+ | [[: | ||
+ | |||
+ | |||
+ | ==== 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 [[andi@splitbrain.org|andi@splitbrain.org]] rovněž fungují. | ||
+ | </ | ||
+ | |||
+ | |||
+ | ==== Interní ==== | ||
+ | |||
+ | |||
+ | Interní odkazy se vytváří pomocí hranatých závorek. Vložíte [[http:// | ||
+ | |||
+ | |||
+ | < | ||
+ | Interní odkazy se vytváří pomocí hranatých závorek. Vložíte | ||
+ | [[doku> | ||
+ | [[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 [[http:// | ||
+ | |||
+ | |||
+ | < | ||
+ | Můžete používat [[doku> | ||
+ | </ | ||
+ | |||
+ | |||
+ | Pro další informace o jmenných prostorech se podívejte do jejich [[http:// | ||
+ | |||
+ | |||
+ | 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 [[syntax# | ||
+ | </ | ||
+ | |||
+ | |||
+ | Poznámky: | ||
+ | |||
+ | |||
+ | * Odkazy na [[: | ||
+ | * DokuWiki ve výchozím nastavení nepoužívá [[http:// | ||
+ | * 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 [[http:// | ||
+ | |||
+ | |||
+ | < | ||
+ | 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 zapnout pomocí volby [[http:// | ||
+ | * Viz [[http:// | ||
+ | |||
+ | |||
+ | ==== 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ř 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í [[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:// | ||
+ | |||
+ | |||
+ | < | ||
+ | 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: | ||
+ | </ | ||
+ | |||
+ | |||
+ | Samozřejmě můžete přidat také titulek, který se ve většině prohlížečů zobrazí jako vyskakovací bublina (tooltip). | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | < | ||
+ | {{ wiki: | ||
+ | </ | ||
+ | |||
+ | |||
+ | Pokud zadáte název souboru (interního či externího), | ||
+ | |||
+ | |||
+ | Viz výše pro [[# | ||
+ | |||
+ | |||
+ | ===== 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! | ||
+ | </ | ||
+ | |||
+ | |||
+ | |||
+ | ===== 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 ===== | ||
+ | |||
+ | [[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 ' | ||
+ | |||
+ | < | ||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "He thought ' | ||
+ | </ | ||
+ | |||
+ | Poznámka: Tento převod lze vypnout v [[doku> | ||
+ | |||
+ | |||
+ | ===== 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 ===== | ||
+ | |||
+ | [[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 2 Sloupec 2 | Řádek 2 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 | (všimněte si dvou svislých čar) || | ||
+ | | Řádek 3 Sloupec 1 | Řádek 2 Sloupec 2 | Řádek 2 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 | | ||
+ | |||
+ | Poznámka: Svislé spojování buněk (rowspan) není možné. | ||
+ | |||
+ | 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. | ||
+ | |||
+ | ^ | ||
+ | | | ||
+ | |doleva | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | A takhle vypadá zdroják: | ||
+ | |||
+ | ^ | ||
+ | | | ||
+ | |doleva | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Neparsované bloky ===== | ||
+ | |||
+ | Do svých stránek můžete zahrnout i bloky, které nebudou interpretovány, | ||
+ | |||
+ | < | ||
+ | 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ě ignoroval nějaký text (tj. vůbec jej neformátoval), | ||
+ | |||
+ | < | ||
+ | Toto je nějaký text obsahující URL jako: http:// | ||
+ | </ | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | <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: | ||
+ | |||
+ | |||
+ | |||
+ | ===== Agregace RSS/ATOM kanálů ===== | ||
+ | |||
+ | [[DokuWiki]] je schopna integrovat data z externích XML kanálů. Pro jejich parsování se využívá [[http:// | ||
+ | |||
+ | ^ Parametr | ||
+ | | // | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | ukáže data položek | | ||
+ | | description| ukáže popisy položek. Pokud je [[doku> | ||
+ | | //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]], | ||
+ | |||
+ | **Příklad: | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | |||
+ | |||
+ | ===== Vkládání HTML a PHP ===== | ||
+ | |||
+ | Čistý HTML či PHP kód můžete do svých dokumentů začlenit pomocí tagů '' | ||
+ | |||
+ | < | ||
+ | < | ||
+ | Toto je nějaké <font color=" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | Toto je nějaké <font color=" | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | <php> | ||
+ | echo 'Logo generované pomocí PHP:'; | ||
+ | echo '< | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <php> | ||
+ | echo 'Logo generované pomocí PHP:'; | ||
+ | echo '< | ||
+ | </ | ||
+ | |||
+ | **Poznámka**: | ||
+ | |||
+ | |||
+ | ===== Syntaktické pluginy ===== | ||
+ | |||
+ | Syntaxi DokuWiki lze rozšířit pomocí [[doku> | ||
+ | |||
+ | ~~INFO: | ||