Istio 官方中文文档工作组,仅用来处理相关任务分派和跟踪 - https://preliminary.istio.io/zh/
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md added some additional rules Aug 16, 2018

README.md

ISTIO 文档汉化工作

Istio 官方文档中文翻译工作组,仅用来处理相关任务分派和跟踪。

当前已合并到 Istio 官方网站中的中文部分可以通过 https://preliminary.istio.io/zh/ 预览。

Service Mesher Slack Workplace

工作流程

  1. 目前项目的 Issue 中包含了尚待翻译的绝大多数文档,要参与的同学可以自行去 Issue 中回复认领,以避免重复工作。整个翻译进度通过 project 追踪,查看待领取的 Issue

  2. 待任务被指派给你的后就可以开始翻译了

    • 对于翻译文稿中涉及到的静态文件,直接沿用英文版的文件(例如 ![english image](/docs/conecept.....)),不再需要自行拷贝。
    • 文稿中的站内链接,需要检查对应文档是否已经有了中文版,如果是,则应将站内链接指向中文版本。
  3. 翻译之前可以请查阅约定和术语表,若对某些词汇的翻译模棱两可,可以直接回复该 Issue。

  4. 翻译过程中可以在项目根目录中运行 make serve,能够启动一个本地 Web 服务器,访问 http://localhost:1313 在其中可以进行预览。

  5. 提交 PR 之前,可以在项目根目录运行 make lint,初步做一下 CI 的检查,成功后再提交。

  6. 如果检查通过,就可以向 Istio 官方网站提交 PR,PR 被合并后就可以通过 Istio 1.0 网站预览页面看到被合并后的页面。

  7. 重复第一步开始的流程。

新增了一点自动化指令

所有指令,都在 Issue 中以 Comment 的形式输入,仅对 Member 有效。如果出错或者不符合条件,不会有任何提示。

  1. /accept: 适用于 pending 状态,且当前无人指派的 Issue,输入该指令,会将该 Issue 指派给当前用户。并变更状态为 translating
  2. /pushed: 适用于 translating 状态的 Issue,输入该指令,会将该 Issue 指派给当前用户。并变更状态为 pushed
  3. /merged: 适用于 pushed 状态的 Issue,输入该指令,会将该 Issue 指派给当前用户。并变更状态为 finished,然后关闭 Issue

注意:每个用户只能同时有三个处于 translating 状态的 Issue,超过上限之后,Bot 不会回应 /accept 指令。所以务必确认指派已经完成之后才开始翻译工作。