¿Hay editores de páginas de manual de GUI disponibles?

19

El formato de la página de manual me parece extremadamente doloroso de escribir. ¿Existe un editor de GUI ( WYSIWYG o WYSIWYM ) disponible para facilitar esta tarea? Espero una aplicación que sea para páginas de manual como Kompozer para páginas web.

He intentado con gmanedit pero he descubierto que es básicamente un editor de texto con algunos fragmentos fácilmente disponibles: es necesario conocer el formato de la página de manual para usarlo y el área de edición es solo un widget de texto.

Si bien prefiero el software que está en los repositorios oficiales de Ubuntu, estoy de acuerdo con el uso de métodos no compatibles para la instalación, como PPA o la instalación desde la fuente.

dv3500ea
fuente

Respuestas:

9

Es posible crear páginas de manual utilizando el marcado de DocBook y utilizar herramientas como docbook2x-man para crear resultados de troff. Hay algunos editores visuales (estilo "WYSIWYM") disponibles para editar el marcado de DocBook. Por ejemplo, Syntext Serna Free con licencia GPL :

Captura de pantalla del uso de Syntext Serna Free para editar una entrada de referencia de DocBook

Además, doclifter es una utilidad para convertir páginas de manual a DocBook.

Jukka Matilainen
fuente
De acuerdo, escribo mis páginas man en formato docbook. ¡Es mucho más fácil de mantener!
Roger Light el
Docbook es el mejor formato para crear documentación. Una vez que se completa su archivo Docbook, se puede convertir a una multitud de formatos. XHTML, Man Pages, etc ...
JM Becker
Parece un buen editor, pero desafortunadamente parece que ya no hay una versión gratuita.
MestreLion
1

Esta es una adición a la sugerencia de Jukka de usar docbook con la razón principal por la que me gusta, además de que es mucho más fácil de escribir y tratar:

Puede convertirlo a archivos .pot para una traducción más fácil. Por ejemplo, creando un .pot (plantilla de idioma):

xml2po -o my_program.1.pot my_program.1.xml

Luego, fusionar los archivos traducidos (.po) nuevamente en una página de manual de docbook específica del idioma, en este caso alemán:

xml2po -p de.po my_program.xml > my_program.de.xml

Roger Light
fuente
1

Grapse , una aplicación web HTML5, apareció en Hacker News 2/3 de hace un año. Incluye vista previa incorporada y resaltado de sintaxis.

aidanh010
fuente
Se ve bien, pero parece principalmente para FreeBSD / OSX y no formatea correctamente las páginas man estándar de Linux (por ejemplo, pierde el espacio entre párrafos para las opciones) incluso cuando se cambia a la esquina ANsuperior derecha de la página web.
Cas
0

Hay uno, ManEdit . Sin embargo, no sé si todavía está activo :(

¡Gracias!

crncosta
fuente
También encontré esa, ¡parece estar abandonada y usa GTK 1.x!
Isaías el