GMLWiki

====== 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 ''<nowiki>http://www.gml.cz/wiki/doku.php/playground:novastranka</nowiki>'' do adresního řádku prohlížeče nebo vytvořením nového odkazu ''<nowiki>[[playground:novastranka|Nová stránka]]</nowiki>'' 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 ''<nowiki>informatika:site:uvod</nowiki>'' a ''<nowiki>informatika:site:adresy</nowiki>''. Na stránce ''<nowiki>informatika:site:uvod</nowiki>'' (odkaz vypadá takto ''<nowiki>[[informatika:site:uvod|Počítačové sítě]]</nowiki>'') 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 ''<nowiki>informatika:site:adresy</nowiki>'' (odkaz vypadá takto ''<nowiki>[[informatika:site:adresy|Síťové adresy]]</nowiki>'') 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.

<WRAP center round important 80%>
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...
</WRAP>

====== 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:  ''<nowiki>text **tučně** vysázený</nowiki>'' (text **tučně** vysázený)
  ; kurzíva : text kurzívou obalte dvojicí lomítek:  ''<nowiki>text //kurzívou// vysázený</nowiki>'' (text //kurzívou// vysázený)
  ; podtržení : podtržení nepoužívejte, slouží pro odkazy. V nouzi nejvyšší obalte text dvojicí spodních podtržítek: ''<nowiki>bezdůvodně __podtržený__ text</nowiki>'' (bezdůvodně __podtržený__ text)
  ; neproporcionálně (psacím strojem) : jako psacím strojem sází dvojice jednoduchých uvozovek (znak amerického apostrofu) ''<nowiki>text ''stojově'' sázený</nowiki>'' (text ''stojově'' sázený)
  ; <BOOKMARK:nowiki>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": ''<nowiki><nowiki>Ignorujeme **dokuwiki**</nowiki></nowiki>''
  ; škrtnutí textu : uzavřete text do HTML značky "del": ''<nowiki><del>škrtnutý text</del></nowiki>'' (<del>škrtnutý text</del>) -- 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 (''<nowiki>a<sup>2</sup>, b<sub>0</sub></nowiki>'' je a<sup>2</sup>, b<sub>0</sub>)
  ; 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ě. (''<nowiki>====== Hlavní nadpis ======</nowiki>'')
  ; 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: ''<nowiki>zlomený\\ odstavec</nowiki>'' 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).
<code>  
  * odr. 1
  * odr. 2
    * odr. 2.1
      * odr 2.1.1
    * odr. 2.2
  * odr. 3
</code>
  * odr. 1
  * odr. 2
    * odr. 2.1
      * odr 2.1.1
    * odr. 2.2
  * odr. 3
<code>  
  - odr. 1
  - odr. 2
    - odr. 2.1
      - odr 2.1.1
    - odr. 2.2
  - odr. 3
</code>
  - 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... ''<nowiki>  ; seznam s definicemi : jako tento přehled, vytváří se jako odrážky</nowiki>'', používáme plugin [[doku>plugin:definitionlist|Definition list]]
  ; vodorovná čára : napište 4 spojovníky (pomlčky) vedle sebe na začátek řádku: ''<nowiki>----</nowiki>''
  ; 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]] 
<code>
 <code c 1 |h Program "Ahoj světe">

#include <stdio.h>

int main(int argc, char* argv[]) {
   printf("Ahoj svete!\n");
   return 0;
}
 </code>  
</code>
<code c 1 |h Program "Ahoj světe">

#include <stdio.h>

int main(int argc, char* argv[]) {
   printf("Ahoj svete!\n");
   return 0;
}
</code>  
  ; 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ů ">"
<code>
Text
> odpověď
>> další reakce
> pokračování odpovědi
>> reakce na pokračování
</code>
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: <nowiki>--</nowiki>)
  ; nezlomitelná mezera : místo mezery napiště obrácené lomítko a mezeru (''<nowiki>v\ lese</nowiki>'') nebo ''<nowiki>v~~SP~~lese</nowiki>''. 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 ''<nowiki>FIXME</nowiki>''
  ; šipky : automaticky se nahrazují některé kombinace znaků:\\ ''<nowiki>-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)</nowiki>'' 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**: ''<nowiki>[[http://www.adresa.cz|Popis odkazu]]</nowiki>'' ([[http://www.adresa.cz|Popis odkazu]]) -- všimněte si nutnosti napsat <nowiki>http://</nowiki>!
  * Odkaz na stránku uvnitř wiki: ''<nowiki>[[informatika:site:uvod|Počítačové sítě]]</nowiki>'' -- 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ř.: ''<nowiki>[[wp>Jiří_Ignác_Linek|Skvělý český skladatel]]</nowiki>'' [[wp>Jiří_Ignác_Linek|Skvělý český skladatel]] nebo ''<nowiki>[[wpde>Truhenorgel|Was ist Truhenorgel?]]</nowiki>'' [[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 ''<nowiki><BOOKMARK:popisek></nowiki>''. 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ř.: ''<nowiki>[[wiki:jakpsat#nowiki|Příkaz nowiki]]</nowiki>'' způsobí odkaz [[wiki:jakpsat#nowiki|Příkaz nowiki]], pokud jsme na příslušném místě této stránky napsali ''<nowiki><BOOKMARK:nowiki></nowiki>''

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**
<code>
<WRAP group>
<WRAP half column>
Jeden sloupec
</WRAP>

<WRAP half column>
Druhý sloupec
</WRAP>
</WRAP>
</code>
<WRAP group>
<WRAP half column>
Jeden sloupec
</WRAP>

<WRAP half column>
Druhý sloupec
</WRAP>
</WRAP>

**Důležitý box** na 80 % šířky stránky
<code>
<WRAP center round important 80%>
důležité
</WRAP>
</code>
<WRAP center round important 80%>
důležité
</WRAP>


===== Obrázky, videa a zvuky =====

===== Tabulky =====

===== Přikládání souborů ke stažení=====

===== Speciální funkce =====
GMLWiki

Uživatelské nástroje

Nástroje pro tento web

Nástroje pro stránku
