教程人工智能机器学习深度学习【免费下载链接】AI-For-Beginners12 Weeks, 24 Lessons, AI for All!项目地址https://gitcode.com/GitHub_Trending/ai/AI-For-Beginners点击查看免费下载导读本文以 AI-For-Beginners 课程仓库中的翻译协作指南为骨架系统讲解如何为这套12 周、24 课的 AI 课程贡献一门新语言。文章覆盖翻译文件命名规范、README 与作业assignment的翻译要点、测验应用quiz-app的本地化数据接入流程以及测验应用在 Azure Static Web Apps 上的部署方式并给出仓库源码级的实现佐证。读完本文你将能按照仓库既定规范从零为课程添加一个完整语种的语言包并让翻译后的测验链接正确路由到对应语言版本。一、翻译贡献的总体流程AI-For-Beginners 是一套面向初学者的多语言 AI 课程其目录结构为每个章节保留了独立的课程文件夹见 lessons 目录仓库还维护着覆盖数十种语言的翻译目录。课程欢迎社区贡献者将英文原文翻译为其他语言贡献者需要同时完成三类交付物翻译各课程的 Markdown 文档README 与作业 assignment为测验应用quiz-app添加对应语言的测验 JSON 数据在翻译后的 README 中更新测验链接使其携带?loc语言参数指向本地化测验。一个关键约束是不要翻译代码示例文件中的任何代码。在 lessons 各课程目录下除了 README 与 assignment 外还有大量.py、.ipynb等代码与 Notebook 文件它们保持英文原样即可需要翻译的只有 README、作业与测验文本。二、翻译文件的命名规范翻译后的文件必须严格遵循以下命名约定否则无法被课程导航与社区维护工具识别README 翻译文件格式为README._[language]_.md其中[language]是遵循 ISO 639-1 标准的两字母语言代码例如README.es.md表示西班牙语、README.nl.md表示荷兰语。作业assignment翻译文件格式与 README 相同即assignment._[language]_.md。课程要求作业也要一并翻译保证学习路径的完整性。从仓库实际目录可以验证这一约定在 translations 目录 下每种语言都有一个独立的子目录如es、fa、zh-CN其中维护着 66 个左右.md文件与 54 个左右.ipynb文件与课程结构的英文版一一对应。三、测验应用quiz-app的本地化接入课程配套的测验应用位于 etc/quiz-app是一个基于 Vue 的静态 Web 应用承载每节课的课前Pre-Quiz与课后Post-Quiz测验。要加入一门新语言的测验需要按以下四个步骤操作。步骤 1添加语言翻译文件在测验应用的语言资源目录中新增一个文件。该目录路径为 etc/quiz-app/src/assets/translations文件命名需与语言对应例如en.json、fr.json、es.json。当前仓库中英文与西班牙语翻译已经就位en目录包含全部 24 课的测验数据lesson-1.json至lesson-24.jsones目录已有lesson-1.json。注意请勿本地化选项中的true/false字样。这是因为测验数据中的判断题依赖这两个值进行正确性判定。以 lesson-1.json 为例判断题的选项结构如下{ questionText: Weak AI is a system designed to solve many tasks, answerOptions: [ { answerText: True, isCorrect: false }, { answerText: False, isCorrect: true } ] }从源码可见Quiz.vue 的handleAnswerClick直接依据option.isCorrect布尔值判断答题对错并维护error/complete状态App.vue 与 Home.vue 则根据当前 locale 渲染对应语言的测验标题与题目文本。因此将true/false保持为英文原文可以避免任何显示层与逻辑层的意外不一致。测验 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 Babbage, isCorrect: true } ] } ] } ] } ]需要翻译的文本包括顶层title、complete、error以及每个测验的title、questionText与各选项的answerTextid、isCorrect等逻辑字段必须原样保留。步骤 2在语言下拉菜单中注册语言编辑 App.vue在导航栏的select v-modellocale下拉框中新增一个option值为你的两字母语言代码select v-modellocale optionen/option optiones/option !-- 新增optionfr/option -- /select下拉框的值会通过watch同步到全局this.$root.$i18n.locale见 App.vue而 Quiz.vue 的currLocale计算属性读取该全局 locale从而决定渲染哪一套题目。语言缩写必须与语言资源目录的文件夹名保持一致例如新增fr目录则下拉框添加fr。步骤 3编辑翻译索引文件测验应用使用两层索引来汇总语言资源语言内部索引在assets/translations/lang/index.js中按en目录的既有写法用import x1 from ./lesson-1.json的形式导入本语言所有 JSON 文件再组装成一个以测验序号为键的quiz对象导出。参照 en/index.js。总索引编辑 assets/translations/index.js导入新语言并将其注册到messages对象中import englishQuizzes from ./en; import spanishQuizzes from ./es; // 新增import frenchQuizzes from ./fr; const messages { en: englishQuizzes, es: spanishQuizzes, // 新增fr: frenchQuizzes, }; export default messages;messages会被 App.vue 和 Quiz.vue 通过/assets/translations引入并作为题目数据源因此漏掉这一步会导致语言切换后无数据可用。课程共 24 课、40 个测验序号从 0 开始计数新增语言时应保证测验 JSON 的覆盖与en保持一致并让编号与正确的测验段落对齐。步骤 4更新翻译后 README 中的测验链接所有已翻译 README.md 中的测验链接都要指向对应语言的测验。仓库采用带查询参数的链接形式将形如.../quiz/1的链接改为.../quiz/1?locfrfr换成你的语言代码。在应用内部这一机制由 router/index.js 中的/quiz/:id路由承载测验组件在created()中读取this.$route.query.loc见 Quiz.vue 与 App.vue若存在loc参数则使用它作为 locale否则默认回落到en。四、测验应用的本地运行与构建本地调试翻译效果时可在 etc/quiz-app 目录下执行npm install # 安装依赖 npm run serve # 开发模式编译并热重载 npm run build # 生产构建编译并压缩输出到 dist/ npm run lint # 检查并修复代码规范问题npm run serve适合翻译过程中实时预览切换语言下拉框即可看到不同语言的题目渲染。npm run build输出静态资源到dist目录供后续部署使用。如需定制构建配置可参考 Vue CLI 的配置参考vue.config.js或 CLI 服务选项。五、将测验应用部署到 Azure Static Web Apps测验应用是纯静态前端项目仓库提供了完整的 Azure Static Web Apps 部署路径。部署步骤准备仓库确保测验应用代码位于你的 GitHub 仓库中可直接 fork 当前仓库。创建 Azure Static Web App注册 Azure 账户后在 Azure 门户中点击创建资源搜索并选择Static Web App点击创建。配置应用基本信息选择订阅、资源组为应用命名选择离目标用户较近的区域部署详情源选择 GitHub授权 Azure 访问 GitHub 账户选择组织、仓库与部署分支构建详情构建预设选择 VueApp Location 填etc/quiz-app若存在 API 则填写 API Location可选Output Location 填dist。审阅并创建确认配置后点击创建Azure 会在你的仓库中生成 GitHub Actions 工作流文件.github/workflows/azure-static-web-apps-name.yml。监控部署进入仓库的 Actions 标签页观察工作流执行完成后应用即通过 Azure 提供的 URL 上线。示例 GitHub Actions 工作流仓库文档给出了一份参考工作流配置核心字段如下name: Azure Static Web Apps CI/CD on: push: branches: - main pull_request: types: [opened, synchronize, reopened, closed] branches: - main jobs: build_and_deploy_job: runs-on: ubuntu-latest name: Build and Deploy Job steps: - uses: actions/checkoutv2 - name: Build And Deploy id: builddeploy uses: Azure/static-web-apps-deployv1 with: azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }} repo_token: ${{ secrets.GITHUB_TOKEN }} action: upload app_location: etc/quiz-app api_location: output_location: dist要点说明on.push与on.pull_request触发条件覆盖main分支的推送与 PR 事件app_location指向测验应用源码目录etc/quiz-app这是本仓库与一般根目录部署的关键差异output_location为dist即npm run build的产物目录azure_static_web_apps_api_token由 Azure 自动注入到仓库 secrets 中无需手工配置。部署完成并通过?loc参数校验后一套新语言的课程翻译与测验本地化即全部就绪。六、关键注意事项与验证清单代码不翻译所有.py、.ipynb等代码示例保持原文仅翻译 README、作业与测验文本命名规范翻译文件必须采用README._[lang]_.md与assignment._[lang]_.md语言代码遵循 ISO 639-1保留逻辑字段测验 JSON 中的id、isCorrect与true/false字样不得本地化三层注册缺一不可语言目录内index.js、总 translations/index.js、App.vue 下拉框三者全部更新后才能正确切换语言链接参数化所有翻译 README 中的测验链接都要追加?loc你的语言代码未带参数的链接会默认回落到英文。按以上流程核对每一项后即可提交你的翻译贡献让更多学习者以母语访问这套 AI 入门课程。赞分享教程人工智能机器学习深度学习【免费下载链接】AI-For-Beginners12 Weeks, 24 Lessons, AI for All!项目地址https://gitcode.com/GitHub_Trending/ai/AI-For-Beginners点击查看免费下载相关推荐AI-For-Beginners 课程翻译贡献指南命名规范、Kviz 本地化与多语言协作流程AI For Beginners 课程翻译贡献指南命名规范、Kviz 本地化与多语言协作流程 本文以 AI For Beginners 开源课程仓库中的《Př教程人工智能机器学习深度学习智慧教育平台电子课本怎么下载3步用 tchMaterial-parser 快速存成完整 PDF智慧教育平台电子课本怎么下载3步用 tchMaterial parser 快速存成完整 PDF tchMaterial parser 是一款免费的图形化小工具教程人工智能机器学习深度学习AI-For-Beginners 课程翻译贡献指南面向多语言社区的本地化协作规范AI For Beginners 课程翻译贡献指南面向多语言社区的本地化协作规范 本指南面向有意为 AI For Beginners https://link教程人工智能机器学习深度学习上一篇Cursor Free VIP完全使用攻略从入门到精通下一篇AI编程助手解锁工具突破Cursor Pro限制的完整方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
