AI-For-Beginners 课程翻译贡献指南：从命名规范到测验本地化的完整实践

教程人工智能机器学习深度学习【免费下载链接】AI-For-Beginners12 Weeks, 24 Lessons, AI for All!项目地址https://gitcode.com/GitHub_Trending/ai/AI-For-Beginners点击查看免费下载本指南以 AI-For-Beginners 课程仓库中的 翻译贡献说明孟加拉语版 及其 英文原版 为主体结合仓库内真实的翻译目录结构、quiz-app 测验应用源码与多语言资源组织方式系统讲解如何为这套12 周、24 课、人人可学 AI的课程贡献高质量的本地化翻译包括文件命名规范、翻译边界、测验四步接入流程以及底层运行原理。AI-For-Beginners 是一套开源 AI 入门课程体系仓库根目录 README.md覆盖从符号推理、神经网络、计算机视觉到 NLP 与强化学习的 24 节课每节课均配套 README 讲义、课后作业assignment与课前/课后测验quiz。为了让非英语学习者无障碍学习仓库鼓励社区贡献多语言翻译。本文将以仓库实际代码与目录为证据完整还原翻译贡献的每一个环节帮助读者快速提交一份合规、可被合并的本地化翻译。一、翻译范围与边界哪些内容该译、哪些不该译原文档首先明确了翻译的范围需要翻译每个课程文件夹lesson folder与课程导论文件夹中的 Markdown 文件即README、assignment作业与测验quizzes。严禁翻译代码示例文件中的任何代码。原文档特别强调请勿翻译代码示例文件中的任何代码唯一需要翻译的是 README、作业与测验。这一边界在仓库中能得到印证翻译目录translations/bn/下共有 67 个.md文件与 54 个.ipynb文件.ipynb内的代码单元仍保留原语言仅 Markdown 说明部分被本地化。此外仓库专门维护了translated_images/目录按语言分文件夹存放翻译后的插图如translated_images/bn/下 120 张图片保证配图文字与译文语言一致。一个容易踩坑的细节来自测验翻译不要本地化true/false这两个单词。原文档与 quiz-app 的 quiz-app README 均明确要求保留原样原因在于测验数据结构中以isCorrect: true/false布尔值承载正确性判定见下文源码分析选项文本中的 True/False 属于课程设计的标准答案表述统一保留可避免歧义与判定错误。二、文件命名规范遵循 ISO 639-1 两字母语言代码翻译文件的命名是仓库合并检查的硬性约定原文档规定如下格式README.[language].md其中[language]为遵循ISO 639-1 标准的两字母语言缩写。例如西班牙语README.es.md荷兰语README.nl.mdassignment.[language].md作业文件遵循同样的命名规则例如assignment.es.md。这一约定在仓库的翻译目录中得到了大规模落地translations/下共有 50 语言文件夹如ar、bn、de、es、fr、ja、ko、zh-CN、zh-HK、zh-TW等其中每个语言目录内均按课程路径镜像组织如translations/bn/lessons/1-Intro/README.md。注意中文等特殊区域语言采用zh-CN、zh-TW这类含连字符的写法遵循 BCP 47 风格的区域变体惯例。三、测验Quiz翻译的四步接入流程测验是整个课程交互学习的核心组件其翻译需要同时改动翻译文件与 Vue 应用。原文档给出四个步骤下面结合仓库源码逐一展开第 1 步在翻译资源目录新增语言 JSON 文件向 quiz-app 的翻译资源目录添加译文文件etc/quiz-app/src/assets/translations命名遵循[语言代码].json如en.json、fr.json——在当前仓库的实际实现中资源按语言分子目录组织每个语言目录内再按课程拆分为lesson-1.json至lesson-24.json外加一个index.js汇总文件。以英文基准文件 en/lesson-1.json 为例其 JSON 结构为[ { title: AI for Beginners: Quizzes, complete: Congratulations, you completed the quiz!, error: Sorry, try again, quizzes: [ { id: 101, title: Introduction to AI: Pre Quiz, quiz: [ { questionText: A famous 19th century proto-computer engineer was, answerOptions: [ { answerText: Charles Barkley, isCorrect: false }, { answerText: Charles Babbage, isCorrect: true }, { answerText: Charles Darwin, isCorrect: false } ] } ] } ] } ]翻译时需要保留结构完全一致仅替换title、complete、error、questionText、answerText等文案字段保持isCorrect的布尔值不动。id如 101 表示第 1 课课前测验201 表示第 1 课课后测验也必须与课程编号一一对齐——quiz-app 的 README 说明整套课程共 40 道测验、编号自 0 起计数且确保编号与正确的测验章节对齐。补充说明在etc/quiz-app/src/assets/translations/中还有一个外层 index.js它汇总各语言模块而每个语言目录内的index.js如 en/index.js负责把 24 个 lesson JSON 按索引 0–23 组装为quiz对象导出。当前仓库已完成英语完整 24 课与西班牙语已完成 lesson-1见 es/lesson-1.json 与 es/index.js 中//add items here的待扩充占位新增语言时可参考这两个已落地示例。第 2 步在 App.vue 的语言下拉框中注册新语言编辑 etc/quiz-app/src/App.vue在导航栏的select v-modellocale中添加新的optionselect v-modellocale optionen/option optiones/option option你的语言代码/option /select语言代码需与第 1 步的翻译文件夹名保持一致。从该组件的watch逻辑可见本地化切换原理当locale变化时this.$root.$i18n.locale val会同步更新全局 i18n 语言环境在created()生命周期中则优先读取 URL 查询参数?locxxx缺省回落到en。第 3 步在 translations/index.js 汇总中导入新语言编辑 etc/quiz-app/src/assets/translations/index.js引入新语言的模块并注册到messages对象import englishQuizzes from ./en; import spanishQuizzes from ./es; // 新增import yourQuizzes from ./你的语言目录; const messages { en: englishQuizzes, es: spanishQuizzes, // 新增你的语言代码: yourQuizzes, }; export default messages;App.vue通过import messages from /assets/translations引用该汇总对象其computed属性questions()直接返回messages供Quiz.vue组件按语言渲染题目。第 4 步改写译文 README 中的测验链接追加 loc 参数最后把所有翻译版 README.md 文件中的测验链接改为直接指向带本地化参数的 URL使测验应用在打开链接时即自动定位到对应语言。原文档给出的转换示例为原链接https://red-field-0a6ddfd03.1.azurestaticapps.net/quiz/1转换后https://red-field-0a6ddfd03.1.azurestaticapps.net/quiz/1?locid即在原链接末尾追加?loc加两字母语言代码。这一机制与第 2 步中App.vue读取this.$route.query.loc的逻辑一一对应用户点击链接进入测验页面时URL 查询参数直接决定了显示语言无需手动切换下拉框。仓库内已翻译的课程笔记如translations/bn/lessons/下的各 README普遍采用了带loc参数的链接写法。四、源码级原理quiz-app 如何按语言加载测验为了确保翻译接入的正确性理解测验应用的加载链路很有必要。以仓库源码为准完整链路如下资源组织每份语言目录en、es…内的lesson-N.json存题目目录级index.js汇总为{ 0: 第1课, 1: 第2课, …, 23: 第24课 }的quiz对象见 en/index.js 的 24 项映射全局汇总顶层 translations/index.js 把各语言模块组合为messages应用入口App.vue 的created()依据?loc设置初始localewatch监听下拉框变化并写入全局 i18n题目渲染router-view内嵌 Quiz.vue按当前语言从messages取对应题组渲染。因此若漏掉第 2 步下拉框或第 3 步index.js新语言将无法被应用识别若漏掉第 4 步链接参数用户从课程讲义进入测验时仍会看到默认英语。四步缺一不可。本地验证方式quiz-app 是基于 Vue CLI 的前端应用可在etc/quiz-app/目录下依次执行npm install安装依赖、npm run serve启动开发服务器进行本地预览生产构建用npm run build代码检查用npm run lint详见 quiz-app README。五、提交前自检清单综合原文档与仓库约定提交翻译前建议逐项核对文件名严格遵循README.[lang].md与assignment.[lang].md[lang]为 ISO 639-1 两字母代码代码示例、.ipynb代码单元未被翻译测验 JSON 结构与英文基准文件完全一致id对齐对应课程isCorrect布尔值未改动true/false选项文案保留原文测验四步全部完成新增语言 JSON → 注册到App.vue下拉框 → 导入顶层translations/index.js→ 译文 README 的所有测验链接追加?loc[lang]课程内嵌图片若有已参照translated_images/目录的既有组织方式准备对应语言版本译文 Markdown 中指向仓库内部文件的相对链接已按仓库实际结构修正避免 404。六、翻译质量与致谢机制原文档在文末表达了对贡献者的诚挚感谢我们真心感谢您的付出同时翻译版文档如孟加拉语版附有明确的免责声明该版本经由 AI 翻译服务 Co-op Translator 自动生成可能存在误差或不一致应以原始语言文档为权威来源对于重要信息建议使用专业人工翻译使用自动翻译版本造成的误解由使用者自负。这一机制同样适用于贡献者仓库鼓励社区提交人工精校的翻译以逐步取代机器初译。贡献者可参考仓库根目录的 CONTRIBUTING.md 了解完整的提交流程并在 etc/TRANSLATIONS.md英文权威版与 etc/quiz-app/README.md 中获取一手约定。若需在本地克隆仓库进行翻译工作可执行git clone https://gitcode.com/GitHub_Trending/ai/AI-For-Beginners。结语为 AI-For-Beginners 贡献翻译是一项小而完整的工程它既包含纯文本的本地化README、作业、测验文案也涉及 Vue 前端应用的注册下拉框与模块汇总与链接参数改写?loc。本文以原翻译指南为骨架结合仓库中translations/、translated_images/与etc/quiz-app/的实际源码与目录证据完整还原了从命名规范到四步接入的全流程。遵循本文清单即可产出一份结构合规、可被测验应用正确加载的高质量本地化翻译让更多语言背景的学习者平等地走近 AI。赞分享教程人工智能机器学习深度学习【免费下载链接】AI-For-Beginners12 Weeks, 24 Lessons, AI for All!项目地址https://gitcode.com/GitHub_Trending/ai/AI-For-Beginners点击查看免费下载相关推荐AI-For-Beginners 课程翻译贡献指南面向多语言社区的本地化协作规范AI For Beginners 课程翻译贡献指南面向多语言社区的本地化协作规范 本指南面向有意为 AI For Beginners https://link教程人工智能机器学习深度学习AI-For-Beginners 多语言翻译协作指南课程文档与测验本地化的完整实践AI For Beginners 多语言翻译协作指南课程文档与测验本地化的完整实践 本指南围绕微软 AI For Beginners 开源课程12 周、24教程人工智能机器学习深度学习AI-For-Beginners 课程翻译贡献指南本地化文件约定与 Quiz 测验的 i18n 接入全流程AI For Beginners 课程翻译贡献指南本地化文件约定与 Quiz 测验的 i18n 接入全流程 本文以 AI For Beginners 仓库的翻教程人工智能机器学习深度学习上一篇The Concise TypeScript Book 深度解析映射类型修饰符Mapped Type Modifiers下一篇go-gin-example 中的 Go-MySQL-Driver 完全指南DSN 参数、连接池与 time.Time 实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考