[opensuse-es] Aplicación para documentar
Hola gente, les comento que estoy tratando de buscar alguna aplicación practica para poder documentar proyectos en linux, vi por ahi el lenguaje docbook, como uno muy usado, pero me interesaría en caso de definirme por ese lenguaje, algún editor interesante que facilite la etapa de documentación. Escucho sugerencias, salu2 Carlitos -- Para dar de baja la suscripción, mande un mensaje a: opensuse-es+unsubscribe@opensuse.org Para obtener el resto de direcciones-comando, mande un mensaje a: opensuse-es+help@opensuse.org
El 30/10/08, Carlos Moreira escribió:
Hola gente, les comento que estoy tratando de buscar alguna aplicación practica para poder documentar proyectos en linux, vi por ahi el lenguaje docbook, como uno muy usado, pero me interesaría en caso de definirme por ese lenguaje, algún editor interesante que facilite la etapa de documentación.
Yo tiraría por OOo (Writer) para la edición, porque es muy cómodo para maquetar, y algún filtro de salida para generar un formato compatible en DocBook: DocBook Filters - Read and write docbook xml using OpenOffice.org http://xml.openoffice.org/xmerge/docbook/ Saludos, -- Camaleón -- Para dar de baja la suscripción, mande un mensaje a: opensuse-es+unsubscribe@opensuse.org Para obtener el resto de direcciones-comando, mande un mensaje a: opensuse-es+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 El 2008-10-30 a las 14:01 +0100, Camaleón escribió:
El 30/10/08, Carlos Moreira escribió:
Hola gente, les comento que estoy tratando de buscar alguna aplicación practica para poder documentar proyectos en linux, vi por ahi el lenguaje docbook, como uno muy usado, pero me interesaría en caso de definirme por ese lenguaje, algún editor interesante que facilite la etapa de documentación.
Yo tiraría por OOo (Writer) para la edición, porque es muy cómodo para maquetar, y algún filtro de salida para generar un formato compatible en DocBook:
DocBook Filters - Read and write docbook xml using OpenOffice.org http://xml.openoffice.org/xmerge/docbook/
Sin embargo, lo del oowriter, tiene una pega para docuementaciones: los estilos son voluntarios. El mantener un estilo constante en todo el libro supone un esfuerzo constante. En este sentido, herramientas como el latex, aunque digan que no está de moda, o el LyX, que es como un latex amigable porque no ves lo que hay detrás sino algo con un aspecto similar al resultado final, pues tienen la ventaja de que el formato resultante va a ser perfectamente consistente. El docbook está de moda, pero no conozco un editor que trabaje con eso en plan WYSIWYG, tienes que trabajar con los tokens a la vista, lo cual es muy feo. A mi se me atraganta. - -- Saludos Carlos E.R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkkJxk0ACgkQtTMYHG2NR9WdMACfZ1of5N8paFhaEpyaRiIPpIyZ 5DUAn2qrn2bI8B8QpkKVBnT4yWFYDzYJ =L4cy -----END PGP SIGNATURE-----
El 30/10/08, Carlos E. R. escribió:
Sin embargo, lo del oowriter, tiene una pega para docuementaciones: los estilos son voluntarios. El mantener un estilo constante en todo el libro supone un esfuerzo constante.
El estilo lo defines tú, o utilizas algún modelo ya creado para la documentación y para seguir un estándar, en caso de que fuera necesario. Esa es la potencia del xml, que es muy flexible.
En este sentido, herramientas como el latex, aunque digan que no está de moda, o el LyX, que es como un latex amigable porque no ves lo que hay detrás sino algo con un aspecto similar al resultado final, pues tienen la ventaja de que el formato resultante va a ser perfectamente consistente.
El docbook está de moda, pero no conozco un editor que trabaje con eso en plan WYSIWYG, tienes que trabajar con los tokens a la vista, lo cual es muy feo. A mi se me atraganta.
Porque empezaste con mal pie :-P. Una cosa son las páginas "man" y otra la edición de documentación: en la segunda tienes más flexibilidad, herramientas, plantillas, estilo, etc... Saludos, -- Camaleón -- Para dar de baja la suscripción, mande un mensaje a: opensuse-es+unsubscribe@opensuse.org Para obtener el resto de direcciones-comando, mande un mensaje a: opensuse-es+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 El 2008-10-30 a las 15:44 +0100, Camaleón escribió:
El 30/10/08, Carlos E. R. escribió:
Sin embargo, lo del oowriter, tiene una pega para docuementaciones: los estilos son voluntarios. El mantener un estilo constante en todo el libro supone un esfuerzo constante.
El estilo lo defines tú, o utilizas algún modelo ya creado para la documentación y para seguir un estándar, en caso de que fuera necesario. Esa es la potencia del xml, que es muy flexible.
Me refiero a crear un estilo - con oowriter - y obligar a que el documento lo siga sin esfuerzo por parte del escritor. Tener un estilo "libro", por ejemplo, y con decir "ponme el índice" que lo ponga en su sitio, sin tener que ponerlo yo en su sitio. Que si digo "esto es el título del libro" automáticamente me lo ponga en la primera pagina con el nombre del autor debajo, fecha y editorial en el formato exacto definido en el estilo de libros. No que tenga yo que decir si esto va medio centímetro arriba o abajo y la primera hoja tiene un formato algo distinto porque no tiene numero de pagina, el preámbulo se numera en romanos y el cuerpo en arábigos. Eso el látex lo hace. El LyX también. El XML, ni idea, porque no he encontrado un editor decente para escritores de letras (tú no cuentas :-p), plan OpenOffice, es decir, WYSIWYG, o mejor WYMIWYG.
En este sentido, herramientas como el latex, aunque digan que no está de moda, o el LyX, que es como un latex amigable porque no ves lo que hay detrás sino algo con un aspecto similar al resultado final, pues tienen la ventaja de que el formato resultante va a ser perfectamente consistente.
El docbook está de moda, pero no conozco un editor que trabaje con eso en plan WYSIWYG, tienes que trabajar con los tokens a la vista, lo cual es muy feo. A mi se me atraganta.
Porque empezaste con mal pie :-P.
Una cosa son las páginas "man" y otra la edición de documentación: en la segunda tienes más flexibilidad, herramientas, plantillas, estilo, etc...
Si, pues ponme un editor WYSIWYG, o mejor WYMIWYG. No quiero ver ni un sólo token o palabra reservada XML en pantalla, ojo. - -- Saludos Carlos E.R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkkJzWQACgkQtTMYHG2NR9WJeQCeKBY4i+uGiZPMaH/UTdsKRaep TVsAoIDHPDzmSMCUmd1S3kRMj8PdlfkC =YtdI -----END PGP SIGNATURE-----
El 30/10/08, Carlos E. R. escribió:
Me refiero a crear un estilo - con oowriter - y obligar a que el documento lo siga sin esfuerzo por parte del escritor.
Se llaman "plantillas" ¿no te sirven? :-) Las plantillas las puedes crear tú (estilo personalizado para una documentación concreta) o las puedes descargar de algún sitio (plantillas creadas para ajustarse a "x" normativa, por ejemplo).
Tener un estilo "libro", por ejemplo, y con decir "ponme el índice" que lo ponga en su sitio, sin tener que ponerlo yo en su sitio. Que si digo "esto es el título del libro" automáticamente me lo ponga en la primera pagina con el nombre del autor debajo, fecha y editorial en el formato exacto definido en el estilo de libros. No que tenga yo que decir si esto va medio centímetro arriba o abajo y la primera hoja tiene un formato algo distinto porque no tiene numero de pagina, el preámbulo se numera en romanos y el cuerpo en arábigos.
A ver, que te vas... Eso que dices se consigue con plantillas de documentos que tienen estilos definidos para todo: titulares, cabeceras, pies de páginas, colores, tamaños, secciones, numeración, tabulaciones... lo que no hacen las plantillas es escribirte la tesis :-P, pero sí definir el formato del documento. Para la mayor parte de trabajos suele ser suficiente.
Eso el látex lo hace. El LyX también. El XML, ni idea, porque no he encontrado un editor decente para escritores de letras (tú no cuentas :-p), plan OpenOffice, es decir, WYSIWYG, o mejor WYMIWYG.
Otra vez metiéndose con los de letras ¿ein? >:-) El XML no es más que un formato de texto con etiquetas. No se trata de que el programa trabaje con xml (todos los editores lo hacen) sino de que sea capaz de interpretar el contenido del xml, y eso se consigue con filtros, plantillas, hojas de estilo...
Si, pues ponme un editor WYSIWYG, o mejor WYMIWYG. No quiero ver ni un sólo token o palabra reservada XML en pantalla, ojo.
El odt que genera el OOo contiene el documento en XML puro (content.xml) pero tú no ves ni coscorro. Trabajas en modo de edición estándar, con negritas y cursivas. El xml que se genera lo puedes transformar de múltiples formas y para distintos tipos de trabajo con xslt : para Docbook, para páginas web, para páginas man* :-P, para un libro... * El problema de las páginas man es que necesitan una estructura (definición del tipo de documento) con un formato concreto que no estaba disponible como estilo para el OOo (si no recuerdo mal). Saludos, -- Camaleón -- Para dar de baja la suscripción, mande un mensaje a: opensuse-es+unsubscribe@opensuse.org Para obtener el resto de direcciones-comando, mande un mensaje a: opensuse-es+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 El 2008-10-30 a las 16:32 +0100, Camaleón escribió:
El 30/10/08, Carlos E. R. escribió:
Me refiero a crear un estilo - con oowriter - y obligar a que el documento lo siga sin esfuerzo por parte del escritor.
Se llaman "plantillas" ¿no te sirven? :-)
Las plantillas las puedes crear tú (estilo personalizado para una documentación concreta) o las puedes descargar de algún sitio (plantillas creadas para ajustarse a "x" normativa, por ejemplo).
Tu te refieres a los formularios. No, no es eso. Eso vale para una hoja de un fax o un impreso y poco más. No para un libro.
Tener un estilo "libro", por ejemplo, y con decir "ponme el índice" que lo ponga en su sitio, sin tener que ponerlo yo en su sitio. Que si digo "esto es el título del libro" automáticamente me lo ponga en la primera pagina con el nombre del autor debajo, fecha y editorial en el formato exacto definido en el estilo de libros. No que tenga yo que decir si esto va medio centímetro arriba o abajo y la primera hoja tiene un formato algo distinto porque no tiene numero de pagina, el preámbulo se numera en romanos y el cuerpo en arábigos.
A ver, que te vas...
Eso que dices se consigue con plantillas de documentos que tienen estilos definidos para todo: titulares, cabeceras, pies de páginas, colores, tamaños, secciones, numeración, tabulaciones... lo que no hacen las plantillas es escribirte la tesis :-P, pero sí definir el formato del documento.
No he visto ninguna. Como lo que digo, no. Dime donde hay una plantilla para el OOo para escribir un libro en un formato definido (forzado) y te cuento. Por ejemplo, para escribir en exactamente el mismo formato con el que suse hace el manual de suse. Con las columnitas de los "asides" y todo. Y sé que lo hacen en docbook, lo han dicho.
Para la mayor parte de trabajos suele ser suficiente.
Eso el látex lo hace. El LyX también. El XML, ni idea, porque no he encontrado un editor decente para escritores de letras (tú no cuentas :-p), plan OpenOffice, es decir, WYSIWYG, o mejor WYMIWYG.
Otra vez metiéndose con los de letras ¿ein? >:-)
Yo para estas cosas me considero de letras. Pesado, cabezota y cerrao de mollera >:-)
El XML no es más que un formato de texto con etiquetas.
No se trata de que el programa trabaje con xml (todos los editores lo hacen) sino de que sea capaz de interpretar el contenido del xml, y eso se consigue con filtros, plantillas, hojas de estilo...
Si, ya... pues el OOo no viene con plantillas para rellenar manuales de linux, por ejemplo, con el formato definido por los estandares de linux. Es decir, que tu escribas y te saque el man, el info, el html y el pdf. Todito.
Si, pues ponme un editor WYSIWYG, o mejor WYMIWYG. No quiero ver ni un sólo token o palabra reservada XML en pantalla, ojo.
El odt que genera el OOo contiene el documento en XML puro (content.xml) pero tú no ves ni coscorro. Trabajas en modo de edición estándar, con negritas y cursivas.
No bloquea el estilo. En plan LyX, donde yo marco el indice al final del docuemento y me lo pone al principio porque ese el el formato.
El xml que se genera lo puedes transformar de múltiples formas y para distintos tipos de trabajo con xslt : para Docbook, para páginas web, para páginas man* :-P, para un libro...
Eso dicen. Yo todavía no se como. Guiaburros, recuerda.
* El problema de las páginas man es que necesitan una estructura (definición del tipo de documento) con un formato concreto que no estaba disponible como estilo para el OOo (si no recuerdo mal).
Pues eso, no sirve. - -- Saludos Carlos E.R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkkJ16sACgkQtTMYHG2NR9VG3ACfXqos3Pdajkt3rzPipMNFFUzg QVIAn09HlHj3rWDukZ1osaDICpicRcaQ =cP4A -----END PGP SIGNATURE-----
El 30/10/08, Carlos E. R. escribió:
Tu te refieres a los formularios. No, no es eso. Eso vale para una hoja de un fax o un impreso y poco más. No para un libro.
No, me refiero a "plantillas" con estilos definidos para cualquier contenido del documento.
No he visto ninguna. Como lo que digo, no.
Dime donde hay una plantilla para el OOo para escribir un libro en un formato definido (forzado) y te cuento. Por ejemplo, para escribir en exactamente el mismo formato con el que suse hace el manual de suse. Con las columnitas de los "asides" y todo.
Y sé que lo hacen en docbook, lo han dicho.
Tendrías que descargar ese formato para poder trabajar con él desde la aplicación. Tampoco sé si la documentación de suse está diseñada para trabajar con el OOo.
Yo para estas cosas me considero de letras. Pesado, cabezota y cerrao de mollera >:-)
Ah, vaya. Interesante concepción que tienes de la gente de letras.
Si, ya... pues el OOo no viene con plantillas para rellenar manuales de linux, por ejemplo, con el formato definido por los estandares de linux. Es decir, que tu escribas y te saque el man, el info, el html y el pdf. Todito.
No trabaja así.
No bloquea el estilo. En plan LyX, donde yo marco el indice al final del docuemento y me lo pone al principio porque ese el el formato.
No sé si el writer es capaz de "bloquear" o crear secciones con restricciones (y no me refiero a formularios sino a un documento estándar). Algunos editores web sí lo permiten, pero no es algo que me guste utilizar.
Eso dicen. Yo todavía no se como. Guiaburros, recuerda.
Las páginas de man son otro mundo. No es un formato muy flexible, que digamos.
Pues eso, no sirve.
No te sirve a ti para las páginas man o para lo que quieras. A mi, sí :-) Saludos, -- Camaleón -- Para dar de baja la suscripción, mande un mensaje a: opensuse-es+unsubscribe@opensuse.org Para obtener el resto de direcciones-comando, mande un mensaje a: opensuse-es+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 El 2008-10-30 a las 10:55 -0200, Carlos Moreira escribió:
Hola gente, les comento que estoy tratando de buscar alguna aplicación practica para poder documentar proyectos en linux, vi por ahi el lenguaje docbook, como uno muy usado, pero me interesaría en caso de definirme por ese lenguaje, algún editor interesante que facilite la etapa de documentación. Escucho sugerencias, salu2 Carlitos
Si es WYSIWYG, me apunto. - -- Saludos Carlos E.R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkkJw+UACgkQtTMYHG2NR9WLZwCfUPKp+ETKFIs17vzzBv96Bg5f Lj4AnijRdY/NFwHBevvzeC9Y+HgJLx8W =NuYL -----END PGP SIGNATURE-----
participants (3)
-
Camaleón
-
Carlos E. R.
-
Carlos Moreira