Pàgines i namespaces (espais de nom)
Diferències entre pàgines i espais de nom (namespaces)
A Dokuwiki podeu diferenciar pàgines i espais de nom (namespaces). Al sistema, una pàgina equival a un fitxer de text (pàgina.txt) i un namespace equival a un directori/carpeta.
En sintaxi wiki (codi), la representació gràfica de l'estructura següent
és:
curs:modul_1:practica_1
és a dir:
curs
seria un namespace (carpeta/directori)modul_1
seria un namespace (carpeta/directori) dins del namespacecurs
practica_1
seria una pàgina (document de text) dins del namespacemodul_1
Vegeu un segon exemple:
curs:inici
és a dir:
curs
és un namespace (carpeta/directori)inici
és una pàgina (document de text) dins del namespacecurs
Si barregeu els dos exemples anteriors i feu una vista d'arbre, el resultat és:
Anem a un tercer exemple. Vegeu l'expressió wiki següent:
curs:modul_1:practica_1:exercicis
Si seguiu la regla de namespaces i pàgines del Dokuwiki:
curs
,modul_1
ipractica_1
són namespacesexercicis
és l'arxiu de text.
Teniu, llavors, dos arxius que s'anomenen igual, practica_1
? No, tindreu un arxiu o pàgina (creada al primer exemple) i un namespace del mateix nom. De tal manera que, si escriviu l'enllaç:
[[curs:modul_1:practica_1]]
anireu a la pàgina practica_1
, però no al contingut del namespace practica_1
.
Una visualització de l'estructura definitiva us ajudarà a entendre millor aquest escenari:
Espais de nom (Namespaces)
Una de les dificultats per comprendre la metodologia de treball amb wikis és el concepte d'espai de noms o namespace. Ja hem esmentat anteriorment la similitud entre un namespace i un directori/carpeta i una pàgina de wiki amb un fitxer de text.
Crear un nou namespace
No podeu crear un namespace buit. Per crear un namespace, cal crear com a mínim una pàgina amb contingut. Per exemple, si creeu amb contingut la pàgina inici
seguint l'enllaç:
curs:modul_1:inici
També creareu de forma automàtica els namespaces curs
i modul_1
.
Esborrar un namespace
Esborrar un namespace és un procediment senzill: esborreu totes les pàgines wiki que conté. Consulteu l'apartat esborrar_pagines per saber com esborrar pàgines wiki.
Sintaxi wiki dels enllaços a namespaces/pàgines wiki
Continuant amb l'exemple de l'estructura anterior:
[[materials:curs:modul_1:practica_1]]
I la seva representació visual:
Al moment de crear una pàgina nova, hem de crear un enllaç que hi apunti, tal com us hem explicat a com_crear_una_pagina_nova. Posem per cas que ens trobem a la pàgina practica_1
i creem els enllaços següents:
Exemple: enllaç a una pàgina del mateix namespace
Enllaça amb la pàgina inici
des de l'actual namespace, és a dir, modul_1
En sintaxi wiki:
inici .inici .:inici
Exemple: enllaç a una pàgina de l'arrel del wiki
Enllaça amb la pàgina inici
del namespace arrel del wiki. En el nostre exemple, la pàgina inici
estaria al mateix nivell que el namespace materials
En sintaxi wiki:
:inici
Exemple: enllaç a una pàgina del namespace anterior
Enllaça amb la pàgina inici
del namespace anterior a l'actual, és a dir, modul_1
, per tant, enllaçaria amb la pàgina inici
del namespace curs
En sintaxi wiki:
..inici ..:inici .:..:inici
Exemple enllaç a una pàgina d'un altre branca des de l'arrel
Enllaça amb la pàgina inici
del namespace materials
. El namespace materials
es troba sota l'arrel del wiki
En sintaxi wiki:
materials:inici :materials:inici
Exemple: enllaç a una pàgina d'un subnamespace del namespace actual des de l'arrel
Enllaça a la pàgina inici
del namespace modul_1
. El namespace modul_1
es troba sota el namespace curs
; el namespace curs
es troba sota el namespace materials
; el namespace materials
es troba sota l'arrel del wiki. (aquesta opció es equivalent a l'exemple anterior)
En sintaxi wiki:
materials:curs:modul_1:inici :materials:curs:modul_1:inici
Exemple: enllaç a una pàgina d'un namespace d'un altre branca des del namespace actual
Enllaça amb la pàgina inici
que es troba sota el namespace faq
; faq
es troba sota el namespace annex
. annex
es troba sota el namespace actual, és a dir modul_1
En sintaxi wiki:
.annex:faq:inici ..:annex:faq:inici
Recomanem
Per exemple:
- .:pagina per a fer enllaços a pàgines del mateix namespace
- .:namespace:pagina per enllaçar amb págines d'un sub-namespace
- ..:pagina per accedir a una pàgina del namespace superior
- ..:namespace:pagina per accedir a una pàgina d'un namespace d'un altre branca des del namespace actual