Uživatelské nástroje

Nástroje pro tento web


dokuwiki:jak_psat_na_dokuwiki

Toto je starší verze dokumentu!


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 www.dokuwiki.org, můžete se také podívat na 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 Nová stránka v jiné stránce (odkaz je červený, pokud stránka opravdu neexistuje: 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 kategorie 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 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 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ý) <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“: 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 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 Code syntax

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

Program „Ahoj světe“

1: #include <stdio.h> 2: 3: int main(int argc, char* argv[]) { 4: printf(„Ahoj svete!\n“); 5: return 0; 6: } 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 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ů: → ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® se nahrazuje za → ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® české uvozovky se opravují automaticky po napsání „uvozovek“ na klávesnici Odkazy Odkazy na cizí stránky: Popis odkazu (Popis odkazu) – všimněte si nutnosti napsat http://! Odkaz na stránku uvnitř wiki: 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ř.: Skvělý český skladatel Skvělý český skladatel nebo Was ist 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 <BOOKMARK:popisek>. 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ř.: Příkaz nowiki způsobí odkaz Příkaz nowiki, pokud jsme na příslušném místě této stránky napsali <BOOKMARK: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áří 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é

dokuwiki/jak_psat_na_dokuwiki.1611655525.txt.gz · Poslední úprava: 2021/03/02 08:55 (upraveno mimo DokuWiki)