Mediawiki

De Wikis en Educación

Imagen:aviso.png Página en construcción


Contenido

Introducción

MediaWiki es el sistema wiki utilizado para elaborar la Wikipedia y otros proyectos de la fundación Wikimedia, pero luego se hizo público bajo licencia GNU. Ha tenido una gran expansión a partir del año 2005, llegando a ser uno de los CMS más populares especializados en wikis.

Instalación

Requisitos previos

El software MediaWiki está escrito en lenguaje PHP y utiliza como sistema de almacenamiento una base de datos. Los prerequisitos para la instalación de la versión actual 1.15 son los siguientes:

Una forma sencilla de instalar estos requisitos es utilizar el paquete de distribución XAMPP, donde solamente es necesario descargarlo y ejecutarlo, sin necesidad de configurar el servidor y la base de datos.

Una vez tengamos estos requisitos, hay que descomprimir y almacenar la carpeta de MediaWiki en el directorio htdocs de XAMPP y comenzar la instalación.

Instalación

La instalación de MediaWiki tarda de unos 10 a 30 minutos. Se realiza mediante el script de instalación accesible mediante el navegador Web y es necesaria para la configuración de la base de datos (creación de tablas y de usuarios), así como para la configuración de los parámetros iniciales (como el nombre del wiki o el lenguaje).

Durante el proceso de instalación aparecerán distintas pantallas relacionadas con:

  1. Pantalla inicial.
  2. Comprobación del entorno.
  3. Configuración del sitio.
  4. Configuración del email.
  5. Configuración de la base de datos.
  6. Completar la instalación.
  7. Problemas encontrados.

Los parámetros que se introduzcan pueden ser cambiados posteriormente en los ficheros de configuración.

1. Pantalla inicial

Para acceder al script de instalación se escribe en el navegador web:

http://localhost/mediawiki-1.15.0

Es posible modificar el nombre a la carpeta mediawiki-1.15.0 que almacenamos previamente en la carpeta htdocs. Si se cambia por wiki, por ejemplo, el acceso al script sería entonces:

http://localhost/wiki

Se nos mostraría la pantalla inicial:

Archivo:MediaWikiInicio.jpg

2. Comprobación del entorno

Siguiendo el enlace que se muestra, MediaWiki procede a la comprobación del entorno, donde chequea que están disponibles todos los requisitos para que pueda funcionar correctamente; como por ejemplo las versiones de PHP y de la base de datos.

Si tras unos segundos se muestra el mensaje Environment checked. You can install MediaWiki, entonces podemos proseguir la instalación. Si por el contrario falta algún requisito, nos muestra en un mensaje qué es lo que falta y habrá que volver a instalarlo y volver a ejecutar el script de instalación, siguiendo el paso 1.

Archivo:MediaWikiChecking.jpg

3. Configuración del sitio

Se introducirán parámetros relacionados con el sitio wiki:

  • Wiki name: El nombre del sitio wiki.
  • Contact e-mail: El email de contacto de la persona que administrará el sitio.
  • Languaje: El lenguaje de interfaz.
  • Copyright/license: La licencia de los contenidos del sitio. Hay 3 tipos de licencia:
    • Sin licencia: El texto y las imágenes no tienen copyright. Cualquiera podrá copiar y usar estos contenidos.
    • GNU free documentation license: Licencia de documentación libre de GNU. Las limitaciones de los contenidos pueden verse aquí. Es la usada por la wikipedia.
    • Licencia Creative Commons o CC: Existen varias licencias de este tipo. Pueden verse aquí.
  • Admin username: Nombre de usuario del administrador.
  • Password: Contraseña del administrador del wiki.
  • Password confirm: Repetir la contraseña.
  • Object caching: Si se desea activar el sistema de cacheo de páginas, útil cuando el sitio es visitado por muchos usuarios.
  • Memcached servers: Especifica el servidor de caché.

Archivo:MediaWikiSite.jpg

4. Configuración del email

Se introducirán parámetros relacionados con las notificaciones por email. Por defecto, la mayoría de opciones están desabilitadas, si se desean habilitar es necesario configurar un servidor de correo electrónico. Aunque se habiliten, no funcionarán si no existe un servidor de correo.

  • E-mail features (global): Por defecto, las notificaciones generales están habilitadas, como el envío de recordatorio de una contraseña o permitir el envío de e-mails entre usuarios.
  • User-to-user e-mail: Para permitir el envío de emails entre usuarios sin que se publiquen sus direcciones.
  • E-mail notification about changes: Para que se envíe un email cuando el usuario lo especifique sobre cambios en una página, o sólo para las discusiones de página.
  • E-mail address authentication: Para que sea necesario introducir un email cuando se registre el usuario, además se debe confirmar la cuenta mediante email.

Archivo:MediaWikiMail.jpg

5. Configuración de la base de datos

A continuación se muestran los parámetros a configurar relacionados con la base de datos:

  • Database type: Tipo de base de datos. Aparece por defecto la base de datos instalada.
  • Database host: Donde se encuentra la base de datos. En este caso, como está instalada en el mismo PC, será la dirección IP del PC o Localhost.
  • Database name: Nombre de la base de datos, por defecto es Wikidb.
  • DB username: Nombre de usuario que se creará para el acceso a la base de datos. Por defecto es wikiuser.
  • DB password: Contraseña para el acceso del usuario de la base de datos. Tiene una longitud mínima de 6 caracteres.
  • DB password confirm: Repetir la contraseña.
  • Superuser account: Si no se posee permiso de creación en la base de datos, debemos darle los permisos necesarios al usuario anterior o marcar esta opción.
  • Superuser name: El nombre del administrador de la base de datos.
  • Superuser password: Contraseña del administrador de la base de datos.
  • Opciones específicas de la base de datos: No es necesario modificar este apartado, únicamente si se precisa una configuración más específica:
    • Database Table Prefix: Prefijo si se precisa acceder a una base de datos compartida con otros wikis o con otra aplicación web, para evitar conflictos.
    • Storage engine: Para seleccionar una tecnología de base de datos que proporciona acciones adicionales, como bloqueo de registros o un estándar de formato de datos. Puede seleccionarse InnoDB o MyISAM.
    • Database character set: Para modificar la configuración de almacenamiento de datos.

Archivo:MediaWikiDB.jpg

6. Completar la instalación

Una vez se hayan introducido todos los parámetros requeridos se procederá a la instalación. Pulsamos el botón, y si algo ha fallado, muestra un error y vuelve a la misma pantalla para que se pueda corregir. Cuando esté todo correcto, MediaWiki creará la base de datos, las tablas necesarias y el fichero de configuración. Para completar la instalación, hay que mover el archivo de configuración config/localsettings.php al directorio raíz del wiki, y para acceder a él se sigue el enlace de la pantalla.

Archivo:MediaWikiComplete.jpg

7. Problemas encontrados

Cuando se introduce un parámetro que no es correcto, aparece un mesaje en rojo sobre el parámetro que causa problemas. Se debe corregir para continuar la instalación.

Pueden verse los errores más comunes de instalación aquí (Inglés).

Configuración

Existen multitud de parámetros configurables en Mediawiki. Todos los parámetros configurables se encuentran en el archivo DefaultSettings.php de la carpeta includes de MediaWiki, pero siempre que se desee modificar algo habrá que hacerlo en el archivo LocalSettings.php, puesto que todos los cambios de DefaultSettings.php serán machacados cuando se actualice MediaWiki. No todos los parámetros aparecen en LocalSettings.php, pero pueden copiarse de DefaultSettings.php a este archivo.

Se pueden ver todos los parámetros configurables de MediaWiki agrupados por orden alfabético aquí, o agrupados por categorías aquí. A continuación se muestran los aspectos configurables más importantes.

Configuración de la interfaz

Modificar el logo

El logo es la imagen situada en la parte superior izquierda que aparece en todas las páginas del wiki. Si se cambia incorrectamente no habrá imagen en la página. Para modificarlo es necesario seguir estos pasos:

  • Subir la imagen al directorio: /wiki/skins/common/images/. Puede subirse a cualquier otro directorio, pero aquí es donde se almacenan todas las imágenes relacionadas con el sitio. Esta imagen debe tener el tamaño adecuado al reservado para éste para que no se solape con otros elementos de la página. El tamaño máximo que debería tener es de 4,76 x 4,76 cm.
  • Modificar la variable $wgStylePath, el directorio por defecto donde se almacena lo relacionado con el estilo del wiki. Debe modificarse a la ruta donde se almacenan todos los skins.
  • Por último, modificar la variable $wgLogo, con la dirección y el nombre de logo.
  • En resumen, deberíamos añadir a LocalSettings.php:
    • $wgStylePath = "$wgScriptPath/skins";
    • $wgLogo = "$wgStylePath/common/images/Logo.JPG";

Modificar la URL del logo cuando se pulsa

Por defecto, al pulsar en el logo se redirige a la página principal del wiki. Para modificar esto, es necesario modificarlo en la plantilla (MonoBook por defecto), que se encuentra en la carpeta skins. Se debe reemplazar:

<?php echo htmlspecialchars($this->data['nav_urls']['mainpage']['href'])?>

Por la URL por defecto, por ejemplo ‘ManualFAQ’, y quedaría de esta forma:

href = ‘ManualFAQ’.

Artículos

Herramientas personales