Existem editores de páginas de manual da GUI disponíveis?

19

Acho o formato da página do manual extremamente doloroso de escrever. Existe um editor de GUI ( WYSIWYG ou WYSIWYM ) disponível para facilitar essa tarefa? Espero um aplicativo que seja para páginas de manual, como o Kompozer, para páginas da web.

Eu tentei o gmanedit, mas descobri que é basicamente apenas um editor de texto com alguns trechos facilmente disponíveis - é necessário conhecer o formato da página do manual para usá-lo e a área de edição é apenas um widget de texto.

Embora eu prefira um software que esteja nos repositórios oficiais do Ubuntu, não posso usar métodos não suportados para instalação, como PPAs ou instalação a partir do código-fonte.

software-recommendation gui documentation editor dv3500ea
fonte

Respostas:

9

É possível criar páginas de manual usando a marcação DocBook e usar ferramentas como docbook2x-man para criar saída de troff. Existem alguns editores visuais (estilo "WYSIWYM") disponíveis para editar a marcação do DocBook. Por exemplo, o Syntext Serna Free licenciado pela GPL :

Captura de tela do uso do Syntext Serna Free para editar uma entrada de referência do DocBook

Além disso, o doclifter é um utilitário para converter páginas de manual em DocBook.

Jukka Matilainen
fonte
Concordo, escrevo minhas páginas de manual no formato docbook. É muito mais sustentável!
Roger Light
Docbook é o melhor formato para criar documentação. Após a conclusão do arquivo do Docbook, ele pode ser convertido em vários formatos. XHTML, Páginas Man, etc ...
JM Becker
Parece um bom editor, mas infelizmente parece que não há mais versão gratuita.
precisa saber é o seguinte
1

Este é um adendo à sugestão de Jukka de usar o docbook com a principal razão pela qual eu gosto, além de ser muito mais fácil escrever e lidar com:

Você pode convertê-lo em arquivos .pot para uma tradução mais fácil. Por exemplo, criando um .pot (modelo de idioma):

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

Em seguida, mescle os arquivos traduzidos (.po) de volta em uma página de manual do docbook específica do idioma, neste caso, alemão:

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

Roger Light
fonte
1

Grapse , um webapp HTML5, foi apresentado no Hacker News 2/3 de um ano atrás. Inclui visualização integrada e destaque de sintaxe.

aidanh010
fonte
Parece bom, mas parece principalmente para o FreeBSD / OSX e não formata as páginas de manual padrão do Linux corretamente (por exemplo, perde o espaçamento de parágrafos para opções), mesmo quando alternado para o ANcanto superior direito da página da web.
Cas
0

Existe um, ManEdit . No entanto, não sei se ainda está ativo :(

Obrigado!

crncosta
fonte
Também descobri que, parece que foi abandonado e usa o GTK 1.x!
Isaiah