Un semplice Wiki con DokuWiki
 Versioni Compatibili ERRORE: valore non valido ( Debian Etch 4.0 Debian Lenny 5.0 Debian Squeeze Debian Sid )! Vedi qui. |
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.
Prerequisiti
Per poter installare DokuWiki è necessario possedere un web server già configurato e completo di supporto PHP. Si veda ad esempio una di queste guide:
- Installare un ambiente LAMP: Linux, Apache2, SSL, MySQL, PHP5
- Installare un ambiente LAMP: Linux, Apache, SSL, MySQL, PHP4
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.confse usate Apache/etc/apache2/conf.d/dokuwiki.confse 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.
Tabelle
Per creare ad esempio una tabella di 4 righe e 3 colonne, in cui la prima riga rappresenta l'intestazione delle celle, si utilizzi la seguente sintassi:
^ Heading 1 ^ Heading 2 ^ Heading 3 ^
| Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |
| Row 2 Col 1 | some colspan (note the double pipe) ||
| Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 |
Link esterni
--Ferdybassi 23:58, 23 feb 2010 (CET)