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