《GitHub入门与实践》第3章使用GitHub的前期准备—

文章目录

1. 使用前的准备
- 创建账户：
- 设置头像
- 设置SSH Key
- 添加公开密钥
- 使用社区功能
2. 实际动手使用
- 2.1 创建仓库
- 2.2 连接仓库
- 2.3 公开代码
3. 小结

1. 使用前的准备

创建账户：

网址：https://github.com/join

设置头像

在GitHub 上随处可见的头像（账户独有的标识）是通过Gravatar服务显示的。

设置SSH Key

GitHub 上连接已有仓库时的认证，是通过使用了SSH 的公开密钥认证方式进行的。

运行以下的命令创建SSH Key。

$ ssh-keygen -t rsa -C "your_email@example.com"
Generating public/private rsa key pair.
Enter file in which to save the key
(/Users/your_user_directory/.ssh/id_rsa): `按回车键`
Enter passphrase (empty for no passphrase): `输入密码`
Enter same passphrase again:`再次输入密码`

id_rsa 文件是私有密钥，id_rsa.pub 是公开密钥。

添加公开密钥

在Title 中输入适当的密钥名称
Key 部分请粘贴id_rsa.pub 文件里的内容

id_rsa.pub的内容可以用如下方法查看，也能用记事本直接打开查看：

$ cat ~/.ssh/id_rsa.pub
ssh-rsa `公开密钥的内容` your_email@example.com

添加成功之后，创建账户时所用的邮箱会接到一封提示“公共密钥添加完成”的邮件。

完成以上设置后，就可以用手中的私人密钥与GitHub 进行认证和通信了。让我们来实际试一试。

$ ssh -T git@github.com
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is `fingerprint值` .
Are you sure you want to continue connecting (yes/no)? `输入yes`

出现如下结果即为成功：

Hi hirocastest! You've successfully authenticated, but GitHub does not
provide shell access.

使用社区功能

既然说GitHub 能够以人为焦点，那么在创建账户后不妨试试Follow（关注）别人。在用户信息页面的右上角点击如图3.3 所示的按钮即可。

这里拿Qt大佬“飞扬青云”的GitHub主页来举例：
https://github.com/feiyangqingyun

这样一来，您所Follow 的用户的活动就会显示在您的控制面板页面中。您可以通过这种方法知道那个人在GitHub 上都做了些什么。

对于仓库，也可以使用Watch 功能获取最新的开发信息。如果您经常使用的某个软件正在GitHub 上进行开发，不妨去Watch 一下。

2. 实际动手使用

2.1 创建仓库

Initialize this repository with a README

在Initialize this repository with a README 选项上打钩，随后GitHub 会自动初始化仓库并设置README 文件，让用户可以立刻clone 这个仓库。如果想向GitHub 添加手中已有的Git 仓库，建议不要勾选，直接手动push。
Add .gitignore

下方左侧的下拉菜单非常方便，通过它可以在初始化时自动生成.gitignore 文件A。这个设定会帮我们把不需要在Git 仓库中进行版本管理的文件记录在.gitignore 文件中，省去了每次根据框架进行设置的麻烦。下拉菜单中包含了主要的语言及框架，选择今后将要使用的即可。由于本书中我们并不使用任何框架，所以不做选择。

该文件用来描述Git 仓库中不需管理的文件与目录
Add a license

右侧的下拉菜单可以选择要添加的许可协议文件。如果这个仓库中包含的代码已经确定了许可协议，那么请在这里进行选择。随后将自动生成包含许可协议内容的LICENSE 文件，用来表明该仓库内容的许可协议。

2.2 连接仓库

下面这个URL 便是刚刚创建的仓库的页面

https://github.com/用户名/Hello-GitHub

README.md

README.md 在初始化时已经生成好了。README.md 文件的内容会自动显示在仓库的首页当中。因此，人们一般会在这个文件中标明本仓库所包含的软件的概要、使用流程、许可协议等信息。如果使用Markdown 语法进行描述，还可以添加标记，提高可读性。
GitHub Flavored Markdown

在GitHub 上进行交流时用到的Issue、评论、Wiki，都可以用Markdown 语法表述，从而进行标记。准确地说应该是GitHub Flavored Markdown（GFM）语法。

务必学会Markdown 语法。

2.3 公开代码

clone 已有仓库

接下来我们将尝试在已有仓库中添加代码并加以公开。首先将已有仓库clone 到身边的开发环境中。clone 时指定的路径请参考下图：

$ git clone git@github.com:tangxing806/Hello-GitHub.git
Cloning into 'Hello-World'...
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (3/3), done.
$ cd Hello-World

编写代码

这里我们编写一个hello_world.php 文件，用来输出“Hello World!”

由于hello_word.php 还没有添加至Git 仓库，所以显示为Untracked files。

提交

将hello_word.php 提交至仓库。这样一来，这个文件就进入了版本
管理系统的管理之下。今后的更改管理都交由Git 进行。

$ git add hello_world.php
$ git commit -m "Add hello world script by php"
[master d23b909] Add hello world script by php
1 file changed, 3 insertions(+)
create mode 100644 hello_world.php

通过git add命令将文件加入暂存区，再通过git commit命令提交。

添加成功后，可以通过git log命令查看提交日志。

$ git log
commit d23b909caad5d49a281480e6683ce3855087a5da
Author: hirocastest <hohtsuka@gmail.com>
Date: Tue May 1 14:36:58 2012 +0900
Add hello world script by php

进行push

之后只要执行push，GitHub 上的仓库就会被更新。

$ git push
Counting objects: 4, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 328 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@github.com:hirocastest/Hello-World.git
46ff713..d23b909 master -> master

3. 小结

本章讲解了初次在GitHub 建立仓库以及公开代码的流程。完成这些，各位就踏入了GitHub 的世界。