Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` 构建并查看效果。

Expand All @@ -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)
3 changes: 3 additions & 0 deletions docs/Appendix/debug.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 常见故障排查

(TBD)
2 changes: 1 addition & 1 deletion docs/Ch01/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)。
4 changes: 2 additions & 2 deletions docs/Spec/writing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 行。

Expand All @@ -26,7 +26,7 @@

### 在本地随时预览当前主题下的格式 {#local-preview}

目前当前的主题已经确定为 Material,可以使用诸如 `pip install mkdocs-material` 等命令完成主题的安装,并在工作根目录下使用 `mkdocs serve` 命令并访问 <http://127.0.0.1:8000> 来实时预览,这对讲义的编写十分有帮助。
目前主题已经确定为 Material,可以在创建 Python 虚拟环境后使用诸如 `pip install mkdocs-material` 等命令完成主题的安装,并在工作根目录下使用 `mkdocs serve` 命令并访问 <http://127.0.0.1:8000> 来实时预览,这对讲义的编写十分有帮助。

更全面的安装和配置信息请参考 [MkDocs 官网](https://www.mkdocs.org) 和 [Material for MkDocs 官网](https://squidfunk.github.io/mkdocs-material/)。

Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down