本文介绍如何为.NET开发者提供的类库创建Visual Studio帮助文件。这些帮助文件采用带有特定元标签的XHTML格式，并被组织成工作簿。文章还讨论了安装工作簿的要求。
如果你为.NET开发者提供了收费或者开源的类库，那么在其中包含帮助文件会显示出你的专业性。当在公司内部应用程序中重用一些框架的时候，拥有帮助文件也会让我们觉得非常方便。
\在最近的一篇文章中，Jeff Braaten向我们说明了创建Visual Studio帮助文件的过程。Visual Studio 2010 RTM和SP1中单独的帮助文件在本质上都是带有特定元标签的XHTML文件。在这些元标签中会存放基本的信息，如页面的语言/地区、内容表格中的位置、关键词以及对F1的支持等等。Jeff强调，我们可以使用.NET的XmlReader来读取这些页面，因此它们的格式必须与XHTML Basic 1.1很好地兼容。
\然后这些松散的页面会被组合成为工作簿（book）。每个工作簿会被压缩成zip文件，其中会包含所有主题页面以及简单描述工作簿的XHTML文件。想要安装以这种方式创建的工作簿，你需要拥有管理员的访问权限。如果不行的话，那么你可以把把zip文件和描述文件捆绑到签名的CAB文件中。当然，这需要获得签名的证书。
\在这个过程的描述中，他没有提到如何通过包管理器——特别是Nuget——来对其进行分发。安装时需要管理员访问权限，或者需要签名的CAB文件都有些让人无法接受，毕竟那仅仅是文档。
\ 查看英文原文： Packaging Visual Studio Help Files
扫一扫
8325
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
