Dokuwiki 2012-10-13 “Adora Belle” (da Amministrazione → raccolta dati o VERSIONE in FTP).

Installato nella sottodirectory ti della root. Per portare a termine l'installazione su altervista.org bisogna cambiare i permessi (chmod -R g+w) prima di copiare via FTP.

Imposto titolo, lingua, ACL. Cambio dmode/fmode (664/775) per non avere problemi nella cancellazione dei file anche se probabilmente non è necessario. Disabilito la registrazione automatica e imposto l'URL rewrite tramite .htaccess (vedi doc).

Cancello install.php e .htaccess.dist.

Modifico le impostazioni ACL per permettere la lettura a tutti.

Con altervista.org bisogna installare i plugin vanno installati a mano. Installo:

• comment per commentare parti del sorgente pagina

La soluzione più semplice è un veloce backup via FTP solo delle pagine con lftp. Ho creato uno script in bin/backupTic che esegue il comando (ce n'è una copia nella directory dei backup).

#!/bin/sh
backupPath=/home/leo/Documenti/lavoro/iti/2011-2012/tecnologia\ informatica/wiki/backup/pagineFTP/
oggi=`date +%F`
[ -d "$backupPath/$oggi" ] || mkdir "$backupPath/$oggi"
cd "$backupPath/$oggi"
lftp -e "mirror ti/data/pages && exit" -u user,password controlli.altervista.org

NB Le immagini e gli altri media non vengono copiati in questo modo.

Il backup via plugin non funziona con altervista.org.

La configurazione di default è nel file dokuwiki.php che non viene alterato. Tutti i parametri diversi dal default sono nel file local.php.

Almeno inizialmente possono contribuire al wiki solo gli utenti registrati e la registrazione automatica è bloccata.

Aggiunto un URL interwiki e la relativa icona per Wikipedia Italia (upload di interwiki.local.conf e wpi.gif). Perché la modifica abbia effetto bisogna pulire la cache.

Gli indirizzi email vengono mascherati (esadecimale) per contrastare lo spam.

• Per svuotare la cache cambiare (e ripristinare, volendo) un parametro della configurazione.
• Rinominare e spostare le pagine è difficile (il plugin pagemove non funziona). La procedura più semplice è duplicare le pagine, metter un link alla nuova pagina in quella vecchia e sistemare i backlink. Poi per cancellare una pagina eliminare tutto il contenuto e salvare.
• Per ottenere il nome di una sezione editarla e salvare. Nella barra dell'indirizzo del browser comparirà il nome della sezione.
• Scorciatoie da tastiera.
• Testare tutto sulla vecchia installazione prima.

• Implementare le ACL per permettere contributi esterni.

Il wiki ha una pagina principale, e delle categorie, accessibili dall'indice (pulsante in basso a destra).

In ogni pagina viene creato un indice automaticamente utilizzando i titoli delle sezioni con intestazione da 1 a 3. I titoli delle sezioni, per loro natura, non sono link. All'interno di ogni sezione si può però linkare a una pagina.

Per sua natura un Wiki non si presta a una lettura lineare mentre un corso è in genere strutturato linearmente. Per creare un collegamento esplicito tra un argomento e quello successivo si può mettere un link alla pagina seguente o a quella superiore.

• Struttura pagine: Accorpare in una pagina tutti gli argomenti di un capitolo e sfruttare la TOC (soluzione printer friendly)
• Indice: a mano: link alle pagine (capitoli), link alle sezioni delle varie pagine (paragrafi)
• Numerazione: numerazione dei capitoli e dei paragrafi come nel libro di testo
• Navigazione: aggiungere un link all'indice in fondo a ogni pagina
• Riferimenti: aggiungere una sezione riferimenti ogni volta che è utile e link a wikipedia
• Forma: impersonale
• Pagine incomplete: nascondere la parte incompleta col plugin folded o commentarla col plugin comment

Vedi anche i tips di dokuwiki.

NB L'uso dei link alle sezioni non è ben documentato ed è facile rompere i link (basta modificare il titolo di una sezione). Usarli con cautela.

Formattazione:

• per l'enfasi uso il grassetto
• in alternativa, per le cose meno importanti, il sottolineato
• per i nomi di file, i parametri, i bottoni e simili il monospace

Da wikipedia consigli su formato e dimensione dei file. Vedi anche qui.

Il formato SVG, raccomandato per diagrammi e grafici, non è supportato direttamente. Usando il plugin è comunque complicato.

Il JPEG va evitato tranne che per le foto.

Per i grafici usare PNG (lossless ma comunque efficace).