songbl 命令使用手册

1. 简介

songbl 命令是深圳大学松柏林编写的一个小程序，目的在于让用户可以便捷地可以在 stata 窗口检索与浏览 Stata 推文、视频、do文档、论坛帖子以及学术论文等众多资源。

2. 安装

2-1 稳定版本

稳定版本更新比较缓慢，在 Stata 命令窗口中输入如下命令即可安装稳定版本：

. ssc install songbl, replace


2-1 内测版本

建议下载内测版本。内测版本更新比较频繁，几乎每周都会增加新内容、新功能或者修复已发现的Bug。在 Stata 命令窗口中输入如下命令即可安装内测版本：

. ssc    install songbl, replace 
. songbl install songbl, replace

或者直接把如下三个文件下载到 Stata 外部命令文件夹：

• songbl.ado
• songbl.sthlp
• songbl_cn.sthlp

3. 命令使用介绍

---

3-1 推文检索

• 资源介绍

推文资源主要是 Stata 微信公众号与连享会网站推文为主，还包括一些 B 站视频、模型论文、Stata 书籍以及一批自编的 Stata do 文档等资源。连享会推文会自动同步更新，其他资源主要为手工收集。目前已经一共收集了2000+篇的推文资源。

1. 查看 Stata 推文资源的分类信息

. songbl


2. 查看最新 Stata 推文

. songbl new

3. 查看 连享会 最新 Stata 推文

. songbl new,auth(连享会)


• 选择项

选择项	描述
cls	清屏后显示结果
nocat	不输出推文分类信息
time	输出检索所耗时间
gap	在输出的推文结果之间进行空格一行
line	搜索推文的另一种输出风格,具有表格划线
author(string)	按照推文来源进行检索，author(连享会)表示仅检索来自连享会的推文
num(int)	指定要列出的最新推文的数量；N(10)是默认值。与 songbl new 搭配使用
file(string)	括号内为文档类型，包括 do/txt/docx/pdf 等。例如 file(do) 表示在 stata 打开以 .do 结尾的 do 文档推文

• 操作实例

1. 按照更新时间来查看推文，默认设置为前10条

. songbl new

2.  同上，但是空格一行打印

. songbl new,gap


3. 查看前20条最新推文

. songbl new,n(20)

4. 查看最新推文的另一种输出风格

. songbl new,l


5. 输出标题中包含 [IV-GMM] 关键词的推文超链接

. songbl IV-GMM

6. 同上,输出风格有所区别

. songbl IV-GMM,l


7. 同上，但是不同推文超链接之间空格一行输出

. songbl psm,l g

8. 输出标题中包含 [PSM] 关键词，并且是来自连享会的推文超链接

. songbl PSM,auth(连享会)


9. 输出标题中包含 [变量] 关键词，并且是来自爬虫俱乐部的推文超链接

. songbl 变量,auth(爬虫俱乐部)

10. 输出标题中包含 [连享会历史文章] 关键词的推文超链接,并在stata打开以.do结尾的推文do文档

. songbl 连享会历史文章,f(do)


11. 输出标题中包含 [DID] 关键词，并且输出的推文结果之间空格一行

. songbl DID,gap

12. 输出标题中包含 [DID] 关键词的推文超链接,但不输出推文分类信息

. songbl DID,noc


13. 输出标题中包含 [DID] 关键词，但清屏后再输出结果

. songbl DID,c

14. 支持大小写关键词的推文超链接检索

. songbl DiD


15. 输出含有 [面板] 和 [数据] 关键词的推文超链接 (交集)

. songbl 面板 数据

16. 输出含有 [Stata] 、[面板] 和 [数据] 关键词的推文超链接 (交集)

. songbl Stata 面板 数据


17. 输出含有 [命令] 、[Stata] 、[面板] 和 [数据] 关键词的推文超链接 (交集)

. songbl Stata 面板 数据 命令

18. 输出含有 [空间] 或者 [面板]  关键词的推文超链接 (并集)

. songbl 空间 + 面板


19. 输出含有 [空间] 或者 [面板] 或者 [Stata命令] 关键词的推文超链接 (并集)

. songbl 空间 + 面板 + Stata命令

20. 检索结果与例19一致，只要含有一个 + 号，就代表并集

. songbl 空间 + 面板 Stata命令


21. 输出同时含有关键词 [面板]，但不包括关键词 [面板] 的推文超链接

. songbl stata - 面板

22. 输出同时含有关键词 [面板]，但不包括关键词 [面板] 与 [PDF] 的推文超链接

. songbl stata - 面板 - PDF


23. 输出同时含有关键词 [面板]，但不包括关键词 [面板] 、[PDF] 、[MP4]  、[do]的推文超链接

. songbl stata - 面板 - PDF - mp4 - do

24. 检索结果与例23一致，只要含有一个 - 号，就代表第一个关键词出现的推文再分别减去后面关键词出现的推文

. songbl stata 面板 PDF mp4 - do


---

3-3 帖子检索

• 资源介绍

可以便捷地可以在 stata 窗口浏览 The Stata Forums 的帖子，包括标题，点击数，回帖数等。也可以对论坛的帖子标题进行检索。

• 选择项

选择项	描述
forum	The Stata Forums 帖子资源的启动选择项，该选择项为必填选择项
post(int)	括号内为帖子的回帖数，范围为1-10，默认值为1。post(5)表示仅检索有5条以上跟帖回复的贴子
page(int)	实时打印 The Stata Forums 的帖子情况。范围为1-1437，默认值为1，即打印首页内容
sort(string)	根据排序情况实时打印The Stata Forums 的帖子情况，包括 sort(title), sort(last), sort(start), sort(like), sort(replie), sort(member).
cls	清屏后显示结果
time	输出检索所耗时间
gap	在输出的推文结果之间进行空格一行
line	搜索推文的另一种输出风格,具有表格划线

• 操作实例

1. 实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum

2. 同上，实时更新查看 The Stata Forums 首页的帖子，但信息会更全面。包括发帖人、回帖人以及时间信息

. songbl ，forum


3. 实时更新查看 The Stata Forums 第10页的帖子

. songbl new，forum page(10)

4. 以跟帖回复时间进行排序后， 实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(last)


5. 以跟帖发布时间进行排序后，实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(start)

6. 以跟帖标题进行排序后，实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(title)


7. 以跟帖点赞数进行排序后，实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(like)

8. 以跟帖回复数进行排序后，实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(replie)


9.以跟帖作者进行排序后，实时更新查看 The Stata Forums 首页的帖子

. songbl new，forum sort(member)

10.  同上，但是空格一行打印

. songbl ,gap forum
. songbl new,gap forum


11. 实时更新查看 The Stata Forums 的另一种输出风格

. songbl new,forum l

12. 输出标题中包含 [IV] 和 [GMM] 关键词的帖子

. songbl IV GMM,forum


13. 输出标题中包含 [IV] 和 [GMM] 关键词，并且跟贴数在5条以上的帖子

. songbl IV GMM,forum post(5)

14. 其他选择项的使用规范与推文检索一致

. songbl IV GMM,forum cls
. songbl IV GMM,forum gap
. songbl IV GMM,forum line
. songbl IV GMM,forum time


---

3-3 论文检索

• 资源介绍

推文资源主要包括，论文主要来自《中国工业经济》、《The Stata Journals》、《世界经济》、《南方经济》、《金融研究》、《财经研究》、《劳动经济研究》等期刊。目前已经一共收集了10000+篇的论文资源。其中，《中国工业经济》还包括论文数据与代码(.zip).

1. 查看论文资源的分类信息

. songbl paper

2. 查看《中国工业经济》论文导航

. songbl cie


3. 查看《The Stata Journals》论文导航

. songbl sj

• 选择项

选择项	描述
paper	论文资源的启动选择项。检索论文资源，并输出论文超链接。输入 ：songbl paper 浏览已有论文分类
cls	清屏后显示结果
nocat	不输出推文分类信息
time	输出检索所耗时间
gap	在输出的推文结果之间进行空格一行
line	搜索推文的另一种输出风格,具有表格划线
file(string)	括号内为文档类型，包括 do/txt/docx/pdf 等。例如 file(do) 表示在 stata 打开以 .do 结尾的 do 文档推文

• 操作实例

1. 输出 《金融研究》的论文超链接与数据

. songbl 金融研究,paper


2. 输出 《中国工业经济》企业出口的论文与数据超链接

. songbl 中国工业经济 企业出口,p

3. 输出 《中国工业经济》2021年第6期论文与数据超链接

. songbl 中国工业经济 2021 6,p


4. 其他选择项的使用规范与推文检索一致

. songbl 中国工业经济 企业出口,p g

. songbl 中国工业经济 企业出口,p l

. songbl 中国工业经济 企业出口,noc

. songbl 中国工业经济 企业出口,cls

. songbl 中国工业经济 企业出口 2018,p

. songbl 中国工业经济 + 世界经济,p

. songbl 中国工业经济 - 2016 - 2017 - 2018 -2019 - 2020 ,p

---

3-4 命令检索

• 资源介绍

命令资源主要包括，主要 SSC 外部命令的中文介绍. 外部命令资源。检索3000多个外部命令的中文介绍。1. 浏览最新外部命令

. songbl new,ssc


• 选择项

选择项	描述
ssc	外部命令资源的启动选择项。该选择项必须选定才能进行外部命令资源的检索
num(int)	指定要列出的最新推文的数量；N(10)是默认值,即展示检索结果的前10条。与 songbl new,ssc 搭配使用
cls	清屏后显示结果
nocat	不输出推文分类信息
time	输出检索所耗时间
gap	在输出的推文结果之间进行空格一行
line	搜索推文的另一种输出风格,具有表格划线

• 操作实例

1. 按照更新时间来查看命令，默认设置为前10条

. songbl new,ssc

2.  同上，但是空格一行打印

. songbl new,ssc gap


3. 查看前20条最新外部命令

. songbl new,ssc n(20)

4. 查看最新外部命令的另一种输出风格

. songbl new,ssc l


5. 输出标题中包含 [变量名] 关键词的外部命令

. songbl 变量名,ssc

---

3-5 文件检索

• 资源介绍

主要检索与快速打开电脑文件。常用于文件查找、文件浏览与文件操作。

• 选择项

选择项	描述
dir	当前目录路径下，电脑文件资源的递归搜索。支持* 、？等通配符，与strmatch（）函数的使用规则一致
maxdeep(int)	选定文件夹目录结构的层次，maxdeep(1)即搜索当前目录的文件夹。可以检索任意层次结构的文件夹，但是最多只打印8层文件夹
cls	清屏后显示结果
nocat	不输出推文分类信息
gap	在输出的推文结果之间进行空格一行
lcine	搜索推文的另一种输出风格,具有表格划线

• 操作实例

1. 打印当前目录所有文件

. songbl ,dir max(1)


2. 打印所有外部命令

. cd `c(sysdir_plus)'
. songbl ,dir

3. 打印外部命令所在的文件夹

. cd `c(sysdir_plus)'
. qui songbl ,dir


4. 打印所有外部命令,但是不呈现文件夹

. cd `c(sysdir_plus)'
. songbl ,dir noc

5. 打印所有外部命令的 [.ado] 文件

. cd `c(sysdir_plus)'
. songbl *.ado,dir


6. 搜索 [songbl.ado] 文件

. cd `c(sysdir_plus)'
. songbl songbl.ado,dir

7. 搜索 s 开头的文件

. cd `c(sysdir_plus)'
. songbl s*,dir


8. 搜索至少含有两个 s 的 ado 文件

. cd `c(sysdir_plus)'
. songbl *s*s*.ado,dir

9. 搜索 s 开头，并且是6个字符的ado文件

. cd `c(sysdir_plus)'
. songbl s?????.ado,dir


---

3-6 命令翻译

• 选择项

选择项	描述
fy	中文帮助文档资源。首先把帮助文档 .sthlp 文件转为 .html 文件，然后借助浏览器(chrome)中的网页翻译转为中文。

• 操作实例

1. 谷歌翻译 append 命令 Help 文档，借助浏览器(chrome)点击右键翻译转为中文。

. songbl append,fy

---

2. 打开翻译网站。

. songbl fy
. songbl fy1


3-7 网页搜索

• 选择项

选择项	描述
sou	网页搜索资源。搜索来源包括计量圈、百度、微信公众号、经管之家、知乎。

• 操作实例

1. 网页搜索关于 DID 的资源

. songbl DID,s

2. 网页搜索关于 PSM 的资源

. songbl PSM,s


3. 搜索'计量圈'关于 DID 的资源：键入 '计量圈' 的任意字符

. songbl DID,s(计)
. songbl DID,s(量圈)
. songbl DID,s(计量圈)

4. 搜索'经管之家'关于 PSM 的资源：键入 '经管之家' 的任意字符

. songbl PSM,s(经)
. songbl PSM,s(管)
. songbl PSM,s(经管之家)


5. 同时搜索'计量圈、百度、微信公众号、经管之家、知乎关于 'Stata' 的内容

. songbl Stata,s(all)

---

3-8 导航功能

• 操作实例

1.打开 《The Stata Journals》 期刊目录

. songbl sj


2.打开 《中国工业经济》 期刊目录

. songbl cie

3.ssci 论文导航

. songbl ssci


4.cssci 论文导航

. songbl cssci1

5.资源导航大全

. songbl all


6.推文主题分类导航

. songbl

7.知网经济学期刊分类导航

. songbl zw


8.常用Stata与学术网站导航

. songbl stata

9.常用社会科学数据库网站导航

. songbl data


10.可直接打开论文链接的期刊分类导航

. songbl paper

3-9 分享功能

• 功能介绍

主要是用于推文、帖子、论文等资源的分享。包括两种形式，一种是生成 Markdowm 格式的文本，主要用于通过博客来分享；一种是生成 [标题+链接] 格式的文本，主要用于通过微信、QQ等社交软件来分享。

• 选择项

选择项	描述
mlink	输出第1种 Markdown 形式的推文信息
mtext	输出第2种 Markdown 形式的推文信息
murl	输出第3种 Markdown 形式的推文信息
wlink	输出第1种 Weixin 分享形式推文信息
wtext	输出第2种 Weixin 分享形式推文信息
wurl	输出第3种 Weixin 分享形式推文信息
clip	点击超链接可以剪切分享推文，与 wlink 搭配使用
save(str)	save 选项将利用文档来打开分享的内容，包括 txt/md/docx/doc/xls/xlsx/sas 等。建议使用 save(txt) 格式输出
replace	作用同 save 选项，replace 选项将生成分享内容的 STATA 数据集。使用 replace 选项将会导致已导进 STATA 的数据被清空替换成分享内容的 STATA 数据集

• 操作实例

1.以推文标题：URL的形式输出结果

. songbl Stata教程,w


2.点击超链接可以剪切分享推文，与 Wlink 搭配使用

. songbl psm,wlink clip

3. 同 Wlink ，但输出的效果略有不同

. songbl Stata教程,wt


同上，但输出的效果略有不同**

. songbl Stata教程,wu

4.三种输出方式进行比较

. songbl 倍分法DID pdf,w wt wu cls


5.输出 markdowm 表格

. songbl new,l m

6.以 Markdown 格式输出推文链接

songbl DID pdf, m


7.同上，但输出的效果略有不同

. songbl DID 倍分法 pdf, mt

8.同上，但输出的效果略有不同

. songbl DID 倍分法 pdf, mu


9.三种输出方式进行比较

. songbl 倍分法 DID pdf,m mt mu cls

10.不输出推文分类信息

. songbl DID 倍分法, w m noc


11.利用 TXT 文档打开分享的内容

. songbl new ,m save(txt) line
. songbl sj-9,w save(txt) paper
. songbl sj-9,m save(txt) paper

12.生成分享内容的 STATA 数据集。注意：使用 replace 选项将会导致已导进 STATA 的数据被清空替换成分享的内容 STATA 数据集

. songbl sj-9,w replace paper
. songbl sj-9,m replace paper


3-10 其他功能

• 操作实例

1. 输出检索结果后面带有返回推文分类目录或者论文分类目录的快捷方式

. songbl PSM,time

2. 随机生成一篇推文、命令或者论文

. songbl r
. songbl r,ssc
. songbl r,paper


3. 随机生成一句话，激励科研工作者

. songbl care

4. 随机播放松柏林的歌单，科研的路途中少不了音乐。需要先安装 imusic 命令

. songbl music


5. Stata科研之余，消遣放松网站导航

. songbl happy

4. 宝贵建议

songbl 命令还不完善，大家使用过程中若发现 bugs 或有好的建议，可以通过以下邮箱反馈：

• 发邮件至 [e-mail]

5. 更新日期

• 2021年07月28日