Taula de continguts

Namespaces

Ho sentim però aquesta pàgina no està completa. Si us plau, ajudeu amb la traducció.

Namespaces

Un «namespace» és similar a un directori o una carpeta, mentre els «pagenames» són similars a arxius.

La DokuWiki pot usar els anomenats «namespaces» per categoritzar les seves pàgines. És una classe o més ben dit un nom d'espai.

Al instal·lar la DokuWiki, només es crea un «namespace» anomenat «wiki».

Creant Namespaces

Vostè no necessita crear namespaces explícitament (es a dir, no té de donar l'ordre per crear-los); simplement escriu les pàgines amb els dos punts (:) al nom de la pàgina (pagename). La paraula que apareix després dels dos punts serà el nom d'aquesta pàgina, mentre que les altres paraules seran namespaces. Tots els namespaces usats amb el seu nom de pàgina que no existeixin al moment, seran creats per DokuWiki automàticament.

Exemple:
Usted está creando información respecto a la historia de los computadores: una parte está dirigida a la generaciones tecnológicas, y la otra a computadores que marcaron puntos claves (hitos) en la historia de los PC.
Usted creará dos paginas independientes : Computadores de primera generación, y el Apple PC.
Los organiza así: Historia:Generaciones:Primera_Generacion Historia:Hitos:Apple_PC
Las paginas creadas son Primera_generacion y Apple_pc, serán creadas por usted pero los namespaces: 'Historia', 'Generaciones' e 'Hitos' serán creados por DokuWiki si no existen.

Ejemplos:
ejemplo .ejemplo .:ejemplo	se refieren a una pagina «ejemplo» en el namespace activo.
:ejemplo	se refiere a la página «ejemplo» en el namespace raiz.
..ejemplo ..:ejemplo .:..:ejemplo	se refieren a la página «ejemplo» en el namespace padre
wiki:ejemplo	se refiere a la pagina «ejemplo» en el namespace «wiki». El namespace «wiki» esta localizado debajo del namespace raiz.
ns1:ns2:ejemplo :ns1:ns2:ejemplo	se refieren a la página «ejemplo» en el namespace ns2. El namespace ns2 esta localizado debajo del namespace ns1; el namespace ns1 esta localizado debajo del namespace raiz.
.ns1:ns2:ejemplo .:ns1:ns2:ejemplo	se refiere a la página «ejemplo» en el namespace ns2. El namespace ns2 esta localizado debajo del namespace ns1; el namespace ns1 esta localizado debajo del namespace actual.
.ns1:ns2:	se refiere a la pagina «inicio» en el namespace ns2. El namespace ns2 esta localizado debajo del namespace ns1; el namespace ns1 esta localizado debajo del namespace actual. (La pagina por defecto puede ser llamada de cualquier otra manera que «inicio» ajustando la configuración config.)

Eliminando Namespaces

Cuando todas las paginas dentro de un namespace han sido eliminadas el namespace ya no existirá más, logicamente. DokuWiki usualmente tambien eliminará el directorio, que ahora se encuentra vacío.

Cómo renombrar namespaces?

Usted puede usar el PageMove plugin para mover cada una de las paginas desde el anterior namespace al nuevo. Por favor consulte la documentacion para ver si esto cumple con sus necesidades.

El método manual es más difícil:

Renombre las carpetas que representan el namespace:
- data/pages
- data/media (si existe)
Remueva (borre) la metadata para el namespace dentro de data/meta
Remueva (borre) el 'attic data' del namespace dentro de data/attic (o muevalo tambien, si usted quiere mantener las versiones anteriores)

Por ejemplo, en Unix, usted puede usar estos comandos:

mv /dokuwiki_base/data/pages/namespace_antiguo /dokuwiki_base/data/pages/namespace_nuevo
mv /dokuwiki_base/data/media/namespace_antiguo /dokuwiki_base/data/media/namespace_nuevo
rm -Rf /dokuwiki_base/data/meta/namespace_antiguo
rm -Rf /dokuwiki_base/data/attic/namespace_antiguo

NOTA: los namespaces namespace_antiguo y/o namespace_nuevo deben ser codificados si tienen caracteres no-latinos (Rusos, Griegos, etc).

Edite todos los enlaces dentro del namespace renombrado (usted puede encontrar esos enlaces antes de renombrar el namespace revisando cada página) backlinks.

Explore todas y cada una de las páginas dentro de su nuevo namespace. Esto creará la información del indice y los metadatos para las páginas que estas dentro del namespace renombrado.

De cualquier forma, aun tendrá bastante «basura» en el medio. Por ejemplo en data/changes.log, varios archivos en el caché,(incluyendo .idx etc). Si fuera posible, podría comenzar desde un blank state de la forma siguiente (de nuevo bajo Unix) Pero tenga en cuenta que esto significara la perdidad de toda la informacion historica (Cambios recientes, por ejemplo):

cat /dev/null > /dokuwiki_base/data/changes.log
rm -Rf /dokuwiki_base/data/attic/*
rm -Rf /dokuwiki_base/data/cache/?
rm -Rf /dokuwiki_base/data/cache/*.idx
rm -Rf /dokuwiki_base/data/cache/purgefile
Browse each and every page of your Wiki.

Entiendo que esto es complicado (y tal vez omití algunas cosas que usted también debería hacer). Todo en todo esto es un PITA. Usted puede usar también algunos plugins que están disponibles para (re)construir el índice de búsqueda (searchindex) para el wiki completo, borrando por completo el espacio de memoria reservada (cache) y/o las anteriores revisiones wiki evitará el tener que hacer esto a mano.

Enlace por defecto de un Namespace

Es posible enlazar un namespace a un archivo terminando la identificación del link (linkid) con dos puntos: [[foo:bar:]]. A cual pagina se enlaza? esto depende del la existencia de ciertos archivos específicos. Para [[foo:bar:]] las siguientes paginas son verificadas:

foo:bar:$conf['start']
foo:bar:bar
foo:bar

Las páginas son verificadas en ese orden y la que se encuentre primero será enlazada al namespace. «Autoplural linking is not done for those links»

Esta característica está sólo disponible en la versión 2006-09-28 RC1 y posteriores.