Page 1

para principiantes

MediaWiki – un wiki para todos Piotr Machej

T

En el DVD

En el DVD se encuentran las aplicaciones descritas en los artículos.

70

Linux+ 7/2006

odos los días aparece un montón de páginas web. Algunas llevarán mucho tiempo desarrollándose, otras serán abandonadas por sus autores inmediatamente, o en poco tiempo. No es un gran problema, si se trata simplemente de una página personal. 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, dependiendo de la configuración) serán capaces de introducir las mejoras y hacer que la web siga actual. El mecanismo wiki se va haciendo más y más popular, se van estrenando cada vez más páginas que hacen uso de esta tecnología: los tutoriales del juego Go, las enciclopedias, y muchas otras páginas. El ejemplo más destacado del empleo del mecanismo wiki parece ser la popular 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 elementos 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 agregar con facilidad la información de los aniversarios (por ejemplo, las fechas de los cumpleañ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 preocuparme ni de la sintaxis HTML ni del lenguaje PHP. Además, mi familia también aprovecha estas páginas, e incluso introduce en ellas alguna cosa. Y es que se trata de uno de los muchos usos potenciales 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 configuración por defecto parece razonable. Desde luego, merece la pena verificar la configuració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 hemos instalado nuestro wiki. Si deseamos cambiar cualquier opción, debemos hacer-


Introducción al manejo del mecanismo wiki

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 artículo no forman parte del fichero por defecto LocalSettings.php, sino que necesitan añadir se a éste. Las configuraciones por defecto de las opciones que no van determinadas en el fichero en cuestión se guardan en el fichero includes/DefaultSettings.php. No se debe realizar en él ninguna modificación manual en absoluto, ya que ésta se perderá a la hora de actualizarse MediaWiki a su nueva versión. Los cambios, los introducimos sola y únicamente en el fichero LocalSettings.php. Podemos editarlo a través de cualquier editor de texto (por ejemplo, GEdit – gedit LocalSettings.php). Durante la instalación fijamos la mayoría de las opciones cruciales de este fichero, ya que nos ocuparemos de él a continuación, cuando sea necesario.

de un enlace que se enviará automáticamente a la dirección que hemos señalado). Si suministramos nuestro e-mail, otros usuarios registrados podrán enviarnos mensajes por correo electrónico. Es importante que nuestra dirección no se dejará ver por nadie, el usuario registrado simplemente entra en nuestra página personal (por ejemplo: http://localhost/~user/wiki/index.php/ User:WikiSysop) y aprovecha el enlace Email this user. Podemos determinar también el apodo, que se visualizará como nuestra firma, en vez del nombre de usuario. Es de

para principiantes

buen gusto que este apodo se aproxime lo más posible al nombre del usuario, o que en este campo simplemente figuren el nombre y apellido. Además, podemos, cambiar la contraseña del usuario, y - si hemos indicado un e-mail correcto - decidir, qué mensajes deben llegar a nuestro buzón de correo. Además, podemos seleccionar el idioma en el que la interfaz debe comunicarnos los mensajes. En este lugar se puede bloquear también la recepción de mensajes de otros usuarios registrados (en tal caso el enlace de dirección, ya mencionado, será invisible para ellos). La segunda pestaña nos permite elegir la piel, y por lo tanto, el aspecto de la interfaz. En este artículo asumimos que se emplea MonoBook, la piel por defecto (las pieles concretas pueden variar no sólo en colores, sino también en la disposición de los enlaces y la localización de los elementos de la interfaz). En las pestañas siguientes podemos limitar el tamaño de las imágenes 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 edición, a la vista de los últimos cambios, la búsqueda de información y un par de opciones más (como por ejemplo si para las páginas de tres títulos o más el índice debe aparecer automáticamente). Introducidas las modificaciones, no olvidemos guardar los cambios dándole a la tecla Save.

Opciones del usuario

Cada usuario puede habilitar en cierta medida la configuración a sus necesidades. Para conseguirlo, primero, hay que validarse en el servicio, utilizando el enlace Log in, que aparece en el rincón superior derecho. Tras indicar el nombre de usuario (por ejemplo, el que se acaba de crear durante la instalación, WikiSysop) y la contraseña, le damos al enlace preferences (que también aparece en el rincón superior derecho). Veremos una página en la que disponemos de toda una serie de pestañas. En la primera podemos introducir nuestro e-mail (es necesario activarlo a través

Figura 2. Para validarse wiki basta elegir la contraseña y el nombre de usuario

www.lpmagazine.org

71


para principiantes

¿Qué es un wiki?

Hablando de wiki pensamos en un género de las páginas 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 básicas 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 creación de los enlaces publicados en el mismo servicio, así como a los que llevan a otras páginas web. Existen muchísimos servicios que

Figura 3. Merece la pena verificar el aspecto de la página antes de guardar los cambios

emplean el mecanismo wiki y que pueden ser modificados por usuarios anónimos. Otros pueden requerir que el usuario se registre en el sistema (lo que suele limi-

Moverse por un wiki

Tras entrar en la página principal de nuestro wiki nos toparemos con su disposición característica. En la parte superior izquierda se sitúa un lugar destinado para el logo. Por debajo está el panel de navegación, el diálogo de búsqueda y el panel de herramientas (toolbox). Gran parte de la pantalla está ocupada por el espacio principal, donde aparece el propio contenido de la página. Por arriba de éste se ve una serie de enlaces/pestañas (cuyo número depende de si nos hemos validado en el servicio y de los permisos que tenemos). En el rincón superior derecho se colocan los enlaces a la página personal del usuario, sus páginas de discusión y un enlace a la entrada en el servicio o la creación de cuenta nueva.

Creación de cuenta nueva

Aunque se puede utilizar el wiki de forma anónima (si la configuración 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 configuración. Además, independientemente del ordenador del que nos serviremos para efectuar los cambios, éstos vendrán a nuestra cuenta (los usuarios anónimos se identifican según su número IP, de modo que les cuesta más seguir los cambios realizados).

72

Linux+ 7/2006

Para crear una cuenta hay que emplear el enlace log in / create account colocado en el rincón 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 contraseña. 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 dirección. Además, podemos indicar nuestros verdaderos nombres y apellidos: en tal caso nuestro trabajo en el wiki se asociará con nuestro apellido. Después de pulsar el botón Create account se activará nuestra cuenta y nos validaremos automáticamente.

Panel de navegación

Al principio la mayoría de los enlaces colocados en el panel navigation lleva a las páginas sin contenido. La forma que va a tomar la página principal (Main Page), el portal de la comunidad (Community Portal) y otras páginas allí ubicadas depende de nosotros mismos y de otros usuarios del wiki. El contenido por defecto de la página principal es muy escaso y está compuesto prácticamente sólo de los enlaces a los manuales del usuario y otra información útil a la hora de empezar a trabajar con el wiki. Otra página que empieza a funcionar de inmediato es Recent changes que contiene una lista de los cambios recientes introducidos en las páginas del wiki. Allí pode-

tarse a la selección del nombre y contraseña del usuario y suministro del e-mail de contacto), o incluso dar permisos de cambio sólo 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 páginas web, en la sencillez del uso y en la posibilidad de que las páginas sean creadas por muchos usuarios simultáneamente. La facilidad de introducir cambios quiere decir también que el wiki queda expuesto a cualquier acto de vandalismo (ya sea el borrado de todo el contenido, o la adición de contenidos no deseados o indecentes). Por suerte, es igual de fácil restaurar cualquier versión anterior de la web, y los gamberros sin remedio se pueden bloquear en el servicio.

mos llegar a saber qué páginas acaban de modificarse, cuándo y por parte de quién. Además, es posible utilizar los enlaces que comparan la versión actual con la anterior y los que llevan al historial de los cambios realizados en la página. Los enlaces a la página personal del usuario que ha introducido los cambios, a sus discusiones y la lista de todos los cambios introducidos por este usuario también permanecen activos. Es muy interesante el enlace Random page. Como lo sugiere el nombre mismo, éste nos lleva a una página aleatoria. Desde


Introducción al manejo del mecanismo wiki

Figura 4. Los dibujos que se envían al servidor los podemos utilizar luego en las páginas

luego, hasta que creemos páginas nuevas (lo que se comenta a continuación), nos veremos condenados a la página principal.

Búsqueda

El diálogo de búsqueda, aunque muy sencillo (un campo de edición y dos botones) ofrece unas capacidades considerables, aunque se podrían soñar más perfectas. Si después de introducir el texto buscado en el campo de edición pulsamos la tecla [Enter], esta acción equivaldrá al uso del botón Go. Para seleccionar Search hay que emplear el ratón o la tecla del tabulador. Conviene añadir también que la búsqueda no es sensible a minúsculas/mayúsculas (lo que no se aplica a los signos diacríticos nacionales: en su caso el wiki toma la mayúscula y la minúscula como dos caracteres distintos). Desafortunadamente, no existe la posibilidad de utilizar las expresiones regulares. En la mayoría de los casos, cuando sabemos qué es lo que estamos buscando, debe ser suficiente el botón Go que se utiliza por defecto. Primero comprueba, si existe la página que corresponde con exactitud a la palabra tecleada. Si no, intenta verificar un par de configuraciones más, modificando mayúsculas/minúsculas. Si vuelve a fracasar en la búsqueda, intenta dar con las palabras deseadas en los nombres de las páginas. Si el resultado sigue sin aparecer, arranca la búsqueda completa, la que ejecutaríamos si pulsáramos la tecla Search.

La búsqueda del contenido de las páginas sólo se efectúa en los espacios de nombres (namespaces) que hemos definido en nuestras preferencias. Si es necesario, podemos cambiar temporalmente tal configuración en la pagina de la búsqueda, añadiendo o eliminando la selección de cada uno de los espacios de nombres.

Panel de herramientas

El contenido del panel toolbox puede variar según la configuración y la página actualmente visualizada. A nosotros, nos interesa más, desde luego, el contenido de este panel por defecto para las páginas del espacio principal de los nombres. El enlace What links here permite visualizar las páginas que contienen los enlaces a la actualmente vista. Por cierto, aquí sólo se trata de las páginas que forman parte del mismo servicio wiki. El enlace resulta útil si queremos comprobar qué páginas tienen enlaces al contenido de nuestro artículo actual. Es que aunque en caso de alguna información que se enlaza así se coloque el enlace de vuelta, esto no siempre tiene sentido. Un ejemplo típico es la situación cuando la información sobre alguna persona dice que visitó cierto país y allí se fija el enlace que describe tal país. Mientras tanto, en la descripción del país no se mencionará la persona, siendo la mayoría de las veces demasiado insignificante la información. En tal caso, al seleccionar el enlace en la página del país podemos llegar a saber de la persona, que lo visitó.

para principiantes

Si nos interesan los cambios producidos en las páginas a las cuales llevan los enlaces de la página 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 sólo abarcará las páginas enlazadas con la actual. Gracias al enlace Special pages obtendremos acceso a la lista de páginas especiales. Entre ellas se pueden hallar la lista de todas las páginas, la de las páginas populares, de las abandonadas, la lista de ficheros, así como muchas más, como por ejemplo las estadísticas, los mensajes de sistema o la lista de usuarios. El enlace Printable version desempeña una función curiosa. Visualiza sólo el contenido de una página en forma lista para imprimir, es decir, sin elementos de la interfaz del wiki. Es útil, aunque no imprescindible en la mayoría 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 página 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 versión particular y concreta de la página que vemos de momento. De modo que si nos importa

Instalación desde paquetes de distribución

En algunas distribuciones se puede dar con un modo bastante fácil de instalar MediaWiki desde los paquetes. Esto, de todas formas, requiere los permisos del administrador y resulta en la instalación del directorio principal en el directorio del servidor Apache (y no en el directorio del usuario, como en la descripción incluida en la sección Instalación). De modo que, por ejemplo, en el caso de la distribución 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 instalación y configuración 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 título tipo My Personal Page. Para marcar un título de sección empleamos los signos = fijados a la izquierda y a la derecha del texto. La cantidad de signos = corresponde al nivel del título. De modo que el título más alto lo podemos conseguir tecleando la línea: = My Personal Page =

Figura 5. Gracias a Wikipedia Toolbar, crear tablas es cosa de niños

poner en algún sitio un enlace a esta versión y no a la versión más actual posible, debemos copiar la dirección de este enlace. Después de emplearlo podemos ver la página en sus sucesivas versiones con la ayuda de los enlaces colocados debajo del título de la página. Además de los enlaces ya mencionados, después de entrar en la página personal de algún usuario (para eso podemos teclear en el diálogo de búsqueda, por ejemplo, el nombre del usuario precedido con User:, por ejemplo: User:WikiSysop y darle al Go). En el panel toolbox aparecerá uno o más enlaces adicionales. El primero será User contributions, que lleva a una página 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 opción.

Comparación de versiones

Empleando la pestaña history podemos familiarizarnos con el historial de los cambios realizados. Los enlaces aquí disponibles nos permiten comparar la versión seleccionada con la que le sigue directamente (last) o con la más actual (cur). Además, podemos seleccionar dos versiones concretas y compararlas, tras pulsar el botón Compare selected versions. El contenido de las páginas comparadas aparece dividida en dos en la pantalla. En la parte superior se visualiza la información sobre la versión concreta, y por debajo

74

Linux+ 7/2006

se dejan ver las diferencias detectadas. Las líneas del mismo contenido se colorean en gris. Los signos + y el color verde marcan las líneas añadidas, y los signos - y el color amarillo, las eliminadas. Los cambios respecto al contenido de las líneas se marcan en rojo. En la parte inferior de la página aparece el contenido de la versión más actual de las dos que se comparan con la presente.

Creación y edición de la web

Ya es hora de que pasemos a lo más entusiasmante en el wiki, o sea, a la creación de las páginas. Como ya hemos creado nuestra propia cuenta, podemos experimentar en nuestra página personal. Para conseguirlo, basta seleccionar el enlace con el nombre del usuario que se sitúa en la parte superior de la ventana. Si éste aparece en rojo, la página a la que lleva todavía no existe. En tal caso, si entramos en esta página, lo sabremos de inmediato. De modo que podemos seleccionar la pestaña edit colocada en la parte de arriba. Esto nos hará pasar al modo de edición. Dado que nuestra página todavía no existe, la ventana de edición está vacía. Si la página existiera, aparecería su código fuente. Según la configuración del navegador y de las preferencias de la interfaz de MediaWiki que hemos fijado, por encima del campo de edición pueden situarse los botones que facilitan el formateado de texto. Para funcionar requieren JavaScript.

Los dos niveles más altos de los títulos se caracterizan por las líneas horizontales adicionales que separan el título del contenido. Los demás no tienen estas líneas. Hay seis niveles de títulos disponibles, así que el nivel más bajo tiene la forma de: ====== Head 6 ======

Debajo del título tecleamos el texto ordinario. Si queremos poner algún 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 común y las páginas personales de los usuarios, las discusiones, las páginas de ayuda, y otras. Gracias a ellos es posible emplear el mismo nombre para varios fines. Por ejemplo el usuario Gerard tiene su página personal llamada User:Gerard, y su página de discusión 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 página. El espacio principal de nombres que se emplea en MediaWiki no se define con ningún nombre, por eso le pertenecen todas las páginas, cuyos nombres del espacio de nombres quedan indefinidos (por ejemplo, la página principal con su nombre Main Page). La búsqueda y el orden de las páginas se limita por defecto precisamente al espacio principal de nombres. Gracias a ello los usuarios “comunes” no llegarán por casualidad a ninguna página destinada para la comunidad de los autores del servicio, tales como sus páginas personales o las discusiones.


Introducción al manejo del mecanismo wiki

Instalación en la cuenta sin acceso a la capa

Podemos proceder, según las indicaciones de la sección Instalación, no sólo a la hora de realizar la instalación en nuestra cuenta, sino también 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 prácticamente igual a lo explicado en la sección Instalación (sólo que descomprimimos el archivo por medio de la interfaz). Si no, tenemos que descomprimir el archivo de forma local y sólo después enviar toda su estructura en la cuenta remota.

También 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 gustaría 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 línea. Sólo si dejamos una línea libre, se producirá un párrafo nuevo. Las listas numeradas y no numeradas se crean hasta de manera trivial. La almohadilla # puesta al inicio de línea es responsable de las primeras, mientras que el signo * responde por las otras. La primera línea que empieza con # obtendrá el número 1, la siguiente, 2 y así por el estilo. Podemos emplear varios niveles de numeración, por ejemplo, el segundo nivel (que se distingue del primero con un sangrado más profundo) lo marcamos con dos almohadillas ## al inicio de la línea. En el caso de las listas no numeradas procedemos de forma analóga, empleando los cuadritos característicos 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 línea sin alguno de los signos de numeración. Los símbolos de numeración que se hallan después de tal línea encabezan una lista nueva.

Enlaces

Más o menos tarde nos gustaría crear un enlace a otra página. Por ejemplo, redactando la información de nuestra población natal podemos crear un enlace a la página de tal población. Si ésta debe relacionarse con una página de nuestro servicio wiki, basta poner su nombre en corchetes dobles, así: [[City]]. En la misma página nos puede gustar, en cambio, fijar otro texto, sin que sea solo el nombre de la población. Lo tenemos igualmente fácil: [[City|My hometown]]. Entonces el enlace llevará a la página llamada City, y en la página aparecerán 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 arreglárnoslas con el método que acaba de mostrarse visualizando otro texto o, en algunos casos, empleando una codificación más sencilla, como en el ejemplo [[house]]s. Entonces la forma del enlace será houses, pero éste nos conducirá a la página llamada House (las primeras letras de los enlaces se transforman automáticamente en mayúsculas). Es todavía más fácil crear enlaces a páginas externas, ya que basta indicar su dirección web, y ésta se convertirá sin más en un enlace listo para hacerle clic. Para visualizar un nombre en vez de la dirección habrá que ayudarse de la fórmula siguiente: [http://www.wikipedia.org/ Wikipedia] (fijémonos en el espacio entre la dirección y el nombre).

Otras capacidades

Los usuarios que conocen la sintaxis de HTML y CSS pueden utilizarla durante la edición para mejorar el aspecto de la página. Sin embargo, también sin este conocimiento uno es capaz de crear tablas, añadir dibujos y colgarlos, crear fórmulas matemáticas, y hacer mucho más. En la página 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 están bien explicados. Antes de guardar los cambios mediante el botón Save page conviene asegurarse del resultado final. Para ello es suficiente acti-

para principiantes

var la vista previa a través del botón Show preview. Si el efecto nos convence, en el campo Summary fijamos una descripción breve de los cambios que acabamos de realizar y sólo entonces guardamos la página. Una vez guardada la página, podemos notar que además del enlace para editarla, fijado en la parte superior de la pestaña, los enlaces parecidos están al lado de cada título. Gracias a ellos podemos editar sólo la sección concreta de la página, en vez de toda ella a la vez. Esto resulta muy práctico en particular cuando sólo queremos corregir una letra mal tecleada o desarrollar sólo una sección del artículo.

Crear página nueva

No trae ningún problema añadir contenido a una página ya existente. Con el ejemplo de la página personal del usuario hemos llegado a saber que es también muy fácil crear una página a la que nos conduce un enlace existente. Desde luego, ¿cómo crear una página completamente nueva? Hay una salida que parece natural: podemos crear un enlace a una página nueva en la actualmente existente. Luego basta emplear este enlace y ya podemos ponernos a editar la nueva página. Este método tiene una ventaja básica: su contenido está accesible de inmediato desde otra página, no queda aislado. Sin embargo, si esto no nos importa demasiado, podemos emplear un método más simple. Basta teclear el nombre de la página que queremos crear en el diálogo de búsqueda y darle a Go. Si tal nombre no existe, veremos un enlace que nos permite pasar a la creación de la página (You can create this page). Un método más reside en teclear en la barra de dirección del navegador la dirección completa que indica la página que nos gustaría añadir. La mayoría de las veces es suficiente eliminar el último fragmento de una dirección real y sustituirlo con el nombre propuesto por nosotros. Entonces MediaWiki visualizará la información de que la página todavía está vacía 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 páginas. 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 también de que el servidor Apache tenga los permisos de escribir en el subdirectorio images/. El método más fácil 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 través 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. Después de seleccionarlo, hay que indicar el archivo por enviar y teclear el nom bre que lo identificará en la base de datos. Lo mejor sería 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). Además, podemos añadir una descripción del archivo (por ejemplo, de dónde procede y en base a qué licencia se distribuye). Luego le damos a Upload file. Si durante el envío del archivo aparece el mensaje "The file is corrupt or has an incorrect extension. Please check the file and upload again.", al fichero de configuración LocalSettings.php hay que añadirle la línea: $wgMimeDetectorCommand= "file -bi";

Esto soluciona muchos de los casos así. Hablando del envío de los dibujos al servidor, podemos mencionar cómo utili-

zarlos en nuestras páginas. Al editar la página hay que utilizar la etiqueta [[Image: London_by_night.png|Rainy night in London]].

Es evidente que no es muy distinta del enlace normal a un documento. Una descripción opcional aparecerá si ponemos el cursor de nuestro ratón por encima del dibujo.

Cambio del logo

Ha llegado la hora de decidir cómo será el logo de nuestro wiki. Empezamos preparando el dibujo en el programa gráfico (por ejemplo, The Gimp). El dibujo debe tener forma rectangular, ya que acabaremos reduciéndolo al tamaño de 135x135 píxeles. 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 configuración, o bien lo fijamos bajo otro nombre. Entonces tenemos que indicarle a MediaWiki dónde 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";

Desde este momento en nuestra página nos dará la bienvenida el logo nuevo

Extensiones para el navegador Firefox

En la web http://wikipedia.mozdev.org/ pode mos encontrar la extensión Wikipedia Toolbar para el navegador Firefox que hace mucho más fácil la edición del wiki a través de dicho navegador. Tras instalar la extensión recibimos una barra de herramientas nueva así como muchos elementos adicionales a través del menú contextual. En las preferencias de la extensión 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 añadir dibujos. En tales casos aparece un menú en el que se puede introducir la información que servirá de base para generar el código en el campo de edición. En cuanto a las funciones más sencillas, como por ejemplo, poner el texto en negrita, basta seleccionar el fragmento deseado y elegir la opción de negrita. La extensión es muy funcional y fácil de usar. De todas formas, en algunos idiomas pueden ocurrir problemas de Firefox con algunos atajos de teclado. Desde luego, gracias a la extensión podemos concentrarnos en crear la página, con las tablas más 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 verán una utilidad inmensa a esta extensión.

Instalación

Figura 6. A la hora de instalar MediaWiki conviene conocer la contraseña del administrador de la base de datos

76

Linux+ 7/2006

MediaWiki puede instalarse en cualquier distribución Linux bastante actual. Para funcionar necesita cualquier servidor web (se recomienda Apache de la serie 2.x), PHP en la versión al menos 4.3 (se recomienda 4.4.2 o 5.1.2) y un servidor MySQL de la serie 4.x (la versión recomendada es la 4.0.23 o alguna más reciente). Además, 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 más fácil es instalar MediaWiki en un servidor web propio, pero se lo puede instalar también en una cuenta suministrada por un proveedor. De todas formas, hay que recordar que tal cuenta debe cumplir los requisitos ya señalados (PHP y la base


Introducción al manejo del mecanismo wiki

MySQL). No es necesario crear una base de datos por separado para MediaWiki: si disponemos de sólo 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 instalación descargando el archivo desde la web del proyecto. La versión estable de MediaWiki más actual a la fecha de creación de este artículo es la número 1.6.3. Ahora bien, ya descargado el archivo, hay que fijarlo en algún directorio disponible desde la web (por ejemplo, en $HOME/public_html/). El paso siguiente es su descompresión con el comando tar xzvf mediawiki-1.6.3.tar.gz. Se crea el subdirectorio mediawiki-1.6.3/, cuyo nombre cambiamos por uno más oportuno (por ejemplo, wiki/) a través 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 configuración.

Página de configuración

Ahora podemos arrancar ya el navegador (por ejemplo, Firefox) abriendo allí la dirección que corresponde al directorio donde acabamos de fijar nuestra instalación de MediaWiki (por ejemplo, http://localhost/~user/ wiki/). A poco tiempo será esta la dirección donde operará nuestro wiki, pero por ahora sólo está allí el enlace a la página de configuración que, por supuesto, debemos utilizar. La página de configuración está dividida en un par de secciones. La primera contiene información del resultado de verificación del entorno. Merece la pena leerla y comprobar si todos los componentes requeridos están instalados en el sistema. Tras leer el mensaje You can install MediaWiki, podemos pasar a la sección siguiente. Aquí definimos el nombre de nuestro wiki (mejor que sea una palabra), la dirección 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 están completas. Elegimos también el tipo de licencia bajo la cual se hará disponible el contenido del wiki. Es muy importante, además, que se fije el nombre del usuario que cuenta con los permisos del administrador (por defecto, WikiSysop) así como su contraseña. Por cierto, la contraseña debe ser única y difícil de adivinar, para que alguien no autorizado no se haga con el

acceso (de todas formas, la contraseña se envía a través de un canal no protegido, por lo que está expuesta a la interceptación). La sección siguiente es responsable de los mensajes de e-mail, las notificaciones y la autenticación. Si el servidor no soporta el envío del correo, podemos desactivar por completo el envío de los e-mails. Si no lo hacemos, podemos decidir, si los usuarios tienen la posibilidad de enviarse mensajes entre sí. Podemos fijar la notificación a los usuarios en tres niveles disponibles: desactivado, notificar de los cambios en la página de discusión del usuario, o notificar los cambios en la página de discusión y en las páginas seguidas por el usuario. Esta última configuración 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 envío de mensajes con un enlace a la página que activa la dirección concreta después que el usuario se registre. La última sección es responsable de la configuración de la base de datos MySQL. Aquí suministramos la información como por ejemplo la dirección del servidor de la base de datos, nombre de la base, nombre y contraseña del usuario. Es obvio que el usuario debe contar con los permisos para crear la base (si ésta todavía 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 señalado no existe todavía, o si no cuenta con los permisos necesarios para crear la base y las tablas, merece la pena dar el nombre y contraseña de administrador de la base MySQL. En tal caso el instalador cuidará de todo por su propia cuenta. Si no disponemos de la contraseña 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.

Actividades finales

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

para principiantes

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 página actual podemos pasar a la página principal de nuestro wiki (o sea, en nuestro ejemplo, http:/localhost/~user/wiki/index. php). Con esto termina la instalación y la configuración preliminar de MediaWiki. Desde ahora sólo podemos añadirle contenido nuevo, igual que pueden hacerlo otros usuarios (tanto los anónimos, como los que tienen sus cuentas).

Para terminar

Como podemos ver, la instalación de MediaWiki no trae problemas, y ponerla en práctica es muy fácil y ameno. Espero que la posibilidad de experimentar por propia cuenta en un servidor propio haga que más usuarios tengan ánimo y se sientan a sus anchas modificando otras páginas wiki, como por ejemplo Wikipedia y los proyectos parecidos. Este artículo no presenta todas las capacidades de MediaWiki. El proyecto es de verdad muy desarrollado y funcional, además cuenta con enormes capacidades de configuración. Además de los cambios de la configuración que se describen en el artículo, se pueden introducir cambios en otras configuraciones por defecto, e incluso pueden modificarse los ficheros PHP haciendo que nuestro wiki llegue a ser hasta más excepcional y ajustado a nuestras necesidades. Os animo de todo corazón a que experimentéis por vuestra propia cuenta y que os juntéis 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: • • •

Página de MediaWiki: http://www.mediawiki.org/ Página de Wikipedia: http://www.wikipedia.org/ La extensión Wikipedia Toolbar para el navegador Firefox: http://wikipedia.mozdev.org/

www.lpmagazine.org

77

Rápido intercambio de archivos en Internet  

En el DVD para principiantes 70 Linux+ 7/2006 Piotr Machej En el DVD se encuentran las aplicaciones descritas en los artículos. www.lpmagazi...

Read more
Read more
Similar to
Popular now
Just for you