|
177 | 177 | "id": "29a3ebe9", |
178 | 178 | "metadata": {}, |
179 | 179 | "source": [ |
180 | | - "#### Python 和 Jupyter 插件\n", |
| 180 | + "### Python 和 Jupyter 插件\n", |
181 | 181 | "\n", |
182 | 182 | "为了能够在 VScode 中使用 Jupyter Notebook 运行 Python 代码,并借助 AI 提升工作效率,你需要安装以下插件:\n", |
183 | 183 | "\n", |
|
207 | 207 | "id": "f5b2c4cf", |
208 | 208 | "metadata": {}, |
209 | 209 | "source": [ |
210 | | - "#### Markdown 插件\n", |
| 210 | + "### Markdown 插件\n", |
211 | 211 | "\n", |
212 | 212 | "VScode 支持 Markdown 语法,可以用来编写文档、笔记等。安装 Markdown 插件可以增强 VScode 对 Markdown 的支持,比如预览、语法高亮、制作幻灯片等。多数情况下,安装如下三个插件就可以满足需求:\n", |
213 | 213 | "\n", |
|
222 | 222 | "你也可以点击 VScode 左边栏中的 `四个小方块` 图标,在搜索框中输入 `markdown`,酌情安装其他插件。" |
223 | 223 | ] |
224 | 224 | }, |
225 | | - { |
226 | | - "cell_type": "markdown", |
227 | | - "id": "8740de3b", |
228 | | - "metadata": {}, |
229 | | - "source": [ |
230 | | - "#### 其他插件\n", |
231 | | - "\n", |
232 | | - "根据个人需求,可以安装其他插件来增强 VScode 的功能,比如:\n", |
233 | | - "\n", |
234 | | - "- [Data Wrangler](https://marketplace.visualstudio.com/items?itemName=DataWrangler) (可选):表格呈现效果很美观。\n", |
235 | | - "- [Rainbow CSV](https://marketplace.visualstudio.com/items?itemName=mechatroner.rainbow-csv) (by *mechatroner*) 和 [CSV](https://marketplace.visualstudio.com/items?itemName=ReprEng.csv) (by *ReprEng*):CSV 文件的高亮显示和表格预览功能很棒。" |
236 | | - ] |
237 | | - }, |
238 | 225 | { |
239 | 226 | "cell_type": "markdown", |
240 | 227 | "id": "26526398", |
241 | 228 | "metadata": {}, |
242 | 229 | "source": [ |
243 | | - "#### Stata 插件 \n", |
| 230 | + "### Stata 插件 \n", |
244 | 231 | "\n", |
245 | 232 | "::: {.callout-important}\n", |
246 | 233 | "### 提示!\n", |
|
257 | 244 | "要顺利运行 Stata 代码,还需要安装 `nbstata` 包,下文将详细介绍。\n" |
258 | 245 | ] |
259 | 246 | }, |
| 247 | + { |
| 248 | + "cell_type": "markdown", |
| 249 | + "id": "7fe2a2e3", |
| 250 | + "metadata": {}, |
| 251 | + "source": [ |
| 252 | + "### 其他插件\n", |
| 253 | + "\n", |
| 254 | + "根据个人需求,可以安装其他插件来增强 VScode 的功能,比如:\n", |
| 255 | + "\n", |
| 256 | + "- [Data Wrangler](https://marketplace.visualstudio.com/items?itemName=DataWrangler) (可选):表格呈现效果很美观。\n", |
| 257 | + "- [Rainbow CSV](https://marketplace.visualstudio.com/items?itemName=mechatroner.rainbow-csv) (by *mechatroner*) 和 [CSV](https://marketplace.visualstudio.com/items?itemName=ReprEng.csv) (by *ReprEng*):CSV 文件的高亮显示和表格预览功能很棒。" |
| 258 | + ] |
| 259 | + }, |
260 | 260 | { |
261 | 261 | "cell_type": "markdown", |
262 | 262 | "id": "62ceab58", |
263 | 263 | "metadata": {}, |
264 | 264 | "source": [ |
265 | 265 | "## 配置 Stata 环境:nbstata\n", |
266 | 266 | "\n", |
267 | | - "为了在 VS Code 中的 `.ipynb` 文档中直接运行 Stata 代码,我们可以借助 [nbstata](https://hugetim.github.io/nbstata/) 扩展包 (注意:`nbstata` 是 Python 包,不是 VScode 插件)。下面介绍如何在已有 Python + Jupyter 环境基础上完成配置。\n", |
| 267 | + "如需在 VS Code 中的 `.ipynb` 文档中运行 Stata 代码,我们可以借助 [nbstata](https://hugetim.github.io/nbstata/) 扩展包 (注意:`nbstata` 是 Python 包,不是 VScode 插件)。下面介绍如何在已有 Python + Jupyter 环境基础上完成配置。\n", |
268 | 268 | "\n", |
269 | 269 | "::: {.callout-important}\n", |
270 | 270 | "### 前提条件:你已经完成以下配置\n", |
|
281 | 281 | "- Stata 的安装路径中不要包含中文字符和空格 (在 Stata 中输入 `sysdir` 可以查看你的 Stata 安装路径);\n", |
282 | 282 | "- Stata 安装目录下有 `STATA.LIC` 文件:该文件是 Stata 的授权文件,里面记录了 Stata 软件的序列号等信息。\n", |
283 | 283 | " - 有些用户使用的不是官方发布的 Stata 版本,或没有正确完成安装程序,都会导致该文件缺失,从而导致 `nbstata` 无法正常工作。\n", |
284 | | - "- `nbstata` 是在 Python 3.12 版本下开发和测试的,如果你在 Python 3.13 或更高版本环境下安装了 `nbstata`,可能会遇到兼容性问题,导致无法正常使用。因此,建议大家创建一个专属于 Stata 的虚拟环境。详情参见 **nbstata 安装和使用常见问题 🍎** 小节。\n", |
285 | | - "\n", |
| 284 | + "- `nbstata` 是在 Python 3.12 版本下开发和测试的,如果你在 Python 3.13 或更高版本环境下安装了 `nbstata`,可能会遇到兼容性问题,导致无法正常使用。因此,建议大家创建一个专属于 Stata 的虚拟环境,并在其中安装 Python 3.12 或更低的版本。详情参见 **nbstata 安装和使用常见问题 🍎** 小节。\n", |
| 285 | + "\n" |
| 286 | + ] |
| 287 | + }, |
| 288 | + { |
| 289 | + "cell_type": "markdown", |
| 290 | + "id": "386a95f5", |
| 291 | + "metadata": {}, |
| 292 | + "source": [ |
286 | 293 | "### 配置步骤\n", |
287 | 294 | "\n", |
288 | 295 | "::: {.callout-important}\n", |
289 | | - "### 注意\n", |
| 296 | + "### 注意:\n", |
290 | 297 | "\n", |
291 | 298 | "- 下面的配置步骤需要在 VS Code 的终端中完成,而不是在 Jupyter Notebook 中。\n", |
292 | 299 | "- 打开 VS Code 的终端的快捷键为 `Ctrl + ~`。详见 [Python 安装常见问题](01_03_install_FAQs.html)。\n", |
293 | 300 | "- 如果按下面的方法无法配置成功,可以参阅 [nbstata User Guide](https://hugetim.github.io/nbstata/user_guide.html) 和 [Jupyter + Stata 配置方法](https://industry.pengxianzhe.org/posts/jupyter-stata/#sec-vscode) (第 4 小节)。也可以打开 [豆包](https://www.douban.com/group/topic/297885930/),把你的错误代码截图和粘贴给它,多数情况下你都能在它的引导下完成配置。\n", |
294 | 301 | "- 我的学生倪璐同学写了一份详细的笔记,也可以参考:[如何在 VScode 的 Jupyter Notebook 中创建 Stata 代码单元](https://github.com/arlionn/Financial-Econometrics/blob/main/FAQs/How-to-create-a-Stata-code-cell_by-NiLu.md)。\n", |
295 | 302 | "\n", |
296 | 303 | ":::\n", |
297 | | - "\n" |
298 | | - ] |
299 | | - }, |
300 | | - { |
301 | | - "cell_type": "markdown", |
302 | | - "id": "0312eedb", |
303 | | - "metadata": {}, |
304 | | - "source": [ |
| 304 | + "\n", |
| 305 | + "\n", |
305 | 306 | "按快捷键 `Ctrl + ~` 打开 VS Code 的**终端**,依次执行以下命令:\n", |
306 | 307 | "\n", |
307 | 308 | "```bash\n", |
|
316 | 317 | "C:\\Users\\Administrator\\.config\\nbstata\\nbstata.conf\n", |
317 | 318 | "```\n", |
318 | 319 | "\n", |
319 | | - "你可以到此文件夹下,用 VScode 打开 `nbstata.conf` 文件,查看或修改配置。我的配置如下:\n", |
| 320 | + "你可以定位到上述路径,用 VScode 打开 `nbstata.conf` 文件,查看或修改配置。我的配置如下:\n", |
320 | 321 | "\n", |
321 | 322 | "```py\n", |
322 | 323 | "[nbstata]\n", |
323 | 324 | "stata_dir = D:\\stata17\n", |
324 | 325 | "edition = mp\n", |
325 | 326 | "splash = False\n", |
326 | | - "graph_format = png\n", |
| 327 | + "graph_format = png # 可选值:png, svg, pystata\n", |
327 | 328 | "graph_width = 7.5in\n", |
328 | 329 | "graph_height = 5.0in\n", |
329 | 330 | "echo = None\n", |
|
404 | 405 | "\n" |
405 | 406 | ] |
406 | 407 | }, |
407 | | - { |
408 | | - "cell_type": "markdown", |
409 | | - "id": "978b29af", |
410 | | - "metadata": {}, |
411 | | - "source": [ |
412 | | - "### nbstata 扩展信息\n", |
413 | | - "\n", |
414 | | - "有关 nbstata 的更多信息和使用方法,参见:\n", |
415 | | - "\n", |
416 | | - "- [nbstata 文档](https://hugetim.github.io/nbstata/),以及 [nbstata User Guide](https://hugetim.github.io/nbstata/user_guide.html)\n", |
417 | | - "- [Jupyter + Stata 配置方法](https://industry.pengxianzhe.org/posts/jupyter-stata/#sec-vscode),第 4 小节。\n", |
418 | | - "- 黄晨晨, 2023, [Jupyter Notebook 与 Stata 交互:nbstata](https://www.lianxh.cn/details/1309.html)\n", |
419 | | - "- 韩少真, 展金永, 2020, [珠联璧合 I:Jupyter Notebook 和 Stata 关联 (windows系统)](https://www.lianxh.cn/details/114.html)。这个推文介绍了如何在原生 Jupyter Notebook 中安装 `nbstata` 包。" |
420 | | - ] |
421 | | - }, |
422 | 408 | { |
423 | 409 | "cell_type": "markdown", |
424 | 410 | "id": "a06bdb87", |
|
526 | 512 | " ```" |
527 | 513 | ] |
528 | 514 | }, |
| 515 | + { |
| 516 | + "cell_type": "markdown", |
| 517 | + "id": "90aa8734", |
| 518 | + "metadata": {}, |
| 519 | + "source": [ |
| 520 | + "### nbstata 扩展信息\n", |
| 521 | + "\n", |
| 522 | + "有关 nbstata 的更多信息和使用方法,参见:\n", |
| 523 | + "\n", |
| 524 | + "- [nbstata 文档](https://hugetim.github.io/nbstata/),以及 [nbstata User Guide](https://hugetim.github.io/nbstata/user_guide.html)\n", |
| 525 | + "- [Jupyter + Stata 配置方法](https://industry.pengxianzhe.org/posts/jupyter-stata/#sec-vscode),第 4 小节。\n", |
| 526 | + "- 黄晨晨, 2023, [Jupyter Notebook 与 Stata 交互:nbstata](https://www.lianxh.cn/details/1309.html)\n", |
| 527 | + "- 韩少真, 展金永, 2020, [珠联璧合 I:Jupyter Notebook 和 Stata 关联 (windows系统)](https://www.lianxh.cn/details/114.html)。这个推文介绍了如何在原生 Jupyter Notebook 中安装 `nbstata` 包。" |
| 528 | + ] |
| 529 | + }, |
529 | 530 | { |
530 | 531 | "cell_type": "markdown", |
531 | 532 | "id": "b190c802", |
|
0 commit comments