Skip to content

Commit d447807

Browse files
arlionnarlionn
committed
up 2025.8.2
1 parent 064b8f3 commit d447807

9 files changed

Lines changed: 354 additions & 171 deletions

‎body/01_install_Python_Anaconda.ipynb‎

Lines changed: 62 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,10 @@
3434
"\n",
3535
"根据我的使用经验，基本步骤总结如下：\n",
3636
"\n",
37-
"1. **安装 Anaconda**。注意勾选 `Add Anaconda to my PATH environment variable` 和 `Register Anaconda as my default Python 3.x` 选项。\n",
38-
"2. **安装 VScode**。随后安装 `Python`, `Jupyter`, `Pylance`, `gitHub Copilot` (或 `codeium`, 现在更名为 `windsurf Plugin`), `Data Wrangler` 插件。\n",
39-
"3. **新建项目文件夹**。打开 VScode，新建一个文件夹，其下新建 **data**, **code**, **output** 等子文件夹，便于分类存放文档。\n",
37+
"1. **安装 Anaconda** 软件 (3.1 小节)。注意勾选 `Add Anaconda to my PATH environment variable` 和 `Register Anaconda as my default Python 3.x` 选项。\n",
38+
"2. **安装 VScode** 软件 (3.2 小节)。\n",
39+
" - 打开 **VScode** 软件，安装 VScode 插件：`Python`, `Jupyter`, `Pylance`, `gitHub Copilot` (或 `codeium`, 现在更名为 `windsurf Plugin`) 等。\n",
40+
"3. **新建项目文件夹** (可选)。打开 VScode，新建一个文件夹，其下新建 **data**, **code**, **output** 等子文件夹，便于分类存放文档。\n",
4041
"4. **新建 Jupyter Notebook 文件**。在主文件夹下新建 `xxx.ipynb` 文件，就可以开始编写代码了。\n",
4142
"\n",
4243
"下面，我详细说明每个步骤的操作。\n",
@@ -75,25 +76,24 @@
7576
"\n",
7677
" - 详情参见：[VSCode 与 Anaconda安装配置](https://blog.csdn.net/weixin_43679228/article/details/147256251)\n",
7778
"\n",
78-
"3. 安装完成后，打开 Anaconda Navigator（在开始菜单或应用程序中找到它）。\n",
79-
"\n",
80-
"4. 在 Anaconda Navigator 中，你可以创建和管理虚拟环境、安装包、启动 Jupyter Notebook 等。\n",
81-
"\n",
82-
"5. 安装完成后，打开 Anaconda Prompt（命令行界面），输入以下命令检查安装是否成功：\n",
79+
"3. 安装完成后，打开 Anaconda Prompt（命令行界面），输入以下命令检查安装是否成功：\n",
8380
"\n",
8481
" ``` bash\n",
8582
" conda --version\n",
8683
" ```\n",
87-
"\n",
84+
" \n",
8885
" 如果显示版本号，则表示安装成功。\n",
8986
"\n",
90-
"6. 在 Anaconda Prompt 中输入以下命令更新 Conda 到最新版本：\n",
87+
"::: {.callout-note}\n",
88+
"### 可选步骤\n",
89+
"\n",
90+
"1. 安装完成后，打开 Anaconda Navigator (在开始菜单或应用程序中找到它)。在 Anaconda Prompt 中输入以下命令更新 Conda 到最新版本：\n",
9191
"\n",
9292
" ``` bash\n",
9393
" conda update conda\n",
9494
" ```\n",
9595
"\n",
96-
"7. 创建一个新的虚拟环境（**可选**）：如果你想在一个独立的环境中工作，比如，你要同时使用 Python 3.8 和 Python 3.12，以便完成不同的项目，你可以创建一个新的虚拟环境。输入以下命令创建一个名为 `myenv38` 的虚拟环境，并安装 Python 3.8：\n",
96+
"2. 创建一个新的虚拟环境（**可选**）：如果你想在一个独立的环境中工作，比如，你要同时使用 Python 3.8 和 Python 3.12，以便完成不同的项目，你可以创建一个新的虚拟环境。输入以下命令创建一个名为 `myenv38` 的虚拟环境，并安装 Python 3.8：\n",
9797
"\n",
9898
" ``` bash\n",
9999
" conda create --name myenv38 python=3.8\n",
@@ -112,7 +112,8 @@
112112
" ```\n",
113113
"\n",
114114
" 此时，若执行 `canda list` 命令，你会看到当前环境中安装的所有包和版本信息；而执行 `canda install Stargazer, v = 2.1.1`，则会在当前环境中安装 `Stargazer` 包的 2.1.1 版本。\n",
115-
"\n"
115+
"\n",
116+
":::"
116117
]
117118
},
118119
{
@@ -241,31 +242,31 @@
241242
"\n",
242243
":::\n",
243244
"\n",
244-
"需要注意的是，`nbstata` 仅适用于 Stata 17+ 及以上版本 (配置了 `pystata`)。\n",
245+
"需要注意的是，`nbstata` 仅适用于 Stata 17+ 及以上版本 (配置了 `pystata`)，且 Stata 的安装路径中不包含中文字符和空格 (在 Stata 中输入 `sysdir` 可以查看你的 Stata 安装路径)。\n",
245246
"\n",
246247
"### 配置步骤\n",
247248
"\n",
248-
"首先，打开 VS Code 的终端 (快捷键：`Ctrl + ~` (ESC 键下方)；或者依次点击 VScode 顶部菜单 **Terminal** → **New Terminal**)，输入以下命令：\n",
249-
"\n",
250-
"```bash\n",
251-
"pip install nbstata\n",
252-
"```\n",
253-
"\n",
254-
"接下来按如下格式运行命令，语法规则为 (方括号表示选项)：\n",
255-
"\n",
256-
"```python\n",
257-
"python -m nbstata.install [--sys-prefix] [--prefix PREFIX] [--conf-file]\n",
258-
"```\n",
249+
"::: {.callout-important}\n",
250+
"### 注意\n",
259251
"\n",
260-
"其中，\n",
252+
"- 下面的配置步骤需要在 VS Code 的终端中完成，而不是在 Jupyter Notebook 中。\n",
253+
"- 打开 VS Code 的终端的方式参见 [5. Python 安装常见问题](02_install_FAQs.html) → `5.5 小节`。\n",
254+
"- 如果按下面的方法无法配置成功，可以参阅 [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",
261255
"\n",
262-
"- `--sys-prefix` 指定安装的环境，例如 virtualenv (虚拟环境) 或 conda env (Conda 环境)。 \n",
263-
"- `--prefix PREFIX` 指定安装路径。\n",
264-
"- `--conf-file` 将创建一个配置文件。\n",
256+
":::\n",
257+
"\n"
258+
]
259+
},
260+
{
261+
"cell_type": "markdown",
262+
"id": "0312eedb",
263+
"metadata": {},
264+
"source": [
265+
"首先，打开 VS Code 的**终端** (快捷键：`Ctrl + ~` (ESC 键下方)；或者依次点击 VScode 顶部菜单 **Terminal** → **New Terminal**)，依次执行以下命令：\n",
265266
"\n",
266-
"如果不需要更改安装的环境或路径，**推荐使用以下指令安装**：\n",
267+
"```bash\n",
268+
"pip install nbstata\n",
267269
"\n",
268-
"```python\n",
269270
"python -m nbstata.install --conf-file\n",
270271
"```\n",
271272
"\n",
@@ -277,7 +278,7 @@
277278
"\n",
278279
"你可以到此文件夹下，用 VScode 打开 `nbstata.conf` 文件，查看或修改配置。我的配置如下：\n",
279280
"\n",
280-
"```plaintext\n",
281+
"```py\n",
281282
"[nbstata]\n",
282283
"stata_dir = D:\\stata17\n",
283284
"edition = mp\n",
@@ -290,7 +291,7 @@
290291
"browse_auto_height = True\n",
291292
"```\n",
292293
"\n",
293-
"如果你目前还无法在 `.ipynb` 文件中运行 Stata 代码，可以尝试按如下方式修改 `nbstata.conf` 文件：\n",
294+
"完成上述配置后，`nbstata` 就可以在 VS Code 的 `.ipynb` 文件中运行 Stata 代码了 (参见下方的 **测试** 提示框)。如果受阻，可以尝试按如下方式修改 `nbstata.conf` 文件：\n",
294295
"\n",
295296
"- 在 Stata 命令窗口中输入 `sysdir` 命令，结果中第一行显示的就是 Stata 的安装路径：\n",
296297
"\n",
@@ -307,10 +308,37 @@
307308
"### 测试\n",
308309
"\n",
309310
"- 打开或新建一个 `.ipynb` 文件；\n",
310-
"- 点击 `+ Codes` 按钮，创建一个新的代码单元格，输入 `display 2 + 2`。\n",
311+
"- 点击 `+ Codes` 按钮，创建一个新的代码单元格，指定 Kernel 为 **Stata (nbstata)**，输入 `display 2 + 2`。\n",
311312
"- 按快捷键 `Shift + Enter` 或点击单元格左上角的 `Run` 按钮，若输出 `4`，说明配置成功。\n",
312313
"\n",
313-
":::\n"
314+
":::\n",
315+
"\n",
316+
"\n"
317+
]
318+
},
319+
{
320+
"cell_type": "markdown",
321+
"id": "88fbfde2",
322+
"metadata": {},
323+
"source": [
324+
"::: {.callout-caution}\n",
325+
"### 说明：`python -m nbstata.install` 的完整语法\n",
326+
"\n",
327+
"安装时，如果需要更改安装环境或安装路径，可以按如下语法规则编写命令 (方括号表示选项)：\n",
328+
"\n",
329+
"```python\n",
330+
"python -m nbstata.install [--sys-prefix] [--prefix PREFIX] [--conf-file]\n",
331+
"```\n",
332+
"\n",
333+
"其中，\n",
334+
"\n",
335+
"- `--sys-prefix` 指定安装的环境，例如 virtualenv (虚拟环境) 或 conda env (Conda 环境)。 \n",
336+
"- `--prefix PREFIX` 指定安装路径。\n",
337+
"- `--conf-file` 将创建一个配置文件。\n",
338+
"\n",
339+
"详情参见 [nbstata User Guide](https://hugetim.github.io/nbstata/user_guide.html)。\n",
340+
"\n",
341+
":::"
314342
]
315343
},
316344
{

‎body/02_install_FAQs.ipynb‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -68,18 +68,25 @@
6868
"- VSCode 中：按下 `Ctrl + Shift + P`，输入 `Terminal: Create New Terminal`，然后按下 `Enter` 键。\n",
6969
"\n",
7070
"\n",
71-
"## 如何打开 VScode 的控制台 (terminal)？\n",
71+
"## 如何打开 VScode 的终端/控制台 (terminal)？\n",
7272
"\n",
7373
"答：VScode 的 terminal 是一个集成的命令行界面，允许用户在 VScode 编辑器中直接执行命令行操作。它支持多种 Shell，如 PowerShell、Bash 和 Command Prompt 等。用户可以在 terminal 中运行 Python 脚本、安装包、管理版本控制等操作，而无需切换到外部命令行窗口。\n",
7474
"\n",
7575
"![](https://fig-lianxh.oss-cn-shenzhen.aliyuncs.com/20250513225516.png){width=600}\n",
7676
"\n",
7777
"**开启方法：**\n",
7878
"\n",
79-
"- 在 VScode 中，按下 `Ctrl + Shift + P`，输入 `Terminal: Create New Terminal`，然后按下 `Enter` 键。\n",
80-
"- 更快捷的方式：\n",
81-
" - Windows：按下 `Ctrl + ~` 键（`~` 在 `Esc` 键下方）。\n",
82-
" - Mac：按下 `Command + Shift + ~` 键。\n",
79+
"- **方法一：** 使用快捷键。\n",
80+
" - Windows 系统：在 VScode 中按下 `Ctrl + ~` 键（`~` 在 `Esc` 键下方）。\n",
81+
" - Mac 系统：按下 `Command + Shift + ~` 键。\n",
82+
"\n",
83+
"- **方法二：** 使用 VScode 命令面板。\n",
84+
" - 在 VScode 中，按下 `Ctrl + Shift + P`，输入 `Terminal: Create New Terminal`，然后按下 `Enter` 键。\n",
85+
"\n",
86+
"- **方法三：** 使用 Windows 命令行。\n",
87+
" - 在 Windows 系统中，按下 `Win + R` 键，输入 `cmd`，然后按下 `Enter` 键，打开命令提示符窗口。\n",
88+
" - 举例：输入 `pip install pkg_name` 来安装 Python 包。\n",
89+
"\n",
8390
"\n",
8491
"**用途：**\n",
8592
"\n",

‎body/03_markdown_marp.md‎

Lines changed: 65 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,18 @@ Markdown 是一种轻量级的标记语言，允许你使用易读易写的纯
2323

2424
以下是 [John Gruber](https://en.wikipedia.org/wiki/John_Gruber) 原始设计文档中列出的基本元素，所有 Markdown 应用程序都支持这些元素。
2525

26-
| 元素 | Markdown 语法 |
27-
| :-------------- | :------------------------------------------------------------- |
28-
| 标题 | `# 一级标题`<br>`## 二级标题`<br>`### 三级标题` |
29-
| 粗体 | `**粗体文本**` |
30-
| 斜体 | `*斜体文本*` |
31-
| 引用块 | `> 引用内容` |
32-
| 有序列表 | `1. 第一项`<br>`2. 第二项`<br>`3. 第三项` |
33-
| 无序列表 | `- 第一项`<br>&emsp; ` - 第一条`<br>`- 第二项`<br>`- 第三项` |
34-
| 代码高亮显示 | \`代码\` (\`xtreg\` &rarr; `xtreg`) |
35-
| 水平线 | `---` |
36-
| 链接 | `[连享会主页](https://www.lianxh.cn)` |
37-
| 图片 | `![图片标题](/Fig/image.jpg)` 或 `![](图片网址)` |
26+
| 元素 | Markdown 语法 |
27+
| :----------- | :------------------------------------------------------------- |
28+
| 标题 | `# 一级标题`<br>`## 二级标题`<br>`### 三级标题` |
29+
| 粗体 | `**粗体文本**` |
30+
| 斜体 | `*斜体文本*` |
31+
| 引用块 | `> 引用内容` |
32+
| 有序列表 | `1. 第一项`<br>`2. 第二项`<br>`3. 第三项` |
33+
| 无序列表 | `- 第一项`<br>&emsp; ` - 第一条`<br>`- 第二项`<br>`- 第三项` |
34+
| 代码高亮显示 | \`代码\` (\`xtreg\` &rarr; `xtreg`) |
35+
| 水平线 | `---` |
36+
| 链接 | `[连享会主页](https://www.lianxh.cn)` |
37+
| 图片 | `![图片标题](/Fig/image.jpg)` 或 `![](图片网址)` |
3838

3939
### 表格
4040

@@ -176,21 +176,25 @@ marp: true
176176
- xxx
177177
```
178178

179+
![](https://fig-lianxh.oss-cn-shenzhen.aliyuncs.com/Lianxh_装饰黄线.png)
179180

180181
### 模版 2：更多的设定
181182

182-
该模板的主要功能包括：
183+
::: {.callout-note}
184+
### 该模板的主要功能包括：
183185

184186
- 幻灯片的标题、作者、页码、脚注
185-
- 幻灯片的字号
187+
- 自定义幻灯片的正文字号
186188
- 标题的颜色和页面背景颜色
187189

190+
:::
191+
188192
```markdown
189193
---
190194
marp: true
191-
size: 16:9 # 宽版：4:3
192-
paginate: true # 显示页码
193-
footer: '脚注文本或 [xxx](URL)'
195+
size: 16:9 # 宽版：4:3
196+
paginate: true
197+
footer: '[lianxh.cn](https://www.lianxh.cn)&ensp;|&ensp;[Books](https://www.lianxh.cn/Books.html)'
194198
---
195199
196200
<style>
@@ -211,7 +215,9 @@ h2 {
211215
h3 {
212216
color: darkblue;
213217
}
214-
218+
h4 {
219+
color: brown;
220+
}
215221
/* 右下角添加页码 */
216222
section::after {
217223
content: attr(data-marpit-pagination) '/' attr(data-marpit-pagination-total);
@@ -223,6 +229,34 @@ footer {
223229
right: 50px;
224230
height: 25px;
225231
}
232+
/* 调整图片与文本之间的间距 */
233+
section img {
234+
margin-right: 10px; /* 设置图片右侧的间距 */
235+
margin-left: 10px; /* 设置图片左侧的间距 */
236+
}
237+
238+
/* 设置正文区域的边距，确保文本能更紧凑地放置 */
239+
section {
240+
#padding-right: 20px; /* 设置右侧边距 */
241+
#padding-left: 20px; /* 设置左侧边距 */
242+
}
243+
244+
/* ====== 新增：设置代码块字号 ====== */
245+
246+
/* 默认代码块字号 */
247+
pre {
248+
font-size: 22px;
249+
}
250+
251+
/* 可选类：小字号代码块 */
252+
.small-code pre {
253+
font-size: 12px;
254+
}
255+
256+
/* 可选类：大字号代码块 */
257+
.large-code pre {
258+
font-size: 20px;
259+
}
226260
</style>
227261
228262
<!--顶部文字-->
@@ -234,7 +268,10 @@ footer {
234268
![bg right:50% w:400 brightness:. sepia:50%](https://fig-lianxh.oss-cn-shenzhen.aliyuncs.com/20220722114227.png)
235269
236270
<!--幻灯片标题-->
237-
# Marp 参数设置
271+
272+
### 连享会 · 2025 暑期班 · 高级班
273+
274+
# B1. 动态面板门槛模型
238275
239276
<br>
240277
<br>
@@ -244,6 +281,7 @@ footer {
244281
arlionn@163.com
245282
246283
<br>
284+
247285
---
248286
<!-- backgroundColor: #FFFFF9 -->
249287
## 第一页幻灯片
@@ -267,9 +305,15 @@ arlionn@163.com
267305
- 宋森安, 2021, [用Markdown制作幻灯片-五分钟学会Marp（下篇）](https://www.lianxh.cn/details/657.html), 连享会 No.657.
268306
- 连玉君, 2022, [Marp幻灯片模板：用Markdown快速写幻灯片](https://www.lianxh.cn/details/1059.html), 连享会 No.1059.
269307

270-
## 用 Markdown 做简历
308+
## 用 Markdown 编写个人网站和简历
309+
310+
使用 Markdown 语法，你可以轻松地创建个人网站和简历。
311+
312+
你可以参考如下推文，轻松创建个人主页 (无需购买域名，也无需学习 HTML 和 CSS)：
313+
314+
- 连小白, 2025, [50 分钟搞定个人主页：Fork 模板 + GitHub Pages + Quarto 完整教程](https://www.lianxh.cn/details/1644.html)
271315

272-
Markdown 也可以用来制作简历。参见：
316+
Markdown 也可以用来制作简历，参见：
273317

274318
- [lapis-cv.bingyan.net](https://lapis-cv.bingyan.net)，[github](https://github.com/BingyanStudio/LapisCV)
275319
- [resume.todev.cc/](https://resume.todev.cc/)，[github](https://github.com/Dunqing/resume)

0 commit comments

Comments
 (0)