Questa è una vecchia versione del documento!
Indice
Funzionalità di base di DokuWiki
Creare una pagina
La prima pagina da creare è la pagina start
. Questa pagina ha un nome predefinito (start
appunto) ed è presente in ogni wiki creato con Dokuwiki; di fatto è l'homepage del sito, vcioè la pagina che viene visualizzata quando si digita l'indirzzo 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 si trovano nel sito).
Per creare la pagina start
:
- si digita l'indirizzo del sito (se la pagina
start
non è mai stata creata ci sarà il messaggio Questo argomento non esiste ancora) - si accede come amministratore
- si clicca sul pulsante a forma di matita nella barra a destra della pagina
La creazione di altre pagine è meno intuitiva:
- bisogna inserire in una pagina un () link alla pagina da creare
- seguire il link (rosso) che porta alla pagina
- crearla/modificarla come si è fatto per la pagina
start
Questo procedimento sembra inutilmente complicato ma assicura che ogni pagina sia collegata e raggiungibile da un'altra.
Comporre una pagina
Le pagine di Dokuwiki si creano direttamente sul sito, un po' come quando si scrive una email con Gmail (invece che con Outlook). Questo comporta vantaggi e svantaggi:
- tutto avviene attraverso il browser, disponibile ovunque
- l'interfaccia che si usa per comporre la pagina non somiglia a quelle di Word, Outlook, ecc.; in particolare l'interfaccia non segue il paradigma WYSIWYG tipico di questi programmi dove ogni modifica viene applicata e visualizzata immediatamente
- non è possibile copiare e incollare contenuti creati con altri software facilmente (vedi anche questa domanda nella sezione domande_e_risposte)
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:
- la formattazione_del_testo (grassetto, sottolineato, intestazioni, elenchi, ecc.)
- i collegamenti tra pagine del wiki (link interni) e a pagine web (link esterni)
- come inserire immagini, video, ecc.
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 opportuni. Il significato dei vari simboli è auto-intuitivo e 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
, che genera appunto un'anteprima della pagina senza salvarla.
Tra altri elementi dell'interfaccia troviamo:
- un link alla pagina con la sintassi (aprirlo in un'altra scheda se si vuole continuare a comporre la pagina)
- un'indicazione (in grigio) di quando è stato effettuato il salvataggio automatico della pagina (bozza)
- alcune opzioni avanzate per contrassegnare il tipo di modifica (poco utile)
- pulsanti per ridimensionare l'area di testo dove si compone la pagina
Formattazione e sintassi essenziale
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:
- applicare uno stile al testo (grassetto, corsivo, ecc.)
- inserire un'intestazione (un titolo) con un determinato livello (capitolo, paragrafo, ecc.)1)
- inserire collegamenti interni (link ad altre pagine del wiki)
- inserire collegamenti esterni (link a pagine web)
- inserire elenchi (numerati e puntati)
- inserire immagini (visualizzate nella pagina) o file (scaricabili)
- inserire caratteri speciali (faccine, lettere greche, ecc.)
- inserire una firma con autore e data
- inserire video
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 e modificare le pagine facendo piccole e frequenti modifiche e controllare con l'anteprima il risultato.
Una precisazione importante da fare è che il modo in cui è interpretato il testo per generare la pagina web può risultare imprevedibile; la cosa più evidente è che:
- gli spazi e le tabulazioni vengono vengono interpretati come un singolo spazio
- per separare i paragrafi non è sufficiente andare a capo ma bisogna interporre una riga vuota tra i due
- non è possibile controllare l'indentazione
Sezioni di una pagina
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 in paragrafi (ad esempio Unità 1, Capitolo 2, Paragrafo 4). Le sezioni sono utili 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).
Una volta salvata la pagina sarà possibile:
- modificarla per intero, col tasto nella barra laterale
- modificare solo parti di essa (se è stata divisa in sezioni usando titoli e intestazioni), con i bottoni
modifica
che compaiono alla fine di ogni sezione
Revisioni
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.
Link
Una delle caratteristiche più importanti di un wiki è il fatto che le pagine siano collegate tra di loro. In Dokuwiki esistono due tipi di collegamenti:
- quelli interni, ad altre pagine dello stesso wiki
- quelli esterni, ad altre pagine web2)
I collegamenti posso essere usati in tanti modi, ad esempio:
- per creare un indice nella pagina
start
- per linkare un sito web dove approfondire un argomento
- per creare un rimando ad altre pagine dove si è trattato o si tratterà un argomento
I link interni sono al tempo stesso:
- necessari, per spostarsi da una pagina all'altra
- utili, se usati come rimando ad un'altra pagina
I link esterni sono una risorsa per arricchire le pagine e suggerire contenuti.
Inserire un link è molto semplice:
- gli indirizzi (URL) dei link esterni vengono automaticamente convertiti in collegamenti
- in alternativa si può usare il bottone (o i simboli
[[
e]]
) e digitare l'indirizzo o il nome di una pagina del nostro wiki
Se ad esempio si vuole creare un link alla pagina introduzione
basterà digitare [[introduzione]]
descrizione/testo di collegamenti
- link a una sezione? editare sezione e copiare la parte di indirizzo dalla barra del browser
Varie
- 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
- raccomandazioni su fonti