Un semplice Wiki con DokuWiki: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
Riga 35: Riga 35:
# cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php
# cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php
</pre>
</pre>
A causa di un bug nell'installer del pacchetto Debian di DokuWiki [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=515675 Bug 515675] è necessario operare ancora qualche modifica alla configurazione di DokuWiki, altrimenti non sarà possibile effettuare il login come Amministratori del Wiki.<br/>
Apriamo innanzitutto il file <code>/etc/dokuwiki/local.php</code> e modifichiamo come segue le linee che riguardano l'uso delle ACL e la definizione dell'Amministratore:
<pre>
$conf['useacl']      = true ;
$conf['superuser']  = '@admin' ;
</pre>
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 <code>admin</code>.<br/>
A questo punto dobbiamo ancora creare un utente, definito da <code>userID/password</code> e assegnarlo al gruppo <code>admin</code>. Per prima cosa generiamo una password crittata:
<pre>
# grub-md5-crypt
Password:
Retype password:
$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.
</pre>
Poi modifichiamo il file <code>/etc/dokuwiki/users.auth.php</code> creando un nuovo account utente. Il formato della linea che definisce un utente in DokuWiki è:
<pre>
utente:MD5passwordHash:Nome Reale:email:gruppo1,gruppo2
</pre>
Perciò inseriamo nel file una riga come questa, stando attenti a riportare correttamente l'hash MD5 della password che abbiamo generato nel passaggio precedente:
<pre>
ferdy:$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.:Ferdy:ferdy@esempio.com:admin,user
</pre>
Ora possiamo aprire il nostro browser sulla pagina:
<pre>
http://indirizzo.ip.del.server/dokuwiki
</pre>
e fare login con le credenziali appena configurate. Dopo il login il pulsante <code>Admin</code> ci darà accesso all'area dedicata all'amministrazione del Wiki.

Versione delle 22:20, 23 feb 2010

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.