Purtroppo una delle limitazioni del servizio di hosting di AlterVista è che alcune operazioni molto importanti nella gestione di un sito sono più complicate del previsto, in particolare non è possibile fare il backup del sito o aggiornare DokWiki con gli plugin, direttamente dalla pagina di amministrazione di DokuWiki. In entrambi i casi bisogna usare un client FTP. Non è complicato ma solo un po' più scomodo:

• per fare il backup del sito basta copiare la cartella dokuwiki dal server al nostro PC con FileZilla
• per aggiornare DokuWiki, dopo aver fatto una backup, sovrascrivere la cartella scaricando l'ultima versione del software e caricandola con FileZilla (la cartella con le pagine, le immagini e la configurazione non dovrebbero andare perse)

Informazioni più dettagliate si trovano nelle pagine del sito ufficiale: faq:backup e install:upgrade.

Non dimentichiamo mai che “il backup è quella cosa che andava fatta prima”

Le limitazioni del servizio di hosting non permettono di installare i plugin direttamente dalla pagina di amministrazione del sito. Bisogna allora:

• cercare i plugin nella pagina del sito ufficiale
• leggere la relativa pagina dedicata al plugin e in particolare le note sull'installazione
• scaricare il plugin nel PC
• scompattarlo e rinominare la cartella come indicato (DokuWiki segnala l'errore nel caso e suggerisce come rinominare il file)
• caricare la cartella del plugin sul server con FileZilla (i plugin vanno nella cartella dokuwiki/lib/plugins/ del server)
• controllare che il plugin sia presente nella pagina delle extensions

Plugin raccomandati:

• cookielaw, per la conformità con la (stupida) legge EU sui cookie
• comment, per fare in modo che una sezione della pagina sorgente non venga visualizzata nella corrispondente pagina wiki (utile per le bozze)
• folded per nascondere parte della pagina e renderla visibile con un click (utile per domande e risposta prima nascosta, poi visibile)
• mathjax, per le formule
• vshare, per inserire video all'interno delle pagine (vedi questa pagina per un esempio)

Per inserire un'immagine un una pagina si può usare l'apposito bottone (a forma di quadro) nell'editor e

• caricare (Seleziona File e Upload) una pagina dal PC
• selezionare una delle immagini caricate in precedenza elencate nella finestra (cliccare le categorie a sinistra se l'elenco è vuoto nonostante si siano caricate immagini)
• nella finestra Impostazioni link scegliere la dimensione immagine adeguata (in genere conviene ridimensionare l'immagine su PC e scegliere la O di dimensione originale)

E' possibile anche inserire immagini senza caricarle nel proprio sito ma “linkandole” da altri siti web, tuttavia non è una buona pratica ed è considerato scorretto.

Qualche raccomandazione tecnica sulle immagini che inseriremo (vedere anche le indicazioni di Wikipedia:

• usare il formato jpeg per le foto e il formato .png per diagrammi, schemi e simili
• controllare sempre la dimensione del file, se è maggire di 1MB ridimensionare l'immagine (100KB è un valore adeguato)
• non caricare immagini con risoluzione elevata, 1024×1024 massimo, meglio se meno

Seguendo queste indicazioni si ottimizza la qualità dell'immagine per il web (per le foto da stampare è tutto un altro discorso) e il “traffico internet” (non vogliamo aspettare dei secondi o consumare dati del piano telefonico per scaricare un'immagine che sarà comunque ridimensionata per “entrare nello schermo”).

Esistono due modi di proporre un video nelle pagine wiki:

• inserire un link alla pagina del video (youtube, vimeo, ecc.)
• inserire il video nella pagina con il plugin plugin:vshare

Alcuni siti web (Wikipedia ad esempio) mostrano le formule come semplici immagini. Questa soluzione funziona sempre ma è “bruttina”, perché le immagini - se ridimensionate - e costringe ad usare un software a parte per creare l'immagine della formula.

La soluzione migliore per inserire formule in DokuWiki è usare il plugin mathjax.

Una volta installato il plugin permette di inserire delle formule, seguendo una particolare sintassi, contenute tra due simboli $. Quando la pagina viene generata DokuWiki trasforma il testo inserito in una formula.

E' una scelta delicata ed è descritta in questa pagina della documentazione ufficiale.

I risultati migliori si ottengono impostando l'opzione .htaccess nella configurazione del wiki, ma prima bisogna modificare il file .htaccess nella cartella dokuwiki del server secondo le indicazioni riportate qui.

• Strani problemi: provare a svuotare la cache (salvare le impostazioni)
• interwiki (local e lib/images/interwiki wpi.gif)