Creando y configurando una wiki como entorno de colaboración para equipos

Hace unas semanas conversando en equipo acerca de cómo mantener nuestros estándares actualizados y visibles, nos decidimos por crear una base de conocimiento donde todos colaboremos. Entre las alternativas que encontramos nos decidimos por MediaWiki un software libre escrito originalmente para la Wikipedia.

En este articulo encontrarán los pasos para instalar, configurar y dejarlo listo para compartir conocimiento en equipo!

Requisitos

  • Servidor web con soporte a PHP 5.3.2+ & MySQL 5.0.2+ (o también PostgreSQL, SQLite), para esta guia estoy usando MAMP, en nuestro caso para producción usamos LAMP.

Instalación

  1. El primer paso es descargar MediaWiki, la última versión estable es la 1.24.1.

  2. Subir los archivos de mediawiki al servidor web.

  3. Ingresar a http://direcciónip/[carpeta-contendora]/mw-config/index.php para el inicio de la instalación

    • Selección de idioma: Idioma

    • Comprobación de entorno: Entorno

    • Información y configuración de base de datos: Base de datos

    • Nombre de la wiki y datos del administrador Información En este punto es importante dejar activa la opción Hazme más preguntas

    • En derechos de usuario seleccionar Wiki privado Wiki Privado

    • En cuanto confirmes la instalación y selecciones Continuar se descargará el archivo LocalSettings.php que contiene la configuración y opciones elegidas en todo el proceso, deberás ponerlo en la ruta base de la instalación del wiki, una vez listo podrás ingresar. Confirmar instalación

Configuración

Estas líneas deben ser agregadas en el archivo LocalSettings.php

  • Activar el editor WikiEditor

    El editor por defecto es bastante basico, el WikiEditor es una extensión que viene instalada y se encuentra desactivada, para activarla:

    require_once "$IP/extensions/WikiEditor/WikiEditor.php";
    $wgDefaultUserOptions['usebetatoolbar'] = 1;
    $wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
    $wgDefaultUserOptions['wikieditor-preview'] = 1;
    $wgDefaultUserOptions['wikieditor-publish'] = 1;
    
  • Activar el resaltado de código

    require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
    $wgSyntaxHighlightKeywordLinks = true;
    
  • Prevenir el registro de nuevos usuarios, excepto por los administradores

    $wgGroupPermissions['*']['createaccount'] = false;
    

    Con esta opción los nuevos usuarios solo podrán ser registrados por los administradores, para crear una cuenta debes ir a http://direcciónip/[carpeta-contendora]/index.php?title=Especial:Entrar&type=signup completar los datos básicos y seleccionar Utilizar una nueva contraseña aleatoria de esta forma el usuario recibirá un correo electrónico con sus datos de acceso.

    Creación de usuario

Y Listo ! La wiki se encuentra lista para compartir información y conocimientos.