Merge pull request #11 from FDUCSLG/feature/basic-command-line

feat: add basic cmdline literacy

Author: ShizuhaAki

docs/.vitepress/config/zh.ts

@@ -80,14 +80,14 @@ function sidebarGuide(): DefaultTheme.Sidebar {
         { text: "Make 入门", link: "/tools/intro-make" },
       ],
     },
-    // {
-    //   text: "Linux & Shell",
-    //   collapsible: true,
-    //   collapsed: false,
-    //   items: [
-    //     { text: "Linux & Shell", link: "/linux-and-shell/linux-and-shell" },
-    //   ],
-    // },
+    {
+       text: "Linux & Shell",
+       collapsible: true,
+       collapsed: false,
+       items: [
+         { text: "基本命令行常识", link: "/linux-and-shell/basic-command-line" },
+       ],
+    },
     { text: "关于 COMP101 项目", link: "/project" },
     { text: "关于我们", link: "/team" },
   ]

docs/linux-and-shell/basic-command-line.md

@@ -0,0 +1,95 @@
+# 基本命令行常识
+
+这篇文章是适用所有系统的基本命令行常识。
+
+## 什么是命令行？
+命令行界面（Command Line Interface，CLI）是一种通过输入文本命令与计算机交互的方式，不同于图形用户界面（GUI）的点击操作。命令行提供了更精确、更强大的控制能力，是开发者的重要工具。
+
+
+命令行程序运行在**终端模拟器**（Terminal Emulator）中，它们的功能相当于是模拟了上一个时代的终端，并为你提供一套帮助你键入、修改、运行命令的功能。
+
+### 在不同系统中打开命令行（终端）
+#### Windows
+  - 按下 Win+R，输入 cmd 或 powershell，按回车
+  - 或在开始菜单搜索"命令提示符"或"PowerShell"
+  
+  
+#### macOS 
+  - 打开 Applications > Utilities > Terminal
+  - 或使用 Spotlight (Cmd+Space)，搜索 "Terminal"
+  
+#### Linux
+  - 在大多数桌面环境中，通常按 Ctrl+Alt+T 快捷键就可以呼出终端模拟器
+  - 或在应用程序菜单中找到"终端"或"Terminal"
+
+## 运行程序
+命令行中运行程序的基本语法是输入程序名称，然后跟上需要的参数。
+
+打开终端后，**壳程序**（Shell）就已经在运行了。这一程序就本质而言，和任何其他的程序并无分别。它主要的功能是接受你给出的命令，将它的一些特殊语法予以解释之后，再帮你执行对应的程序。
+
+例如，在 Linux 系统上，打开终端之后，你应该看到类似这样的内容：
+
+```shell
+user@hostname:~$
+```
+
+在 Windows 系统上，则是：
+```
+C:\Your\Path>
+```
+
+这就是 Shell 的**提示符**。它告诉你，可以在这里键入命令了。
+
+> [!NOTE]记号约定
+> 在很多网站上，会使用 `$` 和 `>` 符号来代指提示符。通常，`$` 符号代表命令适合 Linux 或者其他 Unix-like 系统，而 `>` 符号代表命令适合 Windows。
+> 因此，不要将这些符号认为是命令的一部分。
+
+
+> [!WARNING]不要轻易复制网上的命令
+> **除非你知道自己在做什么，否则不要直接复制粘贴网上的命令到你的终端中！**
+> 
+> 这是因为，它们可能不适合你所使用的环境，或者有需要修改的内容。更危险的，它们也可能包含恶意的命令。
+
+### PATH 环境变量
+PATH 是一个环境变量，它告诉系统在哪里寻找可执行程序。为了保护安全，大多数系统在接受到命令时，都只会搜索这些目录来寻找有没有对应的程序。因此，你会常常需要修改这个变量，来告诉系统你的软件安装在哪里。
+
+如果你希望运行当前目录的文件。通常，需要使用相对寻址方法。也就是，使用 `./program` 而不是直接键入 `program`。
+
+- **查看当前PATH**:
+  - Windows: `echo %PATH%`
+  - macOS/Linux: `echo $PATH`
+
+- **临时添加路径到PATH**:
+  - Windows: `set PATH=%PATH%;C:\your\new\path`
+  - macOS/Linux: `export PATH=$PATH:/your/new/path`
+
+- **永久设置PATH**:
+  - Windows: 通过系统属性 > 环境变量设置。可以在 Windows 搜索中（按 Windows 徽标键呼出）搜索 “environment variables” 找到这个命令。
+  - macOS: 在 `~/.bash_profile` 或 `~/.zshrc` 添加 export 命令。
+  - Linux: 在 `~/.bashrc` 或相应的 Shell 配置文件中添加 export 命令。
+
+> [!NOTE] 不同的 Shell 有不同的语法
+> Linux 和 macOS 用户很可能并不会使用默认的 Shell。这时，它们的变量设置语法也可能不同。因此，请务必查阅你所用的 Shell 的文档。
+### 常见参数语法
+大部分程序的命令行参数通常有以下几种形式：
+
+- **短参数**: 单个字母前加单个连字符，如 `-a`。可以组合使用，如 `-abc` 等同于 `-a -b -c`
+
+- **长参数**: 完整单词前加双连字符，如 `--help`。通常后跟等号和值，如 `--file=document.txt`
+
+- **位置参数**: 不带标识符的参数，按位置解释，如 `cp source.txt destination.txt`
+
+- **示例**:
+  ```
+  $ ls -la                  # 列出所有文件详细信息
+  $ grep --color=auto word file.txt   # 搜索文件中的单词并高亮显示
+  $ python script.py arg1 arg2        # 运行Python脚本并传递两个参数
+  ```
+
+此外，虽然并非一定如此，但许多程序会接受 `-h` 或者 `--help` 参数，并打印自己的帮助信息。
+
+## 实用功能
+大多数终端模拟器还提供了一系列实用功能来帮助你更快地编辑命令。例如：
+
+- 按上箭头键可以依次调出历史中键入过的命令。
+- 按 <kbd>Tab</kbd> 键可以让 Shell 试图补全路径或者命令。这在路径比较长的时候很有用。

docs/tools/intro-make.md

@@ -1,7 +1,7 @@
 # Make 入门
 > [!note]
 > 学习这一篇的内容，需要你对以下技能有基本的了解：
-> * 命令行的基本运用
+> * 命令行的基本运用（请参考[这篇文档](../linux-and-shell/basic-command-line)）
 
 
 随着学习的深入，同学们编写的代码会逐渐需要多个文件的协同工作。而本文介绍的 Make 便是多文件编译的事实标准。它通过一套基于规则匹配的机制，可以允许我们方便地定义一系列编译规则。Make 程序会根据这些规则，自动地找出哪些文件需要重新编译，大大节省编译时间。
@@ -147,33 +147,33 @@ main: main.o utils.o
 示例：
 ```makefile
 %.o: %.c
-    gcc -c $< -o $@
+	gcc -c $< -o $@
 ```
 等价于：
 ```makefile
 main.o: main.c
-    gcc -c main.c -o main.o
+	gcc -c main.c -o main.o
 ```
 #### $^ （所有依赖项）
 代表当前规则的**所有**依赖文件，用空格分隔。适用于链接多个对象文件。
 
 示例：
 ```makefile
 main: main.o utils.o
-    gcc -o $@ $^
+	gcc -o $@ $^
 ```
 等价于：
 ```makefile
 main: main.o utils.o
-    gcc -o main main.o utils.o
+	gcc -o main main.o utils.o
 ```
 #### $* （匹配模式的主干部分）
 代表模式匹配的**通配符**部分，即 `%` 所匹配的内容。通常用于处理不同扩展名的文件。
 
 示例：
 ```makefile
 %.o: %.c
-    gcc -c $< -o $@
+	gcc -c $< -o $@
 ```
 如果执行 `make main.o`，则这里我们有：