Github使用方法(完整版)

GitHub 使用方法

GitHub 是什么？

• GitHub 是一个免费代码托管平台，用于管理代码历史纪录与远程协作，可以让你和他人在任何地方共同开展项目！

GitHub

---

功能简要介绍

基本界面

打开 GitHub 网站 https://github.com/， 注册账号并登录，进入个人主页。

个人主页

页面中间的菜单栏显示了你使用 GitHub 的基本情况。

菜单栏

贡献情况

• Repository :存放代码的储存库,通常用于组织单个项目,存储库可以包含文件夹和文件、图像、视频、电子表格和数据集等任何你的项目所需要的内容

• Star :你收到的赞

• Follower :关注你的人

• Following :你关注的人

• Contributions :你在 GitHub 的使用或贡献情况,每个方格代表一个日期,贡献程度随颜色加深而递增

主要操作：

• Fork ：
  将别人建立好的储存库 repository 全部复制到自己的账户中，会在自己的账户中出现同样名字的repository

• Clone ：
  将 repository 复制到本地或客户端

• Roll back to this commit ：
  回退到之前的版本

• Branch ：
  分支，是同时对同一储存库进行编辑的方法， GitHub 储存库默认有一个主分支 master ，当我们在主分支 Master 开发过程中遇到一个新的功能需求，我们就可以新建一个分支同步开发而互不影响，开发完成后，再合并 merge 到主分支Master上

• Commits :提交,保存更改

GitHub Desktop 的操作

• Add ：
  加入到已有的 repository 中

• Clone ：
  复制到本地

• Create ：
  创建新的 repository

• Publish ：
  将本地的更新同步到 GitHub 中

---

使用步骤

掌握以下简单几步，我们就可以开始使用 GitHub 啦！

---

1. 创建与使用存储库

• 页面右上角,在你的头像旁边找到“+”,点击并选择新的存储库 New Repository

创建储存库

• 命名你的存储库

• 写一个简短的描述

• 选择以自述文件初始化 Initi a lize this Repository with a README

创建储存库

• 单击创建储存库 Create Repository

---

2. 启动与管理新分支

默认情况下，你的存储库有一个名为 Master 的主分支，也叫最终分支。我们使用其他分支进行实验并在提交给主分支Master之前进行编辑

当你在主分支上创建一个分支时，你在主分支的基础上复制了一个分支。如果有人在你对分支工作时对主分支进行了更改，你可以将这些更新拖进主分支，分支间的关系如下所示

分支关系示意图

具体操作：

• 在新建的储存库里,单击文件列表顶部的下拉框,显示主分支 master

• 在文本框内输入新分支的名称,如在 readme - edits

• 选择蓝色创建分支框或单击键盘上的“Enter”

创建分支

---

3. 修改与提交文件

现在，你在 readme - edits 分支的代码视图中，这是主分支的一个副本。我们开始编辑。

在 GitHub 上，保存的变化称为提交 commits 。每个提交都有一个关联的提交消息，解释为什么做出了特定更改。提交消息捕获更改的历史，因此其他贡献者可以理解您所做的工作和原因。

具体操作：

• 单击 readme . md 文件

• 点击位于文件预览右上角的铅笔图标,进行编辑

• 在编辑窗口内进行编辑

• 写明提交信息,描述你的修改

• 点击 Commit Changes 按钮

修改与提交

这些修改仅被保存在 readme - edits 分支，这使得它与主分支 master 有所不同。

---

4. 提出请求 Pull Request

由于刚刚的编辑， readme - edits 分支已经能区别于主分支 master ，我们就能提出请求（合并）。

提出请求 Pull Request 是 GitHub 协作的核心。当你提出请求时，你在提议并请求他人查看你的修改，并将修改合并入他们的分支。提出请求显示了分支之间的差异，绿色表示添加，红色表示删减。

具体操作：

• 单击 Pull Request 按钮,然后页面单击绿色的 New Pull Request按钮

image

• 选择你所编辑的分支,与主分支进行比较

image

• 在对比页面检查分支间的差异,确保它们是你想提交的内容

image

• 当你对想要提交的修改满意时,单击绿色的 Create Pull Request 按钮

image

• 为你创建的 Pull Request 命名,并简要说明你做出的修改

image

• 确认好以上信息，单击 Create pull request 就可以啦！

---

5.合并请求 Pull Request

到了最后一步，是时候把你的更改放在一起啦——将你编辑的分支合并到主分支中。

具体操作：

• 单击绿色的合并请求 Merge Pull Request 按钮,将更改合并到主目录中

• 单击确认合并 Confirm merge

• 更改已被合并,原来编辑的分支就可以删除了,点击紫色的删除分支 Delete branch 按钮

image

GitHub 与 Stata 结合

• 在 GitHub 中搜索 stata 相关信息，并 fork 到自己的账户：

1. 登录 GitHub ，在搜索框中输入关键字，如 stata ，单击回车

image

2.选择查找的内容

image

3.选择排序方式

image

4.选择一个 repository ， fork 到自己的账户中

单击 fork ，保存到自己的账户中

image

fork 成功的 repository 会出现在自己的账户中

image

5.取消 fork ：

单击 setting

image

下拉出现“Danger Zone”，点击“Delete this repository”

image

在输入框中正确输入 repository 名称，下方按钮“I understand the consequences, delete this repository”会亮起，单击即可成功取消 fork

image

成功删除后，界面会出现提示

image

• stata 中使用 GitHub

1.安装 GitHub :
在 stata 中输入：net install github , from ("https://raw.githubusercontent.com/haghish/github/master/")

安装成功后出现

image

2.用 github 安装 GitHub 用户开发的命令

要安装命令包，需要 GitHub 用户名和存储库的名称。例如，要安装 devtools ，你会发现并不能用 ssc 安装，也就是说devtools并没有被ssc收录。

image

在 GitHub 中可以搜索到 gvegayon 用户开发了 devtools 。

输入以下 code 来安装 gvegayon 开发的命令：
github install gvegayon/devtools

安装时基本的语法是
github install 用户名/命令，例如：
github install haghish/findall

3.卸载安装包

要卸载命令包，请使用 uninstall 子命令，后跟程序包名称。例如卸载刚刚安装好的 devtools 命令的安装包：
github uninstall devtools

卸载 github 本身的安装包，命令为：
ado uninstall github

看到这里，你已经初步学会如何创建项目并进行修改与合并啦！可喜可贺！继续开始新的探索吧！