MSDN帮助集成指南

核心提示： 编译HTML Help文件时，你必须让编译器产生.chi索引和二进制的目录表，MSDN帮助集成指南(4)，也就是toc.hhc文件，MSDN库需要用到这两个文件，它实现了加载某个dll并获取版本号，详细的使用说明请参考完整的帮助文件，为此，在.hhp工程文件的[OPTIONS]段里要加上&

编译HTML Help文件时，你必须让编译器产生.chi索引和二进制的目录表，也就是toc.hhc文件。MSDN库需要用到这两个文件。为此，在.hhp工程文件的[OPTIONS]段里要加上“Create CHI file=Yes”，“Binary TOC=Yes”选项。建议你将.chm文件和.chi文件放在MSDN库的集合目录中，但不一定非要这样做，放在其它地方，只要指定正确的路径也可以。编辑完集合文件之后，启动MSDN库，选中索引签产生帮助索引。此时会弹出一个对话框告诉你正在产生索引。 

创建HTML Help的工具

在集成MSDN之前，你必须创建好CHM文件。使用微软提供的免费工具HTML Help Workshop可以很方便的产生HTML Help文件。此外网上还有很多第三方开发的工具，不过都是要你掏银子购买的。 

MSDN 帮助信息集成实用工具

如果你觉得自己是个懒人，本文将给你提供一个方便的实用工具，用它就可以轻松将你的HTML Help文件集成到MSDN中。如图一所示。

图一　MSDN 帮助信息集成实用工具

你只要输入.chm和.chi文件的路径，提供一个集合信息标题串，定义一个帮助文件的唯一标示符。这个唯一标示符你可以自己取名定义，但最保险的方式是用GUID来保证它的唯一性，工具程序为你提供了一个按钮“Gen.GUID”来自动产生这个唯一标示。你还可以指定帮助文件的版本号，但此项不是必输项。最后按“集成到MSDN库”按钮。 实用工具的源代码可以从本文的开始处的链接下载，与集成有关的所有代码都封装在了CMSDNIntegration 类中，根据codejoke的许可协议，CMSDNIntegration类的源代码是免费使用的，因此你可以在自己的MFC程序中无限制地使用这个类来定制集成工具。在CMSDNIntegration的定义文件中还有一个代码中用到的辅助类CLoadLibrary，它实现了加载某个dll并获取版本号。详细的使用说明请参考完整的帮助文件。下图是我将《VC知识库在线杂志》第八期和第九期集成到MSDN库的情形。

图二 将《VC知识库在线杂志》集成到MSDN