Mac系统关于Github的使用 - 设计师的小小盒

### 一：注册Github账号

注册应该不用多啰嗦

### 二：配置SSH

1. Mac系统自动安装了SSH，终端输入  `ssh`  查看是否已安装，输出以下内容表示已安装

2. 输入   `bashssh-keygen -t rsa`   生成ssh key，回车，需要输入密码时输入密码即可（安全起见，Mac系统密码输入时不可见，输完直接回车即可），出现以下内容，说明生成了id_rsa和id_rsa.pub两个文件（id_rsa.pub为公钥，id_rsa为私钥，它们都是隐藏文件）

> Windows系统在C盘Documents and Settings/username/.ssh下面，Mac系统可直接在桌面输入快捷键 `Shift + Command + G`  来搜索  ` .ssh`  定位到这两个文件所在的文件夹

3. 输入命令  `cd /.ssh`  进入到 .ssh隐藏文件夹，  `ls`  列出一下当前文件夹的文件，会发现出现两个文件id_rsa.pub 和id_rsa（另一个know_hosts是已经配置成功的，请忽略）

4. 执行命令
   ```bash
   cat id_rsa.pub
   ```
   获取公钥内容，复制此公钥内容

5. 粘贴公钥内容到github上，选Settings

6. 选择这里

7. 新建一个ssh key

8. title随便起，key输入刚复制的公钥内容，点击Add SSH key添加公钥

9. 添加完后，回来测试一下，输入命令  `ssh -T git@github.com`  来检查一下是否配置成功，以下结果代表成功

10. 注意如果换了设备的话配置ssh这个步骤还是需要重新来一遍的，在github上新增一个ssh key即可

### 三：Fork项目

1. 到github上选择一个自己心仪的项目fork一下

2. 添加到自己的仓库中

### 四：克隆项目到本地

1. fork完成后，会自动进入到已fork完成的这个项目的详情，复制一下这个链接

2. 复制后，在电脑新建一个文件夹（比如doc）用以存放从github上克隆下来的项目

3. 命令行进入到新建的这个文件夹  `cd 文件夹路径（找到文件夹直接拖入命令行即可）`

4. 开始克隆这个项目  `git clone 步骤1中复制的链接粘贴过来`

5. 已克隆到本地

### 五：编辑并上传项目

1. 编辑项目，此处以 ./fashop-docs/docs/docs/help中的001test.md为例

2. 编辑完成后，需要上传到github（上传之前，需要确保已加入到源项目组中以便让作者看到你的提交，需要把github账号提供给项目作者），我们先进入到该项目  `cd 项目路径`

3. 运行  `git add .`  注意空格

4. 然后输入命令  `git commit -m'这里写一些本次所编辑项目的简要描述以便让项目作者看到你修改了什么'`

5. 然后输入命令  `git pull`  需要输入密码时输入密码回车即可

6. 输入命令  `git push`

7. 提交成功，我们返回到github这个项目上，即可查看到自己刚刚提交的内容

8. 再到项目详情中找到刚刚修改的内容确认一下

9. 好了，距离成功还差最后一步，此时已经打通了你的github仓库和你本地的链接，创作完发布到你自己的github后，我们还需要发一个合并请求给项目作者

### 六：项目请求合并

1. 在github上进入到想要请求合并的项目

2. 新增一个请求

3. （1）区域为“你想要请求合并的项目路径”->“源项目的路径”，这个一般不用修改，compare为项目分支。

（2）区域为你的修改记录。

（3）区域为修改预览

4. 确认好需要请求合并的信息后，点击上图create pull request按钮，填写标题和简要描述后，点击 create pull request 等待项目作者同意即可

### 七：从fork来源更新代码

> 从github上直接更新，然后clone到本地覆盖，请参考 [这里](https://blog.csdn.net/qq1332479771/article/details/56087333)
>
> 从github上直接覆盖本地，然后push到自己github上，请参考 [这里](https://gaohaoyang.github.io/2015/04/12/Syncing-a-fork/)