Indico di seguito alcuni esempi sulla creazione delle pagine
Per mantenere ordinato il catewiki ed anche per permettere agli utenti di trovare facilmente quello che è stato scritto, c'è bisogno di organizzare la documentazione che viene prodotta. Qualsiasi wiki è organizzato in categorie e pagine; possiamo dire che le cartelle corrispondono alle categorie, e i files alle pagine.
Ad esempio: Voglio creare la pagina “I miei incontri di catechismo” per poter volta per volta scrivere un diario degli incontri.
In catewiki dovrò mettere questa pagina nella cartella “catechesi comunione” che già è stata predisposta da me. (Come faccio a sapere quali sono le cartelle già esistenti ? Basta andare all'Indice)
Categorie
Una categoria è simile ad una cartella, mentre i nomi pagine sono simili ai file.
In DokuWiki è possibile usare le categorie per classificare le proprie pagine. Per i nomi delle categorie valgono le stesse restrizioni dei nomi pagine.
L'installazione predefinita di DokuWiki include due categorie: playground e wiki.
Creazione di categorie
Non è necessario creare le categorie separatamente, si creano semplicemente pagine con i due punti nel nome pagina. Il blocco di testo dopo gli ultimi due punti sarà il nome della pagina stessa, mentre tutti gli altri blocchi di testo saranno categorie. Tutte le categorie utilizzate nel nome pagina che non esistono ancora saranno create automaticamente da DokuWiki.
(In DokuWiki le pagine vengono create come in ogni altro wiki. È sufficiente creare un collegamento a una pagina non esistente, si segue il collegamento, e si fa clic su Crea questa pagina.)
Aggiungere pagine.
Examples: example .example .:example si riferisce alla pagina “example” nella categoria corrente. :example si riferisce alla pagina “example” nella categoria radice. ..example ..:example .:..:example si riferisce alla pagina “example” nella categoria genitrice. wiki:example si riferisce alla pagina “example” nella categoria “wiki”. La categoria “wiki” si trova nella categoria radice. ns1:ns2:example :ns1:ns2:example si riferisce alla pagina “example” nella categoria ns2. La categoria ns2 si trova nella categoria ns1; la categoria ns1 si trova nella categoria radice. .ns1:ns2:example .:ns1:ns2:example si riferisce alla pagina “example” sotto la categoria ns2. La categoria ns2 si trova sotto la categoria ns1; la categoria ns1 si trova sotto l'attuale categoria. ..ns1:ns2:example ..:ns1:ns2:example si riferisce alla pagina “example” nella categoria ns2. La categoria ns2 si trova sotto la categoria ns1; la categoria ns1 si trova allo stesso livello dell'attuale categoria (cioè sia ns1 che la categoria corrente si trovano nella stessa categoria genitrice). .ns1:ns2: si riferisce alla pagina “start” nella categoria ns2. La categoria ns2 si trova sotto la categoria ns1; la categoria ns1 si trova sotto l'attuale categoria.
(Alla pagina predefinita può essere associato un nome diverso da “start” regolando l'opzione di configurazione startpage.)
Dunque: La sintassi per il collegamenti interni relativi ed assoluti non è unica ed è complessa in relazione alle convenzioni per categorie e nomi di file. I percorsi sono assoluti se e solo se iniziano con ”/”. I collegamenti sono assoluti se e solo se hanno come prefisso ”:” o non hanno prefisso ma hanno un intermedio ( o suffisso) ”:” I collegamenti relativi alla categoria corrente possono anche iniziare con ”.” o ”.:” (”..” o ”..:” per la categoria genitrice). Eliminare categorie
Quando tutte le pagine all'interno di una categoria vengono rimosse la categoria logicamente non esisterà più. DokuWiki di solito elimina anche le cartelle attualmente vuote. Come rinominare categorie? Manualmente
Per rinominare una categoria si dovrà:
Rinominare le cartelle che rappresentano le categorie in:
* data/pages
* data/media (se esiste)
Rimuovere i metadata per la categoria sotto data/meta
Rimuovere i dati attic per la categoria sotto data/attic (o spostarli, se si vogliono conservare le revisioni precedenti)
Tramite Plugin
Si può usare il plugin PageMove per spostare ogni pagina dalla vecchia categoria alla nuova. Si consulti la documentazione per vedere se corrisponde alle vostre necessita. Collegamenti predefiniti per categorie
E' possibile collegare un file predefinito di una categoria terminando il collegamento con due punti: bar. Quale pagina richiama il collegamento dipende dall'esistenza di alcuni nomi di file. Per bar sono controllate le seguenti pagine:
foo:bar:$conf['start'] foo:bar:bar foo:bar
Le pagine sono controllate in quest'ordine e quella che verrà trovata prima sarà collegata. Questi collegamenti richiamano una sola pagina.