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.

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

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.

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 e dare struttura a una pagina utilizzando il linguaggio di formattazione di DokuWiki (vedremo più avanti cosa significa)

Nell'indice compare anche la pagina playground nella categoria playground. E' una pagina di prova dove si può sperimentare la sintassi prima di applicarla ad una pagina vera e propria.

Tutte le pagine elencate finora sono presenti in ogni installazione ma sono parte del nostro WiKi e possono essere cancellate o modificate a piacere (dal solo utente amministratore se abbiamo scelto “WiKi Pubblico” durante la prima configurazione).

Prima di creare la nostra prima pagina - se non l'abbiamo già fatto - accediamo come amministratore e vediamo la pagina di configurazione del 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)

Vedi anche https://www.dokuwiki.org/faq:backup

• FTP
• plugin (non funzionerà causa hosting)

Mia esperienza - vale poco - nessun problema. Upgrade a mano causa hosting, altrimenti plugin

• 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