帮助文件创作

Question

我将不胜感激关于帮助文件创作（Win32）的一些建议。

我知道如何使用C＃或Delphi或其他任何现有的帮助文件，.chm或.hlp。 问题是，总有其他人已经很好地向我提供这些文件:)

现在，我该从哪里开始？

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

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

Answer 1

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

我推荐给你。

Answer 2

我已经使用了robohelp多年。

这很好，但支持和升级途径搞砸了。核心技术也很过时。

我们正在向狂妄的火炬http://www.madcapsoftware.com/products/flare/robohelp.aspx

Answer 3

我们使用DocBook作为我们潜在的帮助格式。它本质上是为创建文档而设计的XML子集。我们使用Syntext Serna作为XML编辑器，因为它支持所见即所得和XML #includes的内联编辑。

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

从DocBook格式前往一个CHM文件很简单，只要：

1. 例如使用xsltproc的
2. 编译使用微软的HTML帮助编译器输出HTML文件运行XML源上的HTML的帮助XSL模板（HHC）。