Sistema de documentación: TWiki

Carla Villena
ing.carla.villena@gmail.com

Roger Humberto Uñoja
rhunoja@gmail.com

Marines Lopez
mary.jlm.2006@gmail.com

Juan Timoteo Ponce
timo.slack@gmail.com

Categories and Subject Descriptor

D.2.3 Coding Tools and Techniques

General Terms

Documentación.

Keywords

TWiki, Wikiword, WYSIWIG, Tag

1. INTRODUCCION

Twiki es un sistema de documentación sencillo de instalar, implementar y configurar. Si bien no es necesario ser un programador para diseñar paginas Twiki, es necesario conocer las convenciones, nomenclatura de para las diferentes fuentes formatos, y archivos multimedia cargables en una página Twiki.

El presente documento proporcionara al lector una guía simple y rápida para las definiciones, características e instalación del sistema Twiki.

2. WIKI.-

Un wiki o una wiki (del hawaiano wiki, 'rápido') es un sitio web cuyas páginas pueden ser editadas por múltiples voluntarios a través del navegador web. Los usuarios pueden crear, modificar o borrar un mismo texto que comparten. Los textos o «páginas wiki» tienen títulos únicos. Si se escribe el título de una «página wiki» en algún sitio del wiki entre dobles corchetes (...), esta palabra se convierte en un «enlace web» a la página wiki. (Wikipedia (Informática))

3. TWIKI.-

Twiki es una flexible, poderosa y fácil plataforma de colaboración para empresas y un sistema de manejo de conocimiento. Este es un wiki estructurado, típicamente usado para ejecutar un proyecto de espacio de trabajo, un sistema de manejo de documentos, una base de conocimiento, o cualquier otra herramienta grupal, en internet o intranet. Contenido web que puede ser creado colaborativamente por solo uso de un navegador. Usuarios sin ninguna habilidad de programación pueden crear aplicaciones web. Desarrolladores que puede extender la funcionalidad de Twiki con plugins.

4. Principales Características.-

Madures de Twiki, características web completas, basadas en sistemas de colaboración.

- Cualquier navegador: Edite o cree nuevas páginas por el uso de cualquier navegador. No hay necesidad de utilizar ftp o http para cargar páginas.

- Enlace editable: para editar una pagina, simplemente haga click en editar al final de cada página.

- Auto enlazamiento: Las páginas web son automáticamente enlazadas. Usted no necesita aprender comandos HTML para enlazar páginas.

- Formateo de texto: Simple potente y fácil para aprender reglas formatos de texto. Básicamente usted escribe el texto como si estuviera escribiendo un email.

- Webs: Las paginas son agrupadas en TWiki webs (colecciones). Esto le permite a usted configurar grupos de colaboración.

- Búsqueda: Completo buscador de texto con o sin expresiones regulares.

- Notificación por E-mail: Sea automáticamente notificado cuando algo se haya cambiado en una página TWiki.

- Contenido estructurado: Utilice formularios TWiki para clasificar y categorizar páginas web no estructuradas y para crear sistemas simples de flujos.

- Archivos adjuntos: Cargue y descargue cualquier archivo como adjunto para una página utilizando un navegador.

- Control de revisión: Todos los cambios a páginas y adjuntos son rastreados. Recupere páginas de revisión previas. Averigüe quien realice cambios y cuando.

- Control de Accesos: Defina grupos e imponga estrictas restricciones y accesos de lectura y escritura basados en grupos y usuarios.

- Variables: Use variables para componer dinámicamente sus páginas. Esto le permitirá por ejemplo construir una tabla de contenido. Incluir otras páginas o mostrar resultados de búsquedas embebidos en una página.

- Plugins TWiki: Mejore la funcionalidad TWiki con servidores de módulos plugin. Desarrolladores pueden plugins Perl usando la TWiki.

- Aplicaciones Wiki: Contribuyentes usan la TWiki para crear aplicaciones web. Las variables TWiki, Plugins y aplicaciones de ejemplo ofrecen amplio ambiente donde las aplicaciones dominio-especifico pueden ser construidas eficientemente por contribuyentes con habilidades regulares. Desarrolladores pueden crear nuevos plugins para mejorar la funcionalidad de TWiki.

- Plantillas (Skins) y apariencias: Un flexible sistema de plantillas separa la lógica del programa y las presentaciones. Apariencias de sobre escritura de plantillas de encabezado y pie de página, el contenido de la página no es afectado.

- Administración de páginas: Las páginas individuales pueden ser renombrables, eliminadas o removidas a través de navegadores.

- Administración de usuarios: Web basado en registro de usuario y cambio de contraseñas.

- Novedades: Ver los cambios recientes de las paginas Twiki. Encontrar más paginas populares y contribuyentes destacados.

- Estadística: Generar estadística de las web TWiki. Los registro de cambios pueden ser exportados en formato XML RSS.

- Preferencias: Cuatro niveles de preferencia TwikiPreferences para cada web, nivel de preferencia de usuarios, nivel de preferencia de páginas.

- Solución de conflictos: El contenido es guardado y unido automáticamente si más de un usuario esta editando la pagina al mismo tiempo. En casos extraños cuando el conflicto no puede ser resuelto automáticamente Los usuario son advertidos e instruidos a resolver el conflicto de forma manual. (Thoeny, 1998)

5. Convenciones y nomenclatura.-

Separe cada párrafo con una línea vacía.

1. Instalación.-

• En Windows.-
  • Descarga el archivo zip TWiki-WP ( http://sourceforge.net/project/downloading.php?group_id=3657&filename=TWiki-WP-4.0.5.zip).
  • Descomprime el archivo en la raiz de una unidad o particion, ejemplo: c: * Crea un acceso directo del directorio \twiki\run.bat
  • Una vez ejecutado el .bat, este iniciara un servicio en el puerto 8765 con el localIP 127.0.0.1 y abrira una pagina en el navegador automaticamente, hacer click en el enlace "Start TWiki"y listo. (PeterThoeny, 2012)
• En Linux.-
  • Descarga el comprimido TWiki-5.1.2.tgz for Linux.
  • Copia y descomprime el archivo en el lugar donde los quieras instalar, por ejemplo: /home/httpd.
  • El empaquetado creara un directorio “twiki/” nota: twiki no permite espacios en los nombres de los directorios.
  • Para descomprimir el empaquetado ejecute el comendo: chown -R user:group /path/to/twiki.
  • Para otras distribuciones:
    • RedHat, Fedora, CentOS, Gentoo, Mandriva : chown -R apache:apache /path/to/twiki
    • debian/Ubuntu/Kubunto : chown -R www-data:www-data /path/to/twiki
    • Suse : chown -R wwwrun:www /path/to/twiki.
    • Otorgar los permisos correspondientes al dierctorio, se recomienda utilizar las configuraciones por defecto.
• TWiki es un script cgi-bin [1] escrito en Perl. Lee el archivo de texto, lo hipervíncula y lo convierte a formato HTML al instante.
• Twiki es software GPL [2], el código fuente cgi Perl, las plantillas y la documentación están disponibles de forma libre.
• La TwikiDocumentacion ofrece una amplia lista de referencias tanto para la instalación del sistema como para su configuración básica y avanzada.
• En caso de que usted no encuentre una respuesta, puedes realizar su pregunta a la comunidad TWiki.
• TWiki es un software libre y no ofrece soporte, por tanto no es posible contactar con el desarrollador si usted tuviera problemas con la instalación.

2. Ventajas.-

• TWiki es un script cgi-bin [1] escrito en Perl. Lee el archivo de texto, lo hipervíncula y lo convierte a formato HTML al instante.
• Twiki es software GPL [2], el código fuente cgi Perl, las plantillas y la documentación están disponibles de forma libre.
• La TwikiDocumentacion ofrece una amplia lista de referencias tanto para la instalación del sistema como para su configuración básica y avanzada.
• En caso de que usted no encuentre una respuesta, puedes realizar su pregunta a la comunidad TWiki.

3. Desventajas.-

• TWiki es un software libre y no ofrece soporte, por tanto no es posible contactar con el desarrollador si usted tuviera problemas con la instalación.

4. Conclusión.-

Finalmente

5. Bibliografía.-

Informática, S. d. (s.f.). CGI (Common Gateway Interface), ejecución de binarios. Recuperado el 9 de Septiembre de 1996, de http://www2.uca.es/manual-html/cgi-bin.htm

PeterThoeny. (01 de 01 de 2012). TWiki for Windows Personal. Recuperado el 27 de Abril de 2012, de http://twiki.org/cgi-bin/view/Codev/TWikiForWindowsPersonal

Thoeny, P. (1 de Enero de 1998). TWiki - the Open Source Enterprise Wiki and Web 2.0 Application Platform. Recuperado el 1 de Noviembre de 2012, de TWiki.org

Wikipedia. (s.f.). Wiki. Recuperado el 23 de noviembre de 2012, de http://es.wikipedia.org/wiki/Wiki

[1] Los cgi-bin son programas que se ejecutan en el servidor, pueden servir para tratar información, como pasarela con una aplicación o base de datos o para generar documentos html de forma automática.

[2] GPL: Licencia publica general (Informática)

- Contributors: RogerUnoja - 2012-11-23

Discussion

Interesante articulo

-- RogerUnoja - 2012-11-24