Github使用方法及Stata资源

发布时间:2020-10-06 阅读 35

Stata 连享会   主页 || 视频 || 推文

温馨提示: 定期 清理浏览器缓存,可以获得最佳浏览体验。

课程详情 https://gitee.com/arlionn/Course   |   lianxh.cn

课程主页 https://gitee.com/arlionn/Course

作者:王若溪、李缘


目录


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 啦!

graph TD
创建与使用存储库-->启动与管理新分支
启动与管理新分支-->修改与提交文件
修改与提交文件-->提出与合并请求

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
image
  • 在对比页面检查分支间的差异,确保它们是你想提交的内容
image
image
  • 当你对想要提交的修改满意时,单击绿色的 Create Pull Request 按钮
image
image
  • 为你创建的 Pull Request 命名,并简要说明你做出的修改
image
image
  • 确认好以上信息,单击 Create pull request 就可以啦!

5.合并请求 Pull Request

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

具体操作:

  • 单击绿色的合并请求 Merge Pull Request 按钮,将更改合并到主目录中
  • 单击确认合并 Confirm merge
  • 更改已被合并,原来编辑的分支就可以删除了,点击紫色的删除分支 Delete branch 按钮
image
image

GitHub 与 Stata 结合

  • 在 GitHub 中搜索 stata 相关信息,并 fork 到自己的账户:
  1. 登录 GitHub ,在搜索框中输入关键字,如 stata ,单击回车
image
image

2.选择查找的内容

image
image

3.选择排序方式

image
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/")

连享会计量方法专题……

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

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

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

输入以下命令来安装 gvegayon 开发的 devtools 命令包:

github install gvegayon/devtools

可见,安装时基本的语法是 github install 用户名/命令

3. 卸载安装包

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

github uninstall devtools

卸载 github 本身的安装包,命令为:

ado uninstall github

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


参考网址:

Hello World GitHub Guides GitHub for Windows使用教程 怎样使用 GitHub? GitHub使用 SSC的好兄弟“github”

相关课程

连享会-直播课 上线了!
http://lianxh.duanshu.com

免费公开课:


课程一览

支持回看,所有课程可以随时购买观看。

专题 嘉宾 直播/回看视频
最新专题 DSGE, 因果推断, 空间计量等
Stata数据清洗 游万海 直播, 2 小时,已上线
研究设计 连玉君 我的特斯拉-实证研究设计-幻灯片-
面板模型 连玉君 动态面板模型-幻灯片-
面板模型 连玉君 直击面板数据模型 [免费公开课,2小时]

Note: 部分课程的资料,PPT 等可以前往 连享会-直播课 主页查看,下载。


关于我们

  • Stata连享会 由中山大学连玉君老师团队创办,定期分享实证分析经验。直播间 有很多视频课程,可以随时观看。
  • 连享会-主页知乎专栏,300+ 推文,实证分析不再抓狂。
  • 公众号推文分类: 计量专题 | 分类推文 | 资源工具。推文分成 内生性 | 空间计量 | 时序面板 | 结果输出 | 交乘调节 五类,主流方法介绍一目了然:DID, RDD, IV, GMM, FE, Probit 等。
  • 公众号关键词搜索/回复 功能已经上线。大家可以在公众号左下角点击键盘图标,输入简要关键词,以便快速呈现历史推文,获取工具软件和数据下载。常见关键词:课程, 直播, 视频, 客服, 模型设定, 研究设计, stata, plus, 绘图, 编程, 面板, 论文重现, 可视化, RDD, DID, PSM, 合成控制法

连享会主页  lianxh.cn
连享会主页 lianxh.cn

连享会小程序:扫一扫,看推文,看视频……

扫码加入连享会微信群,提问交流更方便

✏ 连享会学习群-常见问题解答汇总:
https://gitee.com/arlionn/WD