Dokuwiki – il Wiki orientato alla documentazione


…e non solo !

Poche settimane fa ero alla ricerca di un sistema poco complesso per documentare in modo collaborativo un software, che avesse anche la possibilità di esportare in diversi formati e di “versionare” il tutto. Ho pensato che cercare la soluzione software nella costellazione degli Wiki avrebbe risolto il mio problema… e così è stato. Vi presento:

Dokuwiki

E’ un Wiki, quindi presenta tutte le splendide qualità che caratterizzano questi strumenti; però, dopo averlo utilizzato, mi sono reso conto del suo effettivo valore. Queste sono le caratteristiche che, presentate nel sito web, hanno attratto la mia attenzione:

  • aderente agli standard
  • semplice da usare
  • orientato alla creazione di documentazione
  • indicato a team di sviluppo, gruppi di lavoro, piccole aziende
  • sintassi semplice
  • dati salvati in file di testo

Le si possono notare facilmente, anche dopo un primo rapido utilizzo.

Ma in più, aggiungo anche:

  • ottimo sistema di plug-in: vi sono letteralmente centinaia di moduli pronti da installare che aggiungono le più disparate funzionalità;
  • molte lingue supportate di default;
  • facilmente “skinnabile”: molti temi sono pronti per essere scaricati e provati, ma crearne uno nuovo non è un lavoro particolarmente complicato;
  • leggero e veloce: è possibile installarlo anche su server poco potenti; i requisiti sono un web server e PHP in versione 5.1.2 o superiore;
  • editor di sintassi wiki molto semplice grazie ad una toolbar essenziale ma piuttosto completa

Tutte le suddette caratteristiche rendono DokuWiki un applicativo server davvero versatile: non vedo controindicazioni nell’utilizzarlo come un vero e proprio CMS per il proprio sito web…. in molti lo fanno già.

Installazione

La versione stabile che viene consigliata per il download porta la data del 25 Dicembre 2009 ed è denominata “Lemming”.

Installare il software è un compito davvero rapido e semplice:

  • si scarica il file compresso contenente tutto il necessario;
  • lo si scompatta nel web server, in un’opportuna cartella;
  • si impostano proprietà e permessi corretti su file e directory. Ovviamente, essendo i dati salvati come file nel server, è necessario dare qualche permesso di scrittura in più del solito, abilitando la scrittura nella cartella data/ e sottocartelle nonché alla cartella conf/ all’utente con cui “gira” il webserver;
  • si punta il browser sulla URL dell’installer, qualcosa del tipo http://127.0.0.1/dokuwiki/install.php, si compila una form di pochi campi e il gioco è fatto.

Non resta che cancellare il file install.php e iniziare con il nuovo Wiki.

Un primo utilizzo

Per chi non è abituato ad utilizzare un Wiki, scrivo solo 2 semplici noticine da ricordare:

  1. la prima regola è: non si crea una pagina e poi la si link, ma viceversa: si crea il link, lo si clicca, e, al comparire della notifica di pagina non presente, di preme sul pulsante di creazione;
  2. la seconda regola è: essendo un formattatore di testi per HTML non in sintassi HTML, alcune semplici regole di formattazione vanno imparate, nonostante vi sia la toolbar che può aiutarvi molto.

Questo un esempio del mio personale DoluWiki:

====== Le mie cose da ricordare ======
{{http://bubbakk.ivellezza.it/wp-content/uploads/2008/12/bubbaavatar.jpg?50x50 |bubbakk}} Ciao,
sono sempre io.
Devo scrivermi tutto, così non rischio di perdere traccia di cosa faccio, rischiando di ripetere
operazioni già fatte. Inoltre raccolgo materiale tecnico che trovo in giro e commento con mie
esperienze dirette.

Se può essere utile anche a voi, accomodatevi pure, ma con cautela: non è detto che ciò che vada bene per
me faccia anche al caso vostro. Perciò usate tutte le info che trovate :!: a vostro rischio e pericolo.
  * [[amministrazione di sistema|amministrazione]]
  * [[comandi unix]]
  * [[software]]
  * [[diary]]
  * [[siti web interessanti|siti web]]

che poi, a livello visuale (con il tema di default), si presenta così:

il mio dokuwiki

Ci sarebbe molto da aggiungere, ma vi assicuro che con poco tempo potete avere la maggior parte del sistema sotto controllo. Non ho menzionato la gestione degli utente, il pannello di amministrazione né di come configurarlo, ma è tutto piuttosto intuitivo e, comunque, la documentazione a riguardo si spreca…. e ci mancherebbe altro, se non è ben documentato un Wiki … :-) !

Buon divertimento.

Se vuoi puoi esprimere un giudizio

, , , ,

  1. #1 di www.youtube.com il 30 agosto 2013 - 03:19

    Howdy! Quick question that’s totally off topic. Do you know how tto
    make your site mobile friendly? My blog looks weird when browsing from my iphone4.
    I’m trying too find a template or plugin that might
    be able to resolve his problem. If yyou have any recommendations, please share.

    With thanks!

    Review my homepage :: clash of clans hack android ios pro cheat working free (http://www.youtube.com)

  2. #2 di Marco il 16 aprile 2010 - 15:21

    Bell’articolo!

    a proposito…non funziona il link al sito di dokuwiki!

    • #3 di bubbakk il 16 aprile 2010 - 16:32

      ti ringrazio per i complimenti e per la segnalazione del broken link: ho messo a posto.

      ciao

      • #4 di Erik il 13 agosto 2012 - 13:52

        ehm, sicuro? a me non lo apre..

(non verrà pubblicata)