Ésta es la primera de 3 entregas en las que trataré de comentar brevemente una receta de ‘Mac OS + DocuWiki‘, espero que el plato -una vez cocinado- sea de vuestro agrado. Allá voy:

Como en casa no cuento con un servidor con PHP (requisito principal para que funcione correctamente Docuwiki), lo más práctico -dado que trabajo con Mac OS X- es instalar MAMP (un paquete que contiene Apache + MySQL + PHP). Comenzamos:

MAMP. Instalación de MAMP (Mac OS Apache + MySQL + PHP)

1.- Descargamos MAMP desde AQUÍ, y lo instalamos exactamente igual que cualquier otro software para Mac: doble click al archivo *.dmg, y arrastrar el icono a la carpeta “Aplicaciones” -dado que vamos a trabajar en local y si queréis que os funcione exactamente con las URL’s que voy a ir citando tenéis que copiarlo dentro de la raíz de “Aplicaciones” y no crear ninguna subcarpeta-.

2.- Entramos en “Aplicaciones” / “MAMP” y encontraremos un archivo con extensión *.wgt. Es un widget. Hacemos doble click sobre él y una ventana nos muestra un diálogo en el que se nos pregunta si deseamos instalarlo. Obviamente … sí (sino fuera así ya no habría comentado todo esto).

3.- Vale. Llamamos a ese widget -por defecto si disponemos de un mighty mouse como buenos maqueros clásicos utilizaremos el botón central (la ‘ruedecita’ gris) y pulsamos el botón “Iniciar”. De este modo, si volvemos a “Aplicaciones” / “MAMP” y hacemos doble click en el icono de MAMP la ventana que nos aparecerá ya tendrá las señales de color verde conforme está el servidor iniciado, tal y como podéis ver en la imagen:

(Lo de la parte superior derecha es el widget. La ventana gris grande es el panel de control. Os lo he superpuesto en una única imagen)

4.- Para confirmar que vamos bien, pulsamos en este mismo panel de control el botón “Abrir página de inicio”, y deberemos encontrarnos algo más o menos así:

(Pulsa para ver en tamaño más grande)

[DocuWiki]

1.- Descargamos la última versión estable de DocuWiki desde AQUÍ. Se trata de un archivo comprimido (*.tgz) con el que no deberíamos tener ningún problema. Lo extraemos y nos crea una carpeta llamada “docuwiki-2009-02-14” (éste es el nombre de acuerdo a la versión que yo me he bajado).

2.- Copiamos esta carpeta en la ruta “Aplicaciones” / MAMP” / “htdocs”.

3.- Para saber si vamos bien abrimos un navegador y apuntamos al archivo de instalación del DocuWiki (install.php), escribiendo esta dirección (*): http://localhost:8888/dokuwiki-2009-02-14/install.php .

(*) En una segunda o tercera entrega hablaremos de opciones de configuración (como podéis imaginar, no necesariamente tenemos que escuchar el puerto 8888, entre muchas otras posibilidades …)

En estos momentos deberíamos estar viendo esto:

(Pulsa para ver en tamaño más grande)

4.- Este archivo (install.php) es una especie de asistente que nos irá ayudando en todo el proceso de instalación (además de encargarse de comprobar permisos y disponibilidad de funciones del PHP, crear una cuenta de administrador y establecer una configuración inicial de accesos (ACL – Access Control). En la parte superior derecha podemos elegir el idioma de la instalación (‘es’ – español está a un 99,45 % de la traducción total del DocuWiki, así que no tendremos problema en hacerlo todo en el idioma de Cervantes). Así pues, informamos del nombre que tendrá nuestro wiki, del superusuario y su contraseña, una dirección de correo electrónico y una política inicial de ACL (abierto para todo el mundo = wiki abierta / lectura para todos, escritura para usuarios registrados = wiki pública / lectura y escritura sólo para usuarios registrados = wiki cerrada).

5.- Si todo ha ido bien -(1) el usuario de Mac con el que estamos haciendo todo esto tiene permisos en ese directorio, (2) el servidor de PHP del MAMP dispone de todas las funciones que requiere DocuWiki, y (3) no hemos dejado ningún campo de esa pantalla (punto 4) en blanco- podremos eliminar el archivo ‘install.php‘ y continuar (más bien dicho … finalizar) con la instalación tal y como nos muestra el navegador:

6.- Pulsamos el enlace y ya disponemos de nuestro propio DocuWiki para empezar a crear contenidos. La URL a la que nos ha llevado es a ‘doku.php‘: http://localhost:8888/dokuwiki-2009-02-14/doku.php

(Pulsa para ver en tamaño más grande)

Epílogo.

En esta primera entrega hemos visto cómo montar el ‘esqueleto’ de lo que será nuestro DocuWiki. Intentaré hacer una segunda entrega con las opciones básicas para poder editarlo (atiborrarlo de contenidos, modificarlos, sintaxis básica, etcétera) y una tercera (y última) entrega con las principales opciones de configuración, plugins imprescindibles y cómo poder trasladar nuestro recién estrenado DocuWiki de casa a la empresa -para ser más exactos: al servidor de la empresa-, para convertirlo en un arma colaborativa real.