Funzionalità avanzate di DokuWiki

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”).

Circa il software (gratuito) da utilizzare posso segnalare:

• lo Strumento di cattura di Windows che permette di salvare schermate, finestre, ecc. in formato .png (ad esempio per salvare un immagine di un circuito simulato con Multisim)
• Gimp per ridimensionare e ritoccare le immagini
• Inkscape per disegnare grafici, diagrammi, schemi (io lo uso per gli schemi, ad esempio in questa pagina)

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. La sintassi predefinita è quella Tex (LaTex) per la matematica (vedi questo manuale o questo PDF riassuntivo)¹⁾.

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.

Certe volte capita che qualche operazione di amministrazione/configurazione non vada a buon fine nonostante si sia seguito scrupolosamente documentazione ufficiale. A volte è sufficiente vuotare la cache di DokuWiki per “sistemare tutto”. Per farlo basta andare nella pagina di configurazione e salvare le impostazioni (anche senza aver fatto modifiche).

Gli it:interwiki sono collegamenti rapidi ad altri siti wiki. Ce ne sono di predefiniti, ad esempio per raggiungere la pagina su Pascal di Wikipedia (in inglese) basta scrivere [[wp>Blaise_Pascal]]. Per aggiungere altri collegamenti interwiki bisogna definirli nel file conf/interwiki.local.conf. La procedura è descritta chiaramente nella pagina sugli interwiki ma, ad esempio, se volessimo aggiungere un collegamento rapido alle pagine Wikipedia in italiano potremmo creare il file dokuwiki/conf/interwiki.local.conf e aggiungere la linea:

wpi       http://it.wikipedia.org/wiki/{NAME}