Sandcastle帮助文件生成器无法查找文档源

时间:2012-08-05 07:44:12

标签: c# xml documentation sandcastle shfb

我正在使用Sandcastle帮助文件生成器构建VS 2010 C#项目的文档。我已将编译器生成的.xml文档和项目的Visual Studio解决方案.sln文件添加到文档源。我还将项目的可执行文件.exe添加到参考文献。但是,它没有建设。我收到这些警告和错误:

  

SHFB:警告BE0006:无法找到&C; \ Users \ user \ Music \ Documents \ Visual Studio 2010 \ Projects \ SFML_Platformer \ SFML_Platformer.sln&#39的任何文档来源; (配置:调试平台:AnyCPU)

     

SHFB:错误BE0042:您必须以程序集或Visual Studio解决方案/项目文件的形式指定至少一个文档源

问题是什么?

4 个答案:

答案 0 :(得分:8)

您应该只将XML文档文件添加为文档源。添加XML文件后会自动添加DLL。

答案 1 :(得分:2)

Eric a.k.a EWoodruff的答案是Sandcastle帮助文件生成器的开发人员。

  

BE0006意味着它无法找到基于文档源的文档源   项目。 BE0042是其发现的次要结果   什么都没有记录。什么类型的项目在   解?如果它是一个网站项目,请记住他们没有   通常会产生任何列为输出​​的程序集   项目也不是任何XML注释文件。在这种情况下,您需要添加   您的项目的Web代码提供程序,以获取XML注释和   手动添加网站的。\ bin文件夹作为文档源   SHFB项目。有关于记录网站的话题   如果是这种情况,请参阅“入门”部分。

     

所有其他项目类型都应该有效。如果一切都失败了,请尝试添加   直接汇编和XML注释文件。我认为这是可能的   Express版本使用不同的项目类型ID。如果你能发给我   解决方案文件和项目文件,我可以看看他们,看看   为什么它没有找到目标。我的电子邮件地址位于“关于”中   独立GUI中的框以及帮助中页面的页脚   文件。

     

另一件事,确保配置和平台设置   在SHFB工具栏中选择匹配配置和平台   用于构建项目的设置(即Debug / AnyCPU,   发布/ AnyCPU,Debug / x86等)。如果没有,那将导致它不会   找到合适的输出目标。

     

埃里克

source

答案 2 :(得分:0)

当我在主应用程序的VS.NET中将项目的构建从Debug切换到Release时,我遇到了这个问题。我假设它不能再找到我指定的.dll来创建文档。我本可以修复映射,但回到Debug对我来说就可以解决这个错误。

答案 3 :(得分:0)

在运行Build in Sandcastle之前,不要忘记在清理后重建解决方案。