obrazek_hlavicka
Hlavní stránka| Okres Domažlice| Okres Klatovy| Okres Tachov| Okres Plzeň-jih| Praha| Německo

Uživatelské nástroje

Nástroje pro tento web


Postranní lišta

































































wiki:syntax

Formátovací syntaxe

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. Jednodušší značkování je snadno přístupné také pomocí 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 subscript a superscript.

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

Můžete označit text jako smazaný.

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: 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é 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]].

Wiki pagenames jsou automaticky převedeny na malá písmena, speciální znaky nejsou povoleny.

Můžete také používat 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 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 tuto sekci.

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

Poznámky:

  • Odkazy na existující stránky se zobrazují odlišným stylem než nonexisting odkazy.
  • DokuWiki nepoužívá automaticky CamelCase k vytvoření odkazů, ale toto chování lze povolit v souboru 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 Interwiki odkazy, což jsou rychlé odkazy na jiné wiki. Například tento odkaz vede na Wikipedii: 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 this, jsou rovněž rozpoznávány. Všimněte si, že to má smysl jen pro homogenní skupiny uživatelů, např. firemní 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 security.checkloaduri, ale to se nedoporučuje.
  • Více informací najdete na 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}}]]

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: 1).

((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 ~~NOTOC~~ 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í images pomocí složených závorek. Volitelně můžete specifikovat jejich velikost.

Reálná velikost:

Změna velikosti na zadanou šířku:

Změna velikosti na zadanou šířku a výšku (pokud poměr stran neodpovídá, obrázek bude oříznut):

Externí obrázek ve změněné velikosti:

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.

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

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 2) 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.

Toto je formátovaný kód – všechny mezery jsou zachovány: například              <-to
Toto je prakticky totéž, ale můžete jej použít k zobrazení textu ze souboru.

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: %%.

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

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 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: <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.
    }
}

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á 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 }}

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:

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

Toto je nějaké inline HTML

A toto je blokový HTML kód

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

echo 'Logo generované PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; echo '(inline HTML)';

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>';

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í 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:






Zobrazeno: 3199 x

1) , 2)
Toto je poznámka pod čarou
wiki/syntax.txt · Poslední úprava: 2025/03/02 21:31 autor: admin