Uživatelské nástroje

Nástroje pro tento web


tutorialy:wiki

Toto je starší verze dokumentu!


Použití DokuWiki pro psaní dokumentů

Systém wiki bychom měli používat pro psaní specifikací, dokumentací, návodů, tutoriálů a dalších textů, které by měly být přístupné všem členům laborky.

Výhody wiki:

  • jednoduchá – čistě textová podoba, syntaxe jednodušší než HTML
  • webová – práce přes webový prohlížeč, přístup možný odkudkoliv
  • veřejná – informace jsou přístupné komukoliv, kdokoliv je může editovat
  • řízení přístupu – samozřejmě lze nastavit úroveň přístupových práv k jednotlivým sekcím/stránkám
  • verzovaná – systém sleduje změny stránek a umožňuje se snadno vrátit k některé z minulých verzí

Kofrlab Wiki

Používáme systém DokuWiki s rozšířením MonoBook, které nabízí navíc diskuse k článkům, přehlednější navigaci na stránkách a lepší vzhled systému.

Kofrlab Wiki je umístěna na adrese http://patf-biokyb.lf1.cuni.cz/wiki. Kterýkoliv návštěvník může wiki číst, pro zápis je potřeba mít registraci. Časem1) dojde pravděpodobně k vytvoření chráněné sekce, do které budou mít přístup pouze členové Kofrlabu.

Syntaxe

Přehled syntaxe DokuWiki. Práci s wiki si můžete volně zkoušet na pískovišti.

FIXME poznámky:

  • Použití nadpisů vede k automatickému vytvoření obsahu stránky.
  • Emailové adresy by měly být teoreticky chráněny před spammerskými pavouky.
  • Syntax highlighting - csharp, actionscript, xml, java, html, sql, …
  • Náhled stránky před uložením
  • Klávesové zkratky – Alt+P (náhled), Alt+E (editace stránky), …
  • Editace části stránky (sekce) – lepší orientace v dlouhém textu
  • Soubory – v nástrojích odkaz Nahrát soubor. Obrázky i libovolné soubory.
  • Sledování změn obsahu stránek mailem
  • Editor – pomocník při psaní textu
  • Export do formátů mimo Wiki (XHTML, …)
  • Zálohování obsahu – TODO

Stuktura Kofrlab wiki

FIXME strom

Jak založit novou stránku

Wiki neumožňuje založit novou stránku přímo. Místo toho je nutné nejprve na neexistující stránku vytvořit odkaz a potom na něj kliknout a stránku založit. Alternativní postup je vysledovat, jak wiki tvoří URL, a zadat adresu neexistující stránky přímo do prohlížeče (nepoužívat!).

Pravidla Kofrlab Wiki

FIXME používání dlouhých pomlček, používání syntax highlightingu, co nejvíce odkazů, nebát se upravovat cizí stránky (pozor na názorové rozepře), případně používat diskuse, tvorba odstavců, dodržovat strukturu Kofrlab wiki

1) on demand
tutorialy/wiki.1175700781.txt.gz · Poslední úprava: 2007/04/04 17:33 autor: stod