翻译
本文档以英文撰写。为了让更多人用得上,我们也发布了机器翻译的版本。本页说明这对你意味着什么,以及如何帮助改进这些译文。
目前提供的语言
翻译文档目前是预览版,提供十二种语言:Deutsch、español、français、हिन्दी、日本語、한국어、português (Brasil)、русский язык、Türkçe、українська мова、简体中文和繁體中文。在任意页面顶部的语言切换器中选择即可。等这些语言经过验证后,可能会增加更多语言。
API 参考不做翻译:翻译站点会链接到唯一的英文版。
以英文为准
如果翻译页面和英文原文不一致,以英文页面为准。翻译站点的每个页面开头都有以下三种说明之一,标明该页面的状态:
- 机器翻译——该页面由机器自动翻译,并链接到英文原文。
- 译文落后于英文页面——英文原文在该页面翻译之后有过改动,在译文跟上之前,部分内容可能已经过时。
- 以英文显示——该页面目前没有可用的译文,所以你读到的是英文原文。
译文是如何生成的
翻译页面由本仓库中的一个工具根据 docs/ 下的英文页面机器生成,每种语言由两份人工编写的输入指导:一份风格指南(语体、语气、排版,以及如何处理玩笑和习语)和一份术语表(哪些术语保留英文,其余术语的规定译法和禁用译法)。生成的文本从不手工编辑。所有改进都写进这两份输入,这样下次重新生成页面时改进依然有效。
报告翻译问题
发现了错误的术语、别扭的句子,或者译文说了英文原文没有的意思?请提交 issue,写明语言、页面和具体段落;母语读者的报告尤其有价值。如果你知道怎么改,可以直接向 i18n/ 下对应语言的风格指南(instructions.md)或术语表(glossary.json)提交 pull request——这样下次重新生成译文时,修正就会覆盖所有受影响的页面。英文原文本身的问题则和其他文档改动一样,在 docs/ 下的页面中修复。