必备工作
全程需要xxx,上不了github自行解决
注册Github并登录
安装git
https://git-for-windows.github.io/
直接下载安装,安装好之后在任意文件夹右键出现git的两个组件即为安装完成
在任意文件夹下打开git bash
右键->options..->Keys->取消勾选Copy and Paste->勾选最底下那项->apply->save
之后可以使用Ctrl+Shift+C/V
完成复制粘贴
项目repo的收藏star、转载fork和下载pull
收藏star
看到有用的项目可以点击star,以后可以在自己的star里查看:右上角头像->your star
转载fork
可以把别人的项目一键转到自己的仓库,只要点击fork(上图),即可为自己创建一个相同的项目,别人的项目可能有多个分支,可以选取消勾选下面这个选项来复制所有分支。转载后的私密性和原项目保持一致,只有原作者有权限改变。
下载pull
选择自己需要的分支branch
方式1
点击Code->Download ZIP可以下载项目的压缩包,但是这只适用于repo中没有链接其他repo的情况(一般readme会说)。但是话说回来,浏览器比下面git下载快。非main的分支下载也比方式2方便。
方式2
介于方式1的缺陷,这里推荐git clone进行下载:
点击一键复制上图网址中的内容,基本就是项目地址+.git
https://github.com/EwhaGlab/C2A.git
在想要放项目的根目录(不需要新建文件夹,下载后的项目会自动在repo名的文件夹中)右键 git bash here
输入git clone <项目>,如
git clone https://github.com/EwhaGlab/C2A.git
如果有子仓库需要下载,可以输入
cd <项目文件夹>
git submodule update --init --recursive
即可下载全部子仓库
代码上传及修改
点击自己的主页,再点击Repo->New,新建项目
选择为自己创建或组织创建,输入Repository name后选择和Private和Add a README file
建议先为自己创建,因为自己有所有权,可以变更项目的设置细节,特别注意Description写的明白一点,可以用中文
上传
方式一
如果文件不多的话,直接点击旁边的add->Upload然后拖动文件进行添加,这样是最快的。
方式二
如果文件较多的情况,参考以下步骤
把新建的空仓库git clone到本地
把想要上传的项目文件全部复制进下载的文件夹中
复制好之后继续在git bash中输入
cd <项目文件夹>
请确保文件夹中没有100m以上的文件,这会导致上传失败,使用以下命令查看是否有100m以上的文件
find . -type f -size +100M
确保没有输出内容
git add .
第一次操作会自动弹出网页登录
add之后git就会把文件夹中所有的文件视为仓库的一部分,之后就可以上传
(warning可以不用理会)
编写上传说明,first commit可以改为任意说明
git commit -m "first commit"
上传代码,时间根据项目大小决定,这个main是分支名
git push -u origin main
100m以上的单个文件会导致整体上传失败,如果误上传大文件导致失败,最快的补救措施是删掉git文件夹重新git clone 因为git里面已经记录相关文件,就算已经删掉大文件,git还是会请求上传,最后被github拒绝从而导致失败。
修改仓库中的代码
添加修改的文件
git add .
提交修改
git commit -m "fix xxx"
这次会显示多少文件被修改了
推送
git push -u origin main
修改成功
commit信息也会变
完善Readme
直接在repo界面点击右上角的修改
添加项目说明 环境配置 运行文件 结果图片 参考代码 作者
可以直接粘贴图片,写好之后直接点commit changes
加入组织和转移Repo
加入组织
把自己的Username发给owner,由owner发送邀请,再在邮箱中答应邀请
组织名:Advance Digital Manufacture in USST
转移Repo
转到自己的项目,点击Settings 翻到最下面有Danger Zone 点击Transfer,选中自己的组织,按照步骤完成转移