Un semplice Wiki con DokuWiki

Introduzione

DokuWiki è un semplice motore wiki in PHP, utile quando si vuole approntare un sito interno di supporto, ad esempio per la documentazione aziendale, senza però volersi addentrare nella profondità di installazione e configurazione di un wiki complesso come MediaWiki. Ha una sintassi simile a quella di MediaWiki e questo ne facilita ancora più l'utilizzo per chiunque sia già abituato a scrivere su un Wiki.

Installazione

DokuWiki è presente nei repository Debian a partire da Debian Etch 4.0. Per installarlo, quindi, è sufficiente il comando:

# apt-get install dokuwiki

Fatto ciò, DokuWiki risulterà installato, ma non ancora pronto per l'utilizzo.

Configurazione

Per permettere l'accesso al wiki da parte di tutti i PC della LAN occorre modificare il file:

  • /etc/apache/conf/dokuwiki.conf se usate Apache
  • /etc/apache2/conf.d/dokuwiki.conf se usate Apache2

cambiando la voce 127.0.0.0 to All. Quindi riavviate Apache per fargli digerire le modifiche:

# /etc/init.d/apache restart

oppure

# /etc/init.d/apache2 restart

Per una configurazione completa, che offra anche la possibilità di amministrazione e di effettuare registrazioni utenti e login, occorre abilitare le ACL e apportare qualche cambiamento alla configurazione di default di DokuWiki.
Innanzitutto abilitiamo l'utente di Apache a leggere e scrivere i file di configurazione di DokuWiki:

# chown -R www-data /etc/dokuwiki/
# chown -R www-data /usr/share/dokuwiki/lib/

Poi copiamo i template per le abilitazioni degli utenti dove DokuWiki si aspetta di trovarli:

# cp /etc/dokuwiki/acl.auth.php.dist /var/lib/dokuwiki/acl/acl.auth.php
# cp /etc/dokuwiki/users.auth.php.dist /var/lib/dokuwiki/acl/users.auth.php

Infine copiamo il template per la configurazione locale:

# cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php

A causa di un bug nell'installer del pacchetto Debian di DokuWiki (Bug 515675) è necessario operare ancora qualche modifica alla configurazione di DokuWiki, altrimenti non sarà possibile effettuare il login come Amministratori del Wiki.
Apriamo innanzitutto il file /etc/dokuwiki/local.php e modifichiamo come segue le linee che riguardano l'uso delle ACL e la definizione dell'Amministratore:

$conf['useacl']      = true ;
$conf['superuser']   = '@admin' ;

Queste modifiche abilitano l'uso delle ACL all'interno del wiki, rendendo visibile il pulsante di Login nell'interfaccia web, e attribuiscono i poteri di superuser agli utenti membri del gruppo admin.
A questo punto dobbiamo ancora creare un utente, definito da userID/password e assegnarlo al gruppo admin. Per prima cosa generiamo una password crittata:

# grub-md5-crypt
Password:
Retype password:
$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.

Poi modifichiamo il file /etc/dokuwiki/users.auth.php creando un nuovo account utente. Il formato della linea che definisce un utente in DokuWiki è:

utente:MD5passwordHash:Nome Reale:email:gruppo1,gruppo2

Perciò inseriamo nel file una riga come questa, stando attenti a riportare correttamente l'hash MD5 della password che abbiamo generato nel passaggio precedente:

ferdy:$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.:Ferdy:ferdy@esempio.com:admin,user

Ora possiamo aprire il nostro browser sulla pagina:

http://indirizzo.ip.del.server/dokuwiki

e fare login con le credenziali appena configurate. Dopo il login il pulsante Admin ci darà accesso all'area dedicata all'amministrazione del Wiki.

Sintassi di DokuWiki

Testo

Di seguito sono riportati i principali stili applicabili al testo del wiki:

  • Bold
**bold**
  • Italic
//italic//
  • Sottolineato:
__sottolineato__
  • Monospaced:
''monospaced''
  • Pedici:
<sub>pedice</sub>
  • Apici:
<sup>apice</sup>
  • Testo cancellato:
<del>testo cancellato</del>

Paragrafi

I paragrafi vengono generati automaticamente ad ogni riga lasciata bianca.
Per andare a capo senza creare un nuovo paragrafo è sufficiente utilizzare alla fine della linea due backslash \\ seguiti da uno spazio bianco. Ad esempio:

Questo è del testo\\
in cui si va a capo