Puesta en marcha de ikiwiki

Tal y como reza la documentación incluída con el paquete, también accesible en las páginas de Ikiwiki, lo primero es crear un repositorio Subversion en la máquina donde va a residir el wiki final.

No es estrictamente necesario hacerlo así, pero queremos aprovechar la característica de reconstrucción automática del wiki que proporciona Ikiwiki junto al sistema de control de versiones, y para eso es preferible que tanto el repositorio como las páginas web estén situadas en la misma máquina.

Creación del repositorio

Utilizamos la siguiente secuencia de órdenes, asumiendo que la ruta /home/victor/lib ya exista:

$ svn create lib/svn
$ svn mkdir file:///home/victor/lib/svn/trunk -m create

Ahora pasamos al directorio de trabajo donde vamos a obtener una copia de trabajo de éste repositorio; tengamos en cuenta que todo esto lo estamos haciendo en una máquina de pruebas, y no en el servidor de producción. De momento, pues, nos olvidamos de accesos remotos y detalles similares.

$ cd /home/victor/work
$ mkdir wiki
$ cd wiki
$ svn co file:///home/victor/lib/svn/trunk
Revisión obtenida: 1

Creando un primer wiki

Ikiwiki dispone de una opción para crear una estructura básica de un wiki. Vamos a utilizar aquí con propósitos educativos, aunque no es lo más recomendable una vez que se tiene cierta destreza con la herramienta.

$ pwd
/home/victor/work/wiki
$ ikiwiki --verbose . ~/public_html/wiki --url=http://localhost/~victor/wiki
new page blog
new page preprocessordirective
new page helponformatting
new page index
new page markdown
new page sandbox
...
rendering smileys/ohwell.png, to update its backlinks
rendering smileys/icon-error.png, to update its backlinks
rendering smileys/sad.png, to update its backlinks
rendering wikilink.mdwn, to update its backlinks
$

Ikiwiki incluye un juego de páginas fuente (localizables en /usr/share/ikiwiki/basewiki) para producir un sitio inicial funcional, y que vamos a respetar por el momento aunque la mayor parte de ellas no nos sean útil.

Con la instrucción inicial le hemos dicho que utilice como origen del wiki el directorio actual, que como destino use un directorio llamado wiki dentro de los archivos html públicos de nuestro usuario, y como URL de acceso al wiki la máquina local y nuestra cuenta; eso sí, es necesario que el servidor web esté configurado para aceptar accesos a páginas de usuario (al estilo http://localhost/~/victor/wiki) y posteriormente incluso ejecutar programas en ellas.

El proceso anterior ha construído los equivalentes en HTML y los ha instalado en el directorio que le hemos indicado. ¡ Ya tenemos un wiki !

Repitiendo el proceso esta vez de verdad

Un vistazo a nuestro directorio de trabajo en estos momentos nos revela que está prácticamente vacío. Dispone de un directorio .svn para controlar el repositorio y de otro llamado .ikiwiki para controlar el wiki; sin embargo, no hay ningún archivo fuente y sí que aparecen varias páginas html, ¿ qué está ocurriendo ?.

Lo que está sucediendo es que Ikiwiki, al ver que el wiki es nuevo, utiliza sus plantillas para crear contenido visible, pero sin proporcionarnos los fuentes. Es una característica que a mí me parece molesta, y que chirría un poco con respecto al resto del diseño, muy simple y efectivo por otra parte.

La única forma de evitarlo es cambiar los parámetros base que utiliza Ikiwiki para trabajar, y es algo que anotaré en la siguiente entrega.