Usuario:Leachim/Zona1




BANNER GRUPO TÉCNICO DE ECURED


Marco de trabajo
Marco de trabajo

Como motor de wiki se utiliza la versión 1.16.0 de MediaWiki. Es independiente de la plataforma, por lo cual puede ser utilizado tanto para realizar la instalación sobre plataforma Linux como Windows.

Instalación

Requisitos previos

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

Instalación de la MediaWiki

Durante el proceso de instalación habrá que introducir diferente información relacionada con:

  1. Acceso a MediaWiki.
  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.
  8. Los parámetros que se introduzcan pueden ser cambiados posteriormente en los ficheros de configuración.


Una vez que se tiene el archivo con la versión de la MediaWiki que se utilizará, se descomprime y se extrae en el directorio raíz del servidor web. El directorio creado (en nuestro caso MediaWiki 1.16.0) puede ser cambiado de nombre, por ejemplo a wiki.

1. Acceso a MediaWiki

Para acceder al script de instalación se escribe en el navegador web: http://localhost/wiki y se nos mostraría la pantalla inicial.

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 anterior.

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é.

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 habilitadas, si se dejan como están 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.

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.

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.

7. Problemas encontrados

Cuando se introduce un parámetro que no es correcto, aparece un mensaje en rojo sobre el parámetro que causa problemas. Se debe corregir para continuar la instalación.
Mapeo objeto-relacional (ORM)
Mapeo objeto-relacional (ORM)
Extensiones
Extensiones

Las extensiones son ficheros php que sirven para ampliar la funcionalidad de MediaWiki añadiendo nuevas características y adaptarla a nuestras necesidades. Dependiendo de la meta para la que fueron creadas, se pueden usar para:

  • Extender el lenguaje de marcado wiki para escribir artículos. Por ejemplo, puede añadirse la etiqueta <calendar> para crear un calendario y publicarlo en una página.
  • Añadir nuevas capacidades administrativas. Por ejemplo, crear una página especial que proporcione información sobre los usuarios registrados.
  • Cambiar su aspecto. Crear un nuevo skin o plantilla para modificar el diseño de la interfaz.
  • Aumentar la seguridad con mecanismos de autenticación personalizados. Por ejemplo para que permita añadir un CAPTCHA para confirmar un registro.

Instalación

  1. Descargar la extensión y descomprimirla en la carpeta Extensions de MediaWiki.
  2. La instalación de la extensión consiste en la adición de la siguiente línea al final del fichero LocalSettings.php: require_once("extensions/nombre_de_la_extension.php");
Algunas pueden requerir pasos adicionales como la instalación de un parche o la modificación de la base de datos, pero estas instrucciones se encuentran en la página de descarga, ya que son específicas de cada una.
Extensiones de MediaWiki
Extensiones de MediaWiki
  • Calendar: Esta extensión añade una nueva etiqueta <cal> para añadir un calendario y una página especial que muestra los eventos almacenados en el calendario.
  • Chat: Añade una etiqueta nueva para crear un chat embebido con el nombre del artículo en el que se creó.
  • Colorize: Permite añadir color al texto con una etiqueta.
  • CurrentUsers: Lista los usuarios activos que están en el wiki.
  • FCKeditor: Editor WYSIWYG.
  • Google: Permite insertar un elemento de búsqueda de google.
  • Google Maps: Permite introducir mapas de google.
  • Graph: Introduce una nueva etiqueta <graph> con la cual crear gráficos.
  • My blog: Añade un blog en el menú del usuario.
  • OnlineStatus: Muestra si un usuario está conectado.
  • PDF Writer: Genera PDFs de artículos del wiki.
  • TeX Editor: Añade un editor de fórmulas matemáticas.
  • GoogleAnalytics: Permite incluir la ID de la Web para hacer el seguimiento de la misma vía Google Analytics.
  • ParserFunctions: Añade una serie de funciones que pueden ser utilizadas mientras se edita una página, y que se evaluan dinámicamente en el momento de presentar la página.
  • Cite: Permite crear notas a pie de página.
  • reCAPTCHA: Permite la integración de un captcha en el registro de usuarios.
  • SelectCategoryTagCloud: Añade una nube de categorías en la creación de un post, para que sea más sencillo seleccionar una.
  • Widgets: Permite añadir multitud de widgets a nuestras páginas.
  • ExpandTemplates: similar a ParserFunctions, pero con otro tipo de expresiones. Especialmente útil para plantillas.
  • InputBox: Permite añadir formularios a las páginas.
  • UsabilityInitiative: Proporciona mejoras de usabilidad, sobre todo en el editor.
  • ImageMap: Permite crear image maps, es decir, una imagen con diferentes enlaces definidos por coordenadas.
  • StubManager: Framework necesario para otras extensiones.
  • ImageLink: Permite insertar imágenes con enlaces y añadirles ciertos atributos.
  • CategoryTree: Permite ver las categorías de forma jerarquizada.
Bots
Bots

Los bots son herramientas automáticas que pueden ser usadas para simplificar o automatizar tareas cuya realización manual resultaría muy tediosa o ciertas tareas repetitivas sobre una wiki.

Debe emplearse un bot cuando resulte más eficiente para lograr el resultado deseado que las ediciones manuales o el uso de plantillas.

Pueden ser:

  1. Totalmente automáticos
    • Aún así conviene verificar los cambios
  2. Pidan confirmación antes de actuar
    • Son más lentos pero más seguros
    • Ideales para pocos cambios (<1000) y que éstos sean peligrosos de automatizar

Algunos ejemplos típicos de tareas realizadas por bots son los siguientes:

  • Reparar redirecciones dobles.
  • Mover artículos de una categoria a otra.
  • Verificar que los enlaces externos de un artículo sigan existiendo.


Los bots deben usarse de forma limitada al editar ya que pueden sobrecargar el servidor al abrir y editar muchas páginas en un periodo muy corto de tiempo.


Como los bots, pueden hacer muchas ediciones mientras están funcionando, sus ediciones pueden inundar la lista de cambios recientes, haciendo difícil ver y revisar las ediciones hechas por usuarios humanos.


En principio, si la tarea puede expresarse por un algoritmo, es posible programar a un bot para que la realice; otras tareas, como, por ejemplo, corregir los enlaces que apuntan a una página de desambiguación para que lleven a la página correcta, requieren de la supervisión de un operador humano, pero pueden igualmente ser apoyadas por bots, para que cooperen agilizando la tarea.

Se puede programar un bot para mediawiki en cualquier lenguaje de programación, aunque los que se usan en la EcuRed están programados en Python.
Bots utilizados
Bots de EcuRed

Actualmente en la EcuRed se usan los siguientes bots:

  • New user message: Encargado de enviar un mensaje a los usuarios cuando se crean la cuenta.
  • Year_BOT: Crear los artículos de los años y actualizarlos juntando información de las efemérides diarias.
  • Bot enrique: Mover artículos de una categoría a otra.