如何安装和管理GitHub上的Stata社区命令?

GitHub是微软旗下一个面向开源及私有软件项目的托管平台,与SSC相比,GitHub更加开放和自由,因此越来越多的开发者在上面分享自己编写的Stata代码和数据集、开发统计软件和托管Stata社区命令,下图是图示。

随着GitHub上托管的Stata社区命令越来越多,如何便捷地安装和管理成为一个问题。为此,德国弗莱堡大学(University of Freiburg)的E. F. Haghish开发了Stata社区命令github,用以帮助使用者便捷地搜索、安装和管理GitHub上开发者们托管的Stata社区命令,它还可以帮助开发者快速发布自己的Stata社区命令。

安装Stata社区命令github的Stata命令如下:

 *这是安装GitHub上Stata社区命令的标准格式
net install github, replace from("https://haghish.github.io/github/")

第一部分:安装
安装托管在GitHub上其他Stata社区命令。以Haghish开发开发的Stata社区命令MarkDoc为例,它在GitHub的托管地址是https://github.com/haghish/markdoc,对应安装命令如下:

*如果托管地址是github install username/repository name
github install haghish/markdoc , stable

还可以更简单,直接

*gitget packagename
gitget markdoc , stable

第二部分:搜索
和Stata的搜索命令(search)类似,非常简单:

* github search keywords
github search markdoc
*只搜索名称中含有markdoc的相关命令
github search markdoc, in("name")
*只搜索名称和描述中含有markdoc的相关命令
github search markdoc, in(name,description) 

搜索默认只搜索可安装的Stata社区命令,也就是包含 toc 和 pkg文件仓库,如果要搜索所有的Stata命令,可以加选项all,如


github search markdoc, in("name") all
github search markdoc, in(all) language(Stata) all

另,github命令还支持菜单搜索,更加直观,Stata命令如下:


db github

第三部分:管理
查看通过github已安装的Stata社区命令列表,Stata代码如下:


github list

检查是否可安装,Stata代码如下:


github check haghish/markdoc

卸载通过github已安装的Stata社区命令,Stata代码如下:


github uninstall markdoc

第四部分,版本控制

*查看所有版本
github query haghish/markdoc
*安装特定版本
github install haghish/markdoc,version(5.0.2)
查看已安装版本
github version markdoc

第五部分,快速发布
如果已有ado和sthlp文件,github可自动生成发布文件,Stata命令如下:


db make

更多查看帮助文件:


help github