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.

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.


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


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.


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!


Também descobri que, parece que foi abandonado e usa o GTK 1.x!
— Isaiah
Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.