打包Visual Studio帮助文件

如果你为.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

你可能感兴趣的:(打包Visual Studio帮助文件)