Questa è una vecchia versione del documento!
Indice
Funzionalità avanzate di DokuWiki
Backup aggiornamenti
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”
Plugin consigliati e installazione via FTP
Le limitazioni del servizio di hosting non permettono di installare i plugin direttamente dal sito. Bisogna allora:
- cercare i plugin nella pagina del sito ufficiale
- leggere la relativa pagina, in particolare le note sull'installazione del plugin
- scaricare il plugin nel PC
- scompattarlo e rinominare la cartella come indicato
- caricare la cartella del plugin via FTP con FileZilla (i plugin vanno nella cartella
dokuwiki/lib/plugins/
del server) - controllare che il plugin sia presente nella pagina delle extensions ed eventualmente configurarlo nella pagina di configurazione del Wiki
Plugin raccomandati:
- plugin:cookielaw, per la conformità con la (stupida) legge EU sui cookie
- plugin:comment, per fare in modo che una sezione della pagina sorgente non venga visualizzata nella corrispondente pagina wiki (utile per le bozze)
- plugin:folded per nascondere parte della pagina e renderla visibile con un click (utile per domande e risposta prima nascosta, poi visibile)
- plugin:mathjax, per le formule
- plugin:vshare, per inserire video all'interno delle pagine (vedi https://leonardocanducci.org/wiki/sta/arduino_7 per un esempio)
Immagini
Per inserire un'immagine un una pagina si può usare l'apposito bottone (a forma di quadro) nell'editor e
- caricare (
Seleziona File
eUpload
) 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 laO
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”).
Video
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
Formule
URL rewrite
Se serve lo spiego…
Altro
- Strani problemi: provare a svuotare la cache (salvare le impostazioni)
- interwiki (local e lib/images/interwiki wpi.gif)