19 我发现手册页格式的编写非常痛苦。有没有可用的GUI(所见即所得或所见即所得)编辑器来简化此任务?我希望有一个像Kompozer一样是用于网页的应用程序。 我尝试了gmanedit,但发现它基本上只是一个带有一些容易使用的摘录的文本编辑器-必须知道手册页格式才能使用它,而编辑区域只是一个文本小部件。 虽然我希望使用Ubuntu官方存储库中的软件,但可以使用不受支持的安装方法(例如PPA或从源代码安装)来确定。 software-recommendation gui documentation editor — dv3500ea source
9 可以使用DocBook标记来编写手册页,并使用诸如docbook2x-man之类的工具来创建troff输出。有一些可视(“ WYSIWYM”样式)编辑器可用于编辑DocBook标记。例如,GPL许可的Syntext Serna Free: 另外,doclifter是用于将手册页转换为DocBook的实用程序。 — Jukka Matilainen source 同意,我以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 — 罗杰·莱特 source
1 HTML5网络应用Grapse在一年前的Hacker News 2/3中被精选。它包括内置的预览和语法突出显示。 — aidanh010 source 看起来不错,但似乎主要用于FreeBSD / OSX,即使切换到AN页面右上方,也无法正确格式化标准Linux手册页(例如,丢失选项的段落间距)。 — 卡斯