From 6c5cc7e10939e375f1a896e3db72a7fa0b6b27cd Mon Sep 17 00:00:00 2001 From: taoky Date: Sat, 22 Aug 2026 20:59:52 +0800 Subject: [PATCH 1/4] typo fix --- README.md | 2 -- docs/Spec/writing.md | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/README.md b/README.md index a301ab9e..b2efefdb 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,4 @@ ## Star History -## Star History - [![Star History Chart](https://api.star-history.com/chart?repos=ustclug/Linux101-docs&type=date&legend=top-left&sealed_token=JwfjxFM4BxMmWD5rSEjCC0aQhg-XeNw-qRGkT2NkTVl4OhUfO3ipd9CmY689uu1KJu8KG4HuRKV6x5V39rgYfktSicvvZdw0d4e_Zisitmque1tF_F6vKAavkfZlxAfq9-gLiFqWuau0ZF_vkS-Sdv34JPk4SpP1j0HoouZa3k7mFqHOuchFnMM2i5oo)](https://www.star-history.com/?repos=ustclug%2FLinux101-docs&type=date&legend=top-left) diff --git a/docs/Spec/writing.md b/docs/Spec/writing.md index b7d7c0b0..d047b5d8 100644 --- a/docs/Spec/writing.md +++ b/docs/Spec/writing.md @@ -26,7 +26,7 @@ ### 在本地随时预览当前主题下的格式 {#local-preview} -目前当前的主题已经确定为 Material，可以使用诸如 `pip install mkdocs-material` 等命令完成主题的安装，并在工作根目录下使用 `mkdocs serve` 命令并访问 来实时预览，这对讲义的编写十分有帮助。 +目前主题已经确定为 Material，可以使用诸如 `pip install mkdocs-material` 等命令完成主题的安装，并在工作根目录下使用 `mkdocs serve` 命令并访问 来实时预览，这对讲义的编写十分有帮助。 更全面的安装和配置信息请参考 [MkDocs 官网](https://www.mkdocs.org) 和 [Material for MkDocs 官网](https://squidfunk.github.io/mkdocs-material/)。 From b758003300a73e6fcd7b1232f7667bf835c7aea1 Mon Sep 17 00:00:00 2001 From: taoky Date: Sat, 22 Aug 2026 21:10:28 +0800 Subject: [PATCH 2/4] emphasize python venv --- README.md | 2 +- docs/Spec/writing.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b2efefdb..104cf36c 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ## 如何构建？ -1. （建议）使用 `python3 -m venv venv` 创建虚拟环境，`. venv/bin/activate` 进入虚拟环境； +1. 使用 `python3 -m venv venv` 创建虚拟环境，`. venv/bin/activate` 进入虚拟环境； 2. 使用 `pip install -r requirements.txt` 安装依赖； 3. 使用 `mkdocs serve` 构建并查看效果。 diff --git a/docs/Spec/writing.md b/docs/Spec/writing.md index d047b5d8..467423b1 100644 --- a/docs/Spec/writing.md +++ b/docs/Spec/writing.md @@ -6,7 +6,7 @@ 在每一章的开始都需要编写章节导言。导言的目的有两个：一是为了铺垫一些前置知识以方便后续展开正文；二是写出一个内容摘要来辅助读者和编者自己快速了解该章节的核心内容和脉络。编写导言时可以自己组织语言，以简练为主，不需要面面俱到。 - “章节编写指导”是一份写给该讲义的创作者所用的参考教程。在接下来的编写中，推荐在本地也安装一个 MkDocs 来实时预览项目。MkDocs 基于 Python，故可以使用诸如 `pip install mkdocs` 等命令完成安装。更全面的安装流程请参考 [MkDocs 官网安装说明](https://www.mkdocs.org/#installation) 实现。 + “章节编写指导”是一份写给该讲义的创作者所用的参考教程。在接下来的编写中，推荐在本地也安装一个 MkDocs 来实时预览项目。MkDocs 基于 Python，故可以在创建 Python 虚拟环境后使用诸如 `pip install mkdocs` 等命令完成安装。更全面的安装流程请参考 [MkDocs 官网安装说明](https://www.mkdocs.org/#installation) 实现。 使用形如 `!!! abstract "导言"` 的方式添加一个导言框，并在下面若干行通过缩进 1 个制表符或 4 个空格的方式填写导言里的内容，行与行之间请空 1 行。 @@ -26,7 +26,7 @@ ### 在本地随时预览当前主题下的格式 {#local-preview} -目前主题已经确定为 Material，可以使用诸如 `pip install mkdocs-material` 等命令完成主题的安装，并在工作根目录下使用 `mkdocs serve` 命令并访问 来实时预览，这对讲义的编写十分有帮助。 +目前主题已经确定为 Material，可以在创建 Python 虚拟环境后使用诸如 `pip install mkdocs-material` 等命令完成主题的安装，并在工作根目录下使用 `mkdocs serve` 命令并访问 来实时预览，这对讲义的编写十分有帮助。 更全面的安装和配置信息请参考 [MkDocs 官网](https://www.mkdocs.org) 和 [Material for MkDocs 官网](https://squidfunk.github.io/mkdocs-material/)。 From 9068686246db404abb4a744c6a4744bd8d3d0685 Mon Sep 17 00:00:00 2001 From: taoky Date: Sat, 22 Aug 2026 21:12:18 +0800 Subject: [PATCH 3/4] Add Appendix/debug stub --- docs/Appendix/debug.md | 3 +++ mkdocs.yml | 1 + 2 files changed, 4 insertions(+) create mode 100644 docs/Appendix/debug.md diff --git a/docs/Appendix/debug.md b/docs/Appendix/debug.md new file mode 100644 index 00000000..abbbbfdf --- /dev/null +++ b/docs/Appendix/debug.md @@ -0,0 +1,3 @@ +# 常见故障排查 + +(TBD) diff --git a/mkdocs.yml b/mkdocs.yml index 1218a38f..95c7e1e8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -115,6 +115,7 @@ nav: - Ch09/index.md - 拓展阅读: Ch09/supplement.md - 附录: + - 常见故障排查: Appendix/debug.md - Markdown 教程: Appendix/markdown.md - man 文档的一些示例: Appendix/man.md - 其他的 Linux 发行版：技术差异简介: Appendix/distribution.md From 3cb915236685207a7fce364d43ef1b8ae6af88d1 Mon Sep 17 00:00:00 2001 From: taoky Date: Sat, 22 Aug 2026 21:15:48 +0800 Subject: [PATCH 4/4] Ubuntu Pro status update --- docs/Ch01/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Ch01/index.md b/docs/Ch01/index.md index 385613df..3f0fc3fc 100644 --- a/docs/Ch01/index.md +++ b/docs/Ch01/index.md @@ -358,6 +358,6 @@ LUG@USTC 欢迎校内外的朋友加入社群交流。如果你是中国科学 [^2]: 信息来自维基百科条目：[操作系统](https://zh.wikipedia.org/wiki/%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F)。 -[^3]: 尽管有许多说法称 Ubuntu LTS 有十年的支持，但是后五年实际上是 Extended Security Maintenance (ESM) 阶段，需要付费的 Ubuntu Advantage 订阅，或者最多 3 台设备的个人免费订阅。ESM 的安全更新仓库与主仓库也是独立的，需要登录后才能访问。 +[^3]: 尽管有许多说法称 Ubuntu LTS 有十年的支持，但是其中前五年为标准支持，后五年实际上是 Extended Security Maintenance (ESM) 阶段，需要 Ubuntu Pro（原 Ubuntu Advantage）订阅。Ubuntu Pro 商用需要付费，个人免费订阅支持最多 5 台设备。ESM 的安全更新仓库与主仓库也是独立的，需要登录后才能访问。 [^4]: 数据来自 Ubuntu 介绍：[The Ubuntu lifecycle and release cadence](https://ubuntu.com/about/release-cycle)。