para principiantes

MediaWiki un wiki para todos

Piotr Machej

En el DVD se encuentran las aplicaciones descritas en los artculos.

En el DVD

odos los das aparece un montn de pginas web. Algunas llevarn mucho tiempo desarrollndose, otras sern abandonadas por sus autores inmediatamente, o en poco tiempo. No es un gran problema, si se trata simplemente de una pgina personal. Sin embargo, qu sucede si el autor abandona una web de mucho inters, por ejemplo una que describe el uso de algn programa de forma sencilla o que ofrece respuestas a los problemas que se generan con frecuencia? Incluso si otra persona decide encargarse de la faena de actualizar una web as, corregir los errores o aadir lo que faltaba, no ser capaz de introducir las mejoras sin ayuda del propio autor (no tendr permiso de acceder a la cuenta). A no ser que la web se haya creado con el uso del mecanismo wiki. En tal caso todos (o slo los usuarios autorizados, dependiendo de la configuracin) sern capaces de introducir las mejoras y hacer que la web siga actual. El mecanismo wiki se va haciendo ms y ms popular, se van estrenando cada vez ms pginas que hacen uso de esta tecnologa: los tutoriales del juego Go, las enciclopedias, y muchas otras pginas. El ejemplo ms destacado del empleo del mecanismo wiki parece ser la popular Wikipedia. En este artculo conoceremos el motor que la pone en marcha, o sea, el programa MediaWiki. Llegaremos a saber, cmo configurarlo y manejarlo, adems de en qu puede sernos til. En este artculo los elementos de la interfaz se llaman segn su versin inglesa. En otros idiomas los nombres de los elementos pueden variar segn lo avanzada que vaya la traduccin de la interfaz.

Ejemplo real

Soy un desdichado propietario de una memoria horriblemente floja. Hace mucho sola yo cubrir montones de hojas con mis recados, pero despus igual olvidaba dnde las haba puesto. Tampoco varias agendas y organizadores me valan para mucho. En fin, algn da, navegando por la Wikipedia, pens: por qu no usar esto en casa? Evidentemente, ahora puedo agregar con facilidad la informacin de los aniversarios (por ejemplo, las fechas de los cumpleaos de mis amigos), las soluciones de los problemas que encuentro, las recetas de cocina y cantidad de informaciones diversas que me parecen de valor, y que de no ser apuntadas se me escaparan en media hora, o en unos das cmo mximo. Adems, es trivial la creacin de enlaces entre tal informacin: no tengo que preocuparme ni de la sintaxis HTML ni del lenguaje PHP. Adems, mi familia tambin aprovecha estas pginas, e incluso introduce en ellas alguna cosa. Y es que se trata de uno de los muchos usos potenciales del wiki.

Configuracin

Concluida la instalacin (al final del artculo explicamos cmo llevarla a cabo), MediaWiki est prcticamente lista para el uso. La configuracin por defecto parece razonable. Desde luego, merece la pena verificar la configuracin y asegurarse de que corresponde a nuestras necesidades. El principal fichero de configuracin de MediaWiki se llama LocalSettings.php y est situado en el directorio donde hemos instalado nuestro wiki. Si deseamos cambiar cualquier opcin, debemos hacer-

70

Linux+ 7/2006

Introduccin al manejo del mecanismo wiki

para principiantes

Figura 1. Wikipedia es el mejor ejemplo de las capacidades del programa MediaWiki

lo precisamente en este fichero. Algunas de las opciones descritas en este artculo no forman parte del fichero por defecto LocalSettings.php, sino que necesitan aadir se a ste. Las configuraciones por defecto de las opciones que no van determinadas en el fichero en cuestin se guardan en el fichero includes/DefaultSettings.php. No se debe realizar en l ninguna modificacin manual en absoluto, ya que sta se perder a la hora de actualizarse MediaWiki a su nueva versin. Los cambios, los introducimos sola y nicamente en el fichero LocalSettings.php. Podemos editarlo a travs de cualquier editor de texto (por ejemplo, GEdit gedit LocalSettings.php). Durante la instalacin fijamos la mayora de las opciones cruciales de este fichero, ya que nos ocuparemos de l a continuacin, cuando sea necesario.

de un enlace que se enviar automticamente a la direccin que hemos sealado). Si suministramos nuestro e-mail, otros usuarios registrados podrn enviarnos mensajes por correo electrnico. Es importante que nuestra direccin no se dejar ver por nadie, el usuario registrado simplemente entra en nuestra pgina personal (por ejemplo: http://localhost/~user/wiki/index.php/ User:WikiSysop) y aprovecha el enlace Email this user. Podemos determinar tambin el apodo, que se visualizar como nuestra firma, en vez del nombre de usuario. Es de

buen gusto que este apodo se aproxime lo ms posible al nombre del usuario, o que en este campo simplemente figuren el nombre y apellido. Adems, podemos, cambiar la contrasea del usuario, y - si hemos indicado un e-mail correcto - decidir, qu mensajes deben llegar a nuestro buzn de correo. Adems, podemos seleccionar el idioma en el que la interfaz debe comunicarnos los mensajes. En este lugar se puede bloquear tambin la recepcin de mensajes de otros usuarios registrados (en tal caso el enlace de direccin, ya mencionado, ser invisible para ellos). La segunda pestaa nos permite elegir la piel, y por lo tanto, el aspecto de la interfaz. En este artculo asumimos que se emplea MonoBook, la piel por defecto (las pieles concretas pueden variar no slo en colores, sino tambin en la disposicin de los enlaces y la localizacin de los elementos de la interfaz). En las pestaas siguientes podemos limitar el tamao de las imgenes visualizadas, as como el de sus miniaturas, fijar el formato de la fecha y la franja horaria (merece la pena hacerlo, para que aparezca el horario correcto), definir las opciones que se refieren a la edicin, a la vista de los ltimos cambios, la bsqueda de informacin y un par de opciones ms (como por ejemplo si para las pginas de tres ttulos o ms el ndice debe aparecer automticamente). Introducidas las modificaciones, no olvidemos guardar los cambios dndole a la tecla Save.

Opciones del usuario

Cada usuario puede habilitar en cierta medida la configuracin a sus necesidades. Para conseguirlo, primero, hay que validarse en el servicio, utilizando el enlace Log in, que aparece en el rincn superior derecho. Tras indicar el nombre de usuario (por ejemplo, el que se acaba de crear durante la instalacin, WikiSysop) y la contrasea, le damos al enlace preferences (que tambin aparece en el rincn superior derecho). Veremos una pgina en la que disponemos de toda una serie de pestaas. En la primera podemos introducir nuestro e-mail (es necesario activarlo a travs

Figura 2. Para validarse wiki basta elegir la contrasea y el nombre de usuario

www.lpmagazine.org

71

para principiantes

Qu es un wiki?

Hablando de wiki pensamos en un gnero de las pginas web, que se pueden crear y modificar directamente desde el nivel del navegador web. Dependiendo de los programas instalados en el servidor, el proceso puede producirse de varias formas, pero al usuario siempre debe de bastarle un simple navegador web. Para realizar las tareas bsicas el usuario ni siquiera tiene que conocer HTML ni las hojas de estilo en cascada (CSS). Se puede formatear el texto utilizando el conjunto de sencillas etiquetas. Lo mismo se aplica a la creacin de los enlaces publicados en el mismo servicio, as como a los que llevan a otras pginas web. Existen muchsimos servicios que emplean el mecanismo wiki y que pueden ser modificados por usuarios annimos. Otros pueden requerir que el usuario se registre en el sistema (lo que suele limitarse a la seleccin del nombre y contrasea del usuario y suministro del e-mail de contacto), o incluso dar permisos de cambio slo a los usuarios elegidos (por ejemplo, los alumnos de cierta escuela, los estudiantes de alguna universidad o los empleados de la empresa). Las principales calidades del wiki residen en la ya mencionada facilidad de editar pginas web, en la sencillez del uso y en la posibilidad de que las pginas sean creadas por muchos usuarios simultneamente. La facilidad de introducir cambios quiere decir tambin que el wiki queda expuesto a cualquier acto de vandalismo (ya sea el borrado de todo el contenido, o la adicin de contenidos no deseados o indecentes). Por suerte, es igual de fcil restaurar cualquier versin anterior de la web, y los gamberros sin remedio se pueden bloquear en el servicio.

Figura 3. Merece la pena verificar el aspecto de la pgina antes de guardar los cambios

Moverse por un wiki

Tras entrar en la pgina principal de nuestro wiki nos toparemos con su disposicin caracterstica. En la parte superior izquierda se sita un lugar destinado para el logo. Por debajo est el panel de navegacin, el dilogo de bsqueda y el panel de herramientas (toolbox). Gran parte de la pantalla est ocupada por el espacio principal, donde aparece el propio contenido de la pgina. Por arriba de ste se ve una serie de enlaces/pestaas (cuyo nmero depende de si nos hemos validado en el servicio y de los permisos que tenemos). En el rincn superior derecho se colocan los enlaces a la pgina personal del usuario, sus pginas de discusin y un enlace a la entrada en el servicio o la creacin de cuenta nueva.

Para crear una cuenta hay que emplear el enlace log in / create account colocado en el rincn superior derecho de la pantalla, y luego otra vez darle al enlace Create an account. Introducimos el nombre del usuario, que queremos emplear, y dos veces la contrasea. Opcionalmente podemos indicar el e-mail. Si decidimos hacerlo, tenemos que cuidar de que sea correcto: all se enviar el mensaje con el enlace que activa esta direccin. Adems, podemos indicar nuestros verdaderos nombres y apellidos: en tal caso nuestro trabajo en el wiki se asociar con nuestro apellido. Despus de pulsar el botn Create account se activar nuestra cuenta y nos validaremos automticamente.

Panel de navegacin

Creacin de cuenta nueva

Aunque se puede utilizar el wiki de forma annima (si la configuracin lo permite, y as sucede en el caso de la que viene por defecto), merece la pena crearse una cuenta. Esto ofrece la posibilidad de seguir los cambios que se introducen, participar en las discusiones, as como crear una pgina personal y cambiar la configuracin. Adems, independientemente del ordenador del que nos serviremos para efectuar los cambios, stos vendrn a nuestra cuenta (los usuarios annimos se identifican segn su nmero IP, de modo que les cuesta ms seguir los cambios realizados).

Al principio la mayora de los enlaces colocados en el panel navigation lleva a las pginas sin contenido. La forma que va a tomar la pgina principal (Main Page), el portal de la comunidad (Community Portal) y otras pginas all ubicadas depende de nosotros mismos y de otros usuarios del wiki. El contenido por defecto de la pgina principal es muy escaso y est compuesto prcticamente slo de los enlaces a los manuales del usuario y otra informacin til a la hora de empezar a trabajar con el wiki. Otra pgina que empieza a funcionar de inmediato es Recent changes que contiene una lista de los cambios recientes introducidos en las pginas del wiki. All pode-

mos llegar a saber qu pginas acaban de modificarse, cundo y por parte de quin. Adems, es posible utilizar los enlaces que comparan la versin actual con la anterior y los que llevan al historial de los cambios realizados en la pgina. Los enlaces a la pgina personal del usuario que ha introducido los cambios, a sus discusiones y la lista de todos los cambios introducidos por este usuario tambin permanecen activos. Es muy interesante el enlace Random page. Como lo sugiere el nombre mismo, ste nos lleva a una pgina aleatoria. Desde

72

Linux+ 7/2006

Introduccin al manejo del mecanismo wiki

para principiantes

Figura 4. Los dibujos que se envan al servidor los podemos utilizar luego en las pginas

luego, hasta que creemos pginas nuevas (lo que se comenta a continuacin), nos veremos condenados a la pgina principal.

Bsqueda

El dilogo de bsqueda, aunque muy sencillo (un campo de edicin y dos botones) ofrece unas capacidades considerables, aunque se podran soar ms perfectas. Si despus de introducir el texto buscado en el campo de edicin pulsamos la tecla [Enter], esta accin equivaldr al uso del botn Go. Para seleccionar Search hay que emplear el ratn o la tecla del tabulador. Conviene aadir tambin que la bsqueda no es sensible a minsculas/maysculas (lo que no se aplica a los signos diacrticos nacionales: en su caso el wiki toma la mayscula y la minscula como dos caracteres distintos). Desafortunadamente, no existe la posibilidad de utilizar las expresiones regulares. En la mayora de los casos, cuando sabemos qu es lo que estamos buscando, debe ser suficiente el botn Go que se utiliza por defecto. Primero comprueba, si existe la pgina que corresponde con exactitud a la palabra tecleada. Si no, intenta verificar un par de configuraciones ms, modificando maysculas/minsculas. Si vuelve a fracasar en la bsqueda, intenta dar con las palabras deseadas en los nombres de las pginas. Si el resultado sigue sin aparecer, arranca la bsqueda completa, la que ejecutaramos si pulsramos la tecla Search.

La bsqueda del contenido de las pginas slo se efecta en los espacios de nombres (namespaces) que hemos definido en nuestras preferencias. Si es necesario, podemos cambiar temporalmente tal configuracin en la pagina de la bsqueda, aadiendo o eliminando la seleccin de cada uno de los espacios de nombres.

Panel de herramientas

Si nos interesan los cambios producidos en las pginas a las cuales llevan los enlaces de la pgina actual, debemos utilizar el enlace Related changes. ste har que aparezca la lista de los cambios en un formato igual al del caso Recent changes, pero la lista slo abarcar las pginas enlazadas con la actual. Gracias al enlace Special pages obtendremos acceso a la lista de pginas especiales. Entre ellas se pueden hallar la lista de todas las pginas, la de las pginas populares, de las abandonadas, la lista de ficheros, as como muchas ms, como por ejemplo las estadsticas, los mensajes de sistema o la lista de usuarios. El enlace Printable version desempea una funcin curiosa. Visualiza slo el contenido de una pgina en forma lista para imprimir, es decir, sin elementos de la interfaz del wiki. Es til, aunque no imprescindible en la mayora de los navegadores modernos (por ejemplo, Firefox). Esto se debe a que las hojas de estilo en cascada CSS utilizadas por MediaWiki cuidan de que la pgina se formatee correctamente antes de imprimirse (lo que se puede verificar de todas formas en la vista previa antes de imprimir). El ltimo enlace es Permanent link. Lleva exactamente esta versin particular y concreta de la pgina que vemos de momento. De modo que si nos importa

El contenido del panel toolbox puede variar segn la configuracin y la pgina actualmente visualizada. A nosotros, nos interesa ms, desde luego, el contenido de este panel por defecto para las pginas del espacio principal de los nombres. El enlace What links here permite visualizar las pginas que contienen los enlaces a la actualmente vista. Por cierto, aqu slo se trata de las pginas que forman parte del mismo servicio wiki. El enlace resulta til si queremos comprobar qu pginas tienen enlaces al contenido de nuestro artculo actual. Es que aunque en caso de alguna informacin que se enlaza as se coloque el enlace de vuelta, esto no siempre tiene sentido. Un ejemplo tpico es la situacin cuando la informacin sobre alguna persona dice que visit cierto pas y all se fija el enlace que describe tal pas. Mientras tanto, en la descripcin del pas no se mencionar la persona, siendo la mayora de las veces demasiado insignificante la informacin. En tal caso, al seleccionar el enlace en la pgina del pas podemos llegar a saber de la persona, que lo visit.

Instalacin desde paquetes de distribucin

En algunas distribuciones se puede dar con un modo bastante fcil de instalar MediaWiki desde los paquetes. Esto, de todas formas, requiere los permisos del administrador y resulta en la instalacin del directorio principal en el directorio del servidor Apache (y no en el directorio del usuario, como en la descripcin incluida en la seccin Instalacin). De modo que, por ejemplo, en el caso de la distribucin Fedora Core debe ser suficiente el comando yum install
mediawiki mediawiki-math (ambos pa-

quetes forman parte del repositorio Extras), y en el caso de Ubuntu apt-get install mediawiki mediawiki-math. Las indicaciones acerca de la instalacin y configuracin en estas distribuciones, as como de otras, las podemos encontrar entre los enlaces que se hallan en: http://meta.wikimedia.org/wiki/Help:Installation.

www.lpmagazine.org

73

para principiantes

Si no aparecen por all, nos tendremos que dedicar al formateado manual, pero no hay que temer: no es nada complicado.

Formateado de texto

Empecemos por un ttulo tipo My Personal Page. Para marcar un ttulo de seccin empleamos los signos = fijados a la izquierda y a la derecha del texto. La cantidad de signos = corresponde al nivel del ttulo. De modo que el ttulo ms alto lo podemos conseguir tecleando la lnea:
= My Personal Page =

Figura 5. Gracias a Wikipedia Toolbar, crear tablas es cosa de nios

Los dos niveles ms altos de los ttulos se caracterizan por las lneas horizontales adicionales que separan el ttulo del contenido. Los dems no tienen estas lneas. Hay seis niveles de ttulos disponibles, as que el nivel ms bajo tiene la forma de:
====== Head 6 ======

poner en algn sitio un enlace a esta versin y no a la versin ms actual posible, debemos copiar la direccin de este enlace. Despus de emplearlo podemos ver la pgina en sus sucesivas versiones con la ayuda de los enlaces colocados debajo del ttulo de la pgina. Adems de los enlaces ya mencionados, despus de entrar en la pgina personal de algn usuario (para eso podemos teclear en el dilogo de bsqueda, por ejemplo, el nombre del usuario precedido con User:, por ejemplo: User:WikiSysop y darle al Go). En el panel toolbox aparecer uno o ms enlaces adicionales. El primero ser User contributions, que lleva a una pgina donde se pueden examinar los cambios a nuestro wiki introducidos por el usuario determinado. El segundo enlace, E-mail this user, nos permite enviarle un mensaje al usuario, si ste no ha bloqueado tal opcin.

se dejan ver las diferencias detectadas. Las lneas del mismo contenido se colorean en gris. Los signos + y el color verde marcan las lneas aadidas, y los signos - y el color amarillo, las eliminadas. Los cambios respecto al contenido de las lneas se marcan en rojo. En la parte inferior de la pgina aparece el contenido de la versin ms actual de las dos que se comparan con la presente.

Debajo del ttulo tecleamos el texto ordinario. Si queremos poner algn fragmento en negrita, lo tomamos tres veces entre la comilla simple, as: '''bold text'''.

Espacios de nombres

En el contexto del wiki los espacios de nombres (namespaces) sirven para diferenciar el contenido comn y las pginas personales de los usuarios, las discusiones, las pginas de ayuda, y otras. Gracias a ellos es posible emplear el mismo nombre para varios fines. Por ejemplo el usuario Gerard tiene su pgina personal llamada User:Gerard, y su pgina de discusin que se llama User_talk:Gerard. Como podemos comprobar, la parte que precede los dos puntos determina el nombre del espacio de nombres, y la que lo sigue, el propio nombre de pgina. El espacio principal de nombres que se emplea en MediaWiki no se define con ningn nombre, por eso le pertenecen todas las pginas, cuyos nombres del espacio de nombres quedan indefinidos (por ejemplo, la pgina principal con su nombre Main Page). La bsqueda y el orden de las pginas se limita por defecto precisamente al espacio principal de nombres. Gracias a ello los usuarios comunes no llegarn por casualidad a ninguna pgina destinada para la comunidad de los autores del servicio, tales como sus pginas personales o las discusiones.

Creacin y edicin de la web

Comparacin de versiones

Empleando la pestaa history podemos familiarizarnos con el historial de los cambios realizados. Los enlaces aqu disponibles nos permiten comparar la versin seleccionada con la que le sigue directamente (last) o con la ms actual (cur). Adems, podemos seleccionar dos versiones concretas y compararlas, tras pulsar el botn Compare selected versions. El contenido de las pginas comparadas aparece dividida en dos en la pantalla. En la parte superior se visualiza la informacin sobre la versin concreta, y por debajo

Ya es hora de que pasemos a lo ms entusiasmante en el wiki, o sea, a la creacin de las pginas. Como ya hemos creado nuestra propia cuenta, podemos experimentar en nuestra pgina personal. Para conseguirlo, basta seleccionar el enlace con el nombre del usuario que se sita en la parte superior de la ventana. Si ste aparece en rojo, la pgina a la que lleva todava no existe. En tal caso, si entramos en esta pgina, lo sabremos de inmediato. De modo que podemos seleccionar la pestaa edit colocada en la parte de arriba. Esto nos har pasar al modo de edicin. Dado que nuestra pgina todava no existe, la ventana de edicin est vaca. Si la pgina existiera, aparecera su cdigo fuente. Segn la configuracin del navegador y de las preferencias de la interfaz de MediaWiki que hemos fijado, por encima del campo de edicin pueden situarse los botones que facilitan el formateado de texto. Para funcionar requieren JavaScript.

74

Linux+ 7/2006

Introduccin al manejo del mecanismo wiki

para principiantes

Instalacin en la cuenta sin acceso a la capa

Podemos proceder, segn las indicaciones de la seccin Instalacin, no slo a la hora de realizar la instalacin en nuestra cuenta, sino tambin en el servidor remoto, donde disponemos del acceso a la capa. El problema aparece cuando la capa no est disponible. En tal caso merece la pena comprobar si la interfaz de la cuenta permite descomprimir los archivos que se depositan en ella. Si es as, procedemos de forma prcticamente igual a lo explicado en la seccin Instalacin (slo que descomprimimos el archivo por medio de la interfaz). Si no, tenemos que descomprimir el archivo de forma local y slo despus enviar toda su estructura en la cuenta remota.

La lista termina si aparece la primera lnea sin alguno de los signos de numeracin. Los smbolos de numeracin que se hallan despus de tal lnea encabezan una lista nueva.

Enlaces

Tambin la cursiva la obtenemos gracias a la comilla simple, esta vez doble: ''italic text''. Estas etiquetas las podemos combinar, para obtener un texto en negrita y en cursiva: '''''italic bold text''''' (cinco comillas de cada lado). Sin duda nos gustara introducir el sangrado a nuestro texto. Si le damos una vez a la tecla [Enter] al terminarse la lnea, no lograremos nada. Como resultado el texto seguir en una lnea. Slo si dejamos una lnea libre, se producir un prrafo nuevo. Las listas numeradas y no numeradas se crean hasta de manera trivial. La almohadilla # puesta al inicio de lnea es responsable de las primeras, mientras que el signo * responde por las otras. La primera lnea que empieza con # obtendr el nmero 1, la siguiente, 2 y as por el estilo. Podemos emplear varios niveles de numeracin, por ejemplo, el segundo nivel (que se distingue del primero con un sangrado ms profundo) lo marcamos con dos almohadillas ## al inicio de la lnea. En el caso de las listas no numeradas procedemos de forma analga, empleando los cuadritos caractersticos en vez de los nmeros para marcar los elementos de la lista. Las listas numeradas y no numeradas pueden combinarse unas con otras. De modo que podemos teclear:
# Primer punto numerado #* Primer subpunto no numerado #* Segundo subpunto no numerado # Segundo punto numerado

Ms o menos tarde nos gustara crear un enlace a otra pgina. Por ejemplo, redactando la informacin de nuestra poblacin natal podemos crear un enlace a la pgina de tal poblacin. Si sta debe relacionarse con una pgina de nuestro servicio wiki, basta poner su nombre en corchetes dobles, as: [[City]]. En la misma pgina nos puede gustar, en cambio, fijar otro texto, sin que sea solo el nombre de la poblacin. Lo tenemos igualmente fcil: [[City|My hometown]]. Entonces el enlace llevar a la pgina llamada City, y en la pgina aparecern las palabras My hometown. Frecuentemente, en el contexto de alguna frase, necesitaremos la palabra en otra forma que el nombre del enlace. En tal caso podemos arreglrnoslas con el mtodo que acaba de mostrarse visualizando otro texto o, en algunos casos, empleando una codificacin ms sencilla, como en el ejemplo [[house]]s. Entonces la forma del enlace ser houses, pero ste nos conducir a la pgina llamada House (las primeras letras de los enlaces se transforman automticamente en maysculas). Es todava ms fcil crear enlaces a pginas externas, ya que basta indicar su direccin web, y sta se convertir sin ms en un enlace listo para hacerle clic. Para visualizar un nombre en vez de la direccin habr que ayudarse de la frmula siguiente: [http://www.wikipedia.org/ Wikipedia] (fijmonos en el espacio entre la direccin y el nombre).

var la vista previa a travs del botn Show preview. Si el efecto nos convence, en el campo Summary fijamos una descripcin breve de los cambios que acabamos de realizar y slo entonces guardamos la pgina. Una vez guardada la pgina, podemos notar que adems del enlace para editarla, fijado en la parte superior de la pestaa, los enlaces parecidos estn al lado de cada ttulo. Gracias a ellos podemos editar slo la seccin concreta de la pgina, en vez de toda ella a la vez. Esto resulta muy prctico en particular cuando slo queremos corregir una letra mal tecleada o desarrollar slo una seccin del artculo.

Crear pgina nueva

Otras capacidades

Los usuarios que conocen la sintaxis de HTML y CSS pueden utilizarla durante la edicin para mejorar el aspecto de la pgina. Sin embargo, tambin sin este conocimiento uno es capaz de crear tablas, aadir dibujos y colgarlos, crear frmulas matemticas, y hacer mucho ms. En la pgina http:// meta.wikimedia.org/wiki/Help:Editing , entre otras, podemos hallar una lista amplia de las etiquetas que pueden utilizarse y cuyos ejemplos de uso estn bien explicados. Antes de guardar los cambios mediante el botn Save page conviene asegurarse del resultado final. Para ello es suficiente acti-

No trae ningn problema aadir contenido a una pgina ya existente. Con el ejemplo de la pgina personal del usuario hemos llegado a saber que es tambin muy fcil crear una pgina a la que nos conduce un enlace existente. Desde luego, cmo crear una pgina completamente nueva? Hay una salida que parece natural: podemos crear un enlace a una pgina nueva en la actualmente existente. Luego basta emplear este enlace y ya podemos ponernos a editar la nueva pgina. Este mtodo tiene una ventaja bsica: su contenido est accesible de inmediato desde otra pgina, no queda aislado. Sin embargo, si esto no nos importa demasiado, podemos emplear un mtodo ms simple. Basta teclear el nombre de la pgina que queremos crear en el dilogo de bsqueda y darle a Go. Si tal nombre no existe, veremos un enlace que nos permite pasar a la creacin de la pgina (You can create this page). Un mtodo ms reside en teclear en la barra de direccin del navegador la direccin completa que indica la pgina que nos gustara aadir. La mayora de las veces es suficiente eliminar el ltimo fragmento de una direccin real y sustituirlo con el nombre propuesto por nosotros. Entonces MediaWiki visualizar la informacin de que la pgina todava est vaca y nos permitir editarla.

Enviando archivos al servidor

En MediaWiki la posibilidad de enviar archivos al servidor queda desactivada por defecto. Desde luego, sin esta herramienta no podremos fijar con facilidad los dibujos, las fotos ni otros ficheros en las pginas. Por esto cambiaremos estas opciones. Para conseguirlo, en el fichero LocalSettings.php cambiamos el valor de las

www.lpmagazine.org

75

para principiantes

opciones $wgEnableUploads por true. Hay que cuidar tambin de que el servidor Apache tenga los permisos de escribir en el subdirectorio images/. El mtodo ms fcil de obtener este resultado es emplear el comando chmod a+w images. Aunque es mucho mejor cambiar el propietario por el usuario de apache (a travs del comando chown apache:apache images), esto requiere los permisos del administrador. Realizados estos cambios, en el panel toolbox debe aparecer un enlace nuevo: Upload file. Despus de seleccionarlo, hay que indicar el archivo por enviar y teclear el nom bre que lo identificar en la base de datos. Lo mejor sera que se trate de un nombre inteligible, es decir, en vez de Img672635.png mejor llamar el archivo London_by_night. png (por supuesto, suponiendo que representa Londres por la noche). Adems, podemos aadir una descripcin del archivo (por ejemplo, de dnde procede y en base a qu licencia se distribuye). Luego le damos a Upload file. Si durante el envo del archivo aparece el mensaje "The file is corrupt or has an incorrect extension. Please check the file and upload again.", al fichero de configuracin LocalSettings.php hay que aadirle la lnea:
$wgMimeDetectorCommand= "file -bi";

zarlos en nuestras pginas. Al editar la pgina hay que utilizar la etiqueta [[Image:
London_by_night.png|Rainy night in London]].

Desde este momento en nuestra pgina nos dar la bienvenida el logo nuevo

Es evidente que no es muy distinta del enlace normal a un documento. Una descripcin opcional aparecer si ponemos el cursor de nuestro ratn por encima del dibujo.

Extensiones para el navegador Firefox

Cambio del logo

Ha llegado la hora de decidir cmo ser el logo de nuestro wiki. Empezamos preparando el dibujo en el programa grfico (por ejemplo, The Gimp). El dibujo debe tener forma rectangular, ya que acabaremos reducindolo al tamao de 135x135 pxeles. Si el dibujo no ocupa toda el rea del cuadro, vale la pena cuidar de que el fondo sea transparente: en tal caso se presentar bien en cada color de fondo de la web. El dibujo preparado, lo tenemos que enviar al servidor. Ahora disponemos de dos opciones. O bien lo fijamos en el directorio skins/ common/images/wiki.png, y en tal caso no tenemos que cambiar nada en la configuracin, o bien lo fijamos bajo otro nombre. Entonces tenemos que indicarle a MediaWiki dnde est el fichero con el logo. Para ello abrimos el fichero LocalSettings.php y determinamos la ruta al fichero del logo que tiene la forma siguiente:
$wgLogo = "$wgStylePath/common/images/ wiki.png";

Esto soluciona muchos de los casos as. Hablando del envo de los dibujos al servidor, podemos mencionar cmo utili-

En la web http://wikipedia.mozdev.org/ pode mos encontrar la extensin Wikipedia Toolbar para el navegador Firefox que hace mucho ms fcil la edicin del wiki a travs de dicho navegador. Tras instalar la extensin recibimos una barra de herramientas nueva as como muchos elementos adicionales a travs del men contextual. En las preferencias de la extensin podemos indicar los servicios wiki que ste debe soportar (podemos definir unos propios). Las opciones disponibles permiten, por ejemplo, crear las tablas con facilidad, o aadir dibujos. En tales casos aparece un men en el que se puede introducir la informacin que servir de base para generar el cdigo en el campo de edicin. En cuanto a las funciones ms sencillas, como por ejemplo, poner el texto en negrita, basta seleccionar el fragmento deseado y elegir la opcin de negrita. La extensin es muy funcional y fcil de usar. De todas formas, en algunos idiomas pueden ocurrir problemas de Firefox con algunos atajos de teclado. Desde luego, gracias a la extensin podemos concentrarnos en crear la pgina, con las tablas ms complicadas, en vez en concentrarnos en memorizar la sintaxis. Aunque la sintaxis que se emplea para formatear texto en MediaWiki no es muy complicada, muchos usuarios le vern una utilidad inmensa a esta extensin.

Instalacin

Figura 6. A la hora de instalar MediaWiki conviene conocer la contrasea del administrador de la base de datos

MediaWiki puede instalarse en cualquier distribucin Linux bastante actual. Para funcionar necesita cualquier servidor web (se recomienda Apache de la serie 2.x), PHP en la versin al menos 4.3 (se recomienda 4.4.2 o 5.1.2) y un servidor MySQL de la serie 4.x (la versin recomendada es la 4.0.23 o alguna ms reciente). Adems, merece la pena instalar una herramienta para administrar la base MySQL (por ejemplo, phpMyAdmin), ya que sta luego puede servirnos, por ejemplo, para producir las copias de seguridad. Lo ms fcil es instalar MediaWiki en un servidor web propio, pero se lo puede instalar tambin en una cuenta suministrada por un proveedor. De todas formas, hay que recordar que tal cuenta debe cumplir los requisitos ya sealados (PHP y la base

76

Linux+ 7/2006

Introduccin al manejo del mecanismo wiki

para principiantes

MySQL). No es necesario crear una base de datos por separado para MediaWiki: si disponemos de slo una base, podemos forzar a que las tablas se creen con un prefijo adecuado para que no surja el conflicto con otras tablas. Empezamos la instalacin descargando el archivo desde la web del proyecto. La versin estable de MediaWiki ms actual a la fecha de creacin de este artculo es la nmero 1.6.3. Ahora bien, ya descargado el archivo, hay que fijarlo en algn directorio disponible desde la web (por ejemplo, en $HOME/public_html/). El paso siguiente es su descompresin con el comando tar xzvf mediawiki-1.6.3.tar.gz. Se crea el subdirectorio mediawiki-1.6.3/, cuyo nombre cambiamos por uno ms oportuno (por ejemplo, wiki/) a travs del comando mv mediawiki-1.6.3 wiki. Entramos en el directorio (cd wiki/) y damos el comando chmod a+w config. Lo necesitamos para que el servidor Apache sea capaz de guardar la configuracin.

Pgina de configuracin

Ahora podemos arrancar ya el navegador (por ejemplo, Firefox) abriendo all la direccin que corresponde al directorio donde acabamos de fijar nuestra instalacin de MediaWiki (por ejemplo, http://localhost/~user/ wiki/). A poco tiempo ser esta la direccin donde operar nuestro wiki, pero por ahora slo est all el enlace a la pgina de configuracin que, por supuesto, debemos utilizar. La pgina de configuracin est dividida en un par de secciones. La primera contiene informacin del resultado de verificacin del entorno. Merece la pena leerla y comprobar si todos los componentes requeridos estn instalados en el sistema. Tras leer el mensaje You can install MediaWiki, podemos pasar a la seccin siguiente. Aqu definimos el nombre de nuestro wiki (mejor que sea una palabra), la direccin de contacto del administrador, as como el idioma de la interfaz. Se puede escoger uno de una lista muy larga, pero hay que recordar que no todas las traducciones estn completas. Elegimos tambin el tipo de licencia bajo la cual se har disponible el contenido del wiki. Es muy importante, adems, que se fije el nombre del usuario que cuenta con los permisos del administrador (por defecto, WikiSysop) as como su contrasea. Por cierto, la contrasea debe ser nica y difcil de adivinar, para que alguien no autorizado no se haga con el

acceso (de todas formas, la contrasea se enva a travs de un canal no protegido, por lo que est expuesta a la interceptacin). La seccin siguiente es responsable de los mensajes de e-mail, las notificaciones y la autenticacin. Si el servidor no soporta el envo del correo, podemos desactivar por completo el envo de los e-mails. Si no lo hacemos, podemos decidir, si los usuarios tienen la posibilidad de enviarse mensajes entre s. Podemos fijar la notificacin a los usuarios en tres niveles disponibles: desactivado, notificar de los cambios en la pgina de discusin del usuario, o notificar los cambios en la pgina de discusin y en las pginas seguidas por el usuario. Esta ltima configuracin no se recomienda a los servicios grandes, ya que puede generar una carga considerable. Para terminar, disponemos si las direcciones de e-mail suministradas por los usuarios deben verificarse por medio del envo de mensajes con un enlace a la pgina que activa la direccin concreta despus que el usuario se registre. La ltima seccin es responsable de la configuracin de la base de datos MySQL. Aqu suministramos la informacin como por ejemplo la direccin del servidor de la base de datos, nombre de la base, nombre y contrasea del usuario. Es obvio que el usuario debe contar con los permisos para crear la base (si sta todava no existe) y las tablas. Si la base la utilizan un par de proyectos (por ejemplo, otros wikis u otros programas) hay que definir el prefijo para los nombres de las tablas (por ejemplo, mw_). Gracias a ello evitaremos los conflictos a la hora de crear tablas. Si el usuario de la base sealado no existe todava, o si no cuenta con los permisos necesarios para crear la base y las tablas, merece la pena dar el nombre y contrasea de administrador de la base MySQL. En tal caso el instalador cuidar de todo por su propia cuenta. Si no disponemos de la contrasea del administrador, hay que pedirle que establezca la base adecuada y que nos d los permisos oportunos para manejarla. Para terminar, le damos a Install MediaWiki.

LocalSettings.php lo movemos al directorio superior (con el comando cp config/ LocalSettings.php). Tampoco du demos de borrar, mediante el comando rm -r config/, el directorio config/, que ya no es necesario. Empleando el enlace en la pgina actual podemos pasar a la pgina principal de nuestro wiki (o sea, en nuestro ejemplo, http:/localhost/~user/wiki/index. php). Con esto termina la instalacin y la configuracin preliminar de MediaWiki. Desde ahora slo podemos aadirle contenido nuevo, igual que pueden hacerlo otros usuarios (tanto los annimos, como los que tienen sus cuentas).

Para terminar

Como podemos ver, la instalacin de MediaWiki no trae problemas, y ponerla en prctica es muy fcil y ameno. Espero que la posibilidad de experimentar por propia cuenta en un servidor propio haga que ms usuarios tengan nimo y se sientan a sus anchas modificando otras pginas wiki, como por ejemplo Wikipedia y los proyectos parecidos. Este artculo no presenta todas las capacidades de MediaWiki. El proyecto es de verdad muy desarrollado y funcional, adems cuenta con enormes capacidades de configuracin. Adems de los cambios de la configuracin que se describen en el artculo, se pueden introducir cambios en otras configuraciones por defecto, e incluso pueden modificarse los ficheros PHP haciendo que nuestro wiki llegue a ser hasta ms excepcional y ajustado a nuestras necesidades. Os animo de todo corazn a que experimentis por vuestra propia cuenta y que os juntis a alguna de las comunidades que trabajan sobre varios servicios wiki. Es que gracias al trabajo de ellas los servicios siguen en desarrollo y van atrayendo a los usuarios de la red.

En Internet:
Pgina de MediaWiki: http://www.mediawiki.org/ Pgina de Wikipedia: http://www.wikipedia.org/ La extensin Wikipedia Toolbar para el navegador Firefox: http://wikipedia.mozdev.org/

Actividades finales

Al leer los mensajes de la instalacin, primero hay que asegurarse de que la instalacin ha terminado con xito. Si es as, el fichero que acaba de generarse, el config/

www.lpmagazine.org

77