Style update [1/?]

Author: taoky

.markdownlint.jsonc

@@ -1,4 +1,5 @@
 {
-    "MD046": false,
+    "MD046": false,  // Always use code blocks for commands and outputs.
+    "MD014": false,  // Linux 101 always prepend '$' or '#' to command lines.
     "extends": "node_modules/markdownlint/style/prettier.json",
 }

docs/Appendix/man.md

@@ -46,7 +46,7 @@
 
 ## 命令行工具：以 `su` 为例
 
-```
+```text
 SU(1)                            User Commands                           SU(1)
 （第一行的标题是 User Commands，两边的 SU(1) 代表这篇文档是关于 `su` 的，在文档第一卷。
 第一卷与 Shell 命令和程序有关。更多信息可以查看 man man 中 DESCRIPTION 一节的内容。）
@@ -262,7 +262,7 @@ util-linux                         July 2014                             SU(1)
 
 文档第三卷是程序库函数的信息，包括了 C 语言的标准库函数。
 
-```
+```text
 STRCMP(3)                  Linux Programmer's Manual                 STRCMP(3)
 
 NAME
@@ -320,7 +320,7 @@ COLOPHON（作者信息、文档来源等信息）
 
 文档第二卷是关于系统调用的信息。当然，很多系统调用都由 C 运行时库包装了一层，否则用起来很麻烦。一个目前还没有被包装的系统调用的例子是 `copy_file_range()`，你需要在你的代码里面使用 `syscall()` 去手动包装它，才能方便地使用。
 
-```
+```text
 KILL(2)                    Linux Programmer's Manual                   KILL(2)
 
 NAME

docs/Ch01/index.md

@@ -93,14 +93,14 @@ Linux 内核并不是一个完整的操作系统，因为它过于精简，单
 
 Debian 是一个完全由自由软件构成的类 UNIX 操作系统，第一个版本发布于 1993 年 9 月 15 日，迄今仍在维护，是最早的发行版之一。其以坚持自由软件精神和生态环境优良而出名，拥有庞大的用户群体，甚至自己也成为了一个主流的子框架，称为“Debian GNU/Linux”。
 
-![](images/Debian-Logo.png)
+![Debian](images/Debian-Logo.png)
 
 Debian 图标
 {: .caption }
 
 Debian GNU/Linux 也派生了很多发行版，其中最为著名的便是 Ubuntu（官方译名“友邦拓”）。Ubuntu 由英国的 Canonical 公司主导创立，是一个主打桌面应用的操作系统。其为一般用户提供了一个时新且稳定的由自由软件构成的操作系统，且拥有庞大的社群力量和资源，十分适合普通用户使用。
 
-![](images/Ubuntu-Logo.png)
+![Ubuntu](images/Ubuntu-Logo.png)
 
 Ubuntu 图标
 {: .caption }
@@ -109,14 +109,14 @@ Ubuntu 图标
 
 Red Hat Linux 是美国的 Red Hat 公司发行的一个发行版，第一个版本发布于 1994 年 11 月 3 日，也是一个历史悠久的发行版。它曾经也广为使用，但在 2003 年 Red Hat 公司停止了对它的维护，转而将精力都投身于其企业版 Red Hat Enterprise Linux（简称 RHEL）上，Red Hat Linux 自此完结，而商业市场导向的 RHEL 维护至今。
 
-![](images/Red-Hat-Logo.png)
+![Red Hat](images/Red-Hat-Logo.png)
 
 Red Hat 公司商标，RHEL 是其旗下产品
 {: .caption }
 
 在 Red Hat Linux 在停止官方更新后，由社群启动的 Fedora 项目接管了其源代码并构筑了自己的更新，演变成了如今的 Fedora 发行版。Fedora 是一套功能完备且更新迅速的系统，且本身计划也受到了 Red Hat 公司的赞助，成为了公司测试新技术的平台。
 
-![](images/Fedora-Logo.png)
+![Fedora](images/Fedora-Logo.png)
 
 Fedora 图标
 {: .caption }
@@ -125,7 +125,7 @@ Fedora 图标
 
 2020 年 12 月，CentOS 社区在其博客中[宣布未来的重点转向 CentOS Stream](https://www.redhat.com/en/blog/centos-stream-building-innovative-future-enterprise-linux)，这是一个全新的滚动发行版。在此之前，RHEL 的上游为 Fedora，而 CentOS 的上游为 RHEL；在推出 CentOS Stream 之后，它就成为了 RHEL 的上游发行版。与此同时，CentOS 8 的支持期限被缩短至 2021 年底，且不再推出新的非 Stream 的 CentOS 版本。不满于该决定的人们也组织了新的社区，推出了诸如 [AlmaLinux](https://almalinux.org/)、[Rocky Linux](https://rockylinux.org/) 等发行版。
 
-![](images/CentOS-Logo.png)
+![CentOS](images/CentOS-Logo.png)
 
 CentOS 图标
 {: .caption }
@@ -134,14 +134,14 @@ CentOS 图标
 
 Arch Linux 是一个基于 x86-64 架构的 Linux 发行版，不过因为其内核默认就包含了部分非自由的模块，所以其未受到 GNU 计划的官方支持。即便如此，Arch Linux 也因其“简单、现代、实在、人本、万能”的宗旨赢得了 Linux 中坚用户的广泛青睐。不过，Arch Linux 对这个宗旨的定义和其它发行版有所区别。通常的操作系统为了方便用户快速上手，都是尽可能隐藏底层细节，从而避免用户了解操作系统的运行知识即可直接使用。但是 Arch Linux 则是重在构建优雅、极简的代码结构，这方便了使用者去理解系统，但不可避免地要求使用者自身愿意去了解操作系统的运作方式。某种程度上说，它的“简单”和“人本”注重的是方便用户通过了解而去最大化地利用它，而不是采取屏蔽工作原理的方式来降低使用门槛。因此，本书不建议初学者直接上手 Arch Linux，但十分推荐在读者对 Linux 有进一步了解之后去探索它。
 
-![](images/Arch-Linux-Logo.png)
+![Arch Linux](images/Arch-Linux-Logo.png)
 
 Arch Linux 图标
 {: .caption }
 
 Arch Linux 拥有强大的功能，但因其特殊的理念使得用户不易使用。为了能让一般用户也能用上 Arch Linux 的强大功能，它的变种 Manjaro 发行版于 2011 年问世。Manjaro 发行版基于 Arch Linux，但更注重易用，因而更适合一般用户。
 
-![](images/Manjaro-Logo.png)
+![Manjaro](images/Manjaro-Logo.png)
 
 Manjaro 图标
 {: .caption }
@@ -166,7 +166,7 @@ Manjaro 图标
 
 由谷歌公司推出的 Android 叫做 Android 原生系统，而基于该原生系统诞生出来的各类独特的操作系统就是 Android/Linux 系下的子发行版。Android/Linux 下的子发行版很多，如华为公司的 EMUI 操作系统和小米公司的 MIUI 操作系统等。
 
-![](images/Android-10-Native.png)
+![Android](images/Android-10-Native.png)
 
 Android 10 原生界面
 {: .caption }
@@ -179,7 +179,7 @@ Android 10 原生界面
 
 另一类有名的服务器操作系统是微软公司的 Windows Server 系列，不过其流行程度比不上各类 Linux 发行版。
 
-![](images/Windows-Server.png)
+![Windows Server](images/Windows-Server.png)
 
 Windows Server 图标
 {: .caption }
@@ -188,7 +188,7 @@ Windows Server 图标
 
 比起十几年前采用传统线路的电视，现在国内很多家庭里的电视都换成了智能数字电视，这些电视通常会配备一个机顶盒来控制电视播放的内容。实际上，电视机顶盒就是一个嵌入式设备，而 Android/Linux 分支下的各类发行版正是主流的嵌入式操作系统，如谷歌公司为数字电视专门推出的 Android TV 操作系统。
 
-![](images/Android-TV.png)
+![Android TV](images/Android-TV.png)
 
 Android TV 图标
 {: .caption }
@@ -283,12 +283,12 @@ Xubuntu 是 Ubuntu 的一个子发行版，它与 Ubuntu 非常类似，但其
 
 若已经安装了上述虚拟机管理软件，则可以直接双击打开虚拟机镜像，管理软件会打开并导入该镜像，导入完毕后可直接点击开始按钮启动。
 
-![](images/VirtualBox-import.jpg)
+![VirtualBox 导入镜像](images/VirtualBox-import.jpg)
 
 VirtualBox 导入设置（需要手动选择镜像）
 {: .caption }
 
-![](images/VWP-Xubuntu-32bit-Login.png)
+![VMware Workstation](images/VWP-Xubuntu-32bit-Login.png)
 
 VMware Workstation 启动 Xubuntu 18.04 虚拟机
 {: .caption }

docs/Ch08/index.md

@@ -195,10 +195,10 @@ $ sudo docker rm ubuntu-container
 
 在继续之前，我们来梳理一下 Docker 中的几个关键概念：**容器（container）**、**镜像（image）**、**镜像仓库（registry）**。
 
--   **镜像仓库**是存储镜像的地方
--   **镜像**是 Docker 容器内文件系统的一份快照
--   **Dockerfile** 包含生成镜像的指令序列，可以理解为构建镜像的脚本
--   **容器**是一个（隔离）的运行环境
+- **镜像仓库**是存储镜像的地方
+- **镜像**是 Docker 容器内文件系统的一份快照
+- **Dockerfile** 包含生成镜像的指令序列，可以理解为构建镜像的脚本
+- **容器**是一个（隔离）的运行环境
 
 它们之间的关系可以用下图表示，其中括号中的命令是查看相应对象列表的命令。
 

docs/Ch09/index.md

@@ -140,25 +140,25 @@ $ sort animals | uniq -c
 
 匹配正整数：
 
-```
+```text
 [1-9][0-9]*
 ```
 
 匹配仅由 26 个英文字母组成的字符串：
 
-```
+```text
 ^[A-Za-z]+$
 ```
 
 匹配 Chapter 1-99 或 Section 1-99
 
-```
+```text
 ^(Chapter|Section) [1-9][0-9]{0,1}$
 ```
 
 匹配“ter”结尾的单词：
 
-```
+```text
 ter\b
 ```
 

docs/Spec/slide.md

@@ -1,5 +1,8 @@
 # 演示文稿规格
 
+<!-- markdownlint-disable MD026 -->
+<!-- markdownlint-disable MD001 -->
+
 !!! warning "本文面向编写组提供指导和规范，不面向读者阅读，不属于本书正文。"
 
 ## 1. 文件格式

docs/credits.md

@@ -20,4 +20,4 @@
 
 ## 贡献者 {#contributors}
 
-[![](https://cf.ustclug.org/get/?target=https%3A%2F%2Fcontributors-img.web.app%2Fimage%3Frepo%3Dustclug%2FLinux101-docs)](https://github.com/ustclug/Linux101-docs/graphs/contributors)
+[![Contributors](https://cf.ustclug.org/get/?target=https%3A%2F%2Fcontributors-img.web.app%2Fimage%3Frepo%3Dustclug%2FLinux101-docs)](https://github.com/ustclug/Linux101-docs/graphs/contributors)

docs/notations.md

@@ -10,7 +10,6 @@ $ 普通权限执行的命令 1  # 注释 1
 
 # 高级权限执行的命令 2  # 注释 2
 命令 2 的输出
-
 ```
 
 命令开头的 `$` 代表此命令使用普通用户权限运行；命令开头的 `#` 代表执行命令需要使用 root 权限（最高权限），一般等价于 `$ sudo 该命令`。命令行末尾的 `#` 代表此符号与其后的内容都是注释，不参与执行。