NuGet Sandcastle 安装后缺少文档项目类型答案

【问题标题】：Documentation project type missing after NuGet Sandcastle InstallNuGet Sandcastle 安装后缺少文档项目类型
【发布时间】：2015-12-30 18:41:06
【问题描述】：

我已经从 NuGet 安装了最新版本的 Sandcastle（EWSoftware.SHFB 版本 2015.10.10.0），以及所需的反射包（EWSoftware.SHFB.NETFramework 版本 4.6）。

我阅读了@Frank-Rem 对 Numid 问题 How to generate documentation using Sandcastle NuGet package (EWSoftware.SHFB)? 的回答，并尝试在我的解决方案中添加一个新项目。但是，当我尝试添加 Sandcastle 文档项目时，我没有将文档项目类型作为选项。

我卸载了 NuGet 包并重新安装了它，认为它可能是一个错误的安装。但是文档项目类型仍然不是一个选项，即使在关闭并重新启动 Visual Studio 之后也是如此。

我通读了 readme.txt 文件，发现在生成 .shfbproj 文件时我需要添加一些属性标签。除此之外，我没有看到需要执行的任何其他步骤或要安装的软件包才能显示项目类型。我还去了GitHub project page 并检查了“问题”选项卡，以确保这不是他们正在处理的已知问题。

我正在使用 Visual Studio Ultimate 2013。

是否需要采取其他步骤才能让 Sandcastle 项目类型显示在“添加新项目”列表中？

感谢您的任何想法！

【问题讨论】：

【解决方案1】：

我能够通过运行Sandcastle Help File Builder Guided Installer 解决问题。这会识别缺失的组件并安装它们。

然后我就能够按照@frank-rem 在adding the documentation project and documentation source 上的指示进入新项目。

假设您已经有了一个项目解决方案，请将一个“文档”类型的新项目添加到您的解决方案中。

右键单击文档源并通过选择要记录的 csproj 添加源。

然后构建。

我为获得最终帮助文档而采取的其他步骤： 我发现 Sandcastle 添加了几个 TODO 项，这些项未显示在 Visual Studio 任务列表中。所以我搜索了 TODO 的解决方案并以这种方式解决了它们。

之后，我按照@davy-landman 提供的adding the namespace summaries 上的说明（在对 Davy Landman 的回答的评论中）清除了一些丢失的标志。

这实际上在最新版本（当前为 1.9.3.0）中已更改为 Project Properties > Summaries > NameSpaceSummaries。 – Ant Swift 2012 年 1 月 6 日 9:44

【讨论】：