UsubeniFantasy
·
使用GitHub Actions自动更新开源项目的API文档
💡
原文日文，约2400字，阅读约需6分钟。
📝
内容提要
本文介绍了如何利用GitHub Actions和Docusaurus自动生成和更新API文档，以应对开源库中频繁的接口变更，确保在发布新版本后文档网站的API部分能够自动更新。
🎯
关键要点
- 在更新开源库时，接口的添加、删除或修改是常见的，手动更新文档繁琐，因此需要自动化的管道。
- 使用Docusaurus管理API文档，并将其与主代码库分开，示例使用mind-elixir-core和mind-elixir/docs。
- GitHub Actions的配置文件包括多个步骤，如检出代码、安装依赖、构建项目和发布到npm。
- 推送操作需要设置个人访问令牌（PAT），以便将更改推送到目标GitHub仓库。
- 获取PAT的步骤包括在GitHub设置中选择开发者设置和个人访问令牌。
- GitHub Action的基本流程包括拉取项目、构建、发布、提取接口信息、生成Markdown文件、更新文档仓库并触发文档网站构建。
- 通过这种设置，发布新版本后，文档网站的API部分会自动更新。
🏷️
标签
➡️
