如何在Docusaurus中引用同组织其他Github仓库的文档

完全可以实现，Docusaurus原生支持多文档源挂载，结合你现有AWS环境下的Jenkins流水线不需要调整现有部署架构，有两种成熟落地方案可选：

方案一：构建时拉取外部文档（推荐，适配性最强） #

• 依赖官方原生@docusaurus/plugin-content-docs插件实现多源挂载，不需要安装第三方维护的冷门插件，兼容性有保障。
• 先在Docusaurus配置文件docusaurus.config.js中为每个外部文档仓库单独声明插件实例，分别指定本地存储路径、路由前缀、侧边栏配置即可，不同来源的文档路由完全隔离，不会和主仓库自带文档冲突。比如A团队的服务文档可以统一挂在/docs/service-a/路由下，B团队的挂在/docs/service-b/下。
• 拉取外部文档的逻辑直接嵌入现有Jenkins流水线，不需要额外部署服务：
  1. 先给Jenkins配置同组织GitHub仓库的只读访问凭证，要是Jenkins跑在AWS VPC私网里，可以直接给Jenkins节点绑定的IAM角色配对应权限，或者走VPC的GitHub访问端点拉取，不用绕公网，稳定性更高。
  2. 在流水线的依赖安装步骤（npm install）之后、构建步骤（npm run build）之前，新增文档拉取阶段：用git sparse-checkout浅克隆目标外部仓库，只拉取仓库中存放文档的目录（通常是/docs、/wiki这类文件夹），不要拉取整个仓库，能大幅缩短构建时间。拉取到的文件统一放到项目下提前建好的external-docs/[仓库名]目录，和之前插件配置的本地路径一一对应就行。
  3. 常用拉取命令参考：git clone --depth 1 --filter=blob:none --sparse <组织内目标仓库Git地址> ./external-docs/repo-a && cd ./external-docs/repo-a && git sparse-checkout set docs
• 如果需要做文档版本对齐，拉取时直接checkout对应分支或tag即可，比如拉取v2.3.0标签下的文档和主应用版本匹配。

方案二：Git子模块挂载（适合文档更新频率低、版本强绑定场景） #

• 直接把组织内的文档仓库作为Git子模块添加到Docusaurus主仓库中，Docusaurus配置里直接将文档路径指向子模块内的文档目录即可，不需要额外写拉取逻辑。
• 本地开发时直接用git clone --recurse-submodules就能拉全所有来源的文档，不需要单独配置拉取流程。
• 适配Jenkins流水线时，只需要在原有拉取代码的步骤加上--recurse-submodules参数，保证子模块能正常拉取即可。
• 这个方案的缺点是子模块的版本指针需要在主仓库手动提交更新，没法自动同步外部仓库的最新文档，适合文档版本和主应用版本强绑定、不需要实时跟随外部仓库更新的场景。

注意事项 #

• 不要用年久失修的第三方自动文档同步插件，这类插件大多兼容性差，构建报错排查成本高，直接在Jenkins流水线里写拉取逻辑可控性最高，出问题直接查流水线日志就能定位。
• 不同来源的文档可以单独配置侧边栏、面包屑规则，最终都能归到统一的顶部导航分组里，不会出现导航割裂的问题。
• 如果外部文档仓库体量很大，可以提前在AWS侧做个仓库镜像同步，Jenkins直接从内网镜像拉取，进一步提升构建速度。

内容的提问来源于stack exchange，提问作者Stefano Caravana