是否有可用的GUI手册页编辑器?


19

我发现手册页格式的编写非常痛苦。有没有可用的GUI(所见即所得所见即所得)编辑器来简化此任务?我希望有一个像Kompozer一样是用于网页的应用程序。

我尝试了gmanedit,但发现它基本上只是一个带有一些容易使用的摘录的文本编辑器-必须知道手册页格式才能使用它,而编辑区域只是一个文本小部件。

虽然我希望使用Ubuntu官方存储库中的软件,但可以使用不受支持的安装方法(例如PPA或从源代码安装)来确定。

Answers:


9

可以使用DocBook标记来编写手册页,并使用诸如docbook2x-man之类的工具来创建troff输出。有一些可视(“ WYSIWYM”样式)编辑器可用于编辑DocBook标记。例如,GPL许可的Syntext Serna Free

使用Syntext Serna Free编辑DocBook参考条目的屏幕截图

另外,doclifter是用于将手册页转换为DocBook的实用程序。


同意,我以docbook格式编写手册页。它更易于维护!
罗杰·莱特

Docbook是用于创建文档的最佳格式。完成Docbook文件后,即可将其转换为多种格式。XHTML,手册页等…
JM Becker 2012年

似乎是一个不错的编辑器,但不幸的是,看起来好像再也没有免费版本了。
MestreLion,2012年

1

这是Jukka关于使用docbook的建议的附录,其主要原因是我喜欢它,而不是因为它更容易编写和处理:

您可以将其转换为.pot文件,以便更轻松地进行翻译。例如,创建一个.pot(语言模板):

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

然后将翻译后的文件(.po)合并回特定语言的docbook手册页,在本例中为德语:

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


1

HTML5网络应用Grapse在一年前的Hacker News 2/3中被精选。它包括内置的预览和语法突出显示。


看起来不错,但似乎主要用于FreeBSD / OSX,即使切换到AN页面右上方,也无法正确格式化标准Linux手册页(例如,丢失选项的段落间距)。
卡斯

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.