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

Creazione di una pagina

Per creare una nuova pagina è sufficiente entrare nella modalità di modifica di una pagina esistente e creare un link (vedi più avanti) ad una pagina inesistente. Cliccando poi sul link la nuova pagina verrà automaticamente creata.

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

Link

  • Link esterni

I link esterni sono riconosciuti automaticamente, semplicemente digitando l'indirizzo del sito che si vuole linkare:

www.google.it

E' anche possibile utilizzare del testo come un link:

[[www.google.it|Questo testo punta a Google]]
  • Link interni

I link interni seguono la stessa sintassi dei precedenti. L'importante è linkare una pagina esistente.

[[pagina_del_wiki]]

oppure

[[pagina_del_wiki|Link alla pagina del wiki]]

Condivisioni Windows/Samba

DokuWiki supporta anche le condivisioni Windows e Samba:

[[\\server\condivisione|Nome della condivisione]]

Sezioni

DokuWiki supporta tre livelli di titoli/sezioni:

==== Livello 3 ====
=== Livello 4 ===
== Livello 5 ==

danno origine rispettivamente a:

Livello 3

Livello 4
Livello 5

E' anche possibile aggiungere una linea orizzontale digitando 4 o più trattini - consecutivi.

Liste e elenchi

E' possibile creare liste puntate utilizzando il simbolo * all'inizio di ogni elemento della lista.
E' possibile creare elenchi numerati utilizzando il simbolo - all'inizio di ogni elemento della lista.
E' possibile ramificare liste e elenchi includendo gli uni negli altri.