近期实验室将一些之前的数据及拿出来重新整理用一下,所以想在github上发个仓库来供大家共享,所以开始接触Github的新建仓库,默默的写一篇博客来记录一下如何在Github上建立仓库并且附上使用说明。
【2019.05.08补充】 因为博主之前的浏览器有些bug,导致博主用的Git来传输和新建Github的文件和代码,所以本篇博客的开始是用Git来使用的;如果大家的浏览器十分给力的话,可以直接将内容拖到最后(文章中再次高亮的地方),直接看在GIthub上创建仓库和上传文件就ok了。此外默默的提醒一点,因为用Git传输比较麻烦,所以不建议用Git,如果你和博主存在如下情况,更换浏览器或者升级浏览器就可以解决;
(1)问题描述1:Github首页的Activity一直在Loading;
(2)问题描述2:Github建好仓库后在新建文件的时候一直不能commit;
第一步,Github远程仓库的建立
首先,要在Github上注册和登录,这一步就不详细说了。我们顺便来了解一下Github的基本概念:
-
Repository
Github里面的“仓库”,也就是项目的意思,如果要在Github上开源一个项目,需要新建一个Repository,如果有多个项目需要建多个仓库 -
Fork
我们可以理解为就是“分支”的意思,Git的原始想法就是支持多人完成一个项目(所以可以解决多人修改互传的问题,这也是为什么Github中设立了Fork和Issure),所以你想在别人的项目基础上做些改进,就可以Fork一下他的项目,这个时候你的仓库里面就有一个项目(实际上就是别人项目的分支),可以随便更改对之前的项目不会有影响。 -
Issure
我们可以理解为“问题”的意思,你发现了别人项目中的bug或者数据/代码等又不够完善的地方,可以开个Issure问他,然后Issure解决了就可以关掉了。
然后,我们要在Github上创建一个Repository,点击右上角的加号,点击New Repository,就到了Repository选项卡。
下面是创建仓库的信息,只有名字(Repository name)是必填项,我们创建一个叫HCL2000-1000的仓库。需要注意的是:Public是公用的开源的,如果选择Private需要另付费;
如果出现下述的页面就说明我们已经创建成功一个远程的免费仓库了,并且可以得到我们自己这个仓库的地址。并且还介绍了Github仓库的常用命令,这个需要用Git来实现。
第二步,下载安装Git客户端
如果我们要用Git功能,需要下载安装一个Git客户端(Git是目前世界上最先进的分布式版本控制系统,我的操作系统是windows,所以下载的是Git for windows,下载地址是Git for windows),下载后安装就好,具体步骤不细说了,大家可以自己百度,网上教程都很详细。
安装好Git以后,我们要先绑定用户,用户名和邮箱是Github上的用户名和邮箱;用git config --global
的命令,便是这台机器上所有的Git仓库都会使用这个配置。如下图:
再然后就是为Github账户设置SSH Key(加密传输)。首先检查自己有没有已经生成**,执行指令是:cd ~/.ssh
,如果没有**的话需要生成**,执行指令:ssh-****** -t rsa -C “你的邮箱名”
;
然后去你的目录下找ssh key,地址是:C:\Users\你的电脑用户名\.ssh
;要去id_rsa.pub文件里面找(因为是ssh-rsa开头,符合格式);切换到Github中的Settings,Add Key生成**,如下图;需要注意的是Title建议和仓库名一样,便于区分。
如果出现下图就说明**添加成功了,多人项目的话可以将**分享。
第三步,本地仓库的建立
首先在本地建立HCL2000-1000的本地文件夹和配置文件,如下图所示:
我们要在Git的终端里面进入到本地仓库的目录下,执行git init
命令,如下图所示;如果初始化成功的话可以看到我们现在是(master)的身份了,并且在本地仓库中有一个隐藏的.git
文件夹,需要注意的是:.git
文件夹尽量不要修改没这事用来跟踪管理版本库的。
接下来,我们将所有文件添加到仓库,执行的指令是git add .
然后将文件夹下所有的文件提交到仓库中,双引号内是提交注释,执行的指令是git commit -m “提交文件” .
这样我们的本地仓库就建好了,然后就是将本地仓库和Github仓库关联起来,执行的指令是:git remote add origin [email protected]你的远程仓库ssh地址
或者git remote add origin 你的远程仓库http地址
;
再然后就是上传本地代码,执行的指令是:git push -u origin master
;需要注意的一点是GIt是不能管理空的文件夹的,文件夹里必须有文件才能add。
如果你的浏览器足够给力,请直接跳转到这里,我们来介绍Github网页端的使用
第一步,Github上远程仓库的建立
第一步远程仓库的建立同上,在Github上创建一个Repository,点击右上角的加号,点击New Repository,就到了Repository选项卡。只有名字(Repository name)是必填项,我们创建一个叫HCL2000-3755的仓库。
第二步,Github上添加文件(New file)
点击下图中右上角的create new file
按钮(下图标号(1)),进入创建新文件的界面。输入文件名,将代码文件内容拷贝过来就可以。
在此页面你也可以新建一个文件夹,直接在框中输入文件夹的名字,在敲一个/
就可以了,例:输入Code/split_data
,则如下图:
此外,可以选择Upload files
中的choose your files
这个选项来上传你的文件,如图;注意:一定要等Uploading结束后再Commit,因为有可能会报错。
第三步,Github上编辑Readme.md文件
点击下图中的编辑按钮(下图标号(2)),进入编辑Readme.md的界面。一般在建立新的仓库的时候可以初始化带有Readme.md
,所以没有的话新建一个Readme.md
就可以了。Readme主要是根据不同的需求需要布置排列不同的内容。【补充】Readme.md
的用的是markdown的语法,所以大家可以查markdown的语法就可以非常熟练的编辑readme.md
啦~
偷偷的拿师兄的Github上的一个边缘图数据集的仓库给大家看一下效果,小伙伴们可以star一下师兄的仓库(我发誓绝对不是来做宣传的),哈哈哈~
像这种安装教程怎么可能没有问题!!!如果没有问题可能是上辈子拯救过地球银河或者宇宙吧,所以我就罗列一些安装过程中遇到的问题:
问题一:Warning:LF will be replaced by CRLF
问题原因: CRLF和LF是两种不同的换行格式,git工作区默认为CRLF来作为换行符,所以当我们项目文件里有用的地方使用LF作为换行符,所以会弹出警告,当最终push到远程仓库的时候git会统一格式全部转化为用CRLF作为换行符。
解决办法: 可以忽略它,或者先删除.git,然后在禁用自动转换再初始化就可以啦,禁用自动转换的执行命令为:git config –global core.autocrlf false
;
最近因为一些个人原因没有来得及及时更博,但是我们也是很努力的在更博和学习ing啦,还请小伙伴们多多包容,之前说的分割内容也会在近期补上,请大家敬请期待!