让Sandcastle Help File Builder支持VS2010
引子:
Sandcastle是一个管理类库的文档编译器,是用于编译发布组件(Assembly)信息的一个工具,这个工具通过反射和Xslt技术,可以从dll文件及其xml注释(命令行编译时加/doc参数或vs2005设置项目属性得到)得到一个完整的帮助文档,格式可以是Html或CHM甚至是任何自定义的格式。
Sandcastle Help File Builder (参见主页:http://shfb.codeplex.com)
它提供一个类似于NDoc的界面,允许你输入现有的NDoc项目,自动完成创建过程。
问题:
在VS.NET2010RC版中使用.NET Framework 4.0来开发项目时, Sandcastle Help File Builder得不到友好的支持,导致编译生成帮助文档时出错,解决办法是:
在X:\Program Files\Sandcastle(此为Sandcastle安装路径)\ProductionTools目录下新建一个MrefBuilder.exe.config文件,内容如下:
<?xml version="1.0"?>
<configuration>
<startup>
<supportedRuntime version="v4.0.30128"/> <!-- 4.0 RC -->
<supportedRuntime version="v2.0.50727"/> <!-- 2.0 RTM -->
</startup>
</configuration>
再次编译Sandcastle Help File Builder项目时正常通过.
该解决方案来自: http://shfb.codeplex.com/WorkItem/View.aspx?WorkItemId=24651