如何入门开源文档翻译

本文最后更新于:2023年8月7日 凌晨

为什么要翻译?

给正版文档贡献

Jest 中文文档、Yarn 中文文档、npm 中文文档…

虚假的 Jest 文档

(来自百度第一
优点:百度排名第一,中文;缺点:除了优点都是缺点

Pasted image 20230715143445
image.png
image.png

真实的 Jest 文档

优点:谷歌排名第一、信息最新;缺点:百度排名不是第一,中文不一定对
image.png
image.png
image.png

省钱小妙招

image.png
image.png

拯救下一个同学

比如更新滞后的MDN中文文档,按照中文的信息来得加半天的debug时间(笑
image.png
image.png

哪里可以贡献翻译?

image.png

独立维护文档站点

独立站点一般是直接整个网站镜像,然后翻译。

也有的是按自己的思路来翻译,这种一般多为GitBook

下图分别是印记中文,官网。镜像的方式,长得一样

image.png

image.png

基于MR形式

Issues · reactjs/zh-hans.reactjs.org

GitHub - vuejs-translations/docs-zh-cn: Vue 文档官方中文翻译 | Official Chinese translation for Vue docs

翻译步骤:

  1. 维护团队将原文档进行划分

  2. 贡献者提交该模块翻译****MR

  3. 严格的 review 环节

  4. 代码合入,翻译完成

比如https://github.com/reactjs/zh-hans.reactjs.org/pull/870

image.png
image.png

基于第三方平台

https://crowdin.com/

crowdin是一个文案翻译平台,按句子的粒度切割文案进行翻译。

在某些情况下这是个缺点,比如语言习惯不同、基于语境的翻译,表述不一定跟原文句子一致。
image.png

image.png

翻译步骤:

  1. Crowdin平台加入对应项目

  2. 选择翻译语言后按句翻译

  3. 保存,翻译完成

翻译中需要注意什么?

翻译实际上是译者根据原文进行的二次创作

遣词

  • 正确使用专业术语

    • 合理地使用常见术语可以降低沟通成本

    • 不要使用过于小众或自创的术语

    • 必要时提供对照的英文术语以方便理解

    • 避免无上下文的缩略词

image.png
赛普拉斯?Cypress!傀儡师?Puppeteer!笑话?Jest!

争议:《JavaScript高级程序设计(第4版)》的“期约”败笔

  • 省略程度副词

    • 不管作者意图为何, “非常重要” 和 “重要” 在读者看来大同小异
  • 不要使用过于生僻的词汇,不要过度使用书面语

造句

  • 尽量使用短句,不要使用多从句的复杂句式

  • 去掉无意义的修饰,去掉试图缓和语气的从句

    反例:“我们可以看到, 数据库在一定程度上可以满足我们对事务支持的需求。”

    修改后:“数据库支持事务”

    反例: “MR 提交信息作为读者查阅修改历史时第一时间看到的信息,其重要性不言而喻。”

    修改后:“读者查阅修改历史时会首先关注 MR 提交信息。”

  • 语气要冷静。避免过于口语化

    • 不要加顺口溜

    • 不要使用语气词

  • 准确并客观地描述事实,避免加入主观情绪

排版

中文文案排版指北GitHub - sparanoid/chinese-copywriting-guidelines: Chinese copywriting guidelines for better written

React 中文文档译文排版指南 · reactjs/zh-hans.reactjs.org Wiki

中英文之间需要增加空格

正确:

在 LeanCloud 上,数据存储是围绕 AVObject 进行的。

错误:

在LeanCloud上,数据存储是围绕AVObject进行的。

在 LeanCloud上,数据存储是围绕AVObject 进行的。

中文与数字之间需要增加空格

正确:

今天出去买菜花了 5000 元。

错误:

今天出去买菜花了 5000元。

今天出去买菜花了5000元。

数字与单位之间需要增加空格

正确:

我家的光纤入屋宽带有 10 Gbps,SSD 一共有 20 TB

错误:

我家的光纤入屋宽带有 10Gbps,SSD 一共有 20TB

例外:度数/百分比与数字之间不需要增加空格

我的翻译小插曲

  1. 结合上下文

原文:

The expect function is used every time you want to test a value. You will rarely call expect by itself. Instead, you will use expect along with a “matcher” function to assert something about a value.

机翻:

每次要测试一个值,你需要使用expect函数。你大概率不需要自己调用expect。相反,你通常会使用expect配合matcher函数来断言某个值

尝试修改:

expect用于测试一个值。通常会结合matcher函数来断言某个值,而不是单独使用expect

  1. 特有名词

Fake TimersMock该不该进行翻译

收获

  1. 提高阅读全英文档的能力

  2. 提高技术文档写作的能力

  3. 发现不常用但有用的配置


如何入门开源文档翻译
https://www.chanx.tech/2022/9865f7dac7c8/
作者
ischanx
发布于
2022年8月25日
更新于
2023年8月7日
许可协议