docfx - 如何用docfx链接html文档

Question

我们目前正在使用 docfx 为我们的代码生成 html 文档。

我们有额外的 html 文档要链接到包括在内。

到目前为止，我已将它作为资源部分包含在 docfx.json 文件中，并且可以正常工作，但是 docfx 抱怨我指向它的任何链接，因为它不知道它。

在 build 部分下添加 html 文件的工作更少，因为 docfx 不知道该怎么做。

我还尝试创建一个 xrefmap.yml 文件来指向我现有的 html，它似乎不喜欢有本地的相对引用。

Answer 1

我缺少 html 内容的 toc.yml 文件。

Answer 2

到目前为止，我已将它作为资源部分包含在 docfx.json 文件中，并且可以正常工作，但是 docfx 抱怨我指向它的任何链接，因为它不知道它。

DocFX 知道资源部分。你应该像[a resource](resource.html).

我怀疑您正在使用[a resource](resource.md)，然后将警告记录为resource.md不存在。