扫码阅读
手机扫码阅读

GitHub Actions 真香系列之文档自动简繁体转换

315 2024-01-25

Github Actions是GitHub提供的CI/CD服务,作者最近尝试使用后感到非常满意。GitHub Actions中的核心概念包括:

  • workflow(工作流程):一次完整的持续集成运行过程。
  • job(任务):由一个或多个jobs组成的工作流程,每个job完成一系列任务。
  • step(步骤):每个job由多个steps组成,按顺序执行。
  • action(动作):每个step可以执行一个或多个命令。

文章接着介绍了如何使用GitHub Actions自动将简体中文文档翻译成繁体中文,这一过程基于opencc工具实现。

首先,需要在ubuntu-latest环境中安装opencc:

apt-get install libopencc-dev -y

然后,使用PHP的opencc4php扩展并通过symfony/finder组件来遍历目录和文件。文章提供了安装扩展和组件的命令和代码。

随后,作者展示了如何使用PHP代码调用opencc4php的API进行简繁体转换,并详细列出了代码实现。

在tools目录中创建composer.json和translate.php文件后,文章最后说明了如何将这些组件整合成一个GitHub Action。创建.github/workflows目录并在其中新建translate.yml文件,该文件定义了翻译的工作流程。

提交到GitHub之后,不管是直接推送还是贡献者提交PR,都会触发工作流程并生成一个commit message为"Update docs and translate"的提交,实现自动文档翻译功能。作者还提供了swow/wiki的示例以供参考。

最后,作者沈唁志邀请读者关注其二维码,并鼓励点赞支持。

想要了解更多,点击 查看原文