====== 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

{{.:namespaces9.png?550|}}

és:

<code>
curs:modul_1:practica_1
</code>

é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:

{{.:namespaces10.png?350|}}

<code>
curs:inici
</code>

és a dir:

  * ''curs'' és un **namespace** (carpeta/directori)
  * ''inici'' és una **pàgina** (document de text) dins del **namespace** ''curs''


<note important>
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.
</note>

Si barregeu els dos exemples anteriors i feu una vista d'arbre, el resultat és:

{{.:namespaces11.png?550|}}

Anem a un tercer exemple. Vegeu l'expressió wiki següent:

<code>
curs:modul_1:practica_1:exercicis
</code>

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ç:

<code>
 [[curs:modul_1:practica_1]]
</code>

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:

{{.:namespaces8.png?550|}}

<note warning>
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.
</note>







===== 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ç:

<code>
curs:modul_1:inici
</code>

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 [[.:operacions_basiques#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:

<code>
[[materials:curs:modul_1:practica_1]]
</code>

I la seva representació visual:

{{.:namespaces1.png?550|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 [[.:operacions_basiques#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''

{{.:namespaces2.png?250|}}

En sintaxi wiki:

<code>
  inici
 .inici
.:inici
</code>

==== 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**


{{.:namespaces3.png?250|}}

En sintaxi wiki:

<code>
 :inici
</code>


==== 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''

{{.:namespaces4.png?250|}}

En sintaxi wiki:

<code>
   ..inici
  ..:inici
.:..:inici
</code>


==== 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

{{.:namespaces5.png?250|}}

En sintaxi wiki:

<code>
  materials:inici
 :materials:inici
</code>


==== 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)


{{.:namespaces6.png?250|}}

En sintaxi wiki:

<code>
  materials:curs:modul_1:inici
 :materials:curs:modul_1:inici
</code>


==== 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''

{{.:namespaces7.png?250|}}

En sintaxi wiki:

<code>
  .annex:faq:inici
..:annex:faq:inici
</code>


===== Recomanem =====

<note important>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.</note>

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 
 

[[wiki:miniguia:estructura| >> Documents estructurats]]