GitHub使用总结

本文主要分为三个部分：

• 浏览器上的GitHub：常见的名称解释，仓库管理，开源项目贡献流程
• 在本地客户端：本地仓库管理及远程仓库
• 搭建网站与团队协作开发

GitHub–开源项目的托管平台

---

在浏览器中

创建的概念

-Repository  仓库(项目文件夹)

-Star  收藏

-Fork 复制克隆项目(会直接在自己的账户中建立一个独立的库) 

-Pull request发起请求 (A从B那Fork一个仓库，检查发现有很多bug，做出修改后将其发给B的这个过程叫Pull request.

-watch  关注

-issue 事务卡片 （用于提示对象，此项目有一些debug）

-commit 版本

-github主页有哪些内容？
    左侧是关注用户的信息，右侧是自己仓库信息
-仓库主页有哪些内容？
    项目代码，版本信息，收藏


-跳转项目管理
     -- 右侧create file
    commit new file 版本留言
        -commit directy to the master bench

仓库管理

一个git仓库对应一个开源项目，通过git管理这个库
eg:
    Sunn2018/hello-world
    用户名/仓库名


**1.仓库管理**
    -create new file  创建文件
        Commit new file #增加文件说明
        删除文件  在文件中心有个垃圾桶(可以在仓库中心点击commits中查看操作记录)
    -upload files 上传文件

    -find files 搜索文件

    -issues   用于用户发现xxxbug,返回给原作者




**2.开源项目贡献流程**
·-新建issue  提交使用问问或者建立或者想法

--pull request  
    --fork 项目
    --修改自己仓库的项目代码
    --发起pull request 
    --等待作者审核与合并

---

本地客户端操作

Git安装和使用

--通过git管理github项目代码

--安装
    https://git-scm.com/download/win
    安装时注意选择组件
        -Use git from git bash only
    检验安装是否安装成功(单击鼠标右键)
        Git GUI Here
        Git Bash Here

Git基本工作流程

1。配置基础信息
    -设置用户信息 
        git config --global user.name 'yourname'
    -设置用户邮箱
        git config --global user.name 'youremail'
2.初始化一个新的文件夹
    --mkdir xxx   
        mkdir test
    --在文件内初始化git（创建git仓库）
        cd test
        git init  #/test/.git/  生成一个隐藏文件
 3.向仓库中添加文件(其功能与操作完全同linux终端)
        比如建立一个django项目
        django-admin startproject xxxx

        ###本地创建仓库文件的流程
        (工作区---》暂存区---》Git仓库---》Git服务器)
        -工作区 WORKING DIRECTORY 
             git status #查看文件的状态，是否在工作区
             git add xxx(file)  #提交文件到暂存区
        -暂存区
            git status    #查看文件的状态，是否在暂存区
             git commit -m '提交描述'  # 提交文件到仓库区
        -Git仓库 Git Repository 
        -Git服务器  git push

        （git rm xxx -f 删除文件）
        注意：每次操作后(增删改差),需要重新提交

远程仓库 —备份+代码集中共享(更新与同步)

1.将远程仓库(git对应的项目)复制到本地
    git clone 仓库地址（在仓库中心）
    eg:
    git clone https://github.com/Sunn2018/developer-roadmap-chinese.git
2.工作区---》暂存区---》Git仓库---》同步远程仓库 
git status 
git add 'xxx'
git status
git commit 'xxx' -m'nnnn'
git push

---

github pages 搭建网站

个人站点

1.个人站点--》新建仓库(仓库名必须是[用户名.github.io])
2.在仓库下新建index.html的文件即可
  注意：github pages 仅支持静态网页
        仓库里面只能是.html文件
 eg:
     访问 https://Sxxxx.github.io

项目站点：(不做重点)

搭建步骤：
    -进入项目主页，点击settings
    -在settints中，点击GitHub Pages中的source
    -选择主体
    -生成网页
 eg:
     https://用户名.github.io/仓库名

团队协作开发（三种方式）

1.fork项目--修改自己仓库的项目代码--发起pull request --等待作者审核与合并

2.new repository---settings--collaborators(添加) #给团队成员增加操作权限

3.通过公钥的形式，合作开发
    -创建项目的SSH Key
     ssh-keygen -t rsa -C 'youremail@example.com'
      #此时会在主目录里找到.ssh目录，有id_rsa和id_rsa.pub两个文件（秘钥对）

    -在settings的SSH Keys页面中New SSH Key里粘贴各个成员的id_ras.pub

    -项目负责人创建一个仓库

    -git clone xxx  ###每个成员可以拷贝一份，在本地操作，然后上传
    -与远程库交互
       git pull