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

Question

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

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

Answer 1

这可能不是最好的方法，但是我已经使用Azure DevOps构建/发布管道完成了此操作。它不涉及API文档，因此我无法确定这是否适用。物有所值：

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

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

创建发布管道...

...将每个工件下载到一个地方。

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

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

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

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