Namespaces
En DokuWiki puede usar los llamados “namespaces” para categorizar sus páginas.
Creando Namespaces
Usted no necesita crear namespaces explicitamente (es decir no tiene que dar la orden de crearlos); simplemente cree las páginas con los dos puntos (:) en el nombre de la página (pagename). La palabra que aparece despues de los dos puntos será el nombre de la página misma, mientras las otras palabras serán namespaces. Todos los namespaces usados en su nombre de pagina que no existan en el momento serán creados por DokuWiki automaticamente.
| Ejemplo: | |
|---|---|
| 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 asi: 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' y '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 start.) |
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/pagesdata/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_nuevomv /dokuwiki_base/data/media/namespace_antiguo /dokuwiki_base/data/media/namespace_nuevorm -Rf /dokuwiki_base/data/meta/namespace_antiguorm -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 formar, aun tendra bastante bastante “basura” por el medio. Por ejemplo en data/changes.log, Varios archivos en el cache,(incluyendo .idx etc). Si fuera posible, podria 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.logrm -Rf /dokuwiki_base/data/attic/*rm -Rf /dokuwiki_base/data/cache/?rm -Rf /dokuwiki_base/data/cache/*.idxrm -Rf /dokuwiki_base/data/cache/purgefile- Browse each and every page of your Wiki.
I understand this is convoluted (and maybe I missed/messed a couple of things you should also do). All in all this is a PITA. You may also use a couple of plugins that are available for (re)building the searchindex for the complete wiki, erasing entire cache and/or old wiki revisions thus avoiding to do this manually.
Enlace por defecto de un Namespace
Es posible enlazar un namespace a un archivo terminando la identificacion del link (linkid) con dos puntos: [[foo:bar:]]. A cual pagina se enlaza? esto depende del la existencia de ciertos archivos especificos. 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á emlazada al namespace. “Autoplural linking is not done for those links”
Esta caracteristica está sólo disponible en la versión 2006-09-28 RC1 y posteriores.
