La prima pagina da creare è la pagina start. Questa pagina è presente in ogni wiki creato con Dokuwiki ed è l'homepage del sito, cioè la pagina che viene visualizzata quando si digita l'indirizzo del sito. Qui di solito si mettono le informazioni generali sul sito e un indice o una serie di link alle pagine più importanti (alcune raccomandazioni su come strutturare questa pagina e l'intero wiki si trovano nel sito di Dokuwiki).
Per creare la pagina start:
start non è mai stata creata ci sarà il messaggio Questo argomento non esiste ancora)La creazione delle altre pagine è meno intuitiva:
startQuesto procedimento sembra inutilmente complicato ma assicura che ogni pagina sia collegata ad altre e quindi raggiungibile.
Le pagine di Dokuwiki si creano direttamente sul sito, un po' come quando si scrive una email con Gmail. Questo comporta vantaggi e svantaggi:
Le pagine del wiki sono salvate come semplici file di testo (si trovano nella cartella dokuwiki/data/pages/ sul server) dove oltre al testo sono presenti altri simboli e caratteri speciali che specificano:
Quello che vediamo quando componiamo una pagina è il contenuto esatto di questi file di testo, compresi questi simboli. Per comporre una pagina allora bisogna digitare il testo - come faremmo con Word - e “abbellirla” - formattando il testo, inserendo link, immagini, ecc. - inserendo dei caratteri speciali secondo la particolare sintassi di Dokuwiki. Questa operazione è largamente facilitata da una serie di bottoni presenti nella finestra di composizione della pagina che inseriscono i simboli giusti. Il significato dei bottoni è auto-esplicativo ed è anche descritto da un suggerimento (tooltip) che compare quando spostiamo il mouse sopra l'icona.
Per produrre la pagina vera e propria occorre salvare le modifiche cliccando il pulsante Salva in basso a sinistra. Se invece si desidera solo verificare l'aspetto della pagina mentre si finisce di comporla si può premere il pulsante Anteprima per generare appunto un'anteprima della pagina senza salvarla e uscire dall'editor.
Nell'interfaccia sono presenti altri elementi, tra cui:
Le opzioni più importanti per la formattazione della pagina sono disponibili nella barra degli strumenti posta subito sopra all'area di testo dove si compone la pagina. Qui troviamo bottoni per:
Premendo i bottoni compaiono dei simboli speciali nel testo che, interpretati da Dokuwiki al momento di generare la pagina, producono l'effetto desiderato. Ad esempio premendo il bottone per il grassetto compaiono una coppia di simboli ** che, posti attorno a del testo, fanno sì che nella pagina quella parte di testo venga resa in grassetto (lo stesso effetto si può ottenere digitando manualmente i simboli con la tastiera o usando apposite scorciatoie). Per una spiegazione dettagliata sulla sintassi e le opzioni disponibili per personalizzare una pagina fare riferimento alla pagina ufficiale della documentazione di Dokuwiki.
Il modo migliore per prendere confidenza con la sintassi di Dokuwiki è utilizzare la pagina playground per fare delle prove. In linea generale comunque è una buona prassi creare/modificare le pagine facendo piccole e frequenti modifiche e controllare il risultato con l'anteprima prima di salvare.
Una volta familiarizzato con l'interfaccia la creazione delle pagine sarà molto semplice; tuttavia il modo in cui è interpretato il testo può risultare strano; la cosa più evidente è che:
Tutti questi comportamenti imprevedibili sono in realtà dovuti al fatto che quella che creeremo è una pagina web, non un documento impaginato a piacere.
Di solito una pagina è divisa in più sezioni in base a come sono stati utilizzate le intestazioni (i titoli); potremmo avere un titolo a inizio pagina, poi più capitoli divisi a loro volta suddivisi in paragrafi (ad esempio Unità 1, Capitolo 2, Paragrafo 4). Le sezioni sono fondamentali per dare struttura al testo e sono modificabili e raggiungibili (linkabili) individualmente (ad esempio questo è un link non all'intera pagina ma ad una sua sezione). Sarà possibile allora:
modifica che compaiono alla fine di ogni sezioneUna delle caratteristiche più importanti di un wiki è il fatto che le pagine siano collegate tra di loro. In Dokuwiki esistono due tipi di collegamenti:
I collegamenti posso essere usati in tanti modi, ad esempio:
startI link interni sono necessari, per spostarsi da una pagina all'altra; quelli esterni sono una risorsa per arricchire le pagine e suggerire contenuti.
Inserire un link è molto semplice:
[[ e ]]) e digitare l'indirizzo o il nome di una pagina del nostro wiki
Ad esempio se si vuole creare un link alla pagina introduzione del wiki basterà digitare [[introduzione]]; se invece si vuole creare un link al sito del nostro istituto basterà digitare www.ittcesena.gov.it e verrà generato un collegamento.
Quando si crea una pagina o un collegamento il nome della pagina/collegamento compare per intero. Questo non è sempre ottimale perché il nome potrebbe essere troppo lungo, poco descrittivo, o modificato automaticamente per rispettare la sintassi Dokuwiki. In tutti questi casi si può inserire un testo alternativo più chiaro/sintetico/leggibile. Il testo si inserisce all'interno del link separandolo con il simbolo |; ad esempio un link complicato come https://it.wikipedia.org/wiki/Blaise_Pascal può essere ridotto alla sola parola Pascal digitando [[https://it.wikipedia.org/wiki/Blaise_Pascal|Pascal]] (notare la parte finale del link separata dal simbolo |). Il testo alternativo non si usa solo per i link esterni, ma anche per link interni, immagini, file, ecc.
Il modo più veloce per ottenere l'indirizzo di una sezione di una pagina (ad esempio un paragrafo) e non dell'intera pagina è quella di premere il bottone modifica per la sezione che interessa e poi premere il bottone Annulla senza aver fatto nessuna modifica. Nella barra degli indirizzi del browser ci sarà l'indirizzo completo di pagina e sezione dove la parte finale è quella che ci interessa (il simbolo # separa pagina e sezione).
Dokuwiki non permette di cancellare una pagina con un semplice click. Quando serve eliminare completamente una pagina occorre:
SalvaPrima di procedere è bene controllare i backlink alla pagina che stiamo per cancellare per non lasciare collegamenti interrotti nelle altre pagine del wiki.
Anche in questo caso non è possibile farlo con un click ma bisogna crearne una nuova con il contenuto della vecchia. Si procede così:
Una caratteristica interessante dei wiki è quella di conservare le versioni precedenti delle pagine. Per visualizzarle basta cliccare sul bottone a forma di orologio nella barra laterale.
Conservare uno storico delle versioni precedenti permette eventualmente di ripristinare, integrare e correggere le pagine senza preoccuparsi di avere più versioni o di perdere le modifiche.
Quando si visita un sito fatto con Dokuwiki senza aver fatto l'accesso (nome utente e password) non è possibile modificare le pagine e il pulsante Modifica pagina è sostituito dal pulsante Mostra sorgente. Premendo questo tasto viene mostrata una pagina con il testo (in grigio) che, elaborato da Dokuwiki, produce la pagina. Questo strumento è utile se si vuole prendere spunto per la formattazione e in generale la sintassi dalle pagine realizzate da altri.