问题描述
我需要你的指导...
鉴于一个组织可能在各种存储库中拥有多个产品,并且可能有许多文档存储库,如何将所有内容集成到一个“docs.acme.com”站点中?
例如:3 个产品:X、Y 和 Z,Z 有多个回购。每个人都有自己的/docs。
productX.git
- /src/ sln + *.csproj
- /docs/*
productY.git
- /src/ sln + *.csproj
- /docs/*
productZ.core.git
- /src/ sln + core.csproj
- /docs/* productz.wpf.git
- /src/sln + wpf.csproj
- /docs/* productz.web.git
- /src/sln + wpf.csproj
- /docs/*
一些团队甚至有一个概念性文档存储库。
TeamFoo.git
- /docs/*
和“父”存储库
docs.acme.git
- /docs/*
结果(如果我们模仿 docs.microsoft.com):
- docs.acme.com/
- docs.acme.com/products/
- docs.acme.com/products/productX/
- docs.acme.com/products/productY/
- docs.acme.com/products/productZ/
- docs.acme.com/products/productZ/core/
- docs.acme.com/products/productZ/wpf/
- docs.acme.com/products/productZ/web/
- docs.acme.com/teams/foo/
- docs.acme.com/teams/bar/
这怎么可能?
如果每个 repo/docs 都有自己的 docfx.json,那么每个编译的 _site 都将被视为“父站点”,这是不正确的。
到目前为止,我最接近的是每个子文档都有一个存根 index.md 和 toc.yml 并复制“目标文件夹结构”,并有一个“父构建”,其中包括作为参考子存储并复制它们的相关文件夹。
要求:
- 作为“产品”开发人员,当我运行 docfx serve 时,我可以验证文档是否看起来不错。
- 作为“企业文档”集成商,父文档和子文档是一体的。
- 作为“贡献者”,当我点击“贡献给这个文档”时,我会得到正确的存储库/文件
解决方法
暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!
如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。
小编邮箱:dio#foxmail.com (将#修改为@)