我在不同的存储库中有多个docfx 文档。如何将这些文档合并到一个包含多个其他文档的docfx 项目中?
在项目之间使用docfx交叉引用并没有解决我的问题,因为它只是在项目之间链接我,但没有合并。
我在不同的存储库中有多个docfx 文档。如何将这些文档合并到一个包含多个其他文档的docfx 项目中?
在项目之间使用docfx交叉引用并没有解决我的问题,因为它只是在项目之间链接我,但没有合并。
这可能不是最好的方法,但我已经使用 Azure DevOps 构建/发布管道做到了这一点。它不涉及 API 文档,所以我不能说这是否适用。物有所值:
假设每个 repo 都有自己的 Markdown 文件和图像......
为每个将其内容发布为工件的存储库创建一个构建管道。
创建发布管道...
...将每个工件下载到一个地方。
DocFx 提供发布管道任务。将其添加到发布管道。
在中心位置创建通用docfx.json
。包括每个下载的工件的路径。
将 DocFx 发布管道任务指向该docfx.json
文件。
要应用自定义模板,请为模板创建一个存储库并遵循相同的步骤:将其发布为工件,使用发布管道下载它,并使用docfx.json
.