如何使用 docfx link html 文档

How to link a html document with docfx

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

我们还有其他 html 个文件要 link 添加。

到目前为止,我已将它作为资源部分包含在 docfx.json 文件中,并且有效,但 docfx 抱怨我指向它的任何 link,因为它不知道它。

在构建部分下添加 html 文件效果更差,因为 docfx 不知道该怎么做。

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

So far I've included it as a resource section in docfx.json file, and that works, but docfx complains about any link I point to it since it's not aware of it.

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

这样引用它

我怀疑您正在使用 [a resource](resource.md),然后记录了一条警告,因为 resource.md 不存在。

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