Data-Science-For-Beginners 仓库工程指南环境搭建、构建测试与多语言翻译体系基于 AGENTS.md【免费下载链接】Data-Science-For-Beginners10 Weeks, 20 Lessons, Data Science for All!项目地址: https://gitcode.com/GitHub_Trending/da/Data-Science-For-Beginners本文基于仓库中的 AGENTS.md根目录 AGENTS.md 的芬兰语官方翻译版本展开系统讲解 Microsoft「10 周、20 课」数据科学课程体系仓库的完整工程实践从 Python/Jupyter 环境搭建、Vue.js 测验应用与 Docsify 文档站的本地运行到测试、代码规范、构建部署与多语言翻译流程。读完后你可以独立在本仓库中跑起每一类组件教学笔记、测验应用、文档站、可视化项目并理解各部分在仓库中的落点与协作约定。1. 项目总览与技术栈AGENTS.md 对仓库的定位是由 Microsoft Azure Cloud Advocates 创建的 10 周、20 课数据科学课程属于「教学型 monorepo」——同一个仓库同时承载 Markdown 课程内容、Jupyter 实践笔记、Vue.js 交互测验应用、Docsify 文档站以及多语言翻译。核心技术栈来自 AGENTS.md Key Technologies 一节技术用途仓库落点Jupyter NotebooksPython 3主要学习载体各课程目录下notebook.ipynb、assignment.ipynbpandas / numpy / matplotlib及 seaborn、scikit-learn数据分析与可视化笔记代码数据文件位于 data/Vue.js 2测验应用quiz-app/Docsify离线文档站点生成根目录 index.htmlNode.js / npmJavaScript 组件的包管理根目录与 quiz-app/package.jsonMarkdown全部课程内容与文档六大课程模块目录架构特征多语言教育仓库含大量翻译translations/目录按语言代码组织当前快照可见 50 语言目录课程内容按教学模块分目录组织1-Introduction至6-Data-Science-In-Wild每课包含 README、notebook、assignment 与测验链接独立的 Vue.js 测验应用用于课前/课后评估支持 GitHub Codespaces 与 VS Code 开发容器注意当前仓库快照中未包含.devcontainer目录从源码结构看该项能力依赖上游完整仓库。2. 环境安装命令以下四组安装命令完整继承自 AGENTS.md Setup Commands 章节并按仓库实际文件补充了佐证说明。2.1 仓库获取git clone https://github.com/microsoft/Data-Science-For-Beginners.git cd Data-Science-For-Beginners2.2 Python 环境# Create a virtual environment (recommended) python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install common data science libraries (no requirements.txt exists) pip install jupyter pandas numpy matplotlib seaborn scikit-learn这里有一个关键前提需要强调仓库没有requirements.txt文档明确要求手动安装上述常用库。这与 AGENTS.md 中列出的常用库清单一致pandas数据操作、numpy数值计算、matplotlib绑图、seaborn部分课程的统计可视化、scikit-learn进阶课机器学习。笔记默认推荐 Python 3.7。2.3 测验应用quiz-appcd quiz-app npm install # 安装依赖 npm run serve # 启动开发服务器带 hot-reload npm run build # 生产构建 npm run lint # 静态检查并自动修复对照 quiz-app/package.json 可以确认这四个脚本的真实含义serve/build/lint均委托给vue-cli-service依赖为vue^2.6.11、vue-i18n^8.22.2、vue-router^3.4.9、core-js开发依赖包含vue/cli-service~4.5.0与 ESLinteslint^6.7.2、eslint-plugin-vue^6.2.2、babel-eslint。AGENTS.md 提到「ESLint 配置在 quiz-app/package.json 中」——这一点已可直接验证quiz-app/package.json 内联了eslintConfig块plugin:vue/essentialeslint:recommended。2.4 Docsify 文档服务npm install -g docsify-cli docsify serve # Documentation will be available at localhost:3000Docsify 的特点是「无构建步骤、直接渲染 Markdown」其入口由根目录 index.html 提供其中window.$docsify配置了站点名称、repo与relativePath: true并引入 docsify 主库。文档侧边栏由 docs/_sidebar.md 定义。2.5 可视化课程项目第 13 课第 13 课 meaningful-visualizations 的starter/与solution/各自是一个独立的 Vue 2 项目cd 3-Data-Visualization/13-meaningful-visualizations/starter npm install npm run serve npm run build npm run lint仓库中该目录确实包含独立的 package.json、src/与public/与quiz-app使用同一套 Vue CLI 4.x 工程结构因此命令完全同构。3. 开发工作流3.1 Jupyter 笔记工作流AGENTS.md 给出五步工作流在仓库根目录启动 Jupyterjupyter notebook进入目标课程目录打开.ipynb文件做练习笔记是自包含的解释 代码单元格多数笔记使用 pandas / numpy / matplotlib——务必先装好。3.2 标准课程目录结构每课通常包含五类文件这在仓库中可逐一验证README.md主体理论内容与示例如 1-Introduction/01-defining-data-science/README.mdnotebook.ipynb动手练习assignment.ipynb或assignment.md课后作业solution/解答笔记如 1-Introduction/04-stats-and-probability/solution 下存在解答 notebookimages/配图素材。此外仓库根目录还有跨课程共享的 data/ 目录birds.csv、taxi.csv、mushrooms.csv、diabetes.tsv 等CSV/TSV 为主、JSON 用于非关系型数据示例以及 examples/ 下的 Python 示例脚本。3.3 测验应用结构从 AGENTS.md 与源码结构交叉验证测验应用的关键事实Vue.js 2 单页应用开发时热更新测验内容按语言存放在quiz-app/src/assets/translations/下。对照源码 quiz-app/src/assets/translations/index.js 可以看到当前快照中已装配的语言为en、fr、es三组通过vue-i18n的 messages 对象导出每种语言的测验按group-1.json…group-6.json分组存放例如 quiz-app/src/assets/translations/en/group-1.json 中第一个测验id即为 0Defining Data Science - Pre Quiz印证了文档所述「测验编号从 0 开始、共 40 个0–39」页面层为 quiz-app/src/components/Quiz.vue、quiz-app/src/views/Home.vue 与NotFound.vue路由在 quiz-app/src/router/index.js 中定义。3.4 添加翻译课程翻译放在仓库根目录translations/下每种语言完整镜像英文版的目录结构translations/fi/AGENTS.md本身即是该机制的产物——根目录 AGENTS.md 的 AI 机翻版本文末附 Co-op Translator 免责声明文档称自动翻译由 GitHub Actions 工作流.github/workflows/co-op-translator.yml驱动从源码结构看当前快照的.github/下仅包含ISSUE_TEMPLATE/、PULL_REQUEST_TEMPLATE/其中含 co-op-translator.yml 翻译 PR 模板与chatmodes/未见到该 workflow 文件本身可推断工作流文件存在于上游仓库而本镜像未包含。4. 测试与质量检查4.1 测验应用测试cd quiz-app npm run lint # 静态检查 npm run build # 验证构建流程 npm run serve # 手动测试启动开发服务器并核验测验功能4.2 笔记测试文档明确指出笔记没有自动化测试框架验证方式为手动执行全部单元格并确认三件事——数据文件可访问且输出正确、可视化正常渲染、导入无报错。4.3 文档测试docsify serve # 验证 Docsify 渲染是否正常 # 手动遍历内容检查链接是否失效4.4 代码风格规范PythonJupyter 笔记遵循 PEP 8变量名应体现所分析的数据每个代码单元格前用 Markdown 单元格解释代码单元格聚焦单一概念通用导入范式import pandas as pd import numpy as np import matplotlib.pyplot as pltJavaScript / Vue.js遵循 Vue.js 2 风格指南使用单文件组件.vue保持组件化架构提交前执行npm run lint。Markdown 文档清晰的标题层级#/##/###代码块标注语言图片提供 alt 文本链接到相关课程行宽保持合理。文件组织课程内容放在编号目录如01-defining-data-science解答放在独立solution/子目录翻译镜像英文结构数据文件放data/或课程目录。5. 构建与部署5.1 测验应用部署cd quiz-app npm run build # Output is in dist/ folder # Deploy dist/ folder to static hosting文档给出 Azure Static Web Apps 部署路径创建 Static Web App 资源 → 关联 GitHub 仓库 → 构建配置中「应用位置」填quiz-app、「输出位置」填dist→ push 触发自动部署。5.2 文档站与 PDF 导出npm run convert # 由 Docsify 生成 PDF可选对照根目录 package.json 可知convert脚本实际执行node_modules/.bin/docsify-to-pdfdevDependencydocsify-to-pdf0.0.5其参数由 docsifytopdf.js 定义内容目录取自 docs/_sidebar.mdPDF 输出到pdf/readme.pdf页边距上下各 100px。由于 Docsify 直接从 Markdown 渲染文档站部署无需构建步骤静态托管整个仓库即可。5.3 GitHub Codespaces文档称仓库包含开发容器配置Codespaces 会自动完成 Python 与 Node.js 环境搭建。如前所述当前快照未见.devcontainer目录使用该能力前建议在上游仓库确认配置文件存在。6. Pull Request 规范6.1 提交前检查# For Vue.js changes in quiz-app cd quiz-app npm run lint npm run build npm run serve # 本地验证改动6.2 PR 标题格式格式为[组件] 简短描述AGENTS.md 给出的示例以英文原文为例[Lesson 7] Fix Python notebook import error[Quiz App] Add German translation[Docs] Update README with new prerequisites6.3 必检清单所有代码无错误运行笔记可完整执行Vue.js 应用可成功构建文档链接可用若改动测验应用需实际测试翻译保持结构一致。6.4 贡献约定遵循既有代码风格与模式复杂逻辑加解释性注释更新相关文档在适用时跨课程模块测试改动并阅读 CONTRIBUTING.md。7. 常见问题排查以下四个高频故障场景完整继承自 AGENTS.md 的 Troubleshooting 一节Jupyter 内核问题# Ensure correct kernel is installed python -m ipykernel install --user --namedatasciencenpm 安装失败# Clear npm cache and retry npm cache clean --force rm -rf node_modules package-lock.json npm install笔记导入错误确认所需库均已安装检查 Python 版本兼容性推荐 3.7确认虚拟环境已激活。Docsify 无法加载确认从仓库根目录启动服务确认index.html存在确认网络/端口 3000 可访问。8. 性能、安全与维护要点性能注意事项大型数据文件在笔记中加载较慢复杂图表渲染可能偏慢Vue 开发服务器借 hot-reload 支持快速迭代生产构建经过优化与压缩。安全注意事项不要提交敏感数据或凭据云课程涉及的 API 密钥一律走环境变量Azure 相关课程可能需要 Azure 账户凭据依赖保持更新以获取安全补丁。翻译贡献流程自动翻译由 GitHub Actions 管理欢迎人工校对遵循既有翻译目录结构更新测验链接时需带语言参数如?locfr改动后验证翻译版课程渲染正常。课程内容设计约定每课独立但循序渐进课前测验测前置知识、课后测验巩固学习assignment 提供动手练习sketchnotes/目录如 sketchnotes/README.md提供手绘风视觉摘要。适用前提小结本文所有命令与路径均以当前仓库快照为准。需要特别留意三点差异——仓库无requirements.txt库需手工安装、当前快照未包含.github/workflows/co-op-translator.yml与.devcontainer配置、测验应用当前已装配 en/fr/es 三种语言。AGENTS.md 同时声明其为 Co-op Translator 生成的翻译文档涉及关键操作时建议以根目录 AGENTS.md 英文原文为最终依据。【免费下载链接】Data-Science-For-Beginners10 Weeks, 20 Lessons, Data Science for All!项目地址: https://gitcode.com/GitHub_Trending/da/Data-Science-For-Beginners创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考