Traduzioni: English - Français - Italiano

Contents

DokuWiki

DokuWiki

DokuWiki è disponibile nel repository Debian ufficiale ed è installabile usando i consueti strumenti Debian.

Specificità del pacchetto Debian

Contrariamente ad un'installazione standard, il pacchetto Debian:

è gestito dal gestore dei pacchetti (ovviamente), che permette di ottenere gli aggiornamenti normali e quelli di sicurezza insieme a quelli del sistema;
ha percorsi specifici, fondamentalmente:
- la directory radice di DokuWiki è /usr/share/dokuwiki,
- i dati del wiki sono /var/lib/dokuwiki/data,
- la configurazione è /etc/dokuwiki;
è inizialmente configurato dal gestore di pacchetti, non dalla pagina web di installazione;
gestisce la configurazione del server web per dare accesso anche al wiki;
usa le librerie pacchettizzate invece di alcune incorporate come Geshi e SimplePie.

Alcune delle specificità derivano dal sistema di gestione dei pacchetti stesso, alcune sono per conformità con la Debian policy. Ciò ha:

alcuni vantaggi: integrazione nel sistema, facile configurazione iniziale;
alcuni svantaggi: percorsi dei file non usuali e alcuni bug specifici.

Problemi specifici

L'elenco completo dei bug segnalati per il pacchetto Debian può essere trovato qui. Ecco i problemi più importanti che è possibile incontrare:

la funzionalità RSS non funziona con la versione Squeeze di Debian, a causa di una incompatibilità delle librerie; se tale funzionalità è necessaria, si deve usare una versione più recente da #backports oppure installare DokuWiki a mano senza usare il pacchetto Debian.
Alcuni plugin possono non funzionare a causa della disposizione particolare dei file.

Segnalazioni di bug

Segnalare i bug nel pacchetto usando il Sistema di tracciamento dei bug di Debian. Vedere anche l'attuale elenco dei bug.

Installazione

   sudo apt-get install dokuwiki

I file di configurazione sono in /etc/dokuwiki/.

I file dei dati sono in /var/lib/dokuwiki/.

Il dokuwiki è disponibile su: http://localhost/dokuwiki

A partire da Debian Lenny e Squeeze con #backports, vengono poste alcune domande per la configurazione iniziale:

i server web da configurare e se riavviarli o meno per applicare la configurazione;
il percorso web dove deve essere disponibile il wiki, cioè /dokuwiki, /wiki o qualsiasi altro si desideri;
il tipo di accesso per il wiki: host locale, LAN o Internet;
- se si sceglie LAN, l'intervallo di indirizzi IP della LAN;
se rimuovere o meno i dati del wiki quando il pacchetto viene eliminato;
se permettere o meno la configurazione e l'amministrazione dei plugin dall'interfaccia web;
il titolo, la licenza e l'ACL del wiki;
il nome utente, la password, il nome reale e l'indirizzo di posta elettronica dell'amministratore del wiki.

Queste domande non hanno tutte la stessa priorità:

bassa: quelle i cui valori predefiniti sono giusti nella maggior parte dei casi, per esempio il percorso web (predefinito /dokuwiki);
media: quelle con un valore predefinito ragionevole, per esempio il nome utente dell'amministratore del wiki (predefinito “admin”);
alta: quelle senza un valore predefinito ragionevole, per esempio la password dell'amministratore (nessun valore predefinito!).

Il pacchetto pone solo le domande la cui priorità è più alta di quella scelta globalmente come interessante; si può impostare tale parametro riconfigurando il pacchetto debconf: # dpkg-reconfigure debconf

Per esempio, se si sceglie di essere interessati solamente alle domande con alta priorità, non tutte le domande del pacchetto DokuWiki verranno poste. Si può sempre riconfigurare il pacchetto dokuwiki stesso per ottenere tutte le domande: # dpkg-reconfigure dokuwiki

Backports

Le versioni del pacchetto possono essere un po' datate, specialmente se si sta usando una vecchia versione di Debian come Lenny (oldstable). Pacchetti aggiornati sono disponibili usando il repository backports. Per esempio, per Lenny:

# echo "deb http://backports.debian.org/debian-backports lenny-backports main" >> /etc/apt/sources.list
# apt-get update
# aptitude install dokuwiki/lenny-backports

Uso

Dopo l'installazione del pacchetto, il proprio dokuwiki è disponibile all'indirizzo http://localhost/dokuwiki/ (sostituire //localhost// con il nome o l'indirizzo IP del proprio server se non è sul computer locale).

A partire da Debian Squeeze il wiki è completamente usabile dopo l'installazione.

Configurazione della gestione di più siti (farm) con host virtuali

Questa opzione è disponibile solo nella versione 0.0.20101107-4 o successiva. Verrà mostrato come creare due siti dockuwiki in un'installazione basata su host virtuali.

Host virtuali

Creare due host virtuali minimali (in questo esempio usando un server apache):

/etc/apache2/sites-available/gatto

<VirtualHost *:80>
   ServerName gatto.propriodominio.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

/etc/apache2/sites-available/cane

<VirtualHost *:80>
   ServerName cane.propriodominio.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

Abilitare i siti:

sudo a2ensite gatto cane

E ricaricare il proprio server

sudo service apache2 reload

Aggiungere ulteriori direttive ai propri host virtuali se necessario (questa parte viene omessa per semplificare l'esempio). Guardare in /etc/dokuwiki/apache.conf per una configurazione predefinita più completa.

Creare siti dokuwiki

Per creare un nuovo sito, si può usare il comando dokuwiki-addsite(1):

sudo dokuwiki-addsite gatto.propriodominio.tld
sudo dokuwiki-addsite cane.propriodominio.tld

Si hanno ora due dokuwiki: uno su http://gatto.propriodominio.tld e l'altro su http://cane.propriodominio.tld. Condividono il codice dokuwiki, ma hanno dati e configurazioni indipendenti.

I file di configurazione sono in /etc/dokuwiki/farm/gatoo.propriodominio.tld e /etc/dokuwiki/farm/cane.propriodominio.tld.

I file dei dati sono in /var/lib/dokuwiki/farm/gatto.propriodominio.tld e /var/lib/dokuwiki/farm/cane.propriodominio.tld.

Rimuovere siti dokuwiki

sudo dokuwiki-delsite cane.propriodominio.tld

Domande e risposte

Si possono porre domande qui:

? Dove sono le directory dei dati?

In /var/lib/dokuwiki per essere conforme alla Debian Policy e coerenti con la struttura generale del sistema.

? È possibile avere un breve elenco di tutti i passi necessari per installazioni multiple (separate) che condividono lo stesso codice?

Implementare la farm all'interno del pacchetto Debian è un obiettivo di medio percorso, non ancora raggiunto. Restare in ascolto.

? È possibile installarlo su Ubuntu.

Sì, perché ogni pacchetto Debian finisce anche in Ubuntu. Non è direttamente mantenuto, però perciò le cose potrebbero non funzionare.

? Come ripristinare i dati da una vecchia installazione su un'altra macchina?

Copiare /var/lib/dokuwiki/data dalla vecchia installazione nella nuova. Installare i plugin necessari a mano.

? Se si è installato usando il pacchetto Debian, qual è il metodo corretto per aggiornare DokuWiki?

Aggiornare il sistema (da Lenny a Squeeze per esempio) o usare un #backport.

? Si è installato usando il pacchetto Debian, ma ora (per una ragione qualsiasi, ad esempio per accedere prima alla versione più recente) si desidera usare una versione di DokuWiki scaricata (che non è compatibile con la Debian Policy).

Prendere DokuWiki, installarlo seguendo le istruzioni regolari. Poi ripristinare i vecchi contenuti:

mettere i contenuti del vecchio /var/lib/dokuwiki/data nella directory data della nuova installazione di DokuWiki.
Si può anche provare a ripristinare:
- i file di configurazione, che sono in /etc/dokuwiki;
- i propri plugin, che sono in /var/lib/dokuwiki/lib/plugins.

Vedere anche

CategoryProposedDeletion: This page largely duplicates http://www.dokuwiki.org/install:debian

itDokuWiki