0

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

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

4

1 回答 1

2

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

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

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

创建发布管道...

在此处输入图像描述

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

在此处输入图像描述

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

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

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

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

于 2019-08-14T22:33:22.200 回答