25. Tu Wiki con MediaWiki.


25.1. ¿Qué es una Wiki?

Según la enciclopedia libre Wikipedia, el mejor ejemplo de wiki, un wiki o una wiki es un sitio Web cuyas páginas pueden ser editadas por múltiples voluntarios a través del navegador Web. Nadie duda de los beneficios de disponer de un wiki en su Web, hoy en día podemos encontrar wikis de casi todo: cocina, montañismo, tecnología, etc.

Un Wiki es una herramienta de creación de contenidos de manera colaborativa.

Las características principales de un wiki son:

* Rapidez de creación de páginas, ya que se son creadas por los propios usuarios con su navegador.

* Fomento de la participación del usuario, con la posibilidad de modificar las páginas y añadir nuevos contenidos.

* Normalmente disponen de un lenguaje especial para editar los contenidos denominado wikitexto.

* Fácil y sencillo de utilizar.

En este capítulo vamos a explicarte como disponer de unos de los wikis más utilizados, MediaWiki, desde su instalación hasta el control de sus contenidos, finalmente te mostraremos otros wikis también muy extendidos en Internet.


25.2. Instalación.

MediaWiki es quizás el software más utilizado para la implementación de Wikis. Se distribuye bajo licencia GNU y es multiplataforma.

Puedes informarte sobre licencias software en nuestro libro ¡Aprende en libre! con Linux y Windows de esta misma editorial.

Los requisitos necesarios para instalar MediaWiki en tu servidor Web es que dispongas de un Servidor de bases de datos, tipo MySQL y soporte para el lenguaje PHP.

Estos son los pasos a seguir para su correcta instalación:

1. Dirígete a la Web del proyecto en: http://www.mediawiki.org/ y descárgate la última versión estable.

2. Descomprime el fichero “.tar.gz” en el directorio raíz de tu servidor Web, si utilizas GNU/Linux en “var/www”

3. Ahora tienes que acceder a la página inicial de MediaWiki, ha de ser parecido a esta: htt://miServidorWeb/mediawiki-1-13-11. Recuerda dar los permisos de escritura al directorio config: sudo chmod a+w config.

4. Te aparecerá la página principal de instalación. Es aquí donde indicamos todos los parámetros de instalación:

* Proporciona un nombre para tu Wiki.

* Introduce el e-mail del administrador del Wiki.

* Selección del lenguaje .

* Tipo de licencia que vas a utilizar.

* Nombre y contraseña del administrador del Wiki.

* Específica si deseas habilitar la cache de páginas en el servidor, Lo usual es marcar “No caching”.

* Configura los servicios de notificación de correo, en este apartado puedes indicar si deseas que se envíen correos automáticos cada vez que se cree una página nueva o modifique alguna existente. Para el correcto funcionamiento de estos servicios necesitas tener funcionando un servidor SMTP, de correo, en tu servidor Web. Si este no es tu caso puedes deshabilitarlo todo, selecciona Disabled.

* Configura los servicios de la base de datos, es necesario que dispongas de un sistema gestor de bases de datos tipo MySQL o PostgreSQL. En esta sección has de indicar la dirección del servidor, el nombre de la base de datos y un usuario que existan previamente con todos los permisos sobre dicha base de datos.

La mejor manera de crear la base de datos y el usuario es mediante phpMyAdmin, ilustración inferior. Aquí dirígete a la sección de creación de usuarios y da de alta un nuevo usuario con la opción “Crear base de datos con el mismo nombre y otorgue todos los privilegios”.

En el capítulo 16. “El gestor de bases de datos por excelencia, MySQL” te explicamos en detenimiento todo lo relativo a este gestor.

5. Una vez indicados todos los parámetros haz clic en el botón “Install MediaWiki” de la parte inferior.

6. Si todo ha ido bien, te saldrá el siguiente mensaje, indicándote que muevas el fichero “LocalSettings.php” situado en el directorio “config” al raíz del directorio MediaWiki, es decir, justo en el directorio superior, padre.

7. Ya dispones de tu Wiki, accede a ella desde el enlace que se te indica en la página “this link to your wiki”, o directamente en la dirección: http://miServidorWeb/mediawiki-tu_version.

A continuación te mostramos la pantalla principal de MediaWiki recién instalado.


25.3. Configuración y primeros pasos.

La configuración general de MediaWiki es bastante sencilla. Haz clic en el enlace “Lista de ajustes de configuración”.La página que te muestra “ http://www.mediawiki.org/wiki/Manual:Configuration_settings” te informa de todas la variables de que dispones para configurar tu MediaWiki agrupadas por categorías: General, rutas, objetos globales, e-mail, etc.

El proceso de configuración es el siguiente: has de localizar el parámetro que desees modificar en el archivo DefaultSettings.php, ubicado en el directorio “includes” y modificar o escribir, si no existe, la variable en el fichero LocalSettings.php que se encuentra en el directorio “config”.

No modifiques nunca el archivo DefaultSettings.php, copia o modifica las líneas que desees al LocalSettings.php.

DefaultSettings.php es utilizado en el proceso de actualización.

Veamos un par de ejemplos:

25.3.1. Cambio del logo principal de MediaWiki.

La variable que indica el logotipo de tu Wiki es $wgLogo. Si la buscas en el fichero LocalSettings.php. observarás que no aparece, por el contrario en el fichero DefaultSettings.php nos encontramos con esta línea:

$wgLogo = false; ///< defaults to "{$wgStylePath}/common/images/wiki.png"

Ya sabemos lo que hacer: introduce una nueva línea en el fichero LocalSettings.php indicando la ruta de la imagen utilizada para el logo y ya esta:

$wgLogo= "../images/MiLogo.png"


25.3.2. Eligiendo el Skin de MediaWiki.

El Skin es la apariencia gráfica, de la aplicación. También es conocida como piel. La variable encargada de indicar el Skin es $wgDefaultSkin.

La encontramos en el fichero LocalSettings.php junto con una descripción de los valores que puede tomar:

## Default skin: you can change the default skin. Use the internal symbolic

## names, ie 'standard', 'nostalgia', 'cologneblue', 'monobook':

$wgDefaultSkin = 'monobook';

Cambia el valor de la variable, aquí tienes un ejemplo:

25.3.3. Habilitar la subida de archivos.

Si deseas que los usuarios puedan añadir imágenes y archivos multimedia a las páginas, has de cambiar el valor de la variable “$wgEnableUploads =true;”.

Por defecto está opción esta deshabilitada.

Otros parámetros ligados al anterior son $wgMaxUploadSize, donde indicamos el tamaño máximo de los archivos a subir y $wgSharedUploadDirectory donde se ubicarán las imágenes.

Por defecto las imágenes subidas por los usuarios se ubican en el directorio “images”. Para que los usuarios puedan alojar sus imágenes correctamente el directorio ha de disponer de los permisos oportunos (escritura) y estar registrados.

25.4. Editando una página.

Antes de empezar a crear páginas examinemos la interfaz que nos presenta MediaWiki:

En la parte izquierda nos encontramos con la sección de navegación, para acceder a las páginas ubicadas dentro de nuestra Wiki, la herramienta buscar y la sección de herramientas, fundamentalmente estadísticas y páginas especiales. Este último apartado conviene que la visualices con detenimiento.

Nos encontramos con las siguientes categorías, dentro de páginas especiales:

* Reportes de mantenimiento. Información sobre páginas con menos ediciones, sin salida, largas, etc.

* Listas de páginas, distintas opciones de búsquedas de páginas, por categorías, prefijos, etc.

* Registrarse /Entrar. Página específica para registrar usuarios.

* Usuarios y permisos. Mantenimiento de los usuarios: listas de usuarios, usuarios bloqueados, etc.

* Cambios recientes y registros . Para estar al día: páginas nuevas, cambios recientes, etc.

* Páginas sobre archivos. Herramientas como buscar archivos duplicados, listar imágenes, etc.

* Datos sobre la wiki y herramientas. Estadísticas, versión, etc.

* Búsquedas y redirecciones.

* Páginas sobre usos. Artículos con más ediciones, más enlazados, etc.

* Herramientas de páginas : Exportar páginas y lo que enlaza aquí, muy útil para revisar la estructura de la wiki.

* Otras páginas especiales: Fuentes de libros, búsqueda por ISBN.

Para cada página de tu wiki cualquier usuario, podrá:

* Visualizar la página, opción por defecto, en la pestaña página.

* Discutir sobre la página, pestaña discusión.

* Editar la página, pestaña editar, incluyendo nuevo contenido o modificando el existente. Si la página a la que hace referencia no existe en la wiki puede crearla desde cero, pestaña crear.

* Ver el historial de la página con las modificaciones que se han realizado.

Las wikis se crearon con la idea de que cualquier usuario pudiera contribuir incorporando sus propias aportaciones, es por eso que el procedimiento para incluir páginas sea muy intuitivo y disponga de su propia sintaxis:

También, para algunos elementos específicos podemos insertar código HTML/XHTML.

El usuario dispone de una barra de herramientas para efectuar las operaciones más comunes, de izquierda a derecha y con su correspondiente sintaxis:

* Escribir en negrita. Su sintaxis es ´´´Texto en negrita ´´´

* Escribir en cursiva, ´´Texto en cursiva´´

* Enlace interno, [[Dirección del enlace]]. Si el enlace existe aparece en color azul en caso contrario en rojo para su posterior creación.

* Enlace externo, [Dirección del enlace]

* Secciones de nivel 2. ==Nombre sección==. Puedes especificar secciones de distintos niveles según las veces que introduzcas el carácter “=”. Así por Ejemplo secciones de nivel 1, =Nombre sección= ó secciones de nivel 3 con ===Nombre sección===.

* Inserción de imágenes. [[Archivo:Fichero.jpg|opciones]. Recuerda que la imagen has de subirla antes al servidor. Las opciones son opcionales y puedes indicar:

- La alineación: left, right, center, none.

- Formato: thumb, thumbnail, frame, border, frameless.

- Ancho: número px.

- Indicar texto alternativo: texto.

Ejemplo: [[Archivo:Santiago.jpg | 200px | right | thumb ]]

* Archivo multimedia. [[Media:Archivo.ogg]]

* Fórmula matemática. <math> Fórmula </math> Las fórmulas han de estar escritas en lenguaje TeX, en esta dirección puedes consultar las distintas opciones: http://es.wikipedia.org/wiki/Wikipedia:Usando_TeX.

* Caracteres no wiki. Para insertar texto que no será interpretado como código wiki. <nowiki> texto </nowiki>

* Firmar un comentario o página. ~~~~

* Línea horizontal: ----

Con estos comandos, en la mayoría de los casos cubrirán todas tus necesidades, no obstante queremos mostrarte algunos que a nuestro parecer creemos que son útiles:

* Utiliza el doble espaciado para indicar nuevas líneas.

* Para sangrar el carácter es “:” Cuantos más “:::” insertes más sangrado estará.

* Para utilizar el monoespaciado, empieza la frase con un espacio en blanco.

* Las listas numeradas se crean mediante “#” y las no numeradas con “*”. Fíjate en este ejemplo:

El código:

Se visualizará:

#Días

##Lunes

##Martes

1. Días

1. Lunes

2. Martes

* El texto en superíndice se indica con las etiquetas <sup> texto </sup>

* En subíndice: <sub>texto</sub>

* Puedes cambiar el tamaño de la fuente con la etiqueta: <font size=+1> texto </font>

* Y el color mediante: <font color=”color”>Texto </font>

* Para crear tablas utiliza las sentencias de HTML. Ejemplo:

El código:

Se visualizará:

<table border=1>

<tr>

<td>Enero</td>

<td>Febrero</td>

</tr>

<tr>

<td> 3 Faltas</td>

<td> 14 Faltas</td>

</tr>

</table>




Enero

Febrero

3 Faltas

14 Faltas

A continuación te mostramos la primera página de nuestra wiki sobre el camino de Santiago. En código fuente y el resultado posterior:

[[Imagen:Santiago.jpg | 200px | right |thumb ]]Este Wiki está dedicado a ofrecer '''información de los distintos caminos''' para realizar la peregrinación a Santiago. Para y por todos los usuarios. Animamos a todos a incluir información sobre su peregrinación: albergues, fotos, comentarios, etc.

Busca la etapa que desees comentar y siéntete libre de realizar las aportaciones que estimes oportunas.

== <font color="red"> El Camino Aragones </font> ==

===Etapa 1: De Somport a Jaca===

::Primera etapa de un total de 6

[[Recorrido]]

[[Alberges]]

[[Fotos]]

[[Comentarios]]

===Etapa 2: De Jaca a Arrés===

[[Recorrido]]

[[Alberges]]

[[Fotos]]

[[Comentarios]]

== El Camino del Norte ==

== El Camino Francés ==

== El Camino Portugués ==

== El Camino Primitivo ==

== El Camino Sanabrés ==

== El Camino Vasco ==

== Vía de la Plata ==

Este es el resultado:

25.5. Extensiones MediaWiki.

Actualmente existen más de 1200 extensiones para MediaWiki. Las puedes consultar todas en la siguiente dirección: http://www.mediawiki.org/wiki/ Category:All_extensions.

Puedes encontrar extensiones de casi de todo, pizarras colaborativas, inclusión de archivos mp3, videos, calendarios, visor de documentos pdf, galerías de fotos, etc. Aunque el proceso de instalación es específico para cada extensión, generalmente consta de los siguientes pasos:

1. Descargar la extensión o crear una página para la extensión.

2. Incluir la extensión en la carpeta “extensions” de tu servidor Web dentro del directorio donde se ubique MediaWiki.

3. Modificar el fichero LocalSettings.php para habilitar la extensión.

Las extensiones nos permiten ampliar el lenguaje de edición de páginas con comandos nuevos que ofrecen nuevas funcionalidades.

25.5.1. Añadiendo Videos de Youtube a tu Wiki.

Realicemos un par de ejemplos. Empecemos añadiendo una extensión para mostrar videos de Youtube dentro de nuestro Wiki:

1. La extensión que vamos a utilizar es: EmbedVideo.

2. Hemos localizado la extensión y accedido a la página principal de la misma:

http://www.mediawiki.org/wiki/Extension:EmbedVideo, aquí encontraremos toda la información relativa a la extensión.

3. Descargamos la extensión, la ubicamos en la carpeta “extensions” y la renombramos con el nombre “EmbedVideo.php”, tal como nos comentan en las instruccciones.

4. Insertamos la siguiente línea en nuestro fichero LocalSettings.php:

require_once('extensions/EmbedVideo.php');

5. Ya está, cada vez que queramos utilizarla disponemos de la siguiente sintaxis:

{{#ev:service | id | width}}, donde:

* service, es el nombre de un portal de compartición de videos: YouTube, Dailymotion, FunnyOrDie, Google Video, etc.

* id, es el identificador del vídeo. En la siguiente ilustración puedes observar el detalle:

* width, opcional, es la anchura que ocupará en nuestra página.

Aquí tienes un ejemplo: {{#ev:youtube|35dbtxklmyc}} Nos ofrece este resultado en nuestra Wiki:

25.5.2. Mapas de Google Maps en tu Wiki.

Una de las extensiones más espectaculares es la posibilidad de incluir mapas de Google Maps en nuestra Wiki. Estos son los pasos:

Para crear mapas específicos y aprender a manejar la Api de Google dirígete al capítulo 13 “AJAX La revolución”.

1. La extensión que estamos buscando es Google Maps. La puedes localizar en la siguiente dirección:

http://www.mediawiki.org/wiki/Extension:Google_Maps/Installation.

2. Necesitas disponer de una llave para utilizar las APIs de Google, simplemente es darse de alta. En el capítulo 13 te lo explicamos en detalle.

3. Descárgate el fichero zip que te indican y descomprímelo en la carpeta “extensions”. Esta vez es una carpeta con archivos.

4. Añade a tu fichero las siguientes líneas:

$wgGoogleMapsKey = "TU_LLAVE";

require_once( "extensions/GoogleMaps/GoogleMaps.php" );

5. Ahora, cada vez que edites una página, disponemos de un nuevo botón en la barra de herramientas. Crear mapa.

6. Una vez tengas el mapa configurado, has de copiar el código que te ha generado en la sección inferior de la página y pulsar Grabar la página

25.6. Otros Wikis para tu Web.

Para finalizar este capítulo queremos enumerar algunas wikis que puedes disponer en tu Web, nuestro consejo es que pruebas algunos y uses el que te sientas más cómodo o se adapte más a tus requerimientos y preferencias:

* Moin Moin, es bastante similar a MediaWiki, pero realizado en Python. Tendrás que disponer de dicho lenguaje de programación (instalado por defecto en Ubuntu) para que pueda correr la wiki en tu servidor. La página oficial del proyecto es http://moinmo.in/, en esta dirección encontrarás todo lo necesario para su instalación y uso. Es multiplataforma y se distribuye bajo licencia GPL. Un manual sencillo para su instalación en Ubuntu lo encontrarás en la dirección: https://help.ubuntu.com/8.04/serverguide/C/moinmoin.html.

* Los amantes de Windows disponen de OpenWiki, que utiliza ASP y optimizado para trabajar con Microsoft SQL Server e Internet Information Server como servidor Web. Lo puedes encontrar en la siguiente dirección http://www.openwiki.com/.

* TikiWiki, sobrepasa las fronteras de los wikis y podríamos clasificarlo como un gestor de contenidos ya que dispone además del propio wiki de secciones blogs, foros, RSS, etc. La página del proyecto es http://tikiwiki.org.