Dokuwiki - nejprivetivejsi nastroj pro dokumentaci

14.3.2011 19:45 | Přečteno: 49186× | Všechno možný

Pred nejakou dobou jsem nasadil na domaci server Dokuwiki pro psani poznamek, navodu ..... no proste debilnicek.
Letme procteni nazoru uzivatelu mne presvedcilo k nasazeni a vyzkouseni. Jsem nadsen jednoduchosti a funkcnosti takoveto aplikace jez pro provoz nepotrebuje databazi, snadno se nainstaluje, spravuje a hlavne vlozeni, vyhledavani, editace zapisku je velmi jednoducha, rychla ... no proste vysoka pristupnost a privetivost k uzivateli.
Docela si dovedu predstavit vyuziti v tymu nejake firmy pro vedeni interni dokumentace k cemuz nabadaji jiz predpripravene systemy jez lze nasadit jako virtualni stroje.
Dokuwiki je k dispozici i jako instalovatelna Linuxova distribuce i jakozto VM zde: nebo od jinych autoru zde:
Drive oblibena Mediawiki mi dnes prijde jako kanon na vrabce.
Toz co vy ... jake pouzivate nastroje k tvorbe poznamek, dokumentaci ...        

Komentáře

[YYY]

Osobne na tvorbu dokumentace pouzivam bud javadoc nebo Doxygen. Na psani poznamek pouzivam gedit a jeden soubor. A na evidenci tasku, na ktere opravdu nesmim zapomenout, pouzivam flyspray.

[disorder]

dokuwiki je dobra wiki, blog a vselico ine, ale na tieto veci ani nie.

google calendar (two-way sync s mobilom), org-mode na poznamky a export todo/events do ics pre rainlendar

[w4rr10r]

LionWiki.

[Ondřej Profant]

Přesně tak.

[otasomil]

Sem se na Lionwiki dival a vubec to neni spatny. Nasadil jsem to k testovani.

[____]

Zim desktop wiki pro vlastní poznámky, gtk-doc a Doxygen pro programátorskou dokumentaci. Pro vlastní poznámky bych určitě nechtěl používat nic založeného na webových technologiích.

[Vlastimil Ott]

Zim a píšu o něm na blogu.

[GeBu]

Tohle je v Zimu: Šíření elektromagentických vln

V Zimu jsou ještě drobné nedodělky jako např., že to neumí pořádně tisk a velice by se mi hodil export do PDF a nativní práce s SVG, ale jinak pro tu moji dokumentaci se vzorci a obrázky se s tím pracuje pěkně.

[____]

Co se koukám, lze exportovat do LaTeXu. Dál už to bohužel není tak přímočaré. Co si teď hraju, musel jsem se pohrabat v balíčcích, aby se mi vůbec nějak povedlo to dostat přes XeLaTeX. Na výstupu pak je kýžené PDF.

[poky74]

Kam se to tedy ukládá, když ne do db? (ano, jsem línej to zjišťovat ) )

[Tomáš Heger (geckon)]

Do struktury textových souborů (zhruba platí adresář = namespace, soubor = stránka + nějaká metadata - další soubory v jiných adresářích).

[otasomil]

Do ciste textovych souboru jejichz struktura je totozna se strukturou textu jenz editujete ve vestavenem editoru.

Starsi verze uprav jednotlivych zapisku jsou kazdy zvlast jeste zmacknuty gzipem. Obrazky a dalsi soubory vkladane uzivatelem se ukladaji do spolecnych adresaru opet tak jak jsou.

 

K behu je treba jen webserver s podporou php5.

[Bedňa]

Môžem potvrdiť, pred asi dvoma rokmi som s DokuWiki pracoval a je fakt super jednoduchá a prívetivá. Zhodou okolností teraz pracujem na projekte, kde som len z recesie vyhodil používanie databázy a otvára mi to nové obzory

[kyytaM]

Nasadil som pred cca 2ma rokmi vo firme ako miesto, kde sa vytvara a edituje dokumentacia, vseliake how-to, servisne denniky a podobne. Funguje to perfektne, velka spokojnost u vsetkych pouzivatelov. Vyborna aplikacia.

Data vie ukladat aj do roznych DB aj to text suborov, zvolil som text subory. Bezi na ako PV XEN virtualka s 256 MB RAM (Debian Squeeze) na starsej desktop sunke a lieta to ako blesk. :)

[Bubak]

Jojo, dokuwiki je fajn. Mam na tom svoje website vcetne blogy, diskuzi a galerie. A to ze nepouziva SQL je super featura, zalohu tak delam WGETem

[Josef Kufner]

Jediné co dokuwiki chybí, je podpora verování i jiných typů souborů než je text. V současné době to vůbec neumí obrázky. Ne že by nešly vložit, to jo, ale neverzují se.

[Marek]

Od verze 2012 se verzují.

[m]

porovnanie roznych wiki

[AHAHA]

Poprve jsem se setkal s wiki na Wikipedii (tudiz MediaWiki) - nejaky cas jsem tam pusobil jako redaktor a zdalo se mi to fajn.

Nekdy pred rokem a pul jsem ve firme nasazoval wiki a doporucil/rozhodl jsem, ze se ma pouzit DokuWiki a to vicemene kvuli "success stories" z dokumentacnich projektu a z doslechu, ze MediaWiki je preplacany, zbytecne velky, pomaly obr. Musim rict, ze jsem rozhodnuti litoval:

- V DokuWiki je problem presun stranek na nove jmeno a je na to potreba plugin. Otazka je, nakolik zvlada presun mezi ruznymi namespaci (predevsim z hlediska docela komplexni syntaxe), oprave linku apod. - Opravte me, ale naposled, co jsem se dival, tak neslo presunout namespace. Mozna ze na to byl plugin, mne ale nefungoval

- Dokuwiki neumi "redirect". Existuji na to pluginy, nicmene vzhledem k tomu, ze neexistuje zadny standardni zapis, plugin na presun stranek se s nim asi nevyrovna

- Dokuwiki mrsi jmena souboru. Ve jmene souboru jsou povolene jen lower case alfanumericke znaky (bez diakritiky), cisla a mozna par dalsich veci. Jelikoz jmeno souboru je zaroven jmeno stranky, je to problem. Dokuwiki standardne obsahuje ficuru, ze za jmeno stranky se bere prvni hlavni nadpis ... to mi prijde ale takove nepekne, stranka ma jakoby dva nazvy, obcas je problem nez se pregeneruje index, otazka je opet, jestli se s tim dokazi vyrovnat pluginy na prejmenovani

- Dokuwiki ma spoustu jakychsi indexu a veci, co je nutne pregenerovavat. Supluje to databazi a IMHO to dela veci hur nez by to delalo s DB. Kod musi byt asi daleko komplikovanejsi, nez kdyby se pouzila normalni DB.

- Nelibi se mi koncept namespacu (teoreticky libi, v praxi se ale neosvedcily). Nikdy jsem moc nemel potrebu mit oddelene jmenne prostory, zato mi prislo otravne linkovat tady bez namespace, tam absolutne s namespace a tam relativne. Krom toho, NS maji jednu velkou vyhodu - tvori strom a zda se mi, ze tato vyhoda neni v dokuwiki dostatecne realizovana. Dokazu si predstavit navigacni menu vlevo, ktere pekne zobrazuje strom. Existuji na to pluginy, neni to ale "oficialne" podporovane a nase potreby to bohuzel nesplnovalo (nebyly nejak divne). Kategorie ala MediaWiki mi prijdou lepsi ...

- Dokuwiki ma hodne souboru (MediaWiki asi taky), coz je problem pri pouziti FTP

[Limoto]

Zrovna dneska jsem, částečně na popud tohoto blogupostu, nahodil LionWiki na router s OpenWRT jako cgi. Běhá to dostatečně rychle, funkčnost vypadá dobře, akorát je to PHP zkompilovaný bez ctypes a tudíž chybí funkce ctype_cntrl, kterou jsem se neúspěšně pokusil implemenentovat v PHP (já ten jazyk prostě nemám rád...). Čemu vlastně vadí, když ta funkce vrátí vždycky false?

[AHAHA]

Hmm, nevedel jsem, ze tato funkce jde i vypnout ...

Nicmene pokud funkce vraci false, pak funkcnost nebude nijak omezena, muze byt ale kompromitovana bezpecnost v pripade, ze anonymni internetovy uzivatel ma moznost zapisovat data ("otevrena wiki"). Pokud to mas na lokalu, nebo je nastavene heslo pro editaci, pak je to bezpecne i bez ctype_cntrl(). Funkce se pouziva na sanitizaci vstupu (odstraneni "kontrolnich znaku").

[Limoto]

Super, dík

[Bedňa]

Čau Limoto, v MoinMoin som robil jeden projekt, je to Python, veľká komunita, veľmi aktívny projekt.

[Ajoj]

ja používam TiddlyWiki. Úplne všetko je uskladnené v jednom JavaScriptovom súbore, takže pre fungovanie stačí prehliadač, ktorý zvláda JavaScript.