使用GitHub(1)

使用GitHub(1)

参考GotGitHub
提起GitHub真是有点如雷贯耳的感觉,不过注册了这么久,贯得连耳朵都快聋掉了,我还是没有在上面创建过一个repo。连带着学过的Git基础也没有好好用过。
开始折腾吧,用熟手了,在上面放点东西,拿出去也光彩些。

离线GotGitHub

根据GotGitHub在GitHub上的托管地址,可以将这本书离线下来阅读。

用浏览器打开gotgithub目录下的index.html,即可阅读。

SSH Keys

注册什么的当然就不说了,从ssh使用的公钥/私钥开始吧。
在GitHub中的Account Settings中可以添加SSH keys。找到该链接之后,也能看见几个小的链接,会说明关于生成SSH keys的一些内容。
生成工具ssh-keygen。不知道Windows上是不是有这个东西,因为我安装了Cygwin,可能是Cygwin安装时将这些工具都加入了PATH,所以我现在在cmd中也可以使用。
总之就是,如果在Windows中找不到ssh-keygen,请去下载安装一个Cygwin。
使用ssh-keygen后,会生成一个公钥/私钥对,公钥应该名为id_rsa.pub,这是可以分发给他人的;私钥名为id_rsa,这个请自己保管好。

当生成的公钥/私钥对不在缺省位置(~/.ssh/id_rsa等)时,使用ssh命令连接远程主机时需要使用参数-i 指定公钥/私钥对。或者在配置文件~/.ssh/config中针对相应主机进行设定。例如对于上例创建了非缺省公钥/私钥对~/.ssh/gotgithub,可以在~/.ssh/config配置文件中写入如下配置。

将公钥添加到GitHub,然后用ssh访问GitHub:

显示了一条成功信息,并且退出。

创建新项目

GitHub中一个项目对应一个Git版本库,创建新项目也就是创建一个新的版本库。

选择新建repository后,要求你输入repo的名字。然后还有一些可选的东西,项目的描述,是否在初始化时新建README,以及选用的git忽略方案和开源协议。

虽然很想选择它提供的方案来看看创建出来的.gitignore和README,但现在需要熟悉下从零开始,就不选择了。以后再创建一个看看情况吧。

创建后,会提供给你HTTP和Git两种协议的地址,然后就可以根据给出的说明来创建或推送项目了。这里开始,就涉及到了Git的知识。我也忘得差不多了,所幸以前学的时候也记录过,可以参考。学习Git(1)学习Git(2)

要获得一个Git的版本库,有两种方法,一是在本地直接init一个,从零开始建立;二是clone一个。

GitHub建议每个版本库都有README、LICENSE和 .gitignore三个文件。其中,README里是对于这个项目的一些说明,将会在项目的页面显示出来;LICENSE内保管项目的遵守的协议(通常是某种开源协议吧);.gitignore内指明了git需要忽略的文件和目录。

在使用git之前,还是需要先配置下自己的用户信息,以说明代码是由谁提交的。参见学习Git(1)

推荐在初始化版本库之前运行 git config --list来查看一下Email和用户名,是否与GitHub上对应。还可以在运行一次 ssh -T git@github.com来验证下SSH key是否正常。

init方法

要init一个版本库,步骤可以参考在GitHub上创建一个空项目时,给你的提示。如下:

Create a new repository on the command line

Push an existing repository from the command line

上面使用的HTTP,需要输入GitHub的帐号密码;还可以使用SSH来进行提交。

以上命令基本都能在我的其他两篇博文里找到,就不一一解释了。

执行完上面的步骤,你就在GitHub上的第一个版本库进行了第一次提交,提交的内容是一个说明文件。

clone方法

这个方法显得比较简单一点,不需要添加远程仓库。将GitHub给的地址上的远程仓库clone下来(是个空项目,没有内容),所以不需要添加远程仓库了。

不过建立文件,添加文件,提交,推送这些步骤,还都是要的,也是与init方法一样的。


接下来要做的就是建项目,好好习惯使用版本控制了。等到碰见了需要记录的知识后,再继续写下一篇。

Tips:

  • GitHub可以使用快捷键。有什么样的快捷键,请输入?查看。如果你的浏览器上安装了Vimium这类扩展,请记得添加例外。


  1. Pingback: