帮助文件创作

Question

我很感激有关帮助文件创作（Win32）的一些建议。

我知道如何使用C＃或Delphi等现有的帮助文件，.chm或.hlp。 问题是，总有其他人能够提供这些文件：）

现在，我从哪里开始？

我一直在尝试使用HelpScribble，它可以工作，但我发现它有点缺乏，我可能也会使用TeX来渲染我的帮助文件。 Microsoft HTML Workshop有点粗糙。搜索其他工具会返回太多结果。

你们是怎么做的？使用Vim / Dreamweaver手动编辑HTML。 任何最佳做法？

Answer 1

两个月前我在一个项目中使用过adobe robohelp。我认为它提供了很好的结果。

我向你推荐。

Answer 2

我多年来一直使用过robohelp。

很好，但支持和升级路径搞砸了。核心技术也很陈旧。

我们正在转向madcap flare http://www.madcapsoftware.com/products/flare/robohelp.aspx

Answer 3

我们使用DocBook作为我们的基础帮助格式。它本质上是用于创建文档的XML子集。我们使用Syntext Serna作为我们的XML编辑器，因为它支持WYSIWYG和XML #includes的内联编辑。

使用Docbook的最大优势是可以使用Docbook项目提供的XSL模板将其转换为其他格式。我们可以从Docbook到HTML，HTMLHelp和PDF（通过XML-FO）。从理论上讲，转换为基于XML的MS字格式也是可能的。

从Docbook格式转换为chm文件非常简单：

1. 使用例如XSLTproc
在XML源上运行HTML-Help XSL模板
2. 使用Microsoft的HTML帮助编译器（HHC）编译输出HTML文件。