LWN 中文翻译

LWN.net 中文翻译计划

由 Wang Chen 创建于 2017/11/10

返回 “LWN 中文翻译计划” 主页

活动简介

LWN.net 是一份著名的计算机在线刊物，专注于报道有关自由软件，特别是有关 Linux 和其他 Unix-like 相关操作系统的新闻和技术动态。具体参考 Wikipedia 上有关 LWN 的介绍。

本活动目前主要针对 LWN.net 的内核相关文章进行中文翻译，所有 LWN 的内核文章的 英文原文 汇总在 Kernel index，我们的中文翻译成果汇总在 LWN 中文翻译成果汇总。有志于参加本翻译计划的朋友可以从 英文原文汇总（Kernel index） 中挑选您感兴趣的文章，只要确保不和 LWN 中文翻译成果汇总 中的文章冲突即可。当然为了避免其他的问题，您在挑选好感兴趣的译文后 在实际开始翻译之前 最好先和本项目的负责人先联系确认一下。具体项目负责人的联系方式请参考下面章节有关参与流程的介绍。（另：英文原文汇总（Kernel index） 中对所有文章按照 feature 做了分类，我们按照这些分类对近些年来的文章做了一个粗略的统计分析，供大家选择时参考。）
本活动本着 “自愿参与，开放共享” 的原则进行。所有译文提交给泰晓科技公开发布后，均遵循 CC BY-SA 4.0 协议许可。
所有译文提交给泰晓科技公开发布后，泰晓科技保留继续修改并完善的权利。在尽可能征得原翻译人员同意的前提下，欢迎其他读者提交补丁继续完善原译文。

参与流程

本活动欢迎广大爱好 Linux 的朋友一起参与，为保证活动的有序和质量，特制订如下流程：

参与流程

Step 1: 加入翻译团队
unicornx 为该项目的发起人，有意向参与的朋友请先加他微信（polardotw），然后再申请加入微信群 “LWN 翻译团队”，入群后请提供如下信息方便沟通交流。
姓名微信 id github id 自我介绍
汪辰 polardotw unicornx 目前的工作方向，对 Linux 内核哪方面感兴趣或者比较擅长
Step 2: Fork 主仓库
我们的工作基于 Github 进行，请首先注册 github 帐号，然后 Fork 主仓库 TinyLab.org .

姓名	微信 id	github id	自我介绍
汪辰	polardotw	unicornx	目前的工作方向，对 Linux 内核哪方面感兴趣或者比较擅长

Step 3: Clone 仓库

克隆 Fork 后的代码仓库到本地并添加主仓库地址为 upstream，假设你的帐号是 jack

  $ git clone https://github.com/jack/tinylab.org.git
  $ git remote add upstream https://github.com/tinyclub/tinylab.org.git

Step 4: 创建开发分支
注意：开始翻译前请和 polardotw (微信号) 联系，确定翻译的文章没有和其他人员冲突。
确认无误后创建开发分支进行翻译：
```
  $ git checkout gh-pages
  $ git checkout -b lwn-<XXXXXX>-<description>
```
对译文的开发分支的要求如下：
- 译文开发分支基于 origin 仓库的主线分支 gh-pages 创建，一篇翻译文章对应一个开发分支；一个开发分支对应一次或者多次 pull request 和一次 merge。
- 开发分支的命名规则遵循格式 lwn-<XXXXXX>-<description>，其中 XXXXXX 是文章在 LWN.net 上的编号；是你自己的简单描述，描述中只用英文字母，如果有多个单词用 `-` 分隔。例子：`lwn-123456-just-an-example`。
Step 5: 本地翻译与修改
在开发分支上工作 ( 假设你的开发分支为 lwn-123456-just-an-example )：
```
  $ git checkout lwn-123456-just-an-example
```
修改 ……，其中对修改的要求如下：
- 新增的译文文件放在 _posts 目录下。
- 文件的命名格式如下：YYYY-MM-DD-HH-MM-SS-lwn-XXXXXX-<article title>.md，其中 article title 是原文的标题，中间的空格用 - 代替，具体例子参考 _posts/2017-10-10-06-04-32-lwn-448502-platform-devices-and-device-trees.md 。可以用 tools/post 创建模板文件。Tips：如果审阅后需要涉及多次修改和提交，请每次确保修改文件名中的时间戳部分，采用最新时间确保文章发布后在网站上能够被置顶显示 :)。
- 译文的内容要求，也请直接参考 _posts 目录下的例子，LWN 的译文采取中英文联排格式，方便阅读者对比，毕竟译文再好也比不过原文的魅力，另外也方便读者随时审阅。另外注意如果原文中有链接，并且该链接所指向的文章我们已经翻译的，请在译文中修改相应链接指向我们已经翻译的文章，具体例子可以参考 _posts/2017-10-10-06-04-32-lwn-448502-platform-devices-and-device-trees.md 中的 [本系列文章的上篇](/lwn-448499-platform-device-api) 部分。
- 译文中的校对人信息第一次提交时可以先留空，等指定评审人后第二次修改提交时再补上即可。
- 另外，如果您是第一次参与泰晓科技的文章发表，请别忘记提交您的个人信息。提交方法请参考 _data/people.yml 进行添加。注：该修改请以单独的 Pull Request 提交，不要和译文工作混淆在一起，方便检查和合入。
修改完毕后：
```
  $ git add .
  $ git commit -s -m "commit title"
```
注意：我们要求在每次 commit 的时候务必添加注释和说明
Step 6: 提交到自己仓库
准备提交，注意提交前务必和 tinylab 的 upstream 保持同步，具体操作如下( 假设本地开发分支为 lwn-123456-just-an-example 并且当前已经 checkout 在该开发分支上工作)：
```
  $ git fetch --all
  $ git rebase --onto remotes/upstream/gh-pages --root
  $ git push origin lwn-123456-just-an-example
```
如果 merge 过程中有冲突则自行解决后继续，解决冲突后记得继续执行 git rebase --continue 确保所有变更都已合入。
Step 7: 发起 pull request
进入自己的 github 仓库页面，找到标签 pull request，点击右侧的 New pull request 按钮创建一笔 PR，缺省直接指向远程 gh-pages 分支（注意，远程主仓库 (upstream) 的主线分支不是 master，而是 gh-pages）。
提交后会安排交叉审阅，审阅工作通过 github 在线完成。
如果审阅过程中有修改则返回 Step 5 继续修改。注意：
- 原则上我们要求一次修改和评审对应一次 pull request，但实际操作中为方便起见，目前对此并不强制要求，在评审中翻译人员可以复用一个 PR。
- 每次修改后再提请审阅时一定要和 upstream 时刻保持同步。
Step 8: 管理员 Merge pull request
如果文章无误，管理员就会直接把提交合并到主仓库的主线分支 gh-pages 并关闭相关 PR 和删除相关开发分支。
Congratulations! 至此您的文章将在泰晓科技上发布。