freeCodeCamp/docs/i18n/chinese/how-to-translate-files.md

如何翻译 freeCodeCamp 的资源

我们梦想为使用不同语言的用户提供学习资源。 为了实现这一梦想，我们将代码开源的课程整合到了 Crowdin 中——这是一个帮助我们本地化代码库的工具。

翻译流程主要包括两部分：

• 翻译课程文件、文档和 UI 元素（如按钮、标签）：

  译者可以在我们的翻译平台注册，然后从 30+ 种语言版本中选择要参与贡献的版本，进行翻译。

• 校对上述翻译。

  校对者确认社区成员贡献的译文语调一致，没有错别字等常见问题。 简而言之，校对者需要确保译文是高质量的。 注意，我们不使用任何机器翻译。

[!WARNING] 我们不再使用 GitHub 直接翻译文件。如果你曾经在 GitHub 参与翻译，现在请在我们的翻译平台参与。

贡献前的准备

freeCodeCamp 本地化路线图 —— 没有速度限制

你可以自由安排参与翻译的时间，自由选择翻译的内容。 问题只在于你愿意花多少时间和精力作为志愿者参与翻译。

我们希望你理解：

1. 翻译是一件团队协作的事情。

   翻译 freeCodeCamp 的资源是对贡献者来说最有趣和最有意义的经历之一。如果你邀请与你使用同一种语言的朋友和同事参与，那么效果最好。

   我们建议你和你的朋友在开始翻译前一起加入我们的社区论坛和贡献者聊天室来分享你们有兴趣参与翻译。 Crowdin 让翻译变得简单，但还是需要大量的工作。

   我们希望你在贡献过程感到快乐，而不是感到疲惫，然后失去兴趣。

   如果你们有一个四到五人的小组，就可以开始翻译一种新的语言了。 你可以再招募更多的朋友来加入这个队伍。

2. 为每种语言版本提供服务器，需要较高的成本。

   表面上来看，技术栈可能看起来没那么复杂，但是实际上消耗了很多资源来让引擎跑起来。 这包括提供额外的服务器和专职人员来管理它们。

   freeCodeCamp.org is committed to providing these for free as always, however we need to prioritize resources for those who need them the most. 我们非常不想看到某种语言的翻译活动结束了，并且内容过时了，然后我们不得不关闭相应的服务器。

   当某种语言的翻译团队完成了几个认证， 我们就可以开始将这种语言版本在/learn上线，然后你们可以继续翻译剩余的认证。

   举个例子， 当我们正式上线一个新的语言版本的时候，我们希望至少上线整个前端认证的内容。

3. 但是，如果一种语言没有在翻译平台上列出来，怎么办呢？

   我们已经查看了我们的用户群，并且在翻译平台的可用语言列表上添加了三十多种的常用语言。 有一些语言，例如中文和西班牙语，已经在 "/learn" 上线了。

   然而遗憾的是，这个语言列表并没有涵盖所有的世界语言。 我们每天都能收到许多像你一样的贡献者的需求， 希望将我们的资源翻译成他们的语言。

   我们当然希望在这个列表上增加更多的语言种类， 但是你可能已经猜到了， 假如我们有足够的人来翻译某一语言才能让这件事变得实际。

   假如你希望我们增加某一种新的语言， 我们建议你鼓动你的朋友一起来参与贡献。

   如果你们有一个组的人（至少四到五人）对某一种语言感兴趣，并且承诺翻译这种语言， 那么我们可以在翻译平台上增加这种语言。 我们会解释一切的细节，并且帮助你掌握这些翻译工具和理解这些翻译的过程。

准备开始

首先， 先确保你去我们的贡献者聊天室 问好。 我们会在聊天室定期更新翻译的资源和回答很多问题。

其次，去我们的翻译平台并且登陆（假如你以前没有贡献翻译过，你需要创建一个新账户）。

最后，浏览下面提供的细节图来理解怎么使用翻译工具和流程。

祝你在翻译过程中感到快乐哦！

选择一个项目和文件

当你访问翻译平台，你应该可以看到很多不同的等待翻译的项目：

1. 贡献文档项目，其中包含此文档站点的文件。
2. 编程课程项目，其中包含我们课程的挑战文件。
3. 学习用户界面项目，其中包含我们学习平台的按钮、标签等 UI 元素的字符串。

选择你想参与的任何项目，你将看到可供翻译的语言列表。

选择你要使用的语言，你将看到完整的文件树。

每个文件和文件夹都会显示一个进度条。 进度条的蓝色部分表示多少百分比的文件已经被翻译了，而绿色部分表示多少百分比的文件已经被校对团队审核确认。

选择你想翻译的文件，然后 Crowdin 会打开编辑界面。

[!NOTE] 打开编辑界面后，你需要点击设置图标（右上角的齿轮状图标），将 “HTML tags displaying” 设置为 “SHOW”。 这样，文件中会显示 <code></code> 标签，而不是 <0></0> 标签。

翻译课程

Crowdin 将文档分成可翻译的“字符串”，通常是句子。 每个字符串都被单独翻译。 参考上图：

1. 以绿色标示的字符串已经有了一个建议的翻译。
2. 以红色标示的字符串_没有_建议的翻译。
3. 带有灰色文本的字符串不可翻译。 对于代码块和其他必须不被翻译的内容，就是这种情况。 你将无法在编辑器中选择这些字符串。
4. 如果某位贡献者对某个字符串有建议的译文，那么 Crowdin 将在此处显示所有的建议。 你无法保存相同的译文。如果某个译文是正确的，那么你可以点击 + 图标，给它投票表示赞同。 如果你觉得某个译文不正确，那么你可以点击 - 图标，投反对票。
5. Crowdin 将基于翻译记忆（TM）或机器翻译（MT）推荐译文。 翻译记忆是指我们已在其他文件中翻译过/批准过的相似的或相同的字符串。 机器翻译是指由 Crowdin 系统推荐的翻译。
6. 这是编辑器窗口，你可以在其中输入你对于所选字符串建议的译文。
7. 编辑窗口当前选中的字符串将被标注为黄色。
8. 这里的标签是表示字符串的状态。 Done 标签表示字符串有至少一个建议的译文。 Todo 标签表示字符串还没有建议的译文。
9. 这里是评论窗口。 如果你对某个字符串有疑问或疑虑，可以在此处对字符串发表评论，以便其他翻译人员查看。
10. 点击这两个“窗格”按钮，可以隐藏左边的（文件）视图和右边的（评论）视图。

[!NOTE] 如果你看到一个被隐藏的（即灰色的）字符串有对应的译文，请在译者交流群告诉我们，我们会移除翻译记忆中的译文。

当你翻译完一个字符串，请点击 Save 按钮，将你的译文保存在 Crowdin 中。 然后其他贡献者可以给你的译文投票，而校对者也将审核确认你的译文。

你想翻译多少字符串，都可以，我们非常欢迎你贡献！当你翻译完某个文件或某个字符串之后，你不需要采取其他步骤。 你只需要点击 Save 按钮，就能保存你的译文了。

[!NOTE] 如果你发现在英语源文件中有不正确的内容，请不要在翻译流程中对其进行修改。 请在字符串上留下评论，通知我们有什么问题，或者在 GitHub 创建 issue。

翻译文档

翻译贡献文档的流程和翻译课程文件的流程类似。

[!NOTE] 我们的贡献文档由 docsify 提供支持，并且我们对消息框（比如这份文档里的）进行了特殊的解析。 如果你看到以 [!NOTE]、[!WARNING] 或 [!TIP] 开头的字符串，请注意不要翻译这些单词。

给译文评分

Crowdin 允许你对已有的建议译文进行评分。 在你尝试保存译文的时候，你可能会看到一条消息，提示你无法保存重复的译文——这意味着另一位贡献者已经建议了相同的译文。 如果你赞同那个译文，可以点击 + 按钮来投票赞同它。

如果你认为译文不正确或与源文件字符串的意思不一致，请单击 - 按钮投反对票。

Crowdin 通过这些投票为一个字符串的每个建议译文给出一个分数，这有助于校对团队确定哪个译文是最准确的。

质量保证检查

我们采用了一些质量保证步骤，以确保译文尽可能准确——这有助于我们的校对贡献者审核建议的译文。

当你尝试保存翻译时，你可能会看到一条警告消息，其中包含关于你所建议的翻译的通知。

当 Crowdin 的质量保证检查系统在建议的译文中发现可能的错误时，将显示此消息。 在这个例子中，我们修改了 <code> 标签的文本内容，Crowdin 会发现这个问题。

[!WARNING] 即使 Crowdin 提示有错误，你也可以选择保存译文。 如果你仍要通过点击 “Save Anyway” 保存译文，那么你应该标记（@）校对人员或项目经理，说明为什么需要忽略质量检查消息。

翻译最佳实践

请遵循下列准则，以确保我们的翻译尽可能的准确：

• 不要翻译 <code> 标签中的内容。 这个标签表示在文本在代码中，应保留英文文本。
• 不要添加额外的内容。 如果你认为源文件的文本内容或其他信息需要修改，那么请你在 GitHub issue 或 pull request 来提出更改建议。
• 不要更改内容的顺序。

如果你有任何问题，欢迎你随时在译者交流群提出，我们很高兴给予你支持。