Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku. ====== Formátovací značky a Syntaxe ====== Tato stránka je překladem původního anglického popisu [[wiki:syntax|syntaxe]] DokuWiki. Pro vlastní pochopení základních funkcí by měla plně postačovat, pokud se ale budete chtít dozvědět víc o daných podtématech, použijte některý z odkazů na anglické stránky, které tato témata popisují hloubějí. Kvůli rozsahu celé dokumentace zatím nejsou (a asi dlouho nebudou) všechny stránky o všech tématech přeloženy. Pevně doufáme, že vám to ale nebude vadit a přejeme mnoho štěstí a chuti do objevování světa Wiki. [[wiki:DokuWiki]] podporuje jednoduchý značkovací jazyk, který se snaží o maximální čitelnost zdrojových souborů. Tato stránka obsahuje všechnu dostupnou syntaxi pro tvorbu stránek. Zdrojový kód této stránky zobrazíte stisknutím tlačítka //Upravit stránku// v záhlaví nebo zápatí této stránky. Pokud si chcete něco vyzkoušet, použijte stránku [[playground:playground|pískoviště]]. Jednodušši formátovací značky jsou dostupné přes [[wiki:quickbuttons|pomocná tlačítka]]. ===== Základní formátování textu ===== DokuWiki podporuje **tučné**, //kurzíva//, __podtržené__ a ''bezproporční'' písmo. Také všechny případné **__//''kombinace''//__**. DokuWiki podporuje **tučné**, //kurzíva//, __podtržené__ a ''bezproporční'' písmo. Také všechny případné **__//''kombinace''//__**. Můžete použávat také <sub>dolní</sub> a <sup>horní</sup> indexy. Můžete použávat také <sub>dolní</sub> a <sup>horní</sup> indexy. Také lze text označit jako <del>smazaný</del>. Také lze text označit jako <del>smazaný</del>. **Odstavce** jsou tvořeny konci řádků. Pokud chcete **vynutit zalomení řádku** bez vzniku odstavce, použijte dvojté zpětné lomítko následované mezerou nebo koncem řádku. Toto je nějaký text s nějakými zalomeními řádků\\ Všimněte si že dvojté zpětné lomítka jsou rozpoznány pouze na konci řádku\\ nebo následuje-li\\ mezera \\toto se stane bez ní. Toto je nějaký text s nějakými zalomeními řádků\\ Všimněte si že dvojté zpětné lomítka jsou rozpoznány pouze na konci řádku\\ nebo následuje-li\\ mezera \\toto se stane bez ní. Vynucené zalomení řádku by se však mělo používat jen pokud je nezbytné. ===== Odkazy ===== DokuWiki podporuje řadu způsobů, jak vytvořit odkazy. ==== Externí ==== Externí odkazy jsou rozpoznávány automaticky: http://www.google.com nebo jednodušše www.google.com - Můžete také odkazy pojmenovat: [[http://www.google.com|Tento odkaz vede na google]]. Emailové adresy jako tato: <andi@splitbrain.org> jsou rozpoznávány také. DokuWiki podporuje řadu způsobů jak vytvořit odkazy. Externí odkazy jsou rozpoznávány automaticky: http://www.google.com nebo jednodušše www.google.com - Můžete také odkazy pojmenovat: [[http://www.google.com|Tento odkaz vede na google]]. Emailové adresy jako tato: <andi@splitbrain.org> jsou rozpoznávány také. ==== Interní ==== Interní odkazy jsou tvořeny pomocí hranatých závorek. Můžete uvést jen jméno stránky např. [[wiki:navod]] nebo použít dodatečné [[wiki:navod|pojmenování stránky]]. Názvy stránek Wiki jsou převedeny na malá písmena automaticky, všechna diakritika a speciální znaky jsou převedeny na jejich bezdiakritické verze. Interní odkazy jsou tvořeny pomocí hranatých závorek. Můžete uvést jen jméno stránky např. [[wiki:navod]] nebo použít dodatečné [[wiki:navod|pojmenování stránky]]. Názvy stránek Wiki jsou převedeny na malá písmena automaticky, všechna diakritika a speciální znaky jsou převedeny na jejich bezdiakritickou verzi automaticky. Můžete upřesnit [[doku>wiki:namespaces|jmenné prostory]] použitím dvojteček v názvu stránky. Můžete upřesnit [[doku>wiki:namespaces|jmenné prostory]] použitím dvojteček v názvu stránky. Pro více informací o jmenných prostorech se podívejte na [[doku>wiki:namespaces]]. Odkaz na specifickou část stránky (subsekci) je také možný. Stačí přidat jméno části stránky za znak ''#'' jak to znáte z HTML. Toto je odkaz na [[navod#interni|tuto část stránky]]. Toto je odkaz na [[navod#interni|tuto část stránky]]. Poznámky: * Odkazy na [[wiki:navod|existující stránky]] se ukazují jinak než na [[wiki:neexistujici|neexistující]]. * DokuWiki implicitně nepoužívá [[wp>CamelCase]] k tvorbě automatických odkazů, toto chování se však dá zapnout v souboru [[doku>wiki:config]] Tip: Pokud vidíte toto slovo DokuWiki jako odkaz, potom je CamelCase zapnutý. * Když se změní název části stránky (subsekce), změní se i jeho záložka. Takže nespoléhejte příliš na odkazy do subsekcí stránek. ==== Interwiki ==== DokuWiki podporuje [[doku>wiki:interwiki|Interwiki]] odkazy. To jsou rychlé odkazy na další Wiki stránky. Kupříkladu toto je odkaz na stránku Wikipedie o stránkách Wiki [[wp>Wiki]]. DokuWiki podporuje [[doku>wiki:interwiki|Interwiki]] odkazy. To jsou rychlé odkazy na další Wiki stránky. Kupříkladu toto je odkaz na stránku Wikipedie o stránkách Wiki [[wp>Wiki]]. ==== Sdíleni souborů ala Windows ==== Sdílení souborů ale Windows jako [[\\server\share|toto]] je rozpoznáváno také. Uvědomte si prosím, že toto má smysl pouze v homogenní uživatelské skupině jako je například firemní [[wp>Intranet]]. Sdílení souborů ale Windows jako [[\\server\share|toto]] je rozpoznáváno také. Poznámky: * Kvůli bezpečnostním důvodům funguje brouzdání skrze sdílené adresáře implicitně pouze v Microsoft Internet Exploreru (a pouze v "zóně local"). * Pro Mozillu a Firefox může být tato služba spřístupněna přes konfigurační možnost [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], není to však doporučeno. * Více informací na [[bug>151]]. ==== Obrázkové odkazy ==== Také můžete použít obrázek jako odkaz na jinou interní nebo externí stránku tím, že zkombinujete syntaxi pro odkazy a [[#obrazky_a_jine_soubory|obrázky]] (viz. níže) takto: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Poznámka: Formátování obrázků je jediné dovolené formátování v názvech odkazů. Celá syntax [[#obrazky_a_jine_soubory|obrázků]] a [[#odkazy|odkazů]] je podporována (včetně změny velikosti, interní a externí obrázky, URL i interwiki odkazy) ===== Poznámky pod čarou ===== Můžete do textu přidávat poznámky a vysvětlivky pod čarou ((Toto je poznámka pod čarou nebo vysvětlivka)) uzavřením textu v dvojtých kulatých závorkách. Můžete do textu přidávat poznámky a vysvětlivky pod čarou ((Toto je poznámka pod čarou nebo vysvětlivka)). ===== Dělení na sekce ===== Můžete použít až pět úrovní nadpisů pro obsah vašich stránek. Pokud máte více jak tři Nadpisy, vytvoří se automaticky obsah stránky. Tomuto můžete zabránit, pokud do stránky uvedete příkaz ''<nowiki>~~NOTOC~~</nowiki>'' (NO Table Of Contents). ==== Nadpis Úroveň 3 ==== === Nadpis Úroveň 4 === == Nadpis Úroveň 5 == ---- Čtyři a více pomlček za sebou vytvoří vodorovnou dělící čáru. ==== Nadpis Úroveň 3 ==== === Nadpis Úroveň 4 === == Nadpis Úroveň 5 == <code> ---- </code> Čtyři a více pomlček za sebou vytvoří vodorovnou dělící čáru. ===== Obrázky a jiné soubory ===== Můžete vkládat externí a interní [[doku>wiki:images|obrázky]] pomocí složených závorek. Můžete nepovinně také uvést jejich velikost. Skutečná velikost: {{wiki:dokuwiki-128.png}} Zmenšení na daný rozměr: {{wiki:dokuwiki-128.png?50}} Změna velikosti na danou šířku a výšku: {{wiki:dokuwiki-128.png?200x50}} Zvětšený externí obrázek: {{http://de3.php.net/images/php.gif?200x50}} Skutečná velikost: {{wiki:dokuwiki-128.png}} Zmenšení na daný rozměr: {{wiki:dokuwiki-128.png?50}} Změna velikosti na danou šířku a výšku: {{wiki:dokuwiki-128.png?200x50}} Zvětšený externí obrázek: {{http://de3.php.net/images/php.gif?200x50}} Použitím mezery vlevo nebo vpravo můžete zvolit zarovnání. {{ 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ě také můžete přidat nadpis (většina prohlížečů jej zobrazuje jako popisek pod kurzorem). {{ wiki:dokuwiki-128.png |Toto je nadpis}} {{ wiki:dokuwiki-128.png |Toto je nadpis}} Pokud uvedete soubor (externí nebo interní), který není obrázek (''gif, jpeg, png''), bude zobrazen jako odkaz. Pro obrázkové odkazy na jiné stránky viz výše [[#Obrázkové odkazy]] ===== Seznamy ===== Dokuwiki podporuje číslované i nečíslované seznamy. Položka seznamu se vytvoří odsazením textu o dvě mezery a hvězdičkou ''*'' pro nečíslovaný seznam nebo pomlčkou ''-'' pro seznam číslovany. * Toto je seznam * Druhá položka * Můžete mít další úrovně * Druhá položka druhé úrovně * I třetí úroveň je možná * Můžete zkusit kam to až jde * Návrat zpět * Další položka - Stejný seznam, tentokrát číslovaný - Další položka - O jednu úroveň odsazení víc - Održáka 2 - Třetí úroveň číslování - Docela jednoduché ne? - Tak se na to musí! <code> * Toto je seznam * Druhá položka * Můžete mít další úrovně * Druhá položka druhé úrovně * I třetí úroveň je možná * Můžete zkusit kam to až jde * Návrat zpět * Další položka - Stejný seznam, tentokrát číslovaný - Další položka - O jednu úroveň odsazení víc - Održáka 2 - Třetí úroveň číslování - Docela jednoduché ne? - Tak se na to musí! </code> ===== Smajlíky ===== DokuWiki překládá často používané [[wp>emoticon|emoticony]] na jejich grafické ekvivalenty. Více smajlíků můžete umístit do adresáře ''smajlíků'' a nakonfigurovat je v souboru ''conf/smileys.conf''. Tady je přehled základních Smajlíků používaných na DokuWiki. * 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ádět jednoduché textové znaky do jejich typograficky korektní podoby. Zde je ukázka 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> Poznámka: Tyto konverze mohou být vypnuty přes [[doku>wiki:config#typography|configurační možnosti]] a [[doku>wiki:entities|soubor vzorů]]. ===== Citace ===== Někdy chcete označit nějaký text, aby bylo poznat, že se jedná o odpověď nebo komentář. Toto se provádí touto syntaxí: Myslím si, že bychom to měli udělat. > Ne to bychom rozhodně neměli. >> No, já říkám že měli. > Opravdu? >> Ano! >>> Tak do toho pojďme! Myslím si, že bychom to měli udělat. > Ne to bychom rozhodně neměli. >> No, já říkám že měli. > Opravdu? >> Ano! >>> Tak do toho pojďme! ===== Tabulky ===== DokuWiki podporuje jednoduchou syntax pro tvorbu tabulek. ^ Záhlaví 1 ^ Záhlaví 2 ^ Záhlaví 3 ^ | Řada 1 Sloupec 1 | Řada 1 Sloupec 2 | Řada 1 Sloupec 3 | | Řada 2 Sloupec 1 | spojování buněk (povšimňete si dvojtého svislítka) || | Řada 3 Sloupec 1 | Řada 2 Sloupec 2 | Řada 2 Sloupec 3 | Řádky každé tabulky musí začínat svislítkem ''|'' pokud mají být obyčejné nebo stříškou ''^'' pokud se jedná o záhlaví. ^ Záhlaví 1 ^ Záhlaví 2 ^ Záhlaví 3 ^ | Řada 1 Sloupec 1 | Řada 1 Sloupec 2 | Řada 1 Sloupec 3 | | Řada 2 Sloupec 1 | spojování buněk (povšimňete si dvojtého svislítka) || | Řada 3 Sloupec 1 | Řada 2 Sloupec 2 | Řada 2 Sloupec 3 | Pokud chcete vodorovně spojovat buňky, jednodušše nechejte vedlejší buňku úplně prázdnou (jako nahoře). Dávejte pozor, abyste vždy měli stejný počet oddělovačů buňek na řádek! Svislé záhlaví je také možné. | ^ Záhlaví 1 ^ Záhlaví 2 ^ ^ Záhlaví 3 | Řada 1 Sloupec 2 | Řada 1 Sloupec 3 | ^ Záhlaví 4 | tentokrát žádné spojování | | ^ Záhlaví 5 | Řada 2 Sloupec 2 | Řada 2 Sloupec 3 | Jak můžete vidět, je to oddělovač před buňkou, který rozhoduje o jejím formátování: | ^ Záhlaví 1 ^ Záhlaví 2 ^ ^ Záhlaví 3 | Řada 1 Sloupec 2 | Řada 1 Sloupec 3 | ^ Záhlaví 4 | tentokrát žádné spojování | | ^ Záhlaví 5 | Řada 2 Sloupec 2 | Řada 2 Sloupec 3 | Poznámka: Svislé spojování buněk není možné. Také je možné zarovnat obsah tabulky. Stačí přidat alespoň dvě mezery na opačný konec textu: Přidejte dvě mezery doleva pro zarovnání vpravo, dvě mezery doprava pro zarovnání vlevo a 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 | Takto vypadá zdroj ukázky: ^ Tabulka se zarovnáním ^^^ | doprava| na střed |doleva | |doleva | doprava| na střed | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | ===== Neformátovaný text ===== Můžete přidat bloky neformátovaného textu do svého dokumentu buď odsazením těchto bloků o dvě mezery (jak tomu bylo v předchozích ukázkách) nebo použitím značek ''code'' nebo ''file''. <code> Toto je neformátovaný text, všechny mezery jsou zachované: třeba jako <-tato </code> <file> Toto je celkem to stejné, můžete to použít abyste vyznačili citaci nějakého souboru. </file> Pokud chcete aby parser ((syntaktický analyzátor provádějící formátování textu)) úplně ignoroval nějakou oblast (tzn. neprováděl žádné formátování této oblasti), uzavřete tuto oblast do ''nowiki'' značek nebo ještě jednoduššeji s dvojtým znakem procenta ''<nowiki>%%</nowiki>''. <nowiki> Toto je text obsahující adresy jako je tato http://www.splitbrain.org a **formátování** jako je toto, ale nic se s ním nedělá. </nowiki> Víc o použití těchto bloků se můžete dozvědět, pokud se podíváte na zdrojový kód této stránky. ===== Zvýrazňování syntaxe ===== [[DokuWiki]] umí zvýrazňovat zdrojové kódy, což zjednodušuje čitelnost. Používá [[http://qbnz.com/highlighter/|GeSHi]] Obecný Syntaktický Zvýrazňovač -- takže jakýkoliv jazyk podporovaný GeSHi je také podporovaný. Syntaxe je stejná jako v neformátovaném textovém bloku používajícím značku ''code'' z předchozí sekce. Tentokrát je ale vloženo jméno jazyka dovnitř značky, 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> Tato jazyková označení jsou v tuto chvíli rozpoznávána: //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml// ===== Vložené HTML a PHP ===== Můžete přímo vkládat HTML a PHP kód do svých dokumentů použitím ''html'' nebo ''php'' značek takto: <code> <html> Toto je kus <font color="red" size="+1">HTML</font> </html> </code> <html> Toto je kus <font color="red" size="+1">HTML</font> </html> <code> <php> echo 'Logo generované PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo!" />'; </php> </code> <php> echo 'Logo generované PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo!" />'; </php> **Poznámka**: Vkládání HTML a PHP kódu je implicitně vypnuto v konfiguraci. Pokud je vypnuto, je zdrojový kód zobrazen místo toho, aby se provedl. ===== Syntaktické zásuvné moduly (Plugins) ===== Syntaxe DokuWiki může být rozšířena pomocí [[doku>wiki:plugins|zásuvných modulů]]. Jak se který zásuvný modul instaluje a používá je vysvětleno v příslušné dokumentační stránce daného zásuvného modulu. V této konkrétní DokuWiki jsou nainstalovány tyto zásuvné moduly: ~~INFO:syntaxplugins~~ Poslední úprava: před 17 rokyautor: 127.0.0.1