Buscar
Social
Ofertas laborales ES

Foro sobre Java EE > Crear manual de AYUDA en web

Hola,

Estoy haciendo una aplicación con JSF2 + RichFaces4.
He empezado a realizar un manual de usuario, con openoffice, pero ahora me piden que además de estar la información en un manual, pueda ser vista en modo de ayuda en cada una de las partes de la aplicación.

Me gustaría encontrar algún modo para no tener que escribir dos veces lo mismo, y sobre todo para que cuando haga cambios, no tenga que hacerlo en dos sitios diferentes. ¿Alguna sugerencia?

noviembre 4, 2011 | Registered Commentermarsim86

Pues te toca crear la documentación en un único sitio con un único formato (quizás empleando XML) y después generar a partir de esa fuente el resto de los formatos en los que haya que distribuir la ayuda. O eso, o mantener la ayuda en dos sitios diferentes ....

noviembre 7, 2011 | Registered CommenterAbraham

Nosotros lo que solemos hacer es tener un .doc y a partir de él generar un PDF, que es el que se muestra en una ventana a parte del navegador al usuario.

noviembre 7, 2011 | Registered CommenterUnai Valle

Al final no voy a tener que crear varios documentos.
Lo que hago es generar un único documento pdf, a partir de openoffice, donde pongo marcas en los puntos de la ayuda que quiero acceder.

Luego en mi aplicación hago un windows.open(fichero.pdf#nameddest=marcaCreada, ...) y me abre el documento en una ventana aparte y en el punto del documento que yo quiero.

La única duda que se me plantea es que nameddest no funciona con chrome, así que igual uso la directiva page. Pero esta va a ser más dificil de mantener.

noviembre 10, 2011 | Registered Commentermarsim86

Otra alternativa es hacer una ppt con LibreOffice y exportarlo a flash y colgarlo de una pagina.

noviembre 22, 2011 | Unregistered CommenterPatricio Ascencio