json.net - NewtonSoft.Json.xml 文件引用了一个未随附的文件，这会导致 SandcaSTLe 破坏

Question

我试图引用 Newtonsoft.Json.xml 作为记录我自己的依赖它的代码的一部分。
当我尝试在 SandcaSTLe 中编译我的帮助文件时，出现以下错误:

BuildAssembler : error :  [...\BuildTopics.proj]
BuildAssembler : error : CodeBlockComponent: [N:Newtonsoft.Json] Unable to load source file '...\Visual Studio 2017\Projects\CBUSAlexa\trunk\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs'
Error: Could not find a part of the path '...src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs'. [...\BuildTopics.proj]

(某些路径已被混淆)

查看 Newtonsoft.Json.Xml 我看到:

        <member name="T:Newtonsoft.Json.DefaultValueHandling">
            <summary>
            Specifies default value handling options for the <see cref="T:Newtonsoft.Json.JsonSerializer"/>.
            </summary>
            <example>
              <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs" region="ReducingSerializedJsonSizeDefaultValueHandlingObject" title="DefaultValueHandling Class" />
              <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs" region="ReducingSerializedJsonSizeDefaultValueHandlingExample" title="DefaultValueHandling Ignore Example" />
            </example>
        </member>

此代码未作为 Json.NET 安装的一部分提供，因此缺少 src 路径(这是有道理的，因为它们是测试)，但 SandcaSTLe 不应该只是因为它们丢失而放弃构建。

我希望构建完成并忽略这些链接文件 - 或者是否应该有关于运送文档 xml 文件中引用的任何文件的指导？

Answer 1

在您项目的 SandcaSTLe 帮助文件生成器的组件选项卡中，选择“代码块组件”并将其添加到您的项目中。配置时，请确保选中“允许丢失的源代码文件/区域”。

这有点误导，因为如果没有添加组件，它似乎不应该尝试查找这些项目。另请注意，构建选项卡“禁用自定义代码块组件”与上述不同，因此检查不会对您的构建错误产生影响。