====== Formátovací syntaxe ======

[[doku>DokuWiki]] podporuje jednoduchý značkovací jazyk, který se snaží, aby datové soubory byly co nejčitelnější. Tato stránka obsahuje veškerou možnou syntaxi, kterou můžete při editaci stránek použít. Stačí se podívat na zdroj této stránky stisknutím tlačítka //Edit this page// v horní či dolní části stránky. Pokud chcete něco vyzkoušet, použijte prosím stránku [[playground:playground|playground]]. Jednodušší značkování je snadno přístupné také pomocí [[doku>toolbar|quickbuttons]].

===== Základní formátování textu =====

DokuWiki podporuje **tučný**, //kurzíva//, __podtržený__ a ''monospace'' text. Samozřejmě je můžete **__//''kombinovat''//__**.

  DokuWiki podporuje **tučný**, //kurzíva//, __podtržený__ a ''monospace'' text.

  Samozřejmě je můžete **__//''kombinovat''//__**.

Můžete také používat tagy <sub>subscript</sub> a <sup>superscript</sup>.

  Můžete také používat tagy <sub>subscript</sub> a <sup>superscript</sup>.

Můžete označit text jako <del>smazaný</del>.

  Můžete označit text jako <del>smazaný</del>.

**Odstavce** se vytvářejí pomocí prázdných řádků. Pokud chcete **vynutit nový řádek** bez vytvoření nového odstavce, můžete použít dvě zpětná lomítka následovaná mezerou nebo koncem řádku.

Toto je text s několika řádkovými zlomy\\ Poznamenejte si, že

dvě zpětná lomítka jsou rozpoznána pouze na konci řádku\\

nebo pokud jsou následována mezerou \\ tento efekt nastane bez ní.

  Toto je text s několika řádkovými zlomy\\ Poznamenejte si, že

  dvě zpětná lomítka jsou rozpoznána pouze na konci řádku\\

  nebo pokud jsou následována mezerou \\ tento efekt nastane bez ní.

Používejte vynucené zlomy pouze, pokud je to opravdu potřeba.

===== Odkazy =====

DokuWiki podporuje několik způsobů vytváření odkazů.

==== Externí odkazy ====

Externí odkazy jsou automaticky rozpoznávány: http://www.google.com nebo jednoduše www.google.com – můžete také nastavit text odkazu: [[http://www.google.com|This Link points to google]]. Emailové adresy, jako například <andi@splitbrain.org>, jsou rovněž rozpoznávány.

  DokuWiki podporuje několik způsobů vytváření odkazů. Externí odkazy jsou automaticky rozpoznávány: http://www.google.com nebo jednoduše www.google.com – můžete také nastavit text odkazu: [[http://www.google.com|This Link points to google]]. Emailové adresy, jako například <andi@splitbrain.org>, jsou rovněž rozpoznávány.

==== Interní odkazy ====

Interní odkazy se vytvářejí pomocí hranatých závorek. Můžete uvést pouze [[pagename]] nebo použít dodatečné [[pagename|link text]].

  Interní odkazy se vytvářejí pomocí hranatých závorek. Můžete uvést pouze [[pagename]] nebo použít dodatečné [[pagename|link text]].

[[doku>pagename|Wiki pagenames]] jsou automaticky převedeny na malá písmena, speciální znaky nejsou povoleny.

Můžete také používat [[some:namespaces]] pomocí dvojtečky v názvu stránky.

  Můžete používat [[some:namespaces]] pomocí dvojtečky v názvu stránky.

Pro podrobnosti o jmenných prostorech viz [[doku>namespaces]].

Odkazování na konkrétní sekci je také možné – stačí za název stránky přidat znak hash (#) následovaný názvem sekce, stejně jako v HTML. Tento odkaz vede na [[syntax#internal|tuto sekci]].

  Tento odkaz vede na [[syntax#internal|tuto sekci]].

Poznámky:

  * Odkazy na [[syntax|existující stránky]] se zobrazují odlišným stylem než [[nonexisting]] odkazy.
  * DokuWiki nepoužívá automaticky [[wp>CamelCase]] k vytvoření odkazů, ale toto chování lze povolit v souboru [[doku>config]].
  * Pokud se změní nadpis sekce, změní se i záložka – proto se na odkazování na sekce příliš nespoléhejte.

==== Interwiki ====

DokuWiki podporuje [[doku>Interwiki]] odkazy, což jsou rychlé odkazy na jiné wiki. Například tento odkaz vede na Wikipedii: [[wp>Wiki]].

  DokuWiki podporuje [[doku>Interwiki]] odkazy. Například tento odkaz vede na Wikipedii: [[wp>Wiki]].

==== Sdílení ve Windows ====

Windows sdílení, jako například [[\\server\share|this]], jsou rovněž rozpoznávány. Všimněte si, že to má smysl jen pro homogenní skupiny uživatelů, např. firemní [[wp>Intranet]].

  Windows sdílení jako [[\\server\share|this]] jsou rovněž rozpoznávány.

Poznámky:

  * Z bezpečnostních důvodů funguje přímé prohlížení windows sdílení pouze v Microsoft Internet Explorer ve výchozím nastavení (a pouze v "lokální zóně").
  * U Mozilly a Firefoxu lze tuto funkci povolit přes konfigurační možnost [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], ale to se nedoporučuje.
  * Více informací najdete na [[dokubug>151]].

==== Odkazy na obrázky ====

Obrázek můžete použít jako odkaz na jinou interní nebo externí stránku kombinací syntaxe odkazů a obrázků (viz níže). Například:

  [[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á syntaxe formátování, která je akceptována v názvech odkazů.

Celá syntaxe pro obrázky a odkazy je podporována (včetně změny velikosti obrázku, interních i externích obrázků, URL a interwiki odkazů).

===== Poznámky pod čarou =====

Poznámky pod čarou lze přidávat pomocí dvojitých závorek: ((Toto je poznámka pod čarou)).

  ((Toto je poznámka pod čarou)).

===== Dělení sekcí =====

Můžete použít až pět různých úrovní nadpisů k uspořádání obsahu. Pokud máte více než tři nadpisy, je automaticky generována obsahová tabulka – tuto funkci můžete vypnout vložením řetězce ''<nowiki>~~NOTOC~~</nowiki>'' do dokumentu.

==== Nadpis úrovně 3 ====

=== Nadpis úrovně 4 ===

== Nadpis úrovně 5 ==

  ==== Nadpis úrovně 3 ====
  
  === Nadpis úrovně 4 ====
  
  == Nadpis úrovně 5 ==

Pomocí čtyř nebo více pomlček můžete vytvořit vodorovnou čáru:

----  

===== Obrázky a další soubory =====

Můžete vkládat externí i interní [[doku>images]] pomocí složených závorek. Volitelně můžete specifikovat jejich velikost.

Reálná velikost:                        {{wiki:dokuwiki-128.png}}

Změna velikosti na zadanou šířku:            {{wiki:dokuwiki-128.png?50}}

Změna velikosti na zadanou šířku a výšku (pokud poměr stran neodpovídá, obrázek bude oříznut): {{wiki:dokuwiki-128.png?200x50}}

Externí obrázek ve změněné velikosti:           {{http://de3.php.net/images/php.gif?200x50}}

  Reálná velikost:                        {{wiki:dokuwiki-128.png}}
  
  Změna velikosti na zadanou šířku:            {{wiki:dokuwiki-128.png?50}}
  
  Změna velikosti na zadanou šířku a výšku: {{wiki:dokuwiki-128.png?200x50}}
  
  Externí obrázek ve změněné velikosti:           {{http://de3.php.net/images/php.gif?200x50}}

Pro zarovnání použijte mezery vlevo nebo vpravo.

{{wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{wiki:dokuwiki-128.png }}

Samozřejmě můžete přidat titulek (zobrazený jako tooltip ve většině prohlížečů):

{{wiki:dokuwiki-128.png |This is the caption}}

Pokud zadáte název souboru, který není obrázek (gif, jpeg, png), bude zobrazen jako odkaz.

Pro odkazování obrázku na jinou stránku viz [[#Image Links]] výše.

===== Poznámky =====

DokuWiki podporuje vytváření poznámek pod čarou ((Toto je poznámka pod čarou)) pomocí dvojitých závorek.

  ((Toto je poznámka pod čarou)).

===== Doplňkové bloky =====

Můžete do dokumentu vložit bloky, které nebudou formátovány. To lze provést buď odsazením alespoň o dvě mezery (jako v předchozích příkladech), nebo použitím tagů ''code'' či ''file''.

<code>
Toto je formátovaný kód – všechny mezery jsou zachovány: například              <-to
</code>

<file>
Toto je prakticky totéž, ale můžete jej použít k zobrazení textu ze souboru.
</file>

Aby parser úplně ignoroval část textu (tj. neprováděl žádné formátování), obalte text buď tagy ''nowiki'' nebo jednoduše dvojitými procenty: ''<nowiki>%%</nowiki>''.

<nowiki>
Toto je text, který obsahuje adresy jako http://www.splitbrain.org a **formátování**, ale nebude nijak formátován.
</nowiki>

Viz zdroj této stránky, abyste viděli, jak používat tyto bloky.

===== Zvýraznění syntaxe =====

[[DokuWiki]] dokáže zvýraznit zdrojový kód, což usnadňuje jeho čtení. Používá se k tomu Generic Syntax Highlighter [[http://qbnz.com/highlighter/|GeSHi]], takže je podporován kód jakéhokoli jazyka, který GeSHi umí. Syntaxe je stejná jako u kódových bloků v předchozí sekci, avšak tentokrát se uvádí název použitého jazyka uvnitř tagu. Například: ''<nowiki><code java></nowiki>''.

<code java>
/** 
 * Třída HelloWorldApp implementuje aplikaci, která
 * jednoduše vypíše "Hello World!" na standardní výstup.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); // Vypíše řetězec.
    }
}
</code>

Aktuálně jsou rozpoznány následující jazykové řetězce: //abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoit, bash, basic4gl, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cobol, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, dot, d, eiffel, fortran, freebasic, genero, glsl, gml, gnuplot, groovy, gettext, haskell, html, idl, ini, inno, io, java5, java, javascript, kixtart, klonec, klonecpp, latex, lisp, lotusformulas, lotusscript, lua, m68k, matlab, mirc, mpasm, mxml, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, per, php-brief, php, pic16, plsql, povray, powershell, progress, python, qbasic, rails, reg, robots, ruby, sas, scala, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, visualfoxpro, winbatch, xml, xorg_conf, xpp, z80//

===== RSS/ATOM agregace kanálů =====

[[DokuWiki]] může integrovat data z externích XML kanálů. K jejich parsování se používá [[http://simplepie.org/|SimplePie]]. Všechny formáty, které SimplePie podporuje, lze použít i v DokuWiki. Rendering můžete ovlivnit pomocí dalších parametrů, oddělených mezerami:

^ Parametr  ^ Popis ^
| libovolné číslo | bude použito jako maximální počet položek, výchozí hodnota je 8 |
| reverse         | zobrazí poslední položky kanálu jako první |
| author          | zobrazí jména autorů položek |
| date            | zobrazí datum položek |
| description     | zobrazí popis položky; pokud je HTML vypnuto, budou všechny tagy odstraněny |
| //n//[dhm]     | doba obnovení, kde d=dny, h=hodiny, m=minuty (např. 12h = 12 hodin) |

Doba obnovení je výchozí 4 hodiny. Jakákoliv hodnota pod 10 minut bude považována za 10 minut. [[DokuWiki]] se obvykle snaží dodat ke stránce cachovanou verzi, což není vhodné, pokud stránka obsahuje dynamický externí obsah. Parametr říká, že stránka se má znovu renderovat, pokud uplynula //doba obnovení// od posledního renderování.

**Příklad:**

  {{rss>http://slashdot.org/index.rss 5 author date 1h }}

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

===== Vkládání HTML a PHP =====

Můžete vložit čistý HTML nebo PHP kód do dokumentů pomocí tagů ''html'' nebo ''php'', například:

<code>
<html>
Toto je nějaké <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">A toto je blokový HTML kód</p>
</HTML>
</code>

<html>
Toto je nějaké <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">A toto je blokový HTML kód</p>
</HTML>

<code>
<php>
echo 'Logo generované PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(generovaný inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>Stejné, ale uvnitř blokového elementu:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>
</code>

<php>
echo 'Logo generované PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>Stejné, ale uvnitř blokového elementu:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>

**Poznámka:** Vkládání HTML a PHP je ve výchozím nastavení zakázáno. Pokud je zakázáno, kód se zobrazí místo toho, aby byl spuštěn.

===== Řídicí makra =====

Některé syntaktické prvky ovlivňují, jak DokuWiki vykresluje stránku, aniž by sám generovaly výstup. Následující řídicí makra jsou dostupná:

^ Makro           ^ Popis ^
| %%~~NOTOC~~%%   | Pokud je toto makro nalezeno na stránce, nebude vytvořena obsahová tabulka |
| %%~~NOCACHE~~%% | DokuWiki cachuje veškerý výstup standardně. Pokud to nechcete (např. při použití %%<php>%%), přidáním tohoto makra donutíte DokuWiki, aby stránku renderoval znovu při každém volání |

===== Syntaxe pluginů =====

Syntaxe DokuWiki může být rozšířena pomocí [[doku>plugins|pluginů]]. Jak jsou nainstalované pluginy používány, je popsáno na jejich příslušných stránkách. Následující syntaxe pluginů je dostupná v této instalaci DokuWiki:

~~INFO:syntaxplugins~~