可以从多个存储库生成docfx文档吗？

Question

我在不同的存储库中有多个docfx文档。如何将这些文档合并到一个包含多个其他文档的docfx项目中？

在项目之间使用docfx交叉引用并没有解决我的问题，因为它只是将我链接到项目之间，而不是合并。

Answer 1

这可能不是最好的方法，但我已经使用Azure DevOps构建/发布管道做到了这一点。它不涉及API文档，所以我不能说这是否适用于此。值得一提的是：

假设每个repo都有自己的Markdown文件和图像...

为将其内容作为工件发布的每个存储库创建一个构建管道。

创建发布管道...

​

​

...that将每个工件下载到一个位置。

​

​

DocFx提供了一个发布管道任务。将其添加到发布管道中。

在中心位置创建通用docfx.json。包括到每个下载的工件的路径。

将DocFx release管道任务指向docfx.json文件。

要应用自定义模板，请为该模板创建一个存储库，并遵循相同的步骤:将其作为工件发布，使用发布管道下载它，并使用docfx.json引用目录。