Flex帮助文档(chm格式)制作及FAR的使用

在之前的文章里，我们详细介绍了如何将Flex项目中的注释提取成网页格式的帮助文档（HTML版）。现在，越来越多的公司希望把帮助文档打包成CHM格式，毕竟Windows环境下CHM文件更便于分发和离线查阅。不过Flex本身并不直接支持生成CHM，需要借助第三方工具做一层转换。

花了一天时间试了好几个软件，发现FAR和RoboHelp比较靠谱。但RoboHelp的破解版不好找，界面又是英文的，操作起来不太顺手。相比之下，FAR就方便多了，安装也简单。下面直接上实操。

打开FAR，界面如下：

点击“文件”->“添加文件”，将HTML帮助文档的所有文件添加进去。我的文档都放在Reference_1文件夹内部：

接下来，点击“创作”->“帮助特快”，弹出如下界面：

设置好标题、主页（生成的主页通常是index.html）以及要生成的CHM文件名，点击“创建帮助”。完成后点击“查看帮助”，效果如下：

但你会发现，FAR把所有的HTML文件都列到了目录里，这显然不是我们想要的。需要重新调整——把之前的HTML帮助文档复制一份到另一个目录，比如E:\work\Help，然后用FAR把所有文件添加进去，再点击“创作”->“帮助向导”，弹出如下界面：

点击“下一步”，进入创建HHP文件的界面：

点击红圈标记的按钮，在代码根目录创建一个HHP文件。点击后出现右边的对话框，位置选为存放代码的目录（这里是E:\work\Help）。点击“打开”会提示HHP文件不存在，是否创建，点击“确定”。（如果你熟悉HHP文件格式，也可以自己写一个，直接导入也行。）系统会自动在目录下搜索并创建合适的HHP文件——所以位置一定要选对，方便系统自动识别。确认后选择“继续”，弹出如下提示：

点击“是”，进入HHP初级手动配置界面：

使用红圈标记的两个按钮，分别设置一个默认页面和一个主页。这里把index.html设为主页，package-summary.html设为默认页面（它对应包列表页面，可根据个人喜好调整）。先点击页面，再点击按钮，效果如下：

依次点击“继续”->“继续”->“创建目录”，弹出如下界面：

点击“是”，进入目录编辑页面。右边有预览，可以一边删除一边看效果。把不需要的条目删掉，保留如下结构：

还可以调整顺序。最后点击“保存”，关闭窗口。然后点击“继续”，进入索引的创建和修改，操作和目录类似：

保存后关闭，点击“继续”，输入标题和帮助文档名称，再点击“继续”：

点击“编译帮助”，完成后点击“查看帮助文件”，就生成了我们需要的CHM帮助文档：

后续还可以根据需求修改生成的HTML页面，再重新打包，得到想要的其他效果。用FAR配合帮助向导，可以灵活控制CHM的目录和索引结构，比直接使用“帮助特快”效果好得多。