*! version 1.2 17nov2023
help lianxh English Version

Title

lianxh -- 在 Stata 中快速搜索 lianxh.cn 推文，并采用多种方式呈现和输出。

Quick examples

. lianxh DID

. lianxh DID 多 +

. lianxh, new(10)

. lianxh, hot(10)

. lianxh 张 李, f(author) gsort(-click) hot(20) c d

简介

lianxh 是连享会编写的一个小程序,
目的在于让用户可以便捷地从 Stata 窗口中使用关键词检索
[连享会] 发布的推文。

若不附加任何选项，lianxh 会在 Stata 结果窗口中呈现查询结果。

通过设定 md, text 等选项，你可以呈现检索结果的 Markdown 文本或 txt 文本，以便插入个人笔记或通过微信/邮件分享给他人。

若辅以 hot(#), new(#), fromto() 等选项，可以筛选出特定时间段内、包含特定关键词的「点击量最高」, 「最新发布」的推文。

同时，使用 lianxh, links 可列出常用的 Stata 资源链接，包括 Stata 官网地址，Stata 官方
[FAQs]，
Stata 论坛 [Statalist]，
[Stata Journal]，
Stata online tutorial，
[论文重现资料] 等。

Syntax

lianxh
[keywords,
options]

Note 1：keywords 表示待检索的关键词，可以包含多个关键词。
若 keywords 为空，则呈现所有推文。

o 'k1 k2 k3' 表示检索词中包含 'k1' 或 'k2' 或 'k3';

o 'k1 k2 k3 +' 表示检索词中同时包含 'k1', 'k2' 和 'k3'

Note 2：fields(varlist) 和 exfields(varlist 选项用于控制检索或排除字段。

o 可用字段包括: author, title, keyword, catname，分别表示推文作者，推文标题，推文关键词和推文类别。

o 若用户输入 lianxh DID RDD 命令，但不设定 fields(varlist) 和 exfields(varlist 选项，

则 lianxh 会同时在 author, title, keyword 三个字段中检索指定关键词。

Options

Option Description

检索字段和时间范围

fields(varlist) 检索字段, 包括: author, catname, title, keyword
exclude(string) 需要排除的关键词, e.g. ex(Python); ex(py matlab +)
exfields(varlist 需要排除的关键词所在的检索字段, 同 fields(varlist) 选项
hot(#) 点击次数最多的 # 条, 不能与 new(#) 同时用
new(#) 最新的 # 条
fromto(string) 时间范围, e.g. from(2022), from(2021-10 2023-1)
updata 强制更新本地数据, 设定 new(#) 选项时自动生效, 耗时 2-3 秒

输出内容

clicktimes 显示点击次数
date 显示发布时间

输出风格

simple 极简风格. 仅呈现推文标题
numlist 显示推文序号. 设定此选项时自动加载 nocat 选项
browse 在浏览器中直接显示检索结果
gsortby(varlist) 检索结果按照 gsort varlist 排序.
varlist 可以是: click/view, date, author, catname, title
md Markdown 格式: - Author, Year, [title](URL), jname No.#.
md0 Markdown 格式: - [Author](url), Year, [title](URL), jname No.#.
md1 Markdown 格式: - [title](URL)
md2 Markdown 格式: - Author, Year, [title](URL)
mdc Markdown 正文引用: Author([Year](url_blog))
mdca Markdown 正文引用: [Author](author_link)([Year](url_blog))
latex TeX 格式: Author, Year, \href, jname No.#.
lac TeX 正文引用: Author(\href)
weixin 微信格式: Author, Year, title, URL
text 普通文本格式, 与 weixin 选项等价
view 查看存放检索结果的文档 (.md 或 .txt 格式)
jname(string) 设定推文专题名称. 默认值：连享会.
e.g. 孔亦泽, 2023, 拟合优度：R2知多少？. 连享会 No.1281.
控制和保存

cls 清屏后显示结果
nocat 不呈现推文分类信息
norange 不呈现检索时段 (很少用)
nopreserve 运行 lianxh 时，不执行 preserve 和 restore。
注意：当前内存中的数据会被替换为 lianxh.ado 产生的数据 (很少用)
savetopwd 将自动生成的 [_lianxh_temp_out_.md] 文件保存至当前工作路径，否则存入 PLUS 文件夹 (很少用)。
savedta(string) 保存检索结果原始数据为 Stata 数据文件 (很少用)。

Examples

o 基本用法

搜索包含关键词 'RDD' 的推文

. lianxh RDD

搜索包含关键词 'RDD' 或 '断点' 的推文

. lianxh RDD 断点

搜索包含关键词 'RDD' 和 '断点' 的推文 ('+' 可以放在检索式的任何位置))

. lianxh RDD 断点 +

呈现一些常用资源链接，包括：论文重现网站、在线课程等

. lianxh, links

o 设定检索字段和时间范围

仅在 '标题' 中检索关键词 'DID'

. lianxh DID, field(title)

Note: 默认情况下，同时在 三个字段中进行检索。

搜索所有 '张' 姓作者发表的推文

. lianxh 张, f(a)

Note: f(a) 是 field(author) 的简写。

呈现包含关键词 '面板数据'，但 和 字段中不包含关键词 '动态' 和 '空间' 的推文

. lianxh 面板数据, ex(动态 空间) exfield(t k)

时间范围：2022/1/1 以来

. lianxh DID, fromto(2022) d

时间范围：指定起始和结束日期

. lianxh 数据, fromto(2023-5-1 2023/10/31)

o 最新、最热、排序、点击量和发布时间

呈现最新发表的十篇推文

. lianxh, new(10)

按时间顺序呈现检索结果

. lianxh DID RDD, new(200)

呈现点击量最大的十篇推文

. lianxh, hot(10)

按点击量大小呈现检索结果

. lianxh DID RDD, hot(200)

按点击量由大到小排序，且显示点击次数 (clicktimes) 和发布时间 (date)

. lianxh 动态面板, gsort(-click) c d

依次按年份和点击量由大到小排序，其它同上

. lianxh DID, gsort(-year -click) c d

o 以 Markdown、Text 和 LaTeX 格式输出

以 Markdown 格式呈现搜索结果 (点击结果窗口中的蓝色 View 链接，复制更方便)

. lianxh PSM, md

. lianxh PSM, md0

. lianxh PSM, mdc

. lianxh PSM, mdca

更改推文系列名称

. lianxh PSM, md nocat jname(我最喜欢的推文)

通过邮件或微信分享推文信息时，可以使用 weixin 或 text 选项

. lianxh binscatter, w

. lianxh binscatter, t nocat

o 其它

清屏后显示检索结果

. lianxh DID, cls

强制更新本地数据

. lianxh DID, updata

Note: 默认情况下，lianxh 每天从 https://www.lianxh.cn 下载一份数据，存储到本地 [../PLUS/l] 文件夹中。随后的检索均使用本地数据，这样可以大幅提高检索速度。
若想更新到最新版，则可以使用 updata 选项。注意：不是 'update'，而是 'updata'。

安装最新版

. 方式 1：cnssc install lianxh, replace

. 方式 2：//gitee.com/arlionn/lianxh/raw/master/src/") replace"'

作者

Yujun, Lian* (连玉君) Lingnan College, Sun Yat-Sen University, China.

E-mail: arlionn@163.com

Blog: lianxh.cn

Junjie, Kang (康峻杰) Shanghai Jiaotong University, China.

E-mail: 642070192@qq.com

Ruihan, Liu (刘芮含) National University of Singapore, Singapore.

E-mail: 2428172451@qq.com

问题和建议

使用中有任何蹩脚之处，我们都会第一时间修改，请电邮至：
arlionn@163.com.

你也可以在项目的 Github 仓库 中填写 Issues 来提交你的建议。

Also see

Online:
songbl (if installed),
cnssc (if installed),
lxhuse (if installed)