如何将Doxygen生成的文档发布至Azure DevOps？

核心逻辑 #

优先用代码 Wiki 实现，这是Azure DevOps原生支持的方案，无需额外开发API调用、不用接入第三方服务，完全符合平台合规要求。 #

具体操作步骤 #

• 步骤1：创建绑定代码仓的代码 Wiki
  进入项目Wiki模块，选择「发布代码为 Wiki」，绑定你存放业务代码的仓库、master分支，指定一个专属的同步目录，比如docs/doxygen，完成Wiki创建。

  不要选「创建预配的 Wiki」，预配Wiki仅支持手动上传/API调用更新，操作成本更高。

• 步骤2：修改现有发布流水线
  在原有Doxygen生成HTML文档的步骤之后，新增2个操作：
  1. 将Doxygen输出的所有HTML、CSS、JS、图片等资源，全量移动到刚才指定的docs/doxygen目录下
  2. 执行Git命令把更新后的文档推送到master分支，参考命令：

  # 配置Git提交身份（可根据团队规范调整）
  git config --global user.name "DevOps 自动构建机器人"
  git config --global user.email "devops@yourteam.com"
  # 提交文档更新
  git add docs/doxygen/*
  git commit -m "自动更新Doxygen接口文档 [skip ci]"
  git push origin master
  

  提交信息里添加[skip ci]标识，可以避免本次文档提交重复触发流水线，防止循环执行。

• 步骤3：配置流水线权限
  进入项目仓库的「权限设置」页，给流水线对应的构建服务账号开通仓库的「贡献」权限，否则流水线推送代码会被拦截。
• 步骤4（可选）：配置Wiki入口
  在Wiki根目录新建README.md文件，添加iframe嵌入代码，用户打开Wiki就能直接访问文档首页，不用手动找HTML文件：

  <iframe src="doxygen/index.html" width="100%" height="900px" style="border:none;"></iframe>
  

可选优化 #

如果不想把生成的文档提交到业务代码仓污染提交记录，可以单独新建一个文档仓库，重复上述绑定代码Wiki的操作，流水线生成文档后直接推送到文档仓的对应目录即可。

内容的提问来源于stack exchange，提问作者Enzo Ferrazzano