制作弹性帮助文档(chm格式)和使用FAR

在《Flex帮助文档制作（ASDoc——html篇）》中，我解释了如何从我的flex项目中提取注释，以网页的形式生成帮助文档，这在现在相当流行。然而，许多公司在商业化时需要以chm格式提供帮助文档。似乎不能在flex中直接生成chm文档。如果有读者，请联系我，我也会学习。在这里，我主要解释如何将生成的网页文档转换成chm格式。我花了一天时间找到了很多软件，试了很久，但是很多都不是那么好用。这里推荐FAR和RoboHelp，但是RoboHelp的破解版很难找，英文版也不太了解。FAR更方便。FAR的安装非常简单，直接跳过。打开FAR，界面如下：。

点击文件-添加文件，如下，添加html帮助文档的所有文件，把我的文档放在Reference_1文件夹。

点击创建-帮助快捷弹出如下界面。

设置标题、主页(我们生成的所有主页都应该是index.html)和生成的chm文件的名称，然后单击创建帮助。之后，您可以单击查看帮助。效果如下：。

我们发现FAR已经将所有html文件生成到目录中，这不是我们想要的结果。重新复制之前的html帮助文档，我的在E:\work\Help。使用FAR添加所有文件，点击创建-帮助向导，弹出如下界面：。

点击下一步，讨论创建HHP的界面，如下：。

点击红色圆圈中的按钮，我们需要在您的代码根目录中创建一个HHP文件。单击后，右侧的对话框出现，位置就是您存储代码的地方。我的是E3360 \工作\帮助。单击打开将提示您HHP文件不存在，并询问您是否需要创建它。确保。如果可以自己写一个HHP文件，也就是你的帮助文档的目录链接信息，可以通过这个步骤直接导入。我们没有，所以系统会提示你创建，系统默认会在这个文件中搜索，自动创建一个合适的HHP文件，所以我说位置一定要选对，同时系统自动识别。确认后选择继续，弹出如下提示：。

点击是，进入HHP初级手动配置界面，如下：。

用红色圆圈标记的两个按钮分别用于设置默认页面和主页。我把index.html(原来是主页)设为主页，把package-summary.html设为默认页面，对应的是套餐列表页面。读者可以根据自己的爱好来设置。先点击页面再点击按钮，效果如下：。

点击继续-继续-创建目录，弹出如下界面：。

点击是，则需要编辑，并进入目录编辑页面。右边有预览，删除时可以看到效果。我删除了很多不想要的项目，留下了如下界面：。

也可以调整顺序等。最后点击保存关闭，再点击继续创建修改索引，就像目录一样，界面如下：。

保存并关闭，单击继续，输入标题和帮助文档名称，然后单击继续：。

点击帮助，完成后点击查看帮助文件，我们需要的帮助文档生成如下：。

我们生成html页面后，读者可以根据自己的意愿修改那些界面，然后打包得到自己想要的其他效果。