### 面向教育工作者 欢迎您在课堂上使用本课程内容。它可以与 GitHub Classroom 和主流 LMS 平台无缝结合使用，也可以作为独立的代码库供学生使用。 ### 配合 GitHub Classroom 使用 为了按班级管理课程和作业，请为每节课创建一个独立的代码库，以便 GitHub Classroom 可以单独关联每个作业。 - 将此代码库 Fork 到您的组织。 - 为每节课创建一个独立的代码库，将每节课的文件夹提取到各自的代码库中。 - 选项 A：为每节课创建空代码库，并将课程文件夹内容复制到各自代码库中。 - 选项 B：如果需要保留历史记录，可以使用保留 Git 历史记录的方法（例如，将文件夹拆分为新代码库）。 - 在 GitHub Classroom 中，为每节课创建一个作业，并指向相应的课程代码库。 - 推荐设置： - 代码库可见性：设置为私有，以保护学生的作业。 - 使用课程代码库默认分支中的起始代码。 - 为测验和提交添加 Issue 和 Pull Request 模板。 - 如果课程中包含自动评分和测试，可以选择配置这些功能。 - 有助于管理的约定： - 代码库命名，例如 lesson-01-intro、lesson-02-html 等。 - 标签：quiz、assignment、needs-review、late、resubmission。 - 按班级设置标签/版本（例如 v2025-term1）。 提示：避免将代码库存储在同步文件夹（例如 OneDrive/Google Drive）中，以防止在 Windows 上出现 Git 冲突。 ### 配合 Moodle、Canvas 或 Blackboard 使用 本课程内容包含可导入的包，适用于常见的 LMS 工作流程。 - Moodle：使用 Moodle 上传文件 [Moodle upload file](../../../../../../../teaching-files/webdev-moodle.mbz) 加载完整课程。 - Common Cartridge：使用 Common Cartridge 文件 [Common Cartridge file](../../../../../../../teaching-files/webdev-common-cartridge.imscc) 提供更广泛的 LMS 兼容性。 - 注意事项： - Moodle Cloud 对 Common Cartridge 的支持有限。建议优先使用上述 Moodle 文件，该文件也可以上传到 Canvas。 - 导入后，请根据学期安排检查模块、截止日期和测验设置。  > Moodle 教室中的课程内容  > Canvas 教室中的课程内容 ### 直接使用代码库（不使用 Classroom） 如果您不想使用 GitHub Classroom，可以直接从此代码库运行课程。 - 同步/在线形式（Zoom/Teams）： - 进行简短的导师引导热身活动；使用分组讨论室进行测验。 - 宣布测验的时间窗口；学生通过 GitHub Issues 提交答案。 - 对于协作作业，学生在公共课程代码库中工作并提交 Pull Request。 - 私密/异步形式： - 学生将每节课 Fork 到自己的 **私有** 代码库，并将您添加为协作者。 - 他们通过 Issues（测验）和 Pull Requests（作业）提交到您的课堂代码库或他们的私有 Fork。 ### 最佳实践 - 提供关于 Git/GitHub 基础知识、Issues 和 PR 的入门课程。 - 在 Issues 中使用清单来管理多步骤测验/作业。 - 添加 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md 以设定课堂规范。 - 添加无障碍说明（例如替代文本、字幕），并提供可打印的 PDF。 - 按学期对内容进行版本管理，并在发布后冻结课程代码库。 ### 反馈与支持 我们希望这套课程内容能够满足您和学生的需求。如果发现问题、有请求或改进建议，请在此代码库中创建一个新的 Issue，或者在教师交流区发起讨论。 --- **免责声明**： 本文档使用AI翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行翻译。尽管我们努力确保翻译的准确性，但请注意，自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威来源。对于关键信息，建议使用专业人工翻译。我们不对因使用此翻译而产生的任何误解或误读承担责任。