Note
每个人开一个Issue,两个基本指令为:
- 睡觉:
/sleep - 起床:
/wake
适合:补充资料、上传 PDF/Word/图片等。
原则:一个 PR 对应一条分支。只要该 PR 仍处于 Open 状态,后续所有新增/上传都请 Commit 到该 PR 对应的分支,这样会自动追加到同一个 PR。
点击右上角 Fork,将仓库 Fork 到你自己的账号下。
进入你自己的 fork 仓库(例如 yourname/CSU-Courses):
- 点击分支下拉(通常显示
main) - 输入一个新分支名(例如:
add-xxx-course-materials或patch-1) - 点击 Create branch:
<branch>frommain
说明:如果你不小心在后续步骤里点了 “Create a new branch …”,也无妨, 把它当作你这次贡献的分支即可。关键是:后续都提交到这一个分支。
- 如果仓库里 已经有对应课程目录:直接进入目录,跳到第 4 步。
- 如果 没有对应课程目录:建议新建目录并添加
README.md(资料简介/注意事项/课程体会等)。
网页端创建目录的方法:
- 确认你当前在第 2 步创建的分支(不是
main) - 点击 Add file → Create new file
- 文件名输入:
课程名/README.md
(输入课程名/会自动形成目录;以README.md结尾) - 填写 README 内容
- 提交选项选择:Commit directly to the
<你的分支名>branch(重要) - 点击 Commit changes
- 进入目标课程目录
- 点击 Add file → Upload files
- 选择文件或拖拽上传
- 提交选项选择:Commit directly to the
<你的分支名>branch(重要) - 点击 Commit changes
可以重复上传多次;只要 PR 仍是 Open,就一直提交到该 PR 对应分支即可。
- 回到你 fork 仓库首页,通过以下任一入口发起 PR:
- 页面提示横幅里的 Compare & pull request
- Contribute → Open pull request
- Pull requests → New pull request
- 确认参数正确:
- base repository(目标仓库):
Jinyong-Li/CSU-Courses - base branch:
main - head repository:你的 fork(例如
yourname/CSU-Courses) - compare:你本次贡献的分支(例如
add-xxx-course-materials)
- base repository(目标仓库):
- 填写标题与说明,点击 Create pull request
Important
如果 base repository 不是 Jinyong-Li/CSU-Courses:
点击页面上方小蓝字 compare across forks,手动选择:
- base repository =
Jinyong-Li/CSU-Courses - base branch =
main
前提:该 PR 仍处于 Open 状态。
- 回到你自己的 fork 仓库
- 切换到该 PR 对应的分支(例如
add-xxx-course-materials/patch-1) - 继续 Add file → Create new file / Upload files
- 提交时始终选择:Commit directly to该分支
- 回到 PR 页面刷新即可,新提交会自动出现在同一个 PR 里
如果该 PR 已经 Merged/Closed:请从 fork 的 main 创建新分支,再按本文流程开一个新的 PR。
当 PR 被 Merged 后,你可以删除用于本次贡献的分支,保持仓库整洁:
- 在 PR 页面通常会出现 Delete branch 按钮,点击即可删除该分支
- 或在你自己的 fork 仓库的 Branches 页面手动删除
如果后续还要继续贡献,建议从 fork 的
main再新建一个分支,而不是复用旧分支。
- 单个文件建议不超过 25MB(超过可能无法通过网页上传/或会被限制)
- 一次可上传的文件数量也有限(文件太多建议分批提交)
- 更大的文件建议使用 Git LFS 或提供 网盘/Release 链接,并在
README.md中说明
下列内容为不适合上传的内容。如果你认为缺少这些资料将会影响资源的完整性,建议你撰写一个 README 文档并放置一些链接或指引文字来帮助找到这些资源。
- 盗版电子书/付费电子书
- 盗版/破解版/绿色版付费软件及其安装包
- 教师不允许上传的内容
如果你认为本仓库的一些文件侵犯了您的权益,请联系我们 iljy@vip.qq.com 。我们将会从仓库中删除这些文件。
感谢以下项目贡献者:
本项目参考了浙江大学课程攻略共享计划 ,北京航空航天大学(北航)课程作业资料共享平台 ,在此表示感谢!
由贡献者编写部分的许可如下:
资料仅供参考,请自己判断其适用性。
其他部分的版权归属于其各自的作者。