Cómo hacer un WIKIPublicado originalmente en la revista Linux+ DVD StarterKit http://lpmagazine.org/prt/view/starter-kit.html Colaborando en la generación y documentación de conocimientosA medida que más y más personas se van conectando y habituando a Internet en todo el mundo, el intercambio de ideas y experiencias se hace más rico. Al aparecer los blogs (o bitácoras personales) los internautas estábamos maduros para salir a publicar nuestras propias ideas, no solo recibir información, sino también producirla y trasmitirla por nuestra propia cuenta. Nacía la llamada Web 2.0. Pero los blogs son individuales, usualmente la única manera de colaborar con el creador de un blog es enviándole meros comentarios. Entonces aparecen en escena los sistemas tipo wiki, para cubrir la necesidad de que los lectores actúen también en calidad de autores de contenidos de los sitios que visitan. Un sistema wiki es un sitio web habilitado para que cualquier persona que accede con un navegador común y sin conocimientos técnicos de programación, pueda modificar sus textos e imágenes. Esto se logra habilitando en cada página del sitio un enlace a un formulario donde la persona puede modificar el texto de la página. Este formulario puede estar habilitado para que cualquier visitante edite la página, o puede estar protegido con contraseña para que solo un grupo de personas haga las modificaciones, además, los sistemas wiki guardan todas las versiones de las páginas modificadas, permitiendo recuperar un contenido que hubiera sido modificado incorrectamente. Actualmente, es archiconocida la fabulosa enciclopedia en línea llamada Wikipedia, cuyos contenidos fueron publicados por decenas de miles de colaboradores desde todas partes del mundo, en más de 10 idiomas. Pero no todos los wikis son públicos, la herramienta también resulta útil para organizar la documentación interna de procesos de una empresa o institución, donde los empleados pueden dejar documentado su trabajo muy fácilmente. Un wiki es tan flexible que podemos considerarlo el todo terreno de los sistemas dinámicos, hasta resulta útil para el trabajo de una sola persona! No solo sirve para sitios comunitarios sino también para sitios web personales, ya que por su facilidad de uso habilita a cualquiera a mantener actualizado su propio sitio web. Las manos en la masaSi he logrado trasmitir la idea hasta aquí, estarán preguntándose cómo empezar a utilizar esta poderosa herramienta. Para seguir los pasos que describiré a continuación, el lector solo necesita nociones mínimas de uso de Internet, saber qué es un FTP, saber cómo abrir y guardar archivos de texto simples, saber utilizar un navegador web. En Wikipedia (http://es.wikipedia.org) puede conseguir información facilitada y reforzar esos conceptos si lo necesita. Existen decenas de buenas herramientas wiki disponibles, cada una de ellas con sus propias ventajas. En este caso hemos seleccionado una bastante potente, pero que se caracteriza fundamentalmente por su facilidad de instalación y configuración posterior. Como contrapartida, no es la mejor herramienta para sitios web enormes, con cientos de miles de páginas y miles de visitantes y editores trabajando a la vez. El software seleccionado se llama PmWiki y para usarlo solo necesitamos un servidor web con PHP habilitado. No vamos a explicar la instalación del servidor web ni de PHP, la idea es que el lector instale Apache y PHP con la configuración estándar proporcionada por su distro GNU preferida, o bien contrate un servicio de alojamiento web, cualquier servicio económico que ofrezca PHP debería servir. PmWiki almacena los textos e imágenes en archivos simples en el servidor, por lo tanto no necesita una base datos SQL. El escenario de instalaciónPara el caso, asumiremos que contamos con un servicio de alojamiento web basado en Apache y PHP, al cual podemos acceder mediante FTP para subir archivos y modificarlos. Para acceder al servidor FTP utilizaré el administrador de archivos de KDE, el Konqueror, ya que gracias a los kio_slaves permite acceder al servidor FTP igual que si los archivos estuvieran en el disco rígido de la propia máquina. Y para editar archivos de configuración utilizaré el editor Kate, a la vez simple y potente, que es capaz de abrir y guardar los archivos directamente desde el servidor FTP, sin necesidad de descargarlos, editarlos y transferirlos nuevamente al servidor con distintas herramientas. Por supuesto que el lector puede utilizar otros programas FTP y editores de texto si así lo prefiere. Utilizaremos las función integrada al Konqueror para descomprimir los archivos de instalación. Eso es todo lo que vamos a necesitar. Instalando PmWikiEl primer paso es descargar la herramienta wiki del sitio de sus desarrolladores: http://pmwiki.org/pub/pmwiki/pmwiki-latest.tgz El archivo pesa solo unos 300 Kbytes y contiene el sistema completo, salvo por la traducción del sistema al idioma español. Una vez descargado, debemos extraer su contenido utilizando una herramienta de descompresión. Desde KDE basta con hacer clic con el botón derecho del ratón sobre el archivo y seleccionar la opción "Extraer" -> "Extraer aquí". Si todo anduvo bien, obtendremos un directorio con el siguiente contenido: Listado 1. Contenido de pmwiki-latest.tgz __________________________________________________________________________ $ ls -1h * pmwiki-latest.tgz pmwiki-2.1.27: cookbook docs local pmwiki.php pub README.txt scripts wikilib.d __________________________________________________________________________ Estos archivos debemos subirlos al servidor web mediante FTP, para lo cual utilizaremos en este caso Konqueror, el administrador de archivos de KDE, seleccionando la solapa "Sistema", luego el elemento "Lugares remotos". Haciendo clic en "Añadir a directorio de red" se nos presenta una ventana para ingresar los datos de nuestro servidor FTP. Primero ingresamos un nombre que nos permita identificar la conexión, luego el usuario de acceso al servidor, la dirección IP o nombre del servidor, el puerto (normalmente el valor 21 por defecto está bien) y por el último el directorio de inicio de la conexión (se puede dejar el valor por defecto) Al hacer clic en el botón "Guardar y conectar", Konqueror se conectará al servidor y solicitará la contraseña del servicio. Una vez conectados, podemos copiar, renombrar, eliminar, editar, y en general efectuar cualquier operación sobre los archivos, como si trabajaremos directamente en nuestra máquina. Lo que haremos será seleccionar los directorio y archivos extraídos de pmwiki-latest.tgz, copiarlos haciendo clic con el botón derecho del ratón, y pegarlos en la ventana de Konqueror donde nos hemos conectado al servidor FTP. Por último, finalizamos la instalación haciendo clic con el botón derecho sobre el directorio wiki.d/ y ajustando los permisos de tal modo que el servidor web pueda modificar su contenido. En el mejor de los casos esto implica decir que el Propietario "puede visualizar y modificar el contenido", quizá deba también permitir que el Grupo y Otros puedan modificar el contenido del directorio. Ante la duda, habilite todas las opciones de modificación, pero asesórese más adelante con su proveedor de alojamiento web para saber cuál es la opción más segura en su servidor. Primer contacto cercanoLa instalación de PmWiki terminó, ahora resta configurar el sistema, asegurarlo y personalizarlo completamente, pero ya es posible ingresar y editar páginas wiki. Ingrese a su sitio web desde el navegador y verá un listado de directorios y dos archivos. En mi caso el primer acceso a la web muestra los siguiente: Listado 2. Archivos y directorios en el servidor web __________________________________________________________________________ Index of / Name Last modified Size Description [DIR] Parent Directory 08-Oct-2007 05:45 - [DIR] cgi-bin/ 08-Oct-2007 05:45 - [DIR] cookbook/ 08-Oct-2007 06:04 - [DIR] docs/ 08-Oct-2007 06:04 - [DIR] local/ 08-Oct-2007 06:04 - [ ] pmwiki.php 08-Oct-2007 06:17 65k [DIR] pub/ 08-Oct-2007 06:04 - [DIR] scripts/ 08-Oct-2007 06:08 - [DIR] wiki.d/ 08-Oct-2007 06:33 - [DIR] wikilib.d/ 08-Oct-2007 06:17 __________________________________________________________________________ Si hacemos clic en el enlace al archivo "pmwiki.php" veremos la página inicial del wiki recién instalado. Se parece mucho al sitio web de los desarrolladores de PmWiki. La mayor parte de la configuración se realiza sobre el archivo "local/config.php", utilizamos el administrador de archivos Konqueror para acceder al servidor FTP, ingrese al directorio doc/, copie el archivo "sample-config.php" al directorio local/, renombrelo como "config.php" y haciendo clic con el botón derecho del ratón seleccione la opción "Abrir con..." Busque el editor de texto Kate (o su editor favorito) para modificar el archivo de configuración. Debería modificar por lo menos las siguientes opciones:
Listado 3. Configuración mínima de PmWiki
__________________________________________________________________________
$WikiTitle = 'Mi lugar en la websfera';
$EnablePathInfo = 1;
$DefaultPasswords['admin'] = crypt('contraz');
$EnableUpload = 1;
$DefaultPasswords['upload'] = crypt('secreto');
__________________________________________________________________________
Ahora instalaremos la traducción de sistema a idioma Español, para hacerlo descargue el archivo http://pmwiki.org/pub/pmwiki/i18n/i18n-es.zip, extraiga el contenido como hizo anteriormente y suba los directorio y archivos extraídos al servidor web. Edite nuevamente el archivo local/config.php y añada la siguiente línea al final del mismo:
__________________________________________________________________________
XLPage('Es','PmWikiEs.XLPage');
__________________________________________________________________________
Abra nuevamente el navegador web y recargue la página de inicio, observará que los enlaces referidos a acciones ahora se leen en Español. Un último detalle antes de comenzar a editar el contenido de su nuevo sistema wiki. Hasta este punto, al ingresar a la URL de su sitio, lo primero que aparece es un listado del contenido del directorio de PmWiki, mostrando las carpetas y archivos en vez de la página de inicio. Para ver la página de inicio hemos accedido al enlace del archivo pmwiki.php, lo deseable sería ir directamente a la página inicial. Para lograr esto, cree un archivo llamado "index.php" en el mismo lugar donde se encuentra pmwiki.php, e ingrese el siguiente código en él:
__________________________________________________________________________
<?php include('pmwiki.php');
__________________________________________________________________________
Importante: asegúrese de no dejar líneas en blanco al principio del archivo, de lo contrario no funcionará. La línea indicada arriba debe ser la primera y la única en ese archivo. Recargue su sitio web en el navegador, sin seleccionar el archivo pmwiki.php en la URL. Ya no verá el listado de directorios sino directamente la página de inicio del wiki. El sistema está instalado y funcionando, restan dos cosas para completar el sitio web: ingresar los contenidos que nos interesa publicar, reemplazando los textos predeterminados, y cambiar el aspecto del sitio para darle un toque personal. Cómo publicar sus contenidosEl primer paso es reemplazar el texto de la página de inicio y del menú, cambiándolos por sus propios textos e imágenes. Para ejemplificar, incluiré en el sitio que ven en las imágenes, un texto acerca de los sistemas wiki y un resumen de la sintaxis básica de PmWiki, usted podrá ejercitar con cualquier texto y temática que sea de su interés. Habrá podido observar que tanto arriba sobre la derecha como abajo en el centro, hay varios enlaces, uno de los cuales dice "Editar". Todas las páginas del sitio, salvo unas pocas páginas especiales, tienen este enlace. Haga clic en él y accederá a un formulario cuyo campo principal es una gran caja de edición de texto, dentro de la cual podrá ver el texto de la página que está editando. Rápidamente observará algunos caracteres que no era visibles en la página antes de editarla. Son los códigos que convierten un texto en un enlace o en un título, o que le dan formato destacado a la frase, entre otras funciones que esos códigos pueden cumplir. Ejercite la edición del texto modificándolo y luego haciendo clic en el botón "Previsualizar", que le mostrará el resultado de sus cambios al final de la página. Cuando tenga un texto que desee guardar en reemplazo del texto original de PmWiki, haga clic en el botón "Guardar". Puede repetir la operación cuantas veces quiera, y puede ver sus ediciones anteriores haciendo clic en el enlace "Historia" que se encuentra junto al enlace "Editar". Cómo crear nuevas páginas dinámicamentePor el momento su sitio web tiene solo una página inicial, pero pronto querrá añadir nuevas páginas que enlacen unas con otras, entre sí o desde el menú de la derecha. Observe que el contenido del menú también es editable, encontrará el enlace "editar SideBar" (barra lateral) en la parte inferior del menú. Haciendo clic en el enlace accederá a un formulario de edición idéntico al anterior, excepto que le permitirá modificar el texto y los enlaces del menú. Distinguirá los enlaces porque están encerrados entre doble par de corchetes, por ejemplo: __________________________________________________________________________ [[Main/HomePage]] __________________________________________________________________________ Crear una nueva página es sumamente sencillo e intuitivo, solo debe crear un enlace a la página nueva (que aún no existe) en una página existente o en el menú. Por ejemplo, para crear una página sobre "Tecnología" puede incluir este texto en el menú: __________________________________________________________________________ * [[Tecnología]] __________________________________________________________________________ Cuando guarde el contenido modificado, verá que hay un nuevo enlace, y junto al enlace un signo de interrogación. El signo identifica una página que se enlaza pero que aún no existe, al hacer clic en el enlace nuevo, accederá a un formulario de edición vacío en el cuál podrá ingresar el contenido de la nueva página. Pruébelo, le asombrará lo sencillo que es crear un sitio web completo, con ilimitada cantidad de páginas enlazadas entre sí. Dando formato a textoPara añadir formato al texto introducido, debe utilizar códigos wiki, por ejemplo, para convertir una línea en un título destacado, escriba dos signos de exclamación al principio de la línea, de esta manera: __________________________________________________________________________ !! Esto es un título __________________________________________________________________________ A continuación encontrará un resumen con los principales códigos wiki. Conviene tener este resumen al alcance de la mano para no tener que memorizar todas las directivas, de todos modos con el uso irá recordando las mas frecuentes. Ejercite estos códigos tanto como desee hasta descubrir la utilidad de cada uno. Resaltado de texto
''cursivas'' (italicas)
'''negritas'''
'''''cursiva negrita'''''
@@letra de espaciado regular@@
[-pequeña-], [--mas pequeña--]
[+grande+], [++mas grande++]
'-pequeña-', '+grande+'
'^superindice^', '_subindice_'
{+insertado+} (subrayado)
{-borrado-} (tachado)
[@código no interpretado[=texto no interpretado=] Títulos y encabezados!! Encabezado !!! Encabezado menor (:title texto:) Links externoshttp://ejemplo.com [[http://ejemplo.com]] [[http://ejemplo.com | texto del link]] [[texto del link -> http://ejemplo.com]] Links internos[[NombreDePagina]] [[nombre de página]] [[nombre (página)]] [[NombreDePagina | texto del link]] [[NombreDePagina | + ]] (link mostrando título) [[NombreDePagina | # ]] (link de referencia numerada) [[texto del link -> NombreDePagina]] [[#anchor]] [[#anchor | texto del link]] [[NombreDePagina#anchor | texto del link]] Uploads, archivos adjuntos[[Attach:nombre de archivo.pdf]] Imageneshttp://www.ejemplo.com/image.gif http://www.ejemplo.com/image.gif"alt text" Attach:image.gif"My image" %lfloat% Attach:image.gif %rfloat% Attach:image.gif %center% Attach:image.gif %rframe% Attach:image.gif | Etiqueta %lframe% Attach:image.gif | Etiqueta %width=200px% Attach:image.gif %thumb% Attach:image.gif Listas* lista no ordenada ** nivel interior de lista # lista numerada # %item value=#% iniciar desde un número arbitrario :# %decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA% :termino:definicion Párrafos<space> texto preformateado [@... bloque preformateado ---- (una linea orizontal una linea en blanco deja un espacio vertical \ al final de la linea une con la siguiente linea \\ al final de la linea fuerza un cambio de linea \\\ al final de la linea produce una linea en blanco, incluso en una lista Tablas||table atributos ||!Etiqueta de tabla!|| ||a la izq || centrado || a la derecha|| ||!encabezado|| ||columnas expandidas |||||| Personalización del aspectoUna vez que haya cambiado el contenido de la página de inicio y creado algunas páginas enlazadas desde el menú o desde la misma página inicial, aún le falta algo importante. Para que el sitio sea realmente personal, debe tener un aspecto diferente a la instalación estándar. Puede descargar diferentes diseños ingresando a http://www.pmwiki.org/wiki/Cookbook/Skins La instalación es simple, descargue y extraiga los archivos como lo hizo anteriormente y luego súbalos mediante FTP al directorio pub/skins/. Una vez subidos los archivos, edite el archivo de configuración local/config.php y cambie el valor de la constante $Skin por el nombre del skin seleccionado, por ejemplo: __________________________________________________________________________ $Skin = 'monobook'; __________________________________________________________________________ Si tiene algún conocimiento de html o le interesa investigarlo, puede modificar los archivos del skin, creando un skin nuevo a partir de otro pre-existente. Con algún programa de gráficos puede crear un logotipo para su sitio web, subirlo al un directorio en el servidor (un buen lugar sería crear un directorio pub/imagenes/) y editar el valor de la constante __________________________________________________________________________ $PageLogoUrl = "$PubDirUrl/imagenes/logo.png"; __________________________________________________________________________ El sitio web ya es utilizable, usted y aquellas personas que visiten su sitio pueden editar sucesivamente las páginas, creando documentación o publicando gran variedad de contenidos, información, conocimiento, datos personales, pensamientos. Un uso apropiado sería, por ejemplo, mantener un curriculum vitae actualizado en Internet. Claro que en este caso no querrá que cualquier visitante pueda modificarlo, para evitarlo, añada una línea como la siguiente al archivo de configuración:
__________________________________________________________________________
$DefaultPasswords['edit'] = crypt('contraz');
__________________________________________________________________________
Podrá mantener su sitio actualizado usted mismo, aún cuando no tenga formación técnica como programador web, pero incluso siendo programador, mantener un wiki es mucho más sencillo que mantener un sitio web tradicional con páginas html estáticas. Hay muchas más opciones que no hemos comentado para no extendernos demasiado, le recomiendo ejercitar las nociones contenidas en este artículo, y luego incorporar otras más avanzadas leyendo la abundante documentación existente en http://pmwiki.org También es recomendable que se registre en las listas de email, a través de las cuales obtendrá la mayor colaboración de todos los usuarios de PmWiki: http://www.pmwiki.org/wiki/PmWiki/MailingLists Aquí puede ver ejemplos de sitios desarrollados con PmWiki que le pueden inspirar: http://www.pmwiki.org/wiki/PmWiki/PmWikiUsers Comentario finalMediante la utilización de sistemas tipo wiki para la elaboración y publicación colaborativa de conocimientos, podemos ofrecer a la sociedad o a las personas con las que compartimos una actividad, una nueva oportunidad de crecimiento, tanto desde el punto de vista de contenidos en sí mismos, como desde el punto de vista del aprendizaje del trabajo en equipo. — Copyright (c) Pablo Manuel Rizzo Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and one Back-Cover Text: "El autor del texto original es Pablo Manuel Rizzo, puede ser contactado directamente al email info@pablorizzo.com" A copy of the license is included in the section entitled "GNU Free Documentation License". |