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 namespace curs
  • practica_1 seria una pàgina (document de text) dins del namespace modul_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 namespace curs
Dokuwiki sempre tractarà l'últim fragment (token) de la llista -l'última expressió separada pels dos punts- com un arxiu de text i la resta com a namespaces.

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 i practica_1 són namespaces
  • exercicis é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:

Aquest exemple només il·lustra les diferències entre una pàgina wiki i un espai de nom (namespace) que poden compartir un mateix nom. No feu servir mai el mateix nom per identificar una pàgina i un namespace als cursos de l'EAPC, ja que no segueix el model d'estructura general del curs.

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:

Estructura del wiki

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

Es recomana fer el enllaços de manera relativa, és a dir amb el format .: (punt + dos punts) per a fer referència a la posició actual.

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

>> Documents estructurats