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

时间:2015-12-30 18:41:06

标签: c# visual-studio visual-studio-2013 nuget-package sandcastle

我已经从NuGet安装了最新版本的Sandcastle(EWSoftware.SHFB版本2015.10.10.0),以及所需的Reflection软件包(EWSoftware.SHFB.NETFramework版本4.6)。

Sandcastle is installed

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

Sandcastle project type is missing

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

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

我正在使用Visual Studio Ultimate 2013。

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

感谢您的任何想法!

1 个答案:

答案 0 :(得分:1)

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

然后,我可以按照adding the documentation project and documentation source上{@ 3}}的指示操作新项目。

  

假设您已经拥有项目解决方案,请在解决方案中添加“文档”类型的新项目。

     

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

     

然后建立。

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

之后,我按照@ davy-landman提供的adding the namespace summaries上的说明(在评论Davy Landman的回答中)清除了一些丢失的旗帜。

  

这实际上已在最新版本(目前为1.9.3.0)中更改为Project Properties>摘要> NameSpaceSummaries。 - Ant Swift于2012年1月6日9:44