c# - NuGet SandcaSTLe 安装后缺少文档项目类型

Question

我已经从 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 项目类型显示在“添加新项目”列表中？

感谢您的任何想法!

Answer 1

我能够通过运行 Sandcastle Help File Builder Guided Installer 来解决问题。 .这确定了缺少的组件并安装了它们。

然后我能够按照@frank-rem 在 adding the documentation project and documentation source 上的说明进行操作到新项目。

Assuming that you already have a solution with a project, add a new project of type 'Documentation' to your solution.

Right-click Documentation Sources and add a source by selecting the csproj you wish to document.

Then just build.

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

之后我按照 adding the namespace summaries 上的说明进行操作由@davy-landman 提供(在对 Davy Landman 的回答的评论中)以清除一些丢失的标志。

This has actually changed in the latest version (currently 1.9.3.0) to Project Properties > Summaries > NameSpaceSummaries. – Ant Swift Jan 6 '12 at 9:44