<br />
<b>Warning</b>:  Declaration of action_plugin_discussion::register(&$contr) should be compatible with DokuWiki_Action_Plugin::register(Doku_Event_Handler $controller) in <b>/pub/skautwa/skaut1stredisko.cz/web/rs/wiki/lib/plugins/discussion/action.php</b> on line <b>0</b><br />
====== 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é.

**Pevné mezery** reprezentované v HTML značkou &nbsp; se dají vysázet pomocí jednoho zpětného lomítka následovaného mezerou. Toto není standardní součástí DokuWiki, je to vytvořeno pomocí [[http://wiki.splitbrain.org/plugin:nbsp|NBSP pluginu]].

^  Úkázka s použitím pevných mezer  ^^
| Toto\ je\ text\ využívající\ pevných\ mezer\ neměl\ by\ se\ zalamovat | na rozdíl od klasické mezery není pevná mezera chápána jako oddělovač slov ale pouze jako obyčejný znak bez viditělné reprezentace. Toho se často využívá napříklade mezi krátkými předložkami a slovem. |
| Jak\ vidíme\ může\ se\ toto\ hodit\ například\ v\ tabulkách | pokud chceme zamezit zalamování záznamů, které by měli být na jednom řádku, například telefonních čísel nebo jmen osob. Takto se text láme bez pevných mezer, obyčejně to nevadí a je to celkem příjemná vlastnost, někdy to ale může být nežádoucí |

  ^  Úkázka s použitím pevných mezer  ^^
  | Toto\ je\ text\ využívající\ pevných\ mezer\ neměl\ by\ se\ zalamovat | na rozdíl od klasické mezery není pevná mezera chápána jako oddělovač slov ale pouze jako obyčejný znak bez viditělné reprezentace. Toho se často využívá napříklade mezi krátkými předložkami a slovem. |
  | Jak\ vidíme\ může\ se\ toto\ hodit\ například\ v\ tabulkách | pokud chceme zamezit zalamování záznamů, které by měli být na jednom řádku, například telefonních čísel nebo jmen osob. Takto se text láme bez pevných mezer, obyčejně to nevadí a je to celkem příjemná vlastnost, někdy to ale může být nežádoucí |

^  Úkázka bez použití pevných mezer  ^^
| Toto je text využívající pevných mezer neměl by se zalamovat | na rozdíl od klasické mezery není pevná mezera chápána jako oddělovač slov ale pouze jako obyčejný znak bez viditělné reprezentace. Toho se často využívá napříklade mezi krátkými předložkami a slovem. |
| Jak vidíme může se toto hodit například v tabulkách | pokud chceme zamezit zalamování záznamů, které by měli být na jednom řádku, například telefonních čísel nebo jmen osob. Takto se text láme bez pevných mezer, obyčejně to nevadí a je to celkem příjemná vlastnost, někdy to ale může být nežádoucí |

  ^  Úkázka bez použití pevných mezer  ^^
  | Toto je text využívající pevných mezer neměl by se zalamovat | na rozdíl od klasické mezery není pevná mezera chápána jako oddělovač slov ale pouze jako obyčejný znak bez viditělné reprezentace. Toho se často využívá napříklade mezi krátkými předložkami a slovem. |
  | Jak vidíme může se toto hodit například v tabulkách | pokud chceme zamezit zalamování záznamů, které by měli být na jednom řádku, například telefonních čísel nebo jmen osob. Takto se text láme bez pevných mezer, obyčejně to nevadí a je to celkem příjemná vlastnost, někdy to ale může být nežádoucí |

===== 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~~