Translation(s): English - Français - Italiano


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:

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

Problemi specifici

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

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:

Queste domande non hanno tutte la stessa priorità:

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 e Lenny #backports, il wiki è completamente usabile dopo l'installazione, perciò iniziare ad usarlo e saltare la sezione #Lenny se non serve al proprio caso. Con Lenny senza backports, la configurazione iniziale è invece limitata perciò leggere la prossima sezione.

Lenny

Aggiornare il proprio sistema a Squeeze o usare il pacchetto da #backports! Se proprio non si vuole farlo continuare a leggere.

Per un completo accesso dalla LAN o da Internet, modificare il file */etc/apache/conf/dokuwiki.conf* e cambiare *127.0.0.0* in *All* per Apache2: /etc/apache2/conf.d/dokuwiki.conf

Sarà probabilmente necessario riavviare apache affinché la modifica abbia effetto.

Per una completa configurazione che includa il login e l'amministrazione dall'interno del wiki si devono abilitare le ACL e cambiare alcune configurazioni. Sono necessari i privilegi di root per usare i comandi.

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:

Vedere anche


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