MediaWiki – un wiki para todos.pdf

8
para principiantes 70 Linux+ 7/2006 MediaWiki – un wiki para todos Piotr Machej T odos los días aparece un mon- tón de páginas web. Algunas lle- varán mucho tiempo desarro- llándose, otras serán abandona- das por sus autores inmediatamente, o en poco tiempo. No es un gran problema, si se trata simplemente de una página perso- nal. Sin embargo, ¿qué sucede si el autor abandona una web de mucho interés, por ejemplo una que describe el uso de algún 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 añadir 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 sólo los usuarios autorizados, depen- diendo de la configuración) serán capaces de introducir las mejoras y hacer que la web siga actual. El mecanismo wiki se va hacien- do más y más popular, se van estrenan- do cada vez más páginas que hacen uso de esta tecnología: los tutoriales del juego Go, las enciclopedias, y muchas otras pági- nas. El ejemplo más destacado del emp- leo del mecanismo wiki parece ser la popu- lar Wikipedia. En este artículo conoceremos el motor que la pone en marcha, o sea, el programa MediaWiki. Llegaremos a saber, cómo configurarlo y manejarlo, además de en qué puede sernos útil. En este artículo los elementos de la interfaz se llaman según su versión inglesa. En otros idiomas los nombres de los ele- mentos pueden variar según lo avanzada que vaya la traducción de la interfaz. Ejemplo real Soy un desdichado propietario de una memoria horriblemente floja. Hace mucho solía yo cubrir montones de hojas con mis recados, pero después igual olvidaba dónde las había puesto. Tampoco varias agendas y organizadores me valían para mucho. En fin, algún día, navegando por la Wikipedia, pensé: ¿por qué no usar esto en casa? Evidentemente, ahora puedo agre- gar con facilidad la información de los ani- versarios (por ejemplo, las fechas de los cum- pleaños 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 escaparían en media hora, o en unos días cómo máximo. Además, es trivial la creación de enlaces entre tal información: no tengo que pre- ocuparme ni de la sintaxis HTML ni del lenguaje PHP. Además, mi familia tam- bién aprovecha estas páginas, e incluso introduce en ellas alguna cosa. Y es que se trata de uno de los muchos usos potencia- les del wiki. Configuración Concluida la instalación (al final del artículo explicamos cómo llevarla a cabo), MediaWiki está prácticamente lista para el uso. La con- figuración por defecto parece razonable. Desde luego, merece la pena verificar la con- figuración y asegurarse de que corresponde a nuestras necesidades. El principal fichero de configuración de MediaWiki se llama LocalSettings.php y está situado en el directorio donde he- mos instalado nuestro wiki. Si deseamos cambiar cualquier opción, debemos hacer- En el DVD En el DVD se encuentran las aplicaciones descritas en los artículos.

Transcript of MediaWiki – un wiki para todos.pdf

  • para principiantes

    70 Linux+ 7/2006 71www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    MediaWiki un wiki para todosPiotr Machej

    Todos los das aparece un mon-tn de pginas web. Algunas lle-varn mucho tiempo desarro-llndose, otras sern abandona-

    das por sus autores inmediatamente, o en poco tiempo. No es un gran problema, si se trata simplemente de una pgina perso-nal. 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, depen-diendo de la configuracin) sern capaces de introducir las mejoras y hacer que la web siga actual. El mecanismo wiki se va hacien-do ms y ms popular, se van estrenan-do cada vez ms pginas que hacen uso de esta tecnologa: los tutoriales del juego Go, las enciclopedias, y muchas otras pgi-nas. El ejemplo ms destacado del emp-leo del mecanismo wiki parece ser la popu-lar 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 ele-mentos pueden variar segn lo avanzada que vaya la traduccin de la interfaz.

    Ejemplo realSoy 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 agre-gar con facilidad la informacin de los ani-versarios (por ejemplo, las fechas de los cum-pleaos 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 pre-ocuparme ni de la sintaxis HTML ni del lenguaje PHP. Adems, mi familia tam-bin aprovecha estas pginas, e incluso introduce en ellas alguna cosa. Y es que se trata de uno de los muchos usos potencia-les del wiki.

    ConfiguracinConcluida la instalacin (al final del artculo explicamos cmo llevarla a cabo), MediaWiki est prcticamente lista para el uso. La con-figuracin por defecto parece razonable. Desde luego, merece la pena verificar la con-figuracin 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 he-mos instalado nuestro wiki. Si deseamos cambiar cualquier opcin, debemos hacer-

    En el DVDEn el DVD se encuentran las aplicaciones descritas

    en los artculos.

  • para principiantes

    70 Linux+ 7/2006 71www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    lo precisamente en este fichero. Algunas de las opciones descritas en este artculo no forman parte del fichero por defecto Lo-calSettings.php, sino que necesitan aadirse 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 introdu-cimos sola y nicamente en el fichero Lo-calSettings.php. Podemos editarlo a travs de cualquier editor de texto (por ejemplo, GEdit gedit LocalSettings.php).

    Durante la instalacin fijamos la mayo-ra de las opciones cruciales de este fichero, ya que nos ocuparemos de l a continua-cin, cuando sea necesario.

    Opciones del usuarioCada usuario puede habilitar en cierta me-dida la configuracin a sus necesidades. Para conseguirlo, primero, hay que vali-darse en el servicio, utilizando el enlace Log in, que aparece en el rincn superior dere-cho. 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 dispone-mos de toda una serie de pestaas.

    En la primera podemos introducir nue-stro e-mail (es necesario activarlo a travs

    de un enlace que se enviar automtica-mente a la direccin que hemos sealado). Si suministramos nuestro e-mail, otros usu-arios registrados podrn enviarnos men-sajes por correo electrnico. Es importante que nuestra direccin no se dejar ver pornadie, el usuario registrado simplemen-te entra en nuestra pgina personal (por ejemplo: http://localhost/~user/wiki/index.php/User:WikiSysop) y aprovecha el enlace E-mail this user. Podemos determinar tam-bin el apodo, que se visualizar como nues-tra firma, en vez del nombre de usuario. Es de

    buen gusto que este apodo se aproxime lo ms posible al nombre del usuario, o queen este campo simplemente figuren el nom-bre 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 comuni-carnos 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 inter-faz. En este artculo asumimos que se em-plea MonoBook, la piel por defecto (las pie-les concretas pueden variar no slo en co-lores, sino tambin en la disposicin de los enlaces y la localizacin de los elementos de la interfaz).

    En las pestaas siguientes podemos li-mitar el tamao de las imgenes visualiza-das, as como el de sus miniaturas, fijar elformato de la fecha y la franja horaria (me-rece 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.

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

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

  • para principiantes

    72 Linux+ 7/2006 73www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    Moverse por un wikiTras entrar en la pgina principal de nuestro wiki nos toparemos con su dispo-sicin caracterstica. En la parte superior izquierda se sita un lugar destinado para el logo. Por debajo est el panel de nave-gacin, el dilogo de bsqueda y el panel de herramientas (toolbox). Gran parte de la pantalla est ocupada por el espacio prin-cipal, 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 usua-rio, sus pginas de discusin y un enlace a la entrada en el servicio o la creacin de cuenta nueva.

    Creacin de cuenta nuevaAunque 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 p-gina personal y cambiar la configuracin. Adems, independientemente del orde-nador del que nos serviremos para efec-tuar los cambios, stos vendrn a nuestra cuenta (los usuarios annimos se identi-fican segn su nmero IP, de modo que les cuesta ms seguir los cambios realiza-dos).

    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 usua-rio, que queremos emplear, y dos veces la contrasea. Opcionalmente podemos indi-car el e-mail. Si decidimos hacerlo, tene-mos 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 autom-ticamente.

    Panel de navegacinAl 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 elwiki.

    Otra pgina que empieza a funcionar de inmediato es Recent changes que contie-ne una lista de los cambios recientes intro-ducidos 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 intro-ducido 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

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

    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 con-junto de sencillas etiquetas. Lo mismo se aplica a la creacin de los enlaces publi-cados 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 limi-tarse a la seleccin del nombre y contra-sea 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 simul-tneamente.

    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.

  • para principiantes

    72 Linux+ 7/2006 73www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

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

    BsquedaEl dilogo de bsqueda, aunque muy sen-cillo (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 may-scula 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 uti-liza por defecto. Primero comprueba, si exi-ste la pgina que corresponde con exac-titud 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 nom-bres 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 con-figuracin en la pagina de la bsqueda, aadiendo o eliminando la seleccin de ca-da uno de los espacios de nombres.

    Panel de herramientasEl 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 visua-lizar 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 per-sona 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.

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

    Instalacin desde paquetes de distribucinEn 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 ca-so de la distribucin Fedora Core debe ser suficiente el comando yum install mediawiki mediawiki-math (ambos pa-quetes forman parte del repositorio Ex-tras), y en el caso de Ubuntu apt-get install mediawiki mediawiki-math.

    Las indicaciones acerca de la insta-lacin y configuracin en estas distribu-ciones, as como de otras, las podemos encontrar entre los enlaces que se hallan en: http://meta.wikimedia.org/wiki/Help:In-stallation.

    Si nos interesan los cambios produci-dos en las pginas a las cuales llevan los enlaces de la pgina actual, debemos utili-zar el enlace Related changes. ste har que aparezca la lista de los cambios en un for-mato igual al del caso Recent changes, pero la lista slo abarcar las pginas enlazadas con la actual.

    Gracias al enlace Special pages obten-dremos acceso a la lista de pginas espe-ciales. 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 impres-cindible 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 ve-rificar 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

  • para principiantes

    74 Linux+ 7/2006 75www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    poner en algn sitio un enlace a esta ver-sin 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 menciona-dos, despus de entrar en la pgina per-sonal 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 p-gina donde se pueden examinar los cam-bios 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.

    Comparacin de versionesEmpleando la pestaa history podemos fa-miliarizarnos con el historial de los cam-bios realizados. Los enlaces aqu dispo-nibles nos permiten comparar la versin seleccionada con la que le sigue directa-mente (last) o con la ms actual (cur). Ade-ms, podemos seleccionar dos versiones concretas y compararlas, tras pulsar el bo-tn Compare selected versions.

    El contenido de las pginas compara-das aparece dividida en dos en la pantalla. En la parte superior se visualiza la informa-cin sobre la versin concreta, y por debajo

    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 res-pecto al contenido de las lneas se marcan en rojo.

    En la parte inferior de la pgina apare-ce el contenido de la versin ms actual de las dos que se comparan con la presente.

    Creacin y edicin de la webYa es hora de que pasemos a lo ms entu-siasmante en el wiki, o sea, a la creacin de las pginas. Como ya hemos creado nuestra propia cuenta, podemos experi-mentar 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 colo-cada en la parte de arriba. Esto nos har pasar al modo de edicin. Dado que nues-tra 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.

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

    Formateado de textoEmpecemos por un ttulo tipo My Perso-nal Page. Para marcar un ttulo de seccin empleamos los signos = fijados a la iz-quierda y a la derecha del texto. La canti-dad de signos = corresponde al nivel del ttulo. De modo que el ttulo ms alto lo podemos conseguir tecleando la lnea:

    = My Personal Page =

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

    ====== Head 6 ======

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

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

    Espacios de nombresEn el contexto del wiki los espacios de nombres (namespaces) sirven para dife-renciar el contenido comn y las pginas personales de los usuarios, las discusio-nes, las pginas de ayuda, y otras. Gra-cias 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 discu-sin 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 prin-cipal de nombres que se emplea en Me-diaWiki 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 casua-lidad a ninguna pgina destinada para la comunidad de los autores del servicio, tales como sus pginas personales o las discusiones.

  • para principiantes

    74 Linux+ 7/2006 75www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    Instalacin en la cuenta sin acceso a la capaPodemos proceder, segn las indicacio-nes de la seccin Instalacin, no slo a la hora de realizar la instalacin en nues-tra 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 compro-bar si la interfaz de la cuenta permite des-comprimir los archivos que se depositan en ella. Si es as, procedemos de forma prcticamente igual a lo explicado en la seccin Instalacin (slo que descompri-mimos el archivo por medio de la inter-faz). Si no, tenemos que descomprimir el archivo de forma local y slo despus enviar toda su estructura en la cuenta remota.

    Tambin la cursiva la obtenemos gracias a la comilla simple, esta vez doble: ''italic text''. Estas etiquetas las podemos com-binar, 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 l-nea, no lograremos nada. Como resultado el texto seguir en una lnea. Slo si deja-mos una lnea libre, se producir un prrafo nuevo.

    Las listas numeradas y no numeradas se crean hasta de manera trivial. La almo-hadilla # puesta al inicio de lnea es res-ponsable de las primeras, mientras que el signo * responde por las otras. La pri-mera lnea que empieza con # obtendr el nmero 1, la siguiente, 2 y as por el estilo. Podemos emplear varios niveles de nume-racin, por ejemplo, el segundo nivel (que se distingue del primero con un sangra-do ms profundo) lo marcamos con dos almohadillas ## al inicio de la lnea. En el caso de las listas no numeradas proce-demos de forma analga, empleando los cuadritos caractersticos en vez de los n-meros 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

    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.

    EnlacesMs o menos tarde nos gustara crear un enlace a otra pgina. Por ejemplo, redac-tando 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 lapgina llamada City, y en la pgina apare-cern las palabras My hometown. Frecuen-temente, 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 codifi-cacin 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 automtica-mente en maysculas).

    Es todava ms fcil crear enlaces a p-ginas externas, ya que basta indicar su di-reccin web, y sta se convertir sin ms en un enlace listo para hacerle clic. Pa-ra visualizar un nombre en vez de la dire-ccin habr que ayudarse de la frmu-la siguiente: [http://www.wikipedia.org/ Wikipedia] (fijmonos en el espacio entre la direccin y el nombre).

    Otras capacidadesLos 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 conocimien-to uno es capaz de crear tablas, aadir di-bujos y colgarlos, crear frmulas matem-ticas, y hacer mucho ms. En la pgina http://meta.wikimedia.org/wiki/Help:Editing , entre otras, podemos hallar una lista am-plia de las etiquetas que pueden utilizar-se y cuyos ejemplos de uso estn bien ex-plicados.

    Antes de guardar los cambios mediante el botn Save page conviene asegurarse del resultado final. Para ello es suficiente acti-

    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 rea-lizar 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 corre-gir una letra mal tecleada o desarrollar slo una seccin del artculo.

    Crear pgina nuevaNo 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 per-mite pasar a la creacin de la pgina (You can create this page). Un mtodo ms resi-de en teclear en la barra de direccin del navegador la direccin completa que indi-ca la pgina que nos gustara aadir. La ma-yora 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 servidorEn MediaWiki la posibilidad de enviar archivos al servidor queda desactivada por defecto. Desde luego, sin esta herramienta no podremos fijar con facilidad los dibu-jos, las fotos ni otros ficheros en las pgi-nas. Por esto cambiaremos estas opciones.

    Para conseguirlo, en el fichero Local-Settings.php cambiamos el valor de las

  • para principiantes

    76 Linux+ 7/2006 77www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    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 co-mando chmod a+w images. Aunque es mu-cho mejor cambiar el propietario por el usuario de apache (a travs del comando chown apache:apache images), esto requie-re los permisos del administrador.

    Realizados estos cambios, en el panel toolbox debe aparecer un enlace nuevo: Up-load file. Despus de seleccionarlo, hay que indicar el archivo por enviar y teclear el nombre 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 repre-senta Londres por la noche). Adems, po-demos aadir una descripcin del archivo(por ejemplo, de dnde procede y en base a qu licencia se distribuye). Luego le da-mos a Upload file.

    Si durante el envo del archivo apare-ce el mensaje "The file is corrupt or has an in-correct extension. Please check the file and up-load again.", al fichero de configuracin Local-Settings.php hay que aadirle la lnea:

    $wgMimeDetectorCommand= "file -bi";

    Esto soluciona muchos de los casos as.Hablando del envo de los dibujos al

    servidor, podemos mencionar cmo utili-

    zarlos en nuestras pginas. Al editar la p-gina hay que utilizar la etiqueta [[Image:London_by_night.png|Rainy night in Lon-

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

    Cambio del logoHa llegado la hora de decidir cmo ser el logo de nuestro wiki. Empezamos pre-parando el dibujo en el programa grfico (por ejemplo, The Gimp). El dibujo debe tener forma rectangular, ya que acabare-mos 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 pre-sentar 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 configu-racin, o bien lo fijamos bajo otro nom-bre. Entonces tenemos que indicarle a Me-diaWiki dnde est el fichero con el logo.Para ello abrimos el fichero LocalSet-tings.php y determinamos la ruta al fiche-ro del logo que tiene la forma siguiente:

    $wgLogo = "$wgStylePath/common/images/

    wiki.png";

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

    Extensiones para el navegador FirefoxEn la web http://wikipedia.mozdev.org/ podemos encontrar la extensin Wikipedia Tool-bar para el navegador Firefox que hace mu-cho ms fcil la edicin del wiki a travs de dicho navegador. Tras instalar la exten-sin recibimos una barra de herramientas nueva as como muchos elementos adicio-nales a travs del men contextual. En las preferencias de la extensin podemos indi-car los servicios wiki que ste debe sopor-tar (podemos definir unos propios). Las opciones disponibles permiten, por ejem-plo, 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 idio-mas pueden ocurrir problemas de Firefox con algunos atajos de teclado. Desde luego, gracias a la extensin podemos concentrar-nos 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.

    InstalacinMediaWiki 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 reco-mienda 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 ejem-plo, phpMyAdmin), ya que sta luego pue-de servirnos, por ejemplo, para producir las copias de seguridad.

    Lo ms fcil es instalar MediaWiki en un servidor web propio, pero se lo puede ins-talar 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

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

  • para principiantes

    76 Linux+ 7/2006 77www.lpmagazine.org

    para principiantesIntroduccin al manejo del mecanismo wiki

    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 pre-fijo 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 nom-bre cambiamos por uno ms oportuno (por ejemplo, wiki/) a travs del comando mv mediawiki-1.6.3 wiki. Entramos en el di-rectorio (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 configuracinAhora podemos arrancar ya el navegador (por ejemplo, Firefox) abriendo all la direc-cin 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 aho-ra slo est all el enlace a la pgina de con-figuracin que, por supuesto, debemos uti-lizar.

    La pgina de configuracin est divi-dida en un par de secciones. La primera contiene informacin del resultado de veri-ficacin 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 Media-Wiki, 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 adminis-trador (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 intercepta-cin).

    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: des-activado, 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 gene-rar una carga considerable. Para terminar, disponemos si las direcciones de e-mail suministradas por los usuarios deben veri-ficarse por medio del envo de mensajes con un enlace a la pgina que activa la di-reccin 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 adminis-trador 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 Media-Wiki.

    Actividades finalesAl leer los mensajes de la instalacin, pri-mero hay que asegurarse de que la insta-lacin ha terminado con xito. Si es as, el fichero que acaba de generarse, el config/

    LocalSettings.php lo movemos al directo-rio 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 p-gina actual podemos pasar a la pgina principal de nuestro wiki (o sea, en nues-tro ejemplo, http:/localhost/~user/wiki/index.php).

    Con esto termina la instalacin y la con-figuracin preliminar de MediaWiki. Desde ahora slo podemos aadirle contenido nue-vo, igual que pueden hacerlo otros usua-rios (tanto los annimos, como los que tienen sus cuentas).

    Para terminarComo 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 proyec-tos 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 ex-perimentis por vuestra propia cuenta y queos juntis a alguna de las comunidades que trabajan sobre varios servicios wiki. Es que gracias al trabajo de ellas los ser-vicios siguen en desarrollo y van atrayen-do 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/