Questa è una vecchia versione del documento!
Indice
Configurazione del sito
Terminata l'installazione di DokuWiki si passa alla configurazione iniziale del sito. In questa fase si definiscono le impostazioni più importanti, il resto si può modificare in seguito.
Ok, ma dov'è DokuWiki?
L'indirizzo principale del nostro sito è:
nomeutente.altervista.org
Digitandolo viene visualizzata la pagina index.html
(creata automaticamente da AlterVista) come se avessimo digitato numeutente.altervista.org/index.html
. La pagina può essere modificata o rimossa ed è visibile sia da FileZilla che dal pannello web.
Se vogliamo raggiungere il nostro wiki l'indirizzo da digitare è:
numeutente.altervista.org/dokuwiki
Prima configurazione
Procediamo con la prima configurazione digitando l'indirizzo:
numeutente.altervista.org/dokuwiki/install.php
Si apre una pagina con titolo Dokuwiki Installer che serve a completare la prima installazione (in realtà è una configurazione, il software è già installato nel sito). La prima cosa da fare è cambiare la lingua da inglese a italiano selezionando it
nel menu a tendina in alto a destra.
Nella pagina dobbiamo specificare queste impostazioni (possiamo comunque cambiarle in un secondo momento):
- Nome Wiki: è il titolo del sito e comparirà in ogni pagina
- Abilita ACL: lasciare la spunta (permette di impostare delle restrizioni sull'uso del sito in base all'utente che ha fatto l'accesso)
- Amministratore: scegliere un nome utente per l'amministratore del wiki (non è l'utente di AlterVista)
- altri dati dell'amministratore del WiKi: nome completo, email, password (due volte!)
- Regole di accesso iniziali: scegliere
Wiki Pubblico
se il sito deve essere visibile a tutti ma modificabile solo dall'utente amministratore - non mettere la spunta su
Permetti agli utenti di registrarsi
- scegliere la licenza: quella predefinita di solito è la più indicata per questo tipo di siti (per approfondire leggere qui)
- spunta sulle statistiche: è indifferente
Premere il pulsante Salva
per terminare la prima configurazione. La pagina successiva raccomanda di cancellare install.php
(si può fare con FileZilla o dal pannello di AlterVista) prima di passare al nostro nuovo WiKi.
Primo accesso
Se abbiamo seguito il link al termine della prima configurazione dovremmo visualizzare la pagina di benvenuto (welcome) che ci invita a:
- creare la pagina principale
start
- familiarizzare con la sintassi
- decidere se personalizzare ulteriormente il sito (attivare la barra laterale, installare plugin)
- visitare il forum e la pagina di supporto ufficiale
La pagina di benvenuto è una delle pagine del WiKi ed è già presente quando facciamo il primo accesso. Cliccando sul link Indice
possiamo vedere le altre. Le pagine sono raggruppate secondo categorie (namespaces) che ci aiutano a strutturare il contenuto del sito. Le categorie sono riconoscibili dal link colore blu e possono essere espanse per mostrare le pagine che ne fanno parte. Quando creiamo una nuova pagina possiamo decidere se assegnarle una categoria, altrimenti la pagina farà parte della sezione principale del WiKi e non avrà nessuna categoria (una scelta che va più che bene per un WiKi semplice e con poche pagine).
Tra le pagine della categoria wiki
compaiono anche:
- la pagina
dokuwiki
, con link utili al sito ufficiale di Dokuwiki (in particolare il link al manuale) - la pagina
syntax
, che spiega come comporre una pagina
Indice
- pagina welcome → manuale completo in italiano (come scegliere la lingua)
- pagina dokuwiki
- pagina playground; a cosa serve
poi impostazioni
Configurazione Wiki
Premessa: così è giù usabile, molte delle cose che seguono sono opzionali
- pagina ACL: chi può fare cosa (scelta nell'installer ma modificabile, fare un esempio)
- configurazione WiKi (troppe cose, rischio di combinare guai). elenco solo le impostazioni più comuni/utili:
- nome pagina iniziale
- lingua
- sidebar (mah…)
- licenza
- disabilita azioni wiki
- URL rewrite (e .htaccess) cos'è e perché
Estensioni (plugin)
- cosa sono e perché servono
- come si installano
- facile se si ha pieno accesso al server
- più complicato con l'hosting → FTP
Plugin utili:
- cookielaw? (stupida legge EU)
- mathjax (formule)
- upgrade (non funzionerà…)
- folded (soluzioni nascosta)
- comment (bozze)
Backup?
Vedi anche https://www.dokuwiki.org/faq:backup
- FTP
- plugin (non funzionerà causa hosting)
Sicurezza e upgrade
Mia esperienza - vale poco - nessun problema. Upgrade a mano causa hosting, altrimenti plugin
Tips
- Strani problemi: provare a svuotare la cache (salvare le impostazioni)
- cancellare una pagina? modificarla cancellando tutto, controllare e sistemare i backlink
- rinominare le pagine? no copiarle e cancellare le vecchie, controllare e sistemare i backlink
- link a una sezione? editare sezione e copiare la parte di indirizzo dalla barra del browser
- interwiki (local e lib/images/interwiki wpi.gif)
- link dove si può/ha senso
- raccomandazioni su fonti
- raccomandazioni su immagini (https://en.wikipedia.org/wiki/Wikipedia:Preparing_images_for_upload)
- raccomandazioni su video