====== Jak psát na DokuWiki ======
Psaní na dokuwiki se dá rychle naučit a je celkem podobné psaní HTML stránek. Co nenajdete zde, najdete v angličtině na [[doku>|www.dokuwiki.org]], můžete se také podívat na [[doku>screencast|videa]]. Nejsnažší je podívat se na stránku, kde už někdo vytvořil něco podobného a podívat se, jak to udělal. Po straně je ikonka tužky s nápisem "Upravit stránku" -- stačí kliknout, podívat se a dát zrušit úpravy.
===== Vytvoření, úprava a smazání stránky =====
**Novou stránku vytvoříme** tak, že do jiné vložíme odkaz s názvem neexistující stránky nebo, že upravíme název existující stránky v adresním řádku prohlížeče. Stránky mají hierarchickou strukturu. Mohou tvořit kategorie a podkategorie stránek. Každý uživatel má právo přístupu (čtení a zápisu) jen do určitých kategorií, takže je možné, že v některých kategoriích nebude možné stránku vytvořit. Na zkoušení používejte kategorii PlayGround, kam mohou všichni.
Novou stránku "Nová stránka" v kategorii PlayGround vytvoříme zadáním ''http://www.gml.cz/wiki/doku.php/playground:novastranka'' do adresního řádku prohlížeče nebo vytvořením nového odkazu ''[[playground:novastranka|Nová stránka]]'' v jiné stránce (odkaz je červený, pokud stránka opravdu neexistuje: [[playground:novastranka|Nová stránka]]) a kliknutím na něj. Zobrazí se upozornění //Stránka s tímto názvem ještě neexistuje//. Klikněte vpravo u okraje na ikonu tužky.
Celou **novou kategorii vytvoříme** stejně. Pokud chceme, aby kategori měla nějakou úvodní stránku, která ji popisuje, vytvoříme hned v kategorii stránku s názvem "uvod". V menu se pak zobrazí pod odkazem na kategorii právě tato stránka. Příklad: v kategorii "Informatika" chci vytvořit podkategorii "Počítačové sítě" s úvodní stránkou a podstránkou "Síťové adresy". Zakládám proto stránky s odkazy ''informatika:site:uvod'' a ''informatika:site:adresy''. Na stránce ''informatika:site:uvod'' (odkaz vypadá takto ''[[informatika:site:uvod|Počítačové sítě]]'') napíši hned v záhlaví nadpis "Počítačové sítě" a pokračuji popisem kategorie. Díky tomu se v menu neobjeví "site" (jak je to v adrese), ale "Počítačové sítě". Na stránce ''informatika:site:adresy'' (odkaz vypadá takto ''[[informatika:site:adresy|Síťové adresy]]'') napíši hned v záhlaví nadpis "Síťové adresy" a pokračuji textem stránky.
**Existující stránku upravím** (nebo její způsob zápisu/kód zobrazím) kliknutím na ikonu tužky u pravého okraje textu nebo na tlačítko "upravit" vpravo ve stránce za každým blokem textu.
**Stránka se smaže** tak, že se dá editovat a vymaže se veškerý její obsah.
V DokuWiki se stránka ve skutečnosti nesmaže. Pouze se po vymazání obsahu skryje, ale správce webu ji stále může zobrazit. **Cokoliv, co jednou uložíte, už v DokuWiki navždy zůstává s vaším jménem a informací, kdy jste úpravu provedli.** Byť jsou tyto informace skryty v historii stránky...
====== Syntaxe pro psaní ======
Většinu základních potřebných úprav provedete kliknutím na nabídku nad oknem editace. Přesto bývá rychlejší naučit se alespoň pár základních značek. Některé věci ani jinak než značkou napsat nelze.
===== Úprava vzhledu textu =====
; tučně : tučný text obalte dvojicí hvězdiček: ''text **tučně** vysázený'' (text **tučně** vysázený)
; kurzíva : text kurzívou obalte dvojicí lomítek: ''text //kurzívou// vysázený'' (text //kurzívou// vysázený)
; podtržení : podtržení nepoužívejte, slouží pro odkazy. V nouzi nejvyšší obalte text dvojicí spodních podtržítek: ''bezdůvodně __podtržený__ text'' (bezdůvodně __podtržený__ text)
; neproporcionálně (psacím strojem) : jako psacím strojem sází dvojice jednoduchých uvozovek (znak amerického apostrofu) ''text ''stojově'' sázený'' (text ''stojově'' sázený)
; ignorování příkazů wiki : text, který má být vypsán přesně tak, jak je, anižby ho dokuwiki jakkoliv upravovala, uzavřete do html značek "nowiki": ''Ignorujeme **dokuwiki**''
; škrtnutí textu : uzavřete text do HTML značky "del": ''škrtnutý text'' (škrtnutý text) -- hodí se tehdy, když chcete upozornit na chybu nebo opravit dříve napsaný chybný úsek
; horní a dolní index : používejte HTML značky sup a sub (''a2, b0'' je a2, b0)
; nadpisy : nadpisy se obalují rovnítky, pod nimi je odřádkováno. Hlavní nadpis stránky/sekce je z každé strany obalen 6 rovnítky, ostatní podnadpisy vždy o rovnítko z každé strany méně. (''====== Hlavní nadpis ======'')
; zalomení řádku uvnitř odstavce : používá se při sázení básniček, slok písní, apod. Použijte dvě obrácená lomítka a mezeru za sebou: ''zlomený\\ odstavec'' vytvoří zlomený\\ odstavec
; odrážky : napište od okraje dvě mezery (nutné!), pak hvězdičku, mezeru a text odrážky. Nižší úrovně odrážek pomocí dalších dvou mezer, viz příklad. Číslované odrážky se dělají stejně, jen místo hvězdiček je spojovník (pomlčka).
* odr. 1
* odr. 2
* odr. 2.1
* odr 2.1.1
* odr. 2.2
* odr. 3
* odr. 1
* odr. 2
* odr. 2.1
* odr 2.1.1
* odr. 2.2
* odr. 3
- odr. 1
- odr. 2
- odr. 2.1
- odr 2.1.1
- odr. 2.2
- odr. 3
- odr. 1
- odr. 2
- odr. 2.1
- odr 2.1.1
- odr. 2.2
- odr. 3
; seznam s definicemi : jako tento přehled, vytváří se jako odrážky: dvě mezery, středník, definované slovo, mezera, dvojtečka, mezera, definice... '' ; seznam s definicemi : jako tento přehled, vytváří se jako odrážky'', používáme plugin [[doku>plugin:definitionlist|Definition list]]
; vodorovná čára : napište 4 spojovníky (pomlčky) vedle sebe na začátek řádku: ''----''
; kód v programovacím jazyce : uzavřete kód do HTML značky "code", můžete přidat parametry (název jazyka, číslo 1 pro číslování řádků, a za "|h" titulek), používáme plugin [[doku>plugin:code2|Code syntax]]
#include
int main(int argc, char* argv[]) {
printf("Ahoj svete!\n");
return 0;
}
#include
int main(int argc, char* argv[]) {
printf("Ahoj svete!\n");
return 0;
}
; konverzace : ve stránce je možno vést konverzaci, jednotlivá tvrzení a odpovědi na ně (jako v e-mailu) lze odsazovat tak, že řádek začíná příslušným počtem znaků ">"
Text
> odpověď
>> další reakce
> pokračování odpovědi
>> reakce na pokračování
Text
> odpověď
>> další reakce
> pokračování odpovědi
>> reakce na pokračování
===== Speciální znaky a smajlíky =====
; pomlčka : místo každé pomlčky pište vždy dva spojovníky (pomlčky na klávesnici -- takto: --)
; nezlomitelná mezera : místo mezery napiště obrácené lomítko a mezeru (''v\ lese'') nebo ''v~~SP~~lese''. Plugin [[doku>plugins:nbsp|NBSP]].
; smajlíky : se automaticky opravují... Nemají-li se měnit, musí se uzavřít do HTML značky nowiki :-)
; označení vynechaného nebo chybného textu : použijte "smajlík Fix Me!", stačí napsat ''FIXME''
; šipky : automaticky se nahrazují některé kombinace znaků:\\ ''-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)'' se nahrazuje za\\ -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
; české uvozovky : se opravují automaticky po napsání "uvozovek" na klávesnici
===== Odkazy =====
* Odkazy **na cizí stránky**: ''[[http://www.adresa.cz|Popis odkazu]]'' ([[http://www.adresa.cz|Popis odkazu]]) -- všimněte si nutnosti napsat http://!
* Odkaz na stránku uvnitř wiki: ''[[informatika:site:uvod|Počítačové sítě]]'' -- odkazuje na kategorii //informatika//, podkategorii //site// a její úvodní stránku. Popis odkazu bude //Počítačové sítě//.
* Odkazy **na wikipedii**: stačí napsat "wp>" pro českou a "wpen>" pro anglickou ("wpde>" německá) a za to odkaz na stránku. Např.: ''[[wp>Jiří_Ignác_Linek|Skvělý český skladatel]]'' [[wp>Jiří_Ignác_Linek|Skvělý český skladatel]] nebo ''[[wpde>Truhenorgel|Was ist Truhenorgel?]]'' [[wpde>Truhenorgel|Was ist Truhenorgel?]]
* Odkaz **dovnitř stránky ve wiki**: je-li nutné odkázat na konkrétní místo dovnitř dlouhé stránky wiki, musí se nejprve vytvořit v požadovaném místě na cílové stránce umístění odkazu. Napište zde ''''. Odkaz na takové místo vytvoříte stejně jako odkaz na příslušnou stránku, jen za název stránky dopište ''#popisek''. Např.: ''[[wiki:jakpsat#nowiki|Příkaz nowiki]]'' způsobí odkaz [[wiki:jakpsat#nowiki|Příkaz nowiki]], pokud jsme na příslušném místě této stránky napsali ''''
Popisy odkazu (a s nimi i svislítko) lze vynechat, pak se jako popis zobrazí samotný odkaz. Stačí-li napsat přímo odkaz (adresu stránky, bez speciálního popisku), není nutné používat žádný příkaz, **dokuwiki odkaz v textu rozpozná** a sama zvýrazní. pokud je to nežádoucí, zabalte odkaz do HTML značky nowiki.
===== Informační boxy, sloupce =====
Informační boxy a sloupce vytváří [[doku>plugin:wrap|Wrap plugin]], na jehož stránkách je detailní dokumentace. V menu nabízí své možnosti pod ikonkou krabice. Pár příkladů:
**Dva sloupce**
Jeden sloupec
Druhý sloupec
Jeden sloupec
Druhý sloupec
**Důležitý box** na 80 % šířky stránky
důležité
důležité
===== Obrázky, videa a zvuky =====
===== Tabulky =====
===== Přikládání souborů ke stažení=====
===== Speciální funkce =====