菜单

翻译贡献

相关源文件

目的与范围

本文档提供了向阿波罗11号(Apollo-11)仓库文档贡献新翻译的详细指南。它涵盖了将项目文档翻译成其他语言的翻译结构、提交流程和质量标准。有关仓库中已有的可用翻译信息,请参阅可用翻译

翻译结构概述

阿波罗11号(Apollo-11)仓库对主要文档文件提供了国际化支持。主要文档文件有多种语言版本,每个翻译版本都存储在 Translations/ 目录下,并带有语言特定的后缀。

来源:CONTRIBUTING.md3-33 Translations/CONTRIBUTING.gr.md3-33

支持的语言

仓库目前支持以下语言的翻译。每种语言都由文件命名中使用的特定语言代码表示。

语言代码文件名示例
阿拉伯语ARCONTRIBUTING.ar.md
阿塞拜疆语AZCONTRIBUTING.az.md
加泰罗尼亚语CACONTRIBUTING.ca.md
捷克语CZCONTRIBUTING.cz.md
丹麦语DACONTRIBUTING.da.md
德语DECONTRIBUTING.de.md
英语ENCONTRIBUTING.md (根目录)
西班牙语ESCONTRIBUTING.es.md
法语FRCONTRIBUTING.fr.md
加利西亚语GLCONTRIBUTING.gl.md
希腊语GRCONTRIBUTING.gr.md
印地语HI_INCONTRIBUTING.hi_in.md
印度尼西亚语IDCONTRIBUTING.id.md
意大利语ITCONTRIBUTING.it.md
日语JACONTRIBUTING.ja.md
韩语KO_KRCONTRIBUTING.ko_kr.md
库尔德语KUCONTRIBUTING.ku.md
立陶宛语LTCONTRIBUTING.lt.md
蒙古语MNCONTRIBUTING.mn.md
荷兰语NLCONTRIBUTING.nl.md
挪威语NOCONTRIBUTING.no.md
波兰语PLCONTRIBUTING.pl.md
葡萄牙语(巴西)PT_BRCONTRIBUTING.pt_br.md
瑞典语SVCONTRIBUTING.sv.md
土耳其语TRCONTRIBUTING.tr.md
乌克兰语UKCONTRIBUTING.uk.md
越南语VICONTRIBUTING.vi.md
中文(简体)ZH_CNCONTRIBUTING.zh_cn.md
中文(繁体)ZH_TWCONTRIBUTING.zh_tw.md

来源:CONTRIBUTING.md3-63

翻译贡献工作流程

下图说明了向阿波罗11号(Apollo-11)仓库贡献新翻译的过程。

来源:CONTRIBUTING.md1-177

需翻译的文件

贡献新翻译时,请重点关注以下关键文件

来源:CONTRIBUTING.md1-177

语言代码约定

贡献翻译时,语言代码应遵循仓库的既定约定

  1. 语言代码使用大写(例如,法语使用 FR
  2. 对于有区域变体的语言,使用下划线(例如,巴西葡萄牙语使用 PT_BR
  3. 文件命名模式:FILENAME.{lang_code}.md

交叉引用部分结构

翻译必须保留交叉引用部分,该部分链接到所有其他语言版本。此部分必须出现在每个翻译文件的顶部。

来源:CONTRIBUTING.md3-63 Translations/CONTRIBUTING.gr.md3-63

添加新语言

贡献新翻译时,请遵循以下步骤

  1. 将你的语言添加到每个翻译文档顶部的语言列表中

    🌐
    [Existing languages...]
    [Your language in native script][YOUR_LANG_CODE],
    
  2. 在语言列表底部添加引用链接定义

    [YOUR_LANG_CODE]:CONTRIBUTING.your_lang_code.md
    
  3. 更新所有其他语言文件,在其交叉引用部分中包含新语言。

来源:CONTRIBUTING.md3-63 Translations/CONTRIBUTING.es.md3-63

翻译指南

翻译仓库文档时,请遵循以下指南

  1. 准确性:忠实地翻译原文内容,同时保留技术含义

  2. 技术术语:保留重要的技术术语的原始形式

  3. 格式:保留所有 Markdown 格式,包括

    • 列表
    • 代码块
    • 链接
    • 强调格式
  4. 文件结构:保持与原文相同的整体文档结构

翻译贡献文件结构

下图显示了原始英文文件及其翻译之间的文件结构关系

来源:CONTRIBUTING.md35-63 Translations/CONTRIBUTING.fr.md35-63

提交翻译贡献

  1. 确保你已翻译所有必要的文件
  2. 将它们放置在正确的位置,并遵循适当的命名约定
  3. 更新所有语言的交叉引用部分
  4. 提交一个拉取请求,并清晰描述所添加的语言
  5. 准备好处理仓库维护者的反馈

翻译维护职责

贡献翻译时,请注意,随着英文文档的演进,你可能会被要求协助维护翻译。这确保所有翻译与最新的项目信息保持同步。

来源:CONTRIBUTING.md1-177

结论

向阿波罗11号(Apollo-11)仓库贡献翻译有助于使这份具有历史意义的代码库能够被更广泛的全球受众访问。通过遵循这些指南和程序,你可以帮助扩大项目的影响力,并为你所使用的语言的读者提升教育价值。