新手一文入门GitHub之胎教版本

1. 使用Github、

1.1 目的

借助github托管代码

1.2 基本概念

Repository（仓库）：存放项目代码，开源一个项目，就新建一个Repository。
star（收藏）：100star都比较难。
Fork（复制克隆整个项目）：克隆之后可以在主页修改项目。
Pull Request（发送请求）：基于Fork，对fork的项目改进后，Pull Request后，等待原仓库主人查看后是否选择合并到原仓库。
Watch（关注）：仓库有任何更新，第一时间收到通知。
Issue（事务卡片）：发现BUG，但是没解决，需要讨论。
GitHub主页
仓库主页：项目代码，版本，收藏情况等
个人主页

1.3 注册GitHub账号

网址：GitHub.com。

注册后，到达选择计划页面，默认公有仓库，continue。
到达用户调查网站，不用管，skip this step。
注册成功。
验证邮箱后点击，start a project。

注：

GitHub的服务器在国外，所以有时候访问较慢，可以FQ（github里面搜索Shaowsocks）。
新用户验证邮箱后才能创建仓库。

1.4 创建仓库/新项目

说明

一个git库对应一个开源项目，通过git管理项目。

创建时候填写仓库名称，简单项目描述，根据需求勾上Add a README file（详细描述项目文件），再点击创建。

到达仓库主页。

Add files里

create new file：创建文件
upload files：上传文件

Code：直接下载或者通过git克隆

Issue：新建Issue

1.5 仓库管理

创建文件：

点击create new file
填写文件名（需要后缀）
写文件内容
填写提交的概括标题
填写本次提交详细描述，为了方便其他开发者知道本次添加或者修改的原因。
点击Commit new file，自动跳转到仓库主页。

编辑文件：

点击文件名，点击🖊，即可编辑文件（算一次commit），进入编辑模式，类似于创建文件流程。
点击commits，进入到commits里面，其中内容是每一次的修改详细信息。

删除文件：

点击文件名，进入文件详情，点击垃圾桶。
删除时候也要提交描述，方便后来查看。

上传文件：

点击upload files。
把文件拖进去，或者选择文件。
填写描述。

搜索仓库文件：

go to file or 快捷键 T

下载文件：

点击绿色的code下载键。
复制链接，去码云。
在码云页面，导入github的仓库，再下载。
通过码云下载，速度很快。

1.6 GitHub Issues

作用：发现BUG，但是没解决，需要讨论。

到达别人的仓库后：

点击Issues，来到所有bug/交流页表，存在两种Issues（open/closed）。
New issue，填写标题，具体bug描述。
仓库拥有者就能看到Issue，并解决，可关闭Issue。

1.7 Pull Request（发起请求）

基于Fork，对fork的项目改进后，Pull Request后，等待原仓库主人查看后是否选择合并到原仓库。

1.8 开源项目贡献流程

两种方式：

通过新建Issue提交使用问题或者建议
通过Pull Request直接修改项目

2 Git 安装和使用

目的：通过GitHub托管项目

2.1 下载与安装

下载传送门：https://npm.taobao.org/mirrors/git-for-windows/

安装，一直默认下一步，其中选择Use Git from Git Bash only（只用命令行模式），继续默认下一步，等待安装完成。

2.2 Git工作流程

Git 工作区域

Git Repository（Git 仓库）：最综版本的文件保存到仓库，对他人可见。
暂存区：暂存已经修改的文件，等待最后统一提交到git仓库中。
Working Directory（工作区）：添加、编辑、修改文件等动作。

Git 工作流程：

git status：查看所有文件的状态（在哪个区）
git add 文件名字：工作区提交到暂存区
git commit -m “提交的描述”：将暂存区提交到Git Repository
最后git status查看一下文件情况

2.3 Git初始化及仓库创建和操作

基本信息设置：

设置用户名：git config --global user.name '名字'
设置用户邮箱：git config --global user.email '邮箱'

初始化一个新的git仓库（命令行内）：

新建文件夹；也可以 mkdir 文件夹名字
在文件内初始化git（创建仓库）：cd 文件夹名字（进入文件夹），git init，生成.git隐藏文件
向仓库中添加文件：创建文件用 touch 文件名（带后缀）
添加到暂存区：用 git status 查看状态，再 git add 文件名字
添加到git仓库：git commit -m “提交的描述”

修改文件：

ls：查看当前目录下文件名称（linux命令可以网上查）。
vi 文件名，按i或者a：编辑文件。
辑完内容后，按下Esc键，并输入“:wq”，然后回车就可以保存退出。
添加到暂存区：用 git status 查看状态，再 git add 文件名字。
添加到git仓库：git commit -m “提交的描述”。

删除文件：

rm -rf 文件名：删除文件
git rm 文件名：从git中删除文件
添加到git仓库：git commit -m “提交的描述”。

2.4 Git 远程管理仓库

目的：备份，实现代码共享，集中化管理。

Git 克隆操作：

将远程仓库（github对应的项目）复制到本地（相当于下载）
代码：git clone 仓库地址

将本地仓库同步到git远程仓库中：

git push

注：此处要设置权限，输入密码。

2.5 Github Pages 搭建网站

个人站点：

http://用户名.github.io

搭建步骤：

创建个人站点：新建仓库（仓库名必须是用户名.github.io）
在仓库下新建 index.html的文件即可

注：只支持静态网页，只能是.html文件

项目站点：

http://用户名.github.io/仓库名字