修复lecture1文档链接，修复插件问题

ckc-agc · Sep 25, 2023 · be6959b · be6959b
1 parent 4731578
commit be6959b
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 32 deletions.
diff --git a/README.md b/README.md
@@ -12,11 +12,12 @@
 
 - [neoteroi.cards](https://www.neoteroi.dev/mkdocs-plugins/cards/)
 - [GLightbox](https://github.com/blueswen/mkdocs-glightbox)
+- [mkdocs-heti-plugin](https://github.com/TonyCrane/mkdocs-heti-plugin)
 
 安装 MkDocs 及相关插件：
 
 ```bash
-pip install mkdocs mkdocs-material neoteroi-mkdocs mkdocs-glightbox
+pip install mkdocs mkdocs-material neoteroi-mkdocs mkdocs-glightbox mkdocs-heti-plugin
 ```
 
 本地构建与查看：

diff --git a/docs/programming_lecture/lecture1/pre_class.md b/docs/programming_lecture/lecture1/pre_class.md
@@ -17,17 +17,17 @@
   {
     "title": "运行窗口",
     "content": "使用 Win + R 组合键，将会出现如下窗口。这就是运行窗口，可以在其中输入命令运行，即使是 Windows XP 都可以使用。",
-    "image": "../graph/WinR.png"
+    "image": "graph/WinR.png"
   },
   {
     "title": "命令提示符 CMD",
     "content": "在其中输入 `cmd` 后回车，就会出现**命令提示符**，如下图所示",
-    "image": "../graph/cmd.png"
+    "image": "graph/cmd.png"
   },
   {
     "title": "Windows Terminal",
     "content": "但是命令提示符功能有限，也不是很美观，推荐安装 **Windows Terminal**（终端）。在 Microsoft Store 中搜索 terminal，出现如下的选项，然后选择安装即可。",
-    "image": "../graph/windows_terminal.png"
+    "image": "graph/windows_terminal.png"
   },
 
 
@@ -93,8 +93,6 @@ wsl --import Ubuntu D:\wsl\ubuntu D:\wsl\ubuntu\ubuntu.tar
 
 以上操作完成后，登录 Ubuntu 将会默认以 root 用户打开。但是 root 用户具有最高权限，胡乱操作容易出问题，以及 root 用户的颜色是白色的，不是特别好看，因此可以修改默认的登录用户。首先**在 WSL 外**输入以下指令以停止 WSL：
 
-> 如果不知道 WSL 外是什么意思，参考[“WSL 外” 和 “WSL 内”](../../faq/#wsl-wsl)
-
 ```
 wsl --shutdown
 ```
@@ -107,14 +105,14 @@ Ubuntu config --default-user zhou
 使用终端的一大好处是方便打开 WSL。如下图所示，点击 Ubuntu 22.04.2 LTS 或者使用 Ctrl + Shift + 5 组合键就可以方便地打开 Ubuntu 22.04。当然这是因为我安装的是 `Ubuntu 22.04` 的缘故，在你们的电脑中显示的应该就是 `Ubuntu`。
 
 <div style="text-align:center;">
-<img src="../graph/wsl_terminal.png" alt="wsl_terminal" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/wsl_terminal.png" alt="wsl_terminal" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 其他 WSL 的使用方法留待你们慢慢探索了，在此不再赘述。
 
 ## 安装 C 语言编译器
 
-!!! info "本篇相对比较复杂，如果在本篇配置遇到难以解决的困难，而作业/实验截止日期快要到了，可以跳过本篇参考 [下一篇](local_env.md) 安装 Dev-C++ 进行临时开发。"
+!!! info "本篇相对比较复杂，如果在本篇配置遇到难以解决的困难，而作业/实验截止日期快要到了，可以跳过本篇安装 Dev-C++ 进行临时开发。"
 
 写完了 C 语言代码，我们需要让它变成能跑的程序，这就需要准备 C 语言的编译器支持。以下主要介绍 Windows 系统的配置。
 
@@ -124,11 +122,11 @@ Ubuntu config --default-user zhou
 
 gcc，全称 GNU Compiler Collection，著名的自由软件，被许多现代类 Unix 操作系统采用为标准编译器，但是 Windows 上并不直接支持。我们想要在 Windows 系统上使用，一般得依赖 MinGW 的 gcc，tdm-gcc 也是基于 MinGW 的 gcc 来的。
 
-!!! info "有能力的同学推荐在 Windows 上开启 WSL，使用 WSL 进行 C 语言开发。WSL 可以理解为在 Windows 的电脑中模拟一个 Linux 的小系统，从而能方便地控制环境。[WSL 安装简单引导](../windows_lost/#wsl)提供了一个简单的引导。"
+!!! info "有能力的同学推荐在 Windows 上开启 WSL，使用 WSL 进行 C 语言开发。WSL 可以理解为在 Windows 的电脑中模拟一个 Linux 的小系统，从而能方便地控制环境。"
 
 ### Windows 小白教程之 tdm-gcc
 
-> 前面选择了 WSL 的同学可以自行配置或者参考 [WSL 安装简单引导](../windows_lost/#wsl)，然后再看[第 3 节](#gcc_1)。Mac 用户可以直接看[第 3 节](#gcc_1)。
+> 前面选择了 WSL 的同学可以自行配置，然后再看[第 3 节](#gcc_1)。Mac 用户可以直接看[第 3 节](#gcc_1)。
 
 可以按照老师的视频教程下载 [tdm-gcc](https://jmeubank.github.io/tdm-gcc/download/)，目前最新版为 gcc 10.3.0。
 
@@ -139,38 +137,38 @@ gcc，全称 GNU Compiler Collection，著名的自由软件，被许多现代
     点击 Win 键，输入“关于”，如下图所示。打开“关于你的电脑”后就可以看到电脑是不是 64 位了，新电脑一般都是 64 位。
 
     <div style="text-align:center;">
-        <img src="../graph/win11_about.png" alt="win11_about" style="margin: 0 auto; zoom: 60%;"/>
+        <img src="graph/win11_about.png" alt="win11_about" style="margin: 0 auto; zoom: 60%;"/>
     </div>
 
 === "Windows 10"
 
     桌面找到“此电脑”，右键属性
 
     <div style="text-align:center;">
-        <img src="../graph/pc_right_attr.png" alt="pc_right_attr" style="margin: 0 auto; zoom: 80%;"/>
+        <img src="graph/pc_right_attr.png" alt="pc_right_attr" style="margin: 0 auto; zoom: 80%;"/>
     </div>
 
     可以看到是 64 位系统还是 32 位系统。
 
     <div style="text-align:center;">
-        <img src="../graph/win10_x64.png" alt="win10_x64" style="margin: 0 auto; zoom: 60%;"/>
+        <img src="graph/win10_x64.png" alt="win10_x64" style="margin: 0 auto; zoom: 60%;"/>
     </div>
 
 64 位系统直接下载 tdm64-gcc-10.3.0-2.exe 安装即可，32 位则选择 tdm-gcc-10.3.0.exe。
 
 准备安装。对于零基础的同学，电脑里应该还没装过 tdm-gcc，选择 create 即可。
 <div style="text-align:center;">
-    <img src="../graph/tdmgcc_create.png" alt="tdmgcc_create" style="margin: 0 auto; zoom: 40%;"/>
+    <img src="graph/tdmgcc_create.png" alt="tdmgcc_create" style="margin: 0 auto; zoom: 40%;"/>
 </div>
 接下来就是根据 64/32 位系统选择对应的版本
 
 <div style="text-align:center;">
-    <img src="../graph/tdm32_or_64.png" alt="tdm32_or_64" style="margin: 0 auto; zoom: 40%;"/>
+    <img src="graph/tdm32_or_64.png" alt="tdm32_or_64" style="margin: 0 auto; zoom: 40%;"/>
 </div>
 选择安装路径，推荐零基础同学选择默认路径（如 64 位的 `C:\TDM-GCC-64`）
 
 <div style="text-align:center;">
-    <img src="../graph/tdmgcc_path.png" alt="tdmgcc_path" style="margin: 0 auto; zoom: 40%;"/>
+    <img src="graph/tdmgcc_path.png" alt="tdmgcc_path" style="margin: 0 auto; zoom: 40%;"/>
 </div>
 
 接下来是要认真考虑的页面。
@@ -183,7 +181,7 @@ gcc，全称 GNU Compiler Collection，著名的自由软件，被许多现代
     - **建议选上**。如果不选或者忘选了，将会需要自己配置 tdm-gcc 的环境变量路径。
 
 <div style="text-align:center;">
-    <img src="../graph/tdmgcc_install_items.png" alt="tdmgcc_install_items" style="margin: 0 auto; zoom: 40%;"/>
+    <img src="graph/tdmgcc_install_items.png" alt="tdmgcc_install_items" style="margin: 0 auto; zoom: 40%;"/>
 </div>
 
 > 如果希望用更新版本的 gcc 可以使用 [winlibs 编译的 mingw-gcc](https://winlibs.com/)，或者你可以自己选择。
@@ -197,8 +195,6 @@ gcc，全称 GNU Compiler Collection，著名的自由软件，被许多现代
     compilation terminated.
     ```
 
-    !!! info "不了解 Windows 上的命令提示符/终端的同学可以参考[运行与终端](../windows_lost/#_1)"
-
     如果没有，可能是你还没有安装 gcc，或者你前一步 `Add to PATH` 没有正常进行，可能需要参照 [Windows 修改环境变量](#windows)进行环境变量的检查。
 
     命令提示符/终端中输入 `gcc --version`，应当出现类似如下的信息。
@@ -255,7 +251,7 @@ gcc，全称 GNU Compiler Collection，著名的自由软件，被许多现代
 检查一下环境变量，Win + R 键输入 `sysdm.cpl` 后回车，会出现 “系统属性” 界面，选择 “高级”，如下图所示：
 
 <div style="text-align:center;">
-<img src="../graph/env_var.png" alt="env_var" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/env_var.png" alt="env_var" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 打开环境变量，在 “系统变量” 或者 “用户变量” 中找到 PATH 变量，在其中增加一项 tdm-gcc 的路径。例如你如果默认安装 tdm-gcc，那么路径可能就是 `C:\TDM-GCC-64\bin`。
@@ -299,33 +295,33 @@ VSCode 直接从[官网](https://code.visualstudio.com/)选择自己平台对应
 打开 VSCode 后，在左侧竖栏寻找下面这个图标：
 
 <div style="text-align:center;">
-<img src="../graph/plugin.png" alt="plugin" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/plugin.png" alt="plugin" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 点击这个图标就进入了插件管理。建议可以安装下面两个插件：
 
 - C/C++: 微软自家的插件，可用于**语法识别、代码高亮**
 
 <div style="text-align:center;">
-<img src="../graph/plugin_ccpp.png" alt="plugin_ccpp" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/plugin_ccpp.png" alt="plugin_ccpp" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 - Chinese(Simplified): 界面汉化插件（可选）
 
 <div style="text-align:center;">
-<img src="../graph/plugin_chinese.png" alt="plugin_chinese" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/plugin_chinese.png" alt="plugin_chinese" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 安装汉化插件后可能需要你手动切换显示语言。Ctrl + Shift + P，出现的搜索框中输入 Configure，选择 Configure Display Language。
 
 <div style="text-align:center;">
-    <img src="../graph/config_language.png" alt="config_language" style="margin: 0 auto; zoom: 50%;"/>
+    <img src="graph/config_language.png" alt="config_language" style="margin: 0 auto; zoom: 50%;"/>
 </div>
 
 随后再选择“中文(简体)”就可以完成界面汉化了。
 
 <div style="text-align:center;">
-    <img src="../graph/chinese_english.png" alt="chinese_english" style="margin: 0 auto; zoom: 50%;"/>
+    <img src="graph/chinese_english.png" alt="chinese_english" style="margin: 0 auto; zoom: 50%;"/>
 </div>
 
 > 英语基础不太好的同学有困难可以使用，英语基础比较好以及想要在日常实践中学习英语的同学建议跳过这一步。
@@ -351,7 +347,7 @@ VSCode 直接从[官网](https://code.visualstudio.com/)选择自己平台对应
 鼠标移动到工作区，按 `New File` 键可以新建文件，旁边有新建文件夹按键。当然，直接在左侧工作目录右键也可以新建文件/文件夹。
 
 <div style="text-align:center;">
-<img src="../graph/newfile.png" alt="newfile" style="margin: 0 auto; zoom: 60%;"/>
+<img src="graph/newfile.png" alt="newfile" style="margin: 0 auto; zoom: 60%;"/>
 </div>
 
 创建 `test.c`，输入 Hello World 的代码并**保存文件**。然后在终端输入以下命令并执行：
@@ -406,13 +402,13 @@ gcc test.c -o hello.exe
 安装 WSL 插件，如下图所示：
 
 <div style="text-align:center;">
-<img src="../graph/plugin_WSL.png" alt="plugin_WSL" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/plugin_WSL.png" alt="plugin_WSL" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 或者你也可以像官方文档那样，直接安装整个 Remote Development 扩展包：
 
 <div style="text-align:center;">
-<img src="../graph/plugin_remote.png" alt="plugin_remote" style="margin: 0 auto; zoom: 80%;"/>
+<img src="graph/plugin_remote.png" alt="plugin_remote" style="margin: 0 auto; zoom: 80%;"/>
 </div>
 
 其中不仅有 WSL，还包括另外三个非常有用的远程开发插件。
@@ -437,4 +433,4 @@ code .
 
 就可以打开 VSCode，连接到 WSL 并且打开该目录作为工作目录。`.` 在这里表示当前目录即 `pwd`，如果将它替换成其他目录的路径也是可以将其打开作为工作目录的。
 
-如果你还未将 VSCode 添加到 PATH 环境变量中，那该功能将无法使用，需要你手动添加 VSCode 到 PATH 环境变量。例如你的 Windows 用户名是 ZTM，并把 VSCode 安装在默认目录，那么需要将 `C:\Users\ZTM\AppData\Local\Programs\Microsoft VS Code\bin` 加入到 PATH 环境变量，参考 [Windows 修改环境变量](../C_compiler/#windows)。
+如果你还未将 VSCode 添加到 PATH 环境变量中，那该功能将无法使用，需要你手动添加 VSCode 到 PATH 环境变量。例如你的 Windows 用户名是 ZTM，并把 VSCode 安装在默认目录，那么需要将 `C:\Users\ZTM\AppData\Local\Programs\Microsoft VS Code\bin` 加入到 PATH 环境变量，参考 Windows 修改环境变量章节。
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -118,6 +118,9 @@ nav:
   - 首页: index.md
   - 程设线下辅学:
     - programming_lecture/index.md
+    - 1. 程序编译过程与调试:
+      - 准备开发与调试环境: programming_lecture/lecture1/pre_class.md
+      - 课程讲义: programming_lecture/lecture1/lecture1.md
   - 微积分:
     - calculus/index.md
   - 数学分析:
@@ -131,8 +134,8 @@ nav:
     - FAQ: programming/faq.md
     - 历年卷:
       - programming/exam/index.md
-      - C 小历年卷常见问题总结: programming/exam/fp.md
-      - C 大历年卷常见问题总结: programming/exam/lcp.md
-    - 2023 年辅学资料: programming/2023/index.md
+#      - C 小历年卷常见问题总结: programming/exam/fp.md
+#      - C 大历年卷常见问题总结: programming/exam/lcp.md
+#    - 2023 年辅学资料: programming/2023/index.md
   - 普通化学:
     - chemistry/index.md