Twiki

De Wikis en Educación

Revisión de 14:15 25 ago 2009

Esta página está en construcción

Introducción

TWiki es un gestor de contenidos tipo wiki. Soporta extensiones para acceso a bases de datos, diagramas, ordenamiento de tablas, hojas de cálculo, dibujos, seguimiento de proyectos y muchas otras posibilidades. El aspecto de TWiki se personaliza con cambios de piel. Además, incluye soporte para internacionalización y juego de caracteres UTF-8. Twiki está escrito en Perl y es distribuido con licencia GPL. Como sistema de almacenamiento utiliza ficheros de texto.

Dificultad de instalación Dificultad de configuración Media -

Instalación

Requisitos previos

Para la instalación de TWiki es necesario:

• Servidor web, como Apache (es necesaria la versión 2.2).
• Perl. Para windows, se usará la distribución ActivePerl.
• Software Twiki.

Otra opción es la descarga de un paquete para uso personal de Twiki que incluye todo lo necesario para su funcionamiento; tWiki, servidor web TinyWeb y Perl.

Para el siguiente tutorial se ha instalado la versión 4.2 de Twiki en Windows XP con servidor Apache.

Instalación

Una vez instalados Apache y ActivePerl (con la configuración por defecto debería funcionar correctamente), hay que descargar y descomprimir Twiki en la carpeta que se desee, por ejemplo, en C:\twiki.

A continuación se seguirán los siguientes pasos:

1. Configuración de Twiki desde la línea de comandos.
2. Configuración de Apache.
3. Configuración de Twiki desde el navegador.

1. Configuración de Twiki desde la línea de comandos

Realizar los siguientes pasos en el directorio twiki\bin:

• Cambiar de nombre al archivo LocalLib.cfg.txt por LocalLib.cfg.
• Editar en LocalLib.cfg la variable $twikiLibPath. Debe ser igual a la ruta absoluta de la carpeta lib de Twiki. En este caso quedaría de la siguiente forma: $twikiLibPath = "C:/twiki/lib";
• Copiar el archivo LocalLib.cfg a la carpeta lib de twiki.

Antes de realizar los siguientes pasos hay que asegurarse de que las carpetas tools y bin de Twiki tengan todos los permisos. Si sólo tienen permiso de lectura habrá un problema, por lo que hay que ir a cada carpeta y pulsar con el botón derecho del ratón en propiedades y desmarcar el atributo de sólo lectura, aplicando el cambio a todas las subcarpetas. A continuación accedemos a la línea de comandos:

• Ir a la carpeta bin de Twiki. En este caso el comando sería cd C:\twiki\bin.
• Ejecutar perl ..\tools\rewriteshbang.pl. A continuación se escribe la ruta donde está instalado Perl: C:\Perl\bin\perl.exe, y se confirma.
• Ir a la carpeta tools de Twiki. En este caso el comando sería cd C:\twiki\tools.
• Ejecutar perl rewriteshbang.pl. A continuación volvemos a escribir la ruta donde está instalado Perl: C:\Perl\bin\perl.exe, y se confirma.

2. Configuración de Apache

En este paso debemos crear un archivo de configuración llamado twiki.conf. Habrá que ponerlo en el directorio conf de Apache, en este caso en C:\Archivos de programa\Apache Software Foundation\Apache2.2\conf\twiki.conf.

En la siguiente página podremos generar un script de configuración adaptado, introduciendo las rutas del sistema donde tengamos instalado Twiki. Una vez generado, se copia el contenido en el archivo creado anteriormente, twiki.conf.

A continuación hay que editar el archivo httpd de la carpeta conf de Apache, añadiendo la siguiente línea al final:

Include conf/twiki.conf

3. Configuración de Twiki desde el navegador

Si todo ha salido bien, podremos acceder a la siguiente dirección desde el navegador:

http://localhost/twiki/bin/configure

Lo normal es que aparezcan 12 avisos en la sección de configuración general de rutas (General path settings), como se muestra en la siguiente imagen:

Podemos acceder a esta sección para modificarlo. Los errores se refieren a las barras \ y /, aunque en cada aviso nos muestra donde está el error. Le damos a siguiente, introducimos una contraseña y guardamos los cambios.

Si seguimos el enlace Return to configuration, aparecerán nuevos avisos. Para solucionarlo, hay que pulsar el botón Yes, I've read all the documentation (ya que algunas opciones avanzadas permanecen ocultas si no se pulsa este botón) y modificar lo siguiente:

• En la sección de Security Setup, seleccionar la opción none para {LoginManager}.
• En la sección Store Settings, seleccionar la opción RcsLite para {StoreImpl}.
• En la sección Mail and Proxies, introducir el email del administrador en {WebMasterEmail}.
• En la sección Store Settings, seleccionar la opción TWiki::Store::SearchAlgorithms::PurePerl para el campo {RCS}{SearchAlgorithm}.

Una vez modificados estos parámetros, le damos a next e introduciendo la nueva contraseña guardamos los cambios. Ahora no debería haber más avisos; si es así, siguiendo el enlace Go to the TWiki front page accedemos a la página principal del wiki.

Enlaces

• Página oficial de TWiki