You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4.3 KiB
4.3 KiB
面向教育工作者
欢迎您在课堂上使用本课程内容。它可以与 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 加载完整课程。
- Common Cartridge：使用 Common Cartridge 文件 Common Cartridge file 提供更广泛的 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 进行翻译。尽管我们努力确保翻译的准确性，但请注意，自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威来源。对于关键信息，建议使用专业人工翻译。我们不对因使用此翻译而产生的任何误解或误读承担责任。