菜单

翻译与国际化

相关源文件

本文档描述了 generative-ai-for-beginners 存储库中的翻译系统和国际化支持。该存储库在设计时考虑了全球受众,并提供了多种语言翻译的内容,以便全球用户都能获取生成式AI知识。

有关存储库结构的相关主题,请参阅存储库结构

翻译系统概述

generative-ai-for-beginners 存储库通过结构化的翻译系统支持多种语言。课程材料最初以英文开发,现已翻译成多种语言,以触及全球对学习生成式 AI 感兴趣的受众。

来源:translations/es-mx/README.md 04-prompt-engineering-fundamentals/translations/ja-jp/README.md translations/ko/README.md

支持的语言

该存储库目前支持以下语言:

语言代码语言名称
en英语 (原文)
es-mx西班牙语(墨西哥)
ja-jp日语
cn中文(简体)
pt-br葡萄牙语(巴西)
ko韩语
pl波兰语
tw中文(繁体)

来源:translations/es-mx/README.md translations/ko/README.md 04-prompt-engineering-fundamentals/translations/ja-jp/README.md 11-integrating-with-function-calling/translations/ja-jp/README.md

翻译目录结构

该存储库遵循一致的结构来组织翻译:

每个课程文件夹包含:

  • 原始英文内容 (README.md)
  • 一个 translations 文件夹,其中包含每种语言的子文件夹
  • 每个语言子文件夹包含已翻译的 README.md

来源:04-prompt-engineering-fundamentals/translations/ja-jp/README.md translations/es-mx/README.md 07-building-chat-applications/translations/ja-jp/README.md

翻译内容中的链接通过结构化的相对路径系统保持语言上下文:

内部链接遵循以下模式:

  • 指向其他课程的链接:../../../[lesson-number]/translations/[language-code]/README.md
  • 指向图片的链接(所有语言共享):../../images/[image-name]

来源:translations/es-mx/README.md34 04-prompt-engineering-fundamentals/translations/ja-jp/README.md417-418

翻译内容指南

翻译系统支持以下内容类型:

  1. 文本内容:所有描述性文本、标题和解释都已翻译
  2. 代码注释:代码示例中的注释已翻译
  3. UI 元素:UI 元素和用户交互的描述
  4. 图片:图片引用保持不变,但 alt 文本已翻译
  5. 链接:保持正确的相对路径以保留语言上下文

代码片段本身通常保留英文,以保持技术准确性。

来源:04-prompt-engineering-fundamentals/translations/ja-jp/README.md 05-advanced-prompts/translations/ja-jp/README.md 11-integrating-with-function-calling/translations/ja-jp/README.md

追踪参数

翻译中的链接保留用于分析的追踪参数。

?WT.mc_id=academic-105485-yoterada
?WT.mc_id=academic-105485-koreyst

这些追踪 ID 在所有翻译中都得以保留,以确保跨语言分析的一致性。

来源:translations/es-mx/README.md 04-prompt-engineering-fundamentals/translations/ja-jp/README.md

翻译工作流程

创建和维护翻译的过程涉及以下几个步骤:

来源:translations/es-mx/README.md 04-prompt-engineering-fundamentals/translations/ja-jp/README.md

国际化考量

除了翻译,该存储库还解决了更广泛的国际化问题:

  1. 技术术语:技术术语的翻译保持一致(有时保留英文)
  2. 文化背景:确保示例符合文化习惯且具有相关性
  3. URL 结构:保持正确的路径以便跨语言导航
  4. 共享资源:图片和代码示例在所有翻译中共享
  5. 训练数据示例:不同语言的示例,以展示模型功能

来源:02-exploring-and-comparing-different-llms/translations/ja-jp/README.md 03-using-generative-ai-responsibly/translations/ja-jp/README.md

主要课程翻译

每个主要课程都有翻译文件。下表显示了带有翻译文件夹的主要课程结构:

课程编号主题翻译文件夹结构
00课程设置/00-course-setup/translations/[language-code]/
01生成式AI简介/01-introduction-to-genai/translations/[language-code]/
02探索大型语言模型/02-exploring-and-comparing-different-llms/translations/[language-code]/
03负责任的AI/03-using-generative-ai-responsibly/translations/[language-code]/
04Prompt 工程基础/04-prompt-engineering-fundamentals/translations/[language-code]/
05高级提示词/05-advanced-prompts/translations/[language-code]/
06文本生成应用/06-text-generation-apps/translations/[language-code]/
07聊天应用/07-building-chat-applications/translations/[language-code]/
08搜索应用/08-building-search-applications/translations/[language-code]/
09图像应用/09-building-image-applications/translations/[language-code]/
10低代码AI应用/10-building-low-code-ai-applications/translations/[language-code]/
11函数调用集成/11-integrating-with-function-calling/translations/[language-code]/
12AI应用的UX设计/12-designing-ux-for-ai-applications/translations/[language-code]/

来源:translations/es-mx/README.md66-80

语言特定调整

除了直接翻译,部分内容还会进行调整,使其更贴合特定语言受众:

示例包括

  • 译者添加的解释性说明
  • 针对特定区域示例的额外背景信息
  • 技术术语的统一翻译
  • 代码示例保留英文,同时翻译注释

来源:04-prompt-engineering-fundamentals/translations/ja-jp/README.md154-165 05-advanced-prompts/translations/ja-jp/README.md199-209

根目录翻译文件

该存储库还在根级别维护主 README.md 的翻译版本。

/translations/
├── es-mx/
│   └── README.md (Spanish translation of main README)
├── ja-jp/
│   └── README.md (Japanese translation of main README)
└── ...

这些文件为非英语使用者提供了入口点,并包含以下内容的翻译版本:

  • 课程概述
  • 设置说明
  • 课程结构
  • 指向各节课程的链接

来源:translations/es-mx/README.md translations/ko/README.md

技术实现细节

翻译系统依赖于相对路径和 GitHub 的 Markdown 渲染来创建无缝体验:

  1. 翻译文件使用与原始文件相同的文件名 (README.md)
  2. 链接通过导航到相应的语言目录来保持语言上下文
  3. 共享资源(图片、代码)通过翻译文件中的相对路径引用
  4. 分析追踪参数在所有翻译中都得以保留

来源:translations/es-mx/README.md 04-prompt-engineering-fundamentals/translations/ja-jp/README.md

贡献翻译

存储库欢迎翻译贡献:

  1. Fork 存储库
  2. 按照已建立的目录结构创建或更新翻译
  3. 确保正确的链接和资源引用
  4. 提交包含翻译的拉取请求

来源:translations/es-mx/README.md49-53