Instalación y primeros pasos de Dokuwiki

La instalación de Dokuwiki es sencilla:

1. Desde su sitio oficial descargaos la última versión desde la página de descarga:www.splitbrain.org/projects/dokuwiki. La versión actual es dokuwiki-2011-05-25a.tgz “Rincewind”. Se trata de un archivo .tgz, un formato de ficheros comprimidos que puede abrirse con los programas habituales de compresión de ficheros, como WinRar o WinZip.

2. Ahora tenéis que descomprimid el contenido del archivo .tgz en el directorio “www” del directorio de instalación de AppServ. Si no habéis cambiado ninguna configuración por defecto, este será C:\Archivos de programa\AppServ\www.

Nota: podemos elegir el nombre que queramos para el directorio de Dokuwiki, pero tened la precaución de no usar espacios, tildes o caracteres complicados (los guiones bajos son perfectamente válidos).

3. Tras esto, tenemos que realizar la configuración inicial de Dokuwiki. Para ello dirigíos ahttp://localhost/Nombre_de_vuestra_wiki/install.php, donde Nombre_de_vuestra_wiki es obviamente el nombre del directorio de instalación mencionado en el punto 2. Hecho esto accederéis a la configuración inicial de DokuWiki:

Esta primera configuración es bastante simple. Veámosla paso a paso:

Primero, elegid el código de vuestro idioma en el formulario “Choose your language”, arriba a la derecha (El código para español es “es”). A continuación es preciso rellenar los siguientes campos:

Nombre del wiki: El nombre de vuestra wiki.

Super-usuario: El nombre de usuario del administrador dela wiki.

Nombre real: vuestro verdadero nombre.

E-mail: Vuestra dirección de correo-e.

Contraseña: La contraseña del administrador. Tendréis que confirmarla en el siguiente campo.

Política de ACL inicial: ACL es el acrónimo de access control list, lista de control de acceso (http://es.wikipedia.org/wiki/Lista_de_control_de_acceso). En cristiano, se trata de decidir cuál será la configuración de privacidad inicial de nuestra wiki. Hay tres opciones:

• Wiki abierta (todos tienen permiso de lectura, edición y subida).
• Wiki pública (todos tienen permiso de lectura, solo algunos usuarios tienen permisos de edición y subida).
• Wiki cerrada (solo los usuarios registrados tienen permisos de lectura, edición o subida).

Cuál elijamos depende de nuestras intenciones. Si pensamos usarla wiki en modo local tan solo, no importa realmente cuál elijamosⁱ.

Por último, la configuración nos pide que elijamos un tipo de licencia para nuestros contenidos. De igual forma que el punto anterior, esto solo será relevante en el caso de que subamos la wiki a un servidor en red.

Una vez terminemos pulsamos Guardar. Si no ha habido problemas, DokuWiki debería mostrarnos el siguiente mensaje: La configuración ha concluido correctamente. Ahora puede eliminar el archivo install.php. Visite su nuevo DokuWiki.

Para acceder a vuestra wiki personal haced clic en el enlace de esa página. También podéis dirigiros a la dirección http://localhost/Nombre_de_vuestra_wiki. La página que veréis debería ser tal que esta:

No es muy impresionante, es cierto. Aún tenemos que hacer unos cuantos arreglos. Veamos cuáles son:

Primeros pasos:

Lo primero que deberíamos hacer es identificarnos como superusuario o administrador de la wiki. En la barra inferior veremos un botón llamado Conectarse. Si lo pulsamos nos llevará a la página de login. Allí pondremos el nombre de usuario y la contraseña elegida durante la configuración.

Una vez hecho esto podremos acceder a la página de administración mediante el botónAdministrar. No obstante, salvo que os pique la curiosidad o seáis usuarios avanzados, de momento no necesitáis configurar nada más para comenzar a usar vuestra wiki.

Lo primero que deberíamos hacer es crear una página. Hay varias formas. Pero antes de comentarlas, conviene saber que todas las páginas creadas en DokuWiki se guardan como archivos de texto plano (.txt) en el directorio \data\pages del directorio principal de DokuWiki. (Esto es, si hemos instalado DokuWiki en C:\Archivos de programa\AppServ\www\Dokuwiki, las páginas se guardarán en C:\Archivos de programa\AppServ\www\Dokuwiki\data\pages.

Una forma rápida de crear una página es crear un nuevo archivo de texto en dicho directorio. Pero dado que hay cuestiones relativas a la nomenclatura de los archivos, es mejor que creemos las páginas desde la propia Dokuwiki.

¿Cómo? Imaginad que queréis una nueva página para recoger vuestras anotaciones sobre una ciudad. Para continuar con el ejemplo de la entrada de esta bitácora Cómo dibujar mapas de ciudades, podremos llamar a esta ciudad Fuentenevada.

Si buscamos el término mediante el formulario de búsqueda (arriba, a la derecha) DokuWiki nos informará de que (lógicamente) la página no existe aún, pero que podemos crearla empleando el botón Crea esta página (marcado en rojo en la captura de pantalla bajo este párrafo).

Si lo hacéis veréis el formulario de edición de la página fuentenevada, donde podréis volcar vuestras anotaciones, o escribirlas desde cero. Desde el mismo momento que creáis la página, DokuWiki crea a su vez el archivo .txt de la misma, lo cual os permitirá consultar la información de forma independiente.

Ejemplo de página

Sobre la sintaxis

Incluir toda la sintaxis de DokuWiki en este artículo, ya de por sí largo, sería bastante engorroso, así que esbozaré lo básico (la sintaxis completa de DokuWiki podéis encontrarla aquí:www.dokuwiki.org/es:syntax).

Párrafos:

Para crear un párrafo es preciso añadir un salto de línea extra entre párrafos.

Ejemplo:

Esta frase es un párrafo.

Y esta otra, otro.

Negritas, cursivas y subrayados.

Para que una palabra salga en negritahay que escribirla entre dobles asteriscos (**): **negrita**, por tanto, sería formateado como negrita. Las cursivas, mediante dobles barras (//): //cursivas// »cursivas. El texto subrayado, entre dobles guiones bajos (__): __subrayado__ » subrayado.

Epígrafes

Los encabezados, títulos o epígrafes de nuestro texto se marcan mediante signos de igual (=). Hay cinco niveles; el primero tiene seis signos de igual, el segundo cinco, y así sucesivamente hasta llegar al quinto y último.

Ejemplo:

====== Así se marca un encabezado de primer nivel======

===== Así se marca un encabezado de segundo nivel =====

==== Así se marca un encabezado de tercer nivel ====

=== Así se marca un encabezado de cuarto nivel ===

== Así se marca un encabezado de quinto nivel ==

Enlaces internos

Y llegamos a la marca de la sintaxis de DokuWiki de mayor importancia, sin duda alguna. Los enlaces internos se marcan mediante corchetes dobles ([[]]), e indican un enlace a otra página de nuestra wiki.

Si en el anterior texto de ejemplo queremos incluir enlaces a páginas sobre otros términos (topónimos, gentilicios, antropónimos, etcétera) a los que hacemos referencia, tan solo tenemos que escribirlos entre corchetes dobles.

¿Qué ocurre si aún no tengo contenido, podríais pensar? No importa. DokuWiki os permitirá crear estas páginas cuando decidáis visitar esos enlaces internos. Y una forma excelente de hacer crecer nuestra wiki es precisamente “sembrando” referencias mediante enlaces internos.

Haced la prueba. Escribid un texto o emplead alguno que tengáis y colocad las referencias a lugares, naciones, gentes, personajes y demás términos entre corchetes dobles. Si lo hacemos con nuestro texto de ejemplo y guardamos la página, nos encontraremos con esto:

Los enlaces en rojo son referencias a páginas aún no creadas. Bastará con visitarlas y editarlas para que nuestra wiki vaya creciendo.

Este sistema es compatible con la fase creativa de cualquier historia. Lo normal es solo tener algunos conceptos claros del trasfondo y el argumento, que poco a poco irán aclarándose. Siguiendo el ejemplo anterior, es muy probable que de la provincia en la que se sitúa Fuentenevada, Alto Erín, no sepamos mucho más que es fría, montañosa y famosa por sus vinos. O en el caso de Elías Zamar, el gobernador de Fuentenevada (un personaje relevante de nuestra historia), quizás tan solo tenemos la noción de que es un gobernador apático, cruel y demasiado aficionado a la bebida.

No parece mucha información, desde luego, y podríamos pensar que no merece la pena crear sus correspondientes páginas.

Ni mucho menos: al incluir estos datos en páginas interrelacionadas, daremos los primeros pasos para que nuestro mundo crezca de forma exponencial. Si creamos una página dedicada a Elías Zamar, por ejemplo, podremos incluir de forma sucesiva nuevas “capas” de información. Una hija díscola. La historia de su pasado. Su actual esposa. Etcétera. Un largo etcétera, si queremos.

Organizar la información

Para organizar la información conviene establecer un sistema propio antes de comenzar. No tiene por qué ser perfecto; bastará con que sea coherente. Ya habrá tiempo luego de mejorarlo, además.

A modo de ejemplo, estas son las categorías que empleo, con algunos cambios; en su día las mencioné en esta entrada.

• MIT (Mitología): Mitos, religiones, cosmologías y asuntos ultraterrenos.
• SOC (Sociedad): todo lo relativo a los aspectos de una sociedad: estratos sociales, ritos funerarios, costumbres, etcétera.
• TEC (Tecnología): Detalles sobre la tecnología del mundo; desde técnicas de forja de metales a notas sobre cómo se construyen edificios
• HIS (Historia): Informes sobre hechos históricos del mundo.
• LIN (Lingüística): sobre los lenguajes y peculiaridades lingüísticas del mundo.
• DES (Descripción): cualquier informe que detalle lugares y localizaciones (ciudades, pueblos, edificios, etcétera).
• MIS (Miscelánea): Para lo que no cuadre en otra categoría.

Naturalmente no es obligatorio emplear un sistema de clasificación (y mucho menos el que pongo de ejemplo), pero es muy recomendable emplear alguno.

Sea como fuere, en Dokuwiki tenemos dos formas principales de organizar las páginas creadas. Una mediante los namespaces, directorios, y la segunda mediante categorías. No son excluyentes, por cierto.

Un namespace no es más que un directorio de información que almacena páginas. Existen como subdirectorios en el directorio \data\pages, y pueden crearse directamente así, respetando la sintaxis ya comentada en los nombres de páginas.

Con respecto a los namespaces tenéis información bastante completa aquí:www.dokuwiki.org/es:namespaces

La segunda forma emplea un plugin específico, que recomiendo instalar.

Nota previa: DokuWiki dispone de numerosos plugins, o complementos, algunos de ellos muy interesantes. Tenéis la lista completa en www.dokuwiki.org/plugins (por desgracia, solo en inglés). Para descargar un plugin e instalarlo tenéis que usar el enlace Download y descomprimir los ficheros en el directorio de Dokuwiki \lib\plugins.

El plugin en cuestión es tag (http://www.dokuwiki.org/plugin:tag). Tag permite añadir etiquetas a nuestras páginas, lo cual nos permitirá ordenarlas mediante categorías. Para usarlo habremos de incluir en cada página las etiquetas que consideremos oportunas, mediante el marcado siguiente: {{tag>etiqueta}}, donde etiqueta es el nombre de la categoría (sin espacios, ojo) que queremos emplear. Naturalmente podemos usar más de una etiqueta, empleando espacios para separarlas.

Ejemplo: en la página de Fuentenevada, una vez instalado el plugin, podemos incluir una primera línea de etiquetado, tal que esta:

{{tag>ciudades lugares}}

Así, la página de Fuentenevada está incluida en las categorías “ciudades” y “lugares”, bastante claras por otro lado.

Si queremos mostrar en una página las que están etiquetadas con estas categorías tendremos que emplear el marcado {{topic>etiqueta}}, donde etiqueta es la categoría (o categorías, si incluimos más de una y las separamos con espacios).

En el ejemplo anterior, si queremos mostrar todas las páginas etiquetadas con la categoría “Ciudades” en una página (por ejemplo, la de inicio, llamada start), escribiremos el marcado {{topic>ciudades}}.

Cómo hacer copias de respaldo

La forma más sencilla de hacer copias de respaldo de nuestra wiki en DokuWiki es copiar, tal cual, el directorio creado en el directorio de instalación en AppServ (que por defecto, recordamos, será C:\Archivos de programa\AppServ\www\), que será, por tanto, C:\Archivos de programa\AppServ\www\Nombre_de_vuestra_wiki.

Así podremos guardar nuestras páginas y las configuraciones de DokuWiki.

Pero si solo queremos guardar las páginas, estas se encuentran en C:\Archivos de programa\AppServ\www\Nombre_de_vuestra_wiki\data\pages.

Una combinación excelente es copiar de forma periódicaⁱⁱ los archivos de las anteriores ubicaciones a un directorio de Dropbox;ⁱⁱⁱ o, incluso, instalar Appserv directamente en un subdirectorio de Dropbox.