¿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.

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.


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


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.


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!


También encontré esa, ¡parece estar abandonada y usa GTK 1.x!
Isaías el
Al usar nuestro sitio, usted reconoce que ha leído y comprende nuestra Política de Cookies y Política de Privacidad.
Licensed under cc by-sa 3.0 with attribution required.