Wikihelp – La ayuda online de LibreOffice

From The Document Foundation Wiki
Jump to: navigation, search

Esta página explica las razones y el cambio en el tiempo al implantar Wikihelp - http://help.libreoffice.org

Porque Wikihelp?

Los ficheros de ayudas tienen un formato (el .xhp) difícil de editar por los desarrolladores y los creadores de documentación. También, es desafortunado que para ver los cambios, tengas que reconstruir parte del LibreOffice. Ambos desarrolladores y creadores de documentación necesiten algo más fácil, algo que pueda ser creado de forma colaborativa y simple. Y sobretodo, simplificando la localización de las comunidades.

Wiki es de lejos la mejor herramienta colaborativa. Da la libertad a cualquiera de mejorar cosas. Con la ayuda implementada en la wiki, cualquier usuario que use la suite puede (potencialmente) describir las funcionalidades mejor, y debería encontrar las cosas equivocadas o incompletas; pero por supuesto esto no significa que vayamos abrir la edición al público des del día 1, al principio lasa cuentas van estar creadas por pedido.

El Plan

  • Solamente las páginas en inglés van a ser editables
  • Palabras de las páginas en inglés serán subidas al pootle
    • Así podrás trabajar de la forma que estas acostumbrado
    • El Translate Toolkit tiene herramientas para extraer cadenas del formato de la wiki. - txt2po. Si es necesario tiene que ser extendido para manejar todo lo necesario en la wikihelp
  • Las traducciones existentes van a ser convertidas
    • Así el trabajo hecho no se perderá. ie. Todo lo que ha sido traducido también ha de ser traducido en la versión wikihelp.
  • Las traducciones de pootle se aplicarán en la versión Inglesa.
    • Pero si el equipo de lenguaje decide que quieren traducir directamente a la wikihelp, la versión de lenguaje serán abiertos directamente en la wikihelp.

La linea temporal

  • Actualmente, nosotros estamos transformando los ficheros .xhp en formato wiki.
    • Es ahora online en http://help.libreoffice.org
    • Necesita ser pulido [ex es muy confuso tratar contenido compartido (embebido) especial]
    • Reporte de bugs es apreciado! Ves a https://bugs.documentfoundation.org, y asigna a kendy@suse.cz, con wikihelp: <descripción del problema> en el sujeto
    • LibreOffice 3.3 enlaza a la ayuda online, si la ayuda offline no esta instalada
  • El contenido de Wikihelp tiene que ser exportado a .pot
    • Puede que necesitemos cambios en el filtro txt2po.
  • Las traducciones de ficheros .sdf o .po tienen que ser convertidos al formato de la wiki
    • Comprobado que la ninguna parte de la información se ha perdido
    • Comprobado también que las versiones Inglesas, todo se be correctamente y el formato no se ha perdido.

Plan futuro (3.4)

  • Más tarde necesitaremos herramientas para convertir la ayuda online a versiones de ayuda offline
    • para la plataforma de forma nativa
    • Windows/Linux/MacOSX
    • desde del punto de vista de ingeniería, nosotros no queremos solamente un crecimiento de ayuda de hogar.
    • necesitamos más recerca, para ver si no perdemos características, etc
  • cuando acabemos la wikihelp se convertirá en la versión principal de ayuda.
    • pero de momento aun necesitamos incorporar cambios de los ficheros .xhp que juntamos de OOo

Preguntas abiertas

  • consejos extendidos
    • no puede ser parte de la wikihelp, probablemente esto se manejara de forma separada, ex parte del código fuente
  • seguridad [Pregunta de Jean-Baptiste Faure)
    • Para luchar contra los spamers mirar mediawiki [1]
    • y también contra el saming [2]
    • David Nelson propone poder editar por grupos (dev, l10n, doc, ...)
  • Propuesta por Jonathan Aquilina: un mail se envía a la lista para que el equipo sea consciente y permita comprobar las consistencias como el contenido.
  • Sobre edición offline Kendy propone usar Wiki publisher extension y puede ser revisado las modificaciones en LibreOffic.
  • Actualmente, no hay un glosario o TMX en la wiki.
  • Que hay sobre la ayuda de instalación extensiones? Actualmente las extensiones pueden usar la misma ayuda del sistema offline de LibO. ( Aparentemente aquí hay un bug que previene LibO de comprobar la extensión de ayuda.
  • A lo mejor, sería interesante, des de un punto de vista de optimizaciones, tener caché para guardar en el perfil de usuario páginas online leídas por el usuario.