Skip to content

翻译流程

Lingfeng_Ai edited this page Aug 30, 2018 · 20 revisions
  1. 翻译流程总览
  2. 如何推荐英文原文
  3. 如何认领翻译并提交
  4. 校对与发布

1.翻译流程总览

翻译流程包括以下阶段,使用issue和pull requests配合标签(A,B,C前缀)进行管理。issue用于推荐和认领文章,pr用于管理完成的译文,进行校对等事务。此外,系列文章通过project进行管理,感兴趣可以到对应到project下面去浏览同一个系列到文章

原文推荐(A1) --- 推荐审核 ---> 待翻译(B1) ---- 翻译中(B2) ---- 待校对(B3) ---- 校对中(B4) ----> 完工待发布(C1) ---- 已发布(C2)

标签 含义
A1-Recommend 推荐译文原文
B1-To do 待翻译,认领后添加B2
B2-In progress 当前正在翻译中,完成翻译后,创建PR(添加closes #issue)并添加B3
B3-Need review 完成翻译待校对,请至对应的pr认领校对并添加校对中标签
B4-Reviewing 文章正在校对中,完成后评论合入主线并添加C1
C1-Finished 校对完成,待发布
C2-Published 文章已发布至伯乐在线

2.如何推荐英文原文(A1-Recommend)

原文推荐欢迎大家参与,如果你特别善于推荐某一类问题,欢迎自荐。

  • 搜索是否有重复文章
  • 使用Recommend模板直接发起issue(点我推荐
  • 填写推荐理由
  • 添加A1-Recommend 标签及文章对应分类标签(可以新建,请以T-为前缀)
  • 系列文章请添加【T-系列文章】到标签,标题里面用(1/5)表明是系列第几篇/共几篇,后续会通过project跟踪
  • 提交issue等待审核通过
  • 审核后会变为B1-To do标签,即可认领翻译

3.如何认领翻译并提交(B1-To do)

3.1 认领翻译(B1-To do)

issue列表里面所有具有B1-To do标签的文章均可以认领翻译

  • 过滤标签B1-To do或使用is:open is:issue label:"B1-To do" 可以得到待翻译列表。
  • 过滤标签T-软件工程或使用is:open is:issue label:"B1-To do" label:T-软件工程 可以得到具体分类中待翻译的文章

包含文章标题和文章的分类(T前缀标签),选择感兴趣的文章,进入issue

  1. 在评论中认领翻译
  2. @hanxiaomax

3.2 翻译中(B2-In progress)

认领完成后,标签已经修改为B2,该issue也会被指派给认领者,此时进入翻译实施的流程。

  1. 如果是第一次翻译,请先fork该项目
  2. 切换到trans分支,并从该分支创建一个新的分支做翻译用,分支名格式: (#<issue号>-<文章英文标题>

  1. 在你创建的分支中的translation文件夹中创建一个新的markdown文档 并提交到分支上

  2. 进行翻译

    • 如果你希望在本地翻译,可以仅仅克隆该分支,master分支可能会很重

    • 如果你希望在线编辑,推荐使用http://prose.io/, 通过下面格式的链接可以找到文章

      http://prose.io/#YOUR_USERNAME/translation-warehouse/tree/BRANCH_NAME/translation
      

      也可以直接从http://prose.io/主页进入,具体的操作方法可以点击这里

    • 翻译请使用一段英文、一段中文的形式(具体参见排版规则

3.3 提交译文

  1. 翻译完成后,发起pull request,将文章提交到伯乐在线的trans分支
  2. 提交pr时,会自动加载pr模板,补全closes + #issue号
  3. 一篇文章只能创建一个pr,不要重复创建,需要补充修改时,只需要向你自己的分支提交commit即可
  4. 注意:不要向你的分支提交与本译文不相关的内容,如果不慎提交,请参考:如何撤销已经发起pr分支中的commit

4.校对与发布

4.1 如何认领校对(B3-Need review)

  1. 认领校对请至pull request列表,所有标记为B3-Need review的PR均可以认领校对
  2. 选择感兴趣的文章,点击进入PR,在评论中回复【认领校对】,并@hanxiaomax
  3. 每篇文章需要一人校对,免校对流程待定

4.2 如何进行校对(B4-Reviewing)

1.切换到文件选项卡查看译者提交到文章
2.由于文章的中英文都是新提交的,所以我们切换diif的方式为unified的,以一栏的方式进行校对
3.鼠标悬浮在某行的起始处可以针对该行添加意见
4.点击start a review提交意见,不要点击add single comment
5.完成校对后,点击review changes来提交意见

意见包括:

1. 有一些小问题,但是校对通过
2. 校对通过
3. 返回修改
4. 评论
    - @译者
    - 给出综合评价

4.3 文章发布(C2-Published)

  1. 文章校对通过后,会合并pull request,到伯乐在线的trans分支,进入完工(C1-Finished)状态 ,对应issue关闭
  2. 完工后的文章会尽快(1-3个工作日)发布到伯乐在线,并在对应issue中告知文章发布后的地址,发布后标记切换为(C2-Published
  3. C2-Published状态下的文章,译者可以转载
  4. 文章后续会根据情况,在微博或微信公众号上发布,一般情况下不另行通知