翻译¶
令人难以置信的是,在国际社会的帮助下, MkDocs的材料已被翻译成60多种语言。正如你所想象的, 我们维护人员不可能让所有语言都保持最新和最新 功能有时需要新的翻译。
如果您想帮助我们在全球范围内制作MkDocs材料 可访问,并注意到缺少您语言的翻译,或者 如需添加新语言,您可以按照指南中的步骤帮助我们 在......下面
在创建问题之前¶
翻译经常发生变化,这就是为什么我们希望确保您不会 把时间花在复制工作上。在添加翻译之前,请检查 以下事项:
检查语言可用性¶
有60多种语言,你的语言很可能已经 由MkDocs材料支持。您可以检查您的语言是否可用, 或需要通过检查以下列表进行改进或额外翻译 [支持的语言]:
-
__您的语言已受支持_ – 在这种情况下,你可以检查一下 如果缺少翻译,请单击您语言下方的链接进行添加,这需要5分钟的时间。
-
您的语言缺失 – 在这种情况下,您可以帮助我们添加支持 将您的语言转换为MkDocs的材料!继续阅读,了解如何做到这一点。
搜索我们的问题跟踪器¶
另一个用户可能已经创建了一个提供缺失信息的问题 我们仍需整合您的语言翻译 维护人员。为了避免将时间投入到重复的工作中,请搜索 [问题跟踪器]事先。
此时,当您确保MkDocs的材料尚未 支持您的语言,您可以按照以下步骤为其添加新的翻译 问题模板。
问题模板¶
我们创建了一个问题模板,使贡献翻译变得简单 尽可能。这是我们60多种语言贡献经验的结果 以及过去几年的更新,由以下部分组成:
- Title
- Translations
- Country flag optional
- Checklist
名称¶
更新现有语言时,您可以保留标题不变 是。添加对新语言的支持,请替换“”。..在预先填写的标题中 用你的语言命名。
Example | |
---|---|
Clear | Add translations for German |
Unclear | Add translations ... |
Useless | Help |
翻译¶
如果翻译包含右侧的:arrow_light:图标,则该图标缺失。 您可以翻译此行并删除:arrow_light:图标。如果你不知道 如何翻译特定的行,只需将其留给其他贡献者即可 完成。为确保翻译的准确性,请考虑仔细检查 通过查看我们的[英文翻译]来了解单词的上下文。
国旗 optional¶
为了更好地了解情况,我们的[支持的语言]列表包括国旗 在语言名称旁边。您可以通过以下方式帮助我们为您的语言选择旗帜 将国旗的短代码添加到此字段中。前往我们的 [表情符号搜索]并输入“flag”以查找所有可用的快捷方式。
如果我的国旗不可用怎么办?
Twemoji为260个国家/地区提供国旗表情符号, 不支持州、省或地区等。如果你正在添加 细分的翻译,请选择最合适的翻译 旗帜。
为什么这可能有帮助: 在国家名称旁边添加国旗 可以帮助您和其他人在列表中找到该语言 支持的语言更快更容易。如果贵国国旗不受支持 通过Twemoji,您可以帮助我们选择替代方案。
清单¶
感谢您遵循指南并帮助我们为材料添加新的翻译 对于MkDocs,您几乎完成了。检查表确保您已阅读此内容 指导并尽最大努力为我们提供所需的一切 整合你的贡献。
我们从这里开始。
归因¶
如果您使用上述模板提交翻译,您将被记为 commit中有一个co-author,所以你不需要打开pull请求。你有 为该项目做出了重大贡献,为MkDocs制作了材料 世界各地更多的人可以访问。非常感谢。