aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFangcat_Dev <f20091219@outlook.com>2026-08-15 07:28:58 +0000
committerFangcat_Dev <f20091219@outlook.com>2026-08-15 07:28:58 +0000
commitb90296180a70c510c00ef81106d4141e567f80ff (patch)
tree9bbf0f1d28cc9dcdcda056734242c6c86508d013
parentMerge pull request 'docs: advanced' (#8) from Fangcat_Dev/linux-handbook:main into main (diff)
parentMerge branch 'main' into 审查修改部分越界内容 (diff)
Merge pull request '审查修改部分越界内容' (#6) from 审查修改部分越界内容 into main
Reviewed-on: https://codeberg.org/LinuxCabin/linux-handbook/pulls/6 Reviewed-by: Fangcat_Dev <f20091219@outlook.com>
-rw-r--r--docs/applications/emacs.md85
-rw-r--r--docs/applications/fish.md89
-rw-r--r--docs/applications/git.md92
-rw-r--r--docs/applications/openclaw.md4
-rw-r--r--docs/applications/programming/cpp.md88
-rw-r--r--docs/applications/programming/miniconda.md68
-rw-r--r--docs/applications/programming/python.md69
-rw-r--r--docs/applications/ssh.md128
-rw-r--r--docs/applications/vim.md103
-rw-r--r--docs/applications/zsh.md22
10 files changed, 260 insertions, 488 deletions
diff --git a/docs/applications/emacs.md b/docs/applications/emacs.md
index f78df2b..e5a39b7 100644
--- a/docs/applications/emacs.md
+++ b/docs/applications/emacs.md
@@ -2,23 +2,26 @@
![emacs](https://www.gnu.org/software/emacs/images/emacs.png)
-[官方文档](https://www.gnu.org/software/emacs/manual/emacs.html)
-
-[官网](https://www.gnu.org/software/emacs/)
-
-**Emacs的配置文件位于`~/.emacs.d/`或`~/.config/emacs`(更老的Emacs版本使用`~/.emacs`作为配置目录),其名称为init.el,使用Elisp作为配置语言**。
-
-## 梗概
+## 概述
Emacs是一个[自由](https://www.gnu.org/philosophy/free-sw.html)的编辑器,采用[GPL-v3](https://www.gnu.org/licenses/gpl-3.0.en.html)发布,采用Elisp作为配置语言,Emacs功能强大(包括但不限于发邮件,使用irc聊天,阅读新闻和RSS订阅,玩俄罗斯方块),常被与vim/nvim比较,最早由Richard Stallman编写发布,Emacs是[自由软件运动](https://www.gnu.org/)的一部分。
-**注:本文档使用Emacs编辑**。
-
## 安装
-- Debian系: `sudo apt install emacs`
-- 红帽系: `sudo dnf install emacs`
-- Arch系: `sudo pacman -S emacs`
+Debian系:
+```bash
+sudo apt install emacs
+```
+
+红帽系:
+```bash
+sudo dnf install emacs
+```
+
+Arch系:
+```bash
+sudo pacman -S emacs
+```
## 使用(默认快捷键)
@@ -26,39 +29,31 @@ Emacs是一个[自由](https://www.gnu.org/philosophy/free-sw.html)的编辑器,
**由于Emacs的功能关于繁杂无法将所有快捷键列出,强烈建议您阅读官方文档**。
-- C-x C-c 退出Emacs
-- M-x 输入命令
-- C-x C-s 保存文件
-- C-s 搜索关键词
-- C-p/n/b/f 使光标上下左右的移动
-- C-a/e 移动到行头或行尾
-- M-</> 移动到文件头或文件尾
-- C-k 删除光标后面的所有文本
-- C-/ 撤销操作(C-x u和C-_也可已,详情见官方文档9.4)
-- C-x C-f 跳转到另一个文件(旧文件会被放入一个buffer中)
-- C-x b 切换到另一个Buffer
-- C-x C-b 打开Buffer列表(?获得帮助)
-- C-x o 切换到另一个Window
-- C-x 0 关闭Window
-- C-x k 关闭一个Buffer
-- C-h C-f Emacs常见问题解答
-- C-h r 官方手册(需要安装info)
-- C-h t 官方快速指南
-
-## 配置
-
-**由于Emacs的配置过于纷杂繁复,不适合Linux新手,所以只做文档与视频的推荐**。
-
-1.[Emacs轻奢之路](https://www.bilibili.com/video/BV1T64y1R7EL/)
-2.[21天学会Emacs 2022年版本](https://www.bilibili.com/video/BV12P4y1j7EL/)
-3.[Emacs高手修炼手册](https://www.bilibili.com/video/BV13g4y167Zn/)
-4.[专业 Emacs 入门教程](https://www.zhihu.com/column/c_1440829147212279808)
-
-## 尾言
+`C-x C-c` 退出Emacs
+`M-x` 输入命令
+`C-x C-s` 保存文件
+`C-s` 搜索关键词
+`C-p/n/b/f` 使光标上下左右的移动
+`C-a/e` 移动到行头或行尾
+`M-</>` 移动到文件头或文件尾
+`C-k` 删除光标后面的所有文本
+`C-/` 撤销操作(C-x u和C-_也可已,详情见官方文档9.4)
+`C-x C-f` 跳转到另一个文件(旧文件会被放入一个buffer中)
+`C-x b` 切换到另一个Buffer
+`C-x C-b` 打开Buffer列表(?获得帮助)
+`C-x o` 切换到另一个Window
+`C-x 0` 关闭Window
+`C-x k` 关闭一个Buffer
+`C-h C-f` Emacs常见问题解答
+`C-h r` 官方手册(需要安装info)
+`C-h t` 官方快速指南
-Emacs的上手并不简单,但当您上手并习惯它后它将是您最好的编程伙伴,在您上手后我推荐您尝试使用[Org-mode](https://orgmode.org/)编写文档管理日程安排,也推荐您使用Emacs的更多功能,愿Emacs可以成为您一生的编辑器。
+## 关于更多
-## 相关网站
+受限于我们的专门性,我们建议您到其他专门性教程进行学习。
-- [Emacs-china](https://emacs-china.org/)
-- [Emacs官网](https://www.gnu.org/software/emacs/) \ No newline at end of file
+1. [Emacs轻奢之路](https://www.bilibili.com/video/BV1T64y1R7EL/)
+2. [21天学会Emacs 2022年版本](https://www.bilibili.com/video/BV12P4y1j7EL/)
+3. [Emacs高手修炼手册](https://www.bilibili.com/video/BV13g4y167Zn/)
+4. [专业 Emacs 入门教程](https://www.zhihu.com/column/c_1440829147212279808)
+5. [官方文档](https://www.gnu.org/software/emacs/manual/emacs.html)
diff --git a/docs/applications/fish.md b/docs/applications/fish.md
index dd47f9f..1b31ff1 100644
--- a/docs/applications/fish.md
+++ b/docs/applications/fish.md
@@ -2,73 +2,74 @@
![fish](https://fishshell.com/assets/img/Terminal_Logo_CRT_4.svg)
-[官网](https://fishshell.com/)
-
-[官方文档](https://fishshell.com/docs/current/index.html)
-
-[Fish语言教程](https://fishshell.com/docs/current/tutorial.html)
-
-**默认配置文件在`~/.config/fish`下,其名称为`config.fish`**
-
## 概述
-Fish是一个[Shell](https://hb.linuxcabin.top/concepts/linux/shell/),它有着功能丰富,开箱即用,脚本编写简便的特点。
+Fish是一个[Shell](../concepts/linux/shell.md),它有着功能丰富,开箱即用,脚本编写简便的特点。
**但它不兼容[POSIX标准](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html),这意味着Bash无法运行Fish的脚本,反之亦然**。
## 安装
-- Debian系: `sudo apt install fish`
-- 红帽系: `sudo dnf install fish`
-- Arch系: `sudo pacman -S fish`
+- Debian系:
+```bash
+sudo apt install fish
+```
-## 使用
+- 红帽系:
+```bash
+sudo dnf install fish
+```
-- 进入Fish:
-
- `fish`
+- Arch系:
+```bash
+sudo pacman -S fish
+```
-- 退出fish
-
- `exit`
+## 使用
+
+将Fish作为默认Shell
-- 将Fish作为默认Shell
-
- 1.将Fish加入Slhel列表
-
- `command -v fish | sudo tee -a /etc/shells`
-
- 2.更改默认Shell
-
- `chsh -s "$(command -v fish)"`
+```bash
+# 将Fish加入Shell列表
+command -v fish | sudo tee -a /etc/shells
-- 当您在Fish输入命令时,光标后会有一个暗灰色建议,如果您同意这个建议,您可以按右方向键或`ctrl-f`
+# 更改默认Shell
+chsh -s "$(command -v fish)"
+```
+当您在Fish输入命令时,光标后会有一个暗灰色建议,如果您同意这个建议,您可以按右方向键或`ctrl-f`
-- 当您在Fish输入命令时,您可以按Tab键列出所有选项,您可以使用方向键选择选项,使用回车键补全
+当您在Fish输入命令时,您可以按Tab键列出所有选项,您可以使用方向键选择选项,使用回车键补全
-- 使用`ctrl-a`或`ctrl-e`移动到命令的头部或尾部
+使用`ctrl-a`或`ctrl-e`移动到命令的头部或尾部
-- 使用`ctrl-k`删除光标后的所有内容
+使用`ctrl-k`删除光标后的所有内容
-- 使用`ctrl-c`中断命令
+使用`ctrl-c`中断命令
-- 使用`alt-c`将光标后面的第一个字母大写
+使用`alt-c`将光标后面的第一个字母大写
-- 使用`alt-u`将光标后面的所有字母大写
+使用`alt-u`将光标后面的所有字母大写
**Fish默认使用Emacs快捷键,您可以使用`fish_vi_key_bindings`切换到vi模式,使用`fish_default_key_bindings`,切换回去**。
## 配置
-- 您可以在config-fish添加以下文本关闭Fish的欢迎信息:
-
- `set -U fish_greeting`
+您可以在config-fish添加以下文本关闭Fish的欢迎信息:
+```bash
+set -U fish_greeting
+```
+
+您可以使用以下语法设置别名
+```bash
+alias 别名="原本的命令"
+abbr -a 别名="原本的命令"
+```
+
+## 关于更多
+
+受限于我们的专门性,建议选择这些更专门的教程或文档学习
-- 您可以使用以下语法设置别名
-
- `alias 别名="原本的命令"`
-
- `abbr -a 别名="原本的命令"`
-
+- [官方文档](https://fishshell.com/docs/current/index.html)
+- [Fish语言教程](https://fishshell.com/docs/current/tutorial.html)
diff --git a/docs/applications/git.md b/docs/applications/git.md
index 8b8bf98..ad481a6 100644
--- a/docs/applications/git.md
+++ b/docs/applications/git.md
@@ -4,77 +4,93 @@
[官网](https://git-scm.com/)
-## 什么是Git
+## 概述
Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择。
-## Git的诞生
+## 使用方法
-自从Linus于1991年发布Linux的第一个版本并且公开源代码开始,每天都有来自全世界的程序员给Linux贡献代码,这就产生了一个问题,如果新添加的代码存在问题该如何回退到之前的版本,如何管理代码,如何决定那些代码进入最终版本,也就是版本控制的问题。在1991~2001年期间,Linux的维护工作的大量时间都花在了提交补丁和保存归档的繁琐事务上。
+### 克隆仓库
-在2002年Linux使用BitKeeper来管理版本,BitKeeper是一个闭源付费的软件,但其开发公司与Linux团队达成了协议,让Linux团队免费使用BitKeeper,但Linux的开发社区依旧对BitKeeper不满,所以社区试图破解BitKeeper的协议。被发现后,BitKeeper的开发公司收回了Linux团队的免费使用权,Linus在此情况下自己写出了Git并公开源代码发布。
-
-有趣的是,BitKeeper在2016以Apache2.0协议开源,不过其已经停止开发。
-
-## Git的使用
+```
+git clone http://example.com/example.git
+```
-**由于本文档面向新手所以只介绍Git的本地仓库版本管理,不涉及远程仓库的使用**
+### 创建初始化一个Git仓库
-- 使用以下命令创建初始化一个Git仓库
+#### 从空的目录创建
```
-#mkdir用于创建文件夹
+mkdir 文件夹名称
+cd 文件夹名称
+git init
+```
-mkdir 文件夹名称
+> `mkdir 文件夹名称` 用于创建文件夹
+>
+> `cd 文件夹名称` 进入您刚刚创建的文件夹
-#cd用于切换目录
-cd 文件夹名称
+#### 在已有项目中创建
-git init
+> 确保您当前位于您的项目目录中 (使用`pwd`命令确认,`cd`命令用于进入一个文件夹)
```
+git init
+```
-- 使用以下命令将修改的文件推送到本地仓库创建一个版本
+### 将修改的文件推送到仓库创建一个版本
-```
-#git add命令会把文件放入暂存区
+#### 加入暂存区
+```
git add 修改的文件
+```
-#您可以不加-m参数,Git会打开一个图形界面让您填写信息
-#git commit 将缓存区的文件放入本地仓库
+> `add`意为`添加`,用于将文件加入暂存区
-git commit -m "这一次提交的介绍"
+#### 提交暂存区
```
+git commit -m "这一次提交的介绍"
+```
-- 使用使用以下命令查看所有版本
+???+ tip "不带`-m`参数"
+ 您可以不加`-m`参数,Git会根据您当前的`EDITOR`环境变量打开一个编辑器让您填写信息
-```
-git log
+ 您可以使用`echo $EDITOR`得知当前编辑器是什么
-#如果您想要一个更加简洁的界面
+ `git commit` 将缓存区的文件放入本地仓库
-git log --oneline
+> `commit`意为`提交`
+### 查看所有版本
+
+```
+git log
```
-- 使用以下命令回退版本
+???+ tip "如果您想要一个更加简洁的界面"
+ `git log --oneline`
-```
-#哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的
-#git reflog可以查看您所有的操作,包括您删除的版本的哈希值
-#git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件
-#更推荐您使用默认参数
+### 回退版本
-git reset 版本的哈希值
+- `git log` 查看commit历史,每一个提交都具有一个独一无二的哈希值
+- `git reflog` 可以查看您所有的操作,包括您删除的版本的哈希值
+- `git reset --mixed` 这是默认使用参数,会删除本地仓库和缓存区的文件
+- `git reset --hard` 会删除本地仓库和缓存区和工作区的文件
+- `git reset --soft` 只删除本地仓库的文件
-```
+> 更推荐您使用默认参数
+>
+> `git reset 版本的哈希值`
-## 视频教程
-[一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/)
-[蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/)
-[Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/)
+## 关于更多
+由于我们的专门性限制,我们建议您去其他专门教程深入的的学习git。
+1. [Pro Git Book](https://git-scm.com/book/zh/v2)
+2. [菜鸟教程](https://www.runoob.com/git/git-tutorial.html)
+3. [一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/)
+4. [蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/)
+5. [Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/)
diff --git a/docs/applications/openclaw.md b/docs/applications/openclaw.md
index 726da6c..b6ce94e 100644
--- a/docs/applications/openclaw.md
+++ b/docs/applications/openclaw.md
@@ -1,5 +1,7 @@
# OpenClaw
+## 概述
+
[OpenClaw](https://openclaws.io/zh/)是一个开源的AI智能体框架,相当于一只“大手”,能够帮助使用者完成具体任务。
## 安装
@@ -44,4 +46,4 @@ npm i -g openclaw
pnpm add -g openclaw
```
-之后,运行`openclaw onboard`来配置即可。 \ No newline at end of file
+之后,运行`openclaw onboard`来配置即可。
diff --git a/docs/applications/programming/cpp.md b/docs/applications/programming/cpp.md
index 22b0b0f..5f99a01 100644
--- a/docs/applications/programming/cpp.md
+++ b/docs/applications/programming/cpp.md
@@ -1,17 +1,12 @@
-# C++
+# C++开发套件
-## Windows 的配置灾难
+## g++
-众所周知,在windows上安装VSCode并配置好mingw编译器对于很多新手来说都是一件非常曲折的事情。
-因为 Windows 的主要受众是普通人,所以软件管理,编译器配置方面都不如Linux便利。
+### 概述
-如果你选择了 Linux ,那么恭喜你将获得一个非常便利而自然的开发环境。
-接下来我简单介绍一下如何在 Linux 上跑通一个 简单的 Hello World 以及多文件编译。
+g++是GNU项目开发的C++编译器,属于GNU编译器套件(GCC)的核心组成部分。它通过命令行运行,能把C++源代码文件编译、链接并转换成计算机可以直接运行的二进制可执行程序。
-## g++ 安装
-
-g++ 编译器是专门用于编译 cpp 代码的(也就是让你写的东西能用机器跑起来)。
-安装非常简单,取决于你使用什么包管理器。
+### 安装
- Debian 系(Ubuntu, Mint, Debian)
@@ -31,77 +26,8 @@ sudo dnf install g++ -y
sudo pacman -S g++ -y
```
-- 查看版本
-
-```bash
-g++ -v
-```
-
-参考输出:
-❯ g++ -v
-
-```shell
-Using built-in specs.
-COLLECT_GCC=g++
-COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-pc-linux-gnu/16/lto-wrapper
-Target: x86_64-pc-linux-gnu
-Configured with: ../gcc/configure --enable-languages=ada,c,c++,d,fortran,go,lto,m2,objc,obj-c++,rust,cobol --enable-bootstrap --prefix=/usr --libdir=/usr/lib --libexecdir=/usr/lib --mandir=/usr/share/man --infodi
-r=/usr/share/info --with-bugurl=https://gitlab.archlinux.org/archlinux/packaging/packages/gcc/-/issues --with-build-config=bootstrap-lto --with-gcc-major-version-only --with-linker-hash-style=gnu --with-system-zl
-ib --enable-cet=auto --enable-checking=release --enable-clocale=gnu --enable-default-pie --enable-default-ssp --enable-gnu-indirect-function --enable-gnu-unique-object --enable-libstdcxx-backtrace --enable-link-s
-erialization=1 --enable-linker-build-id --enable-lto --enable-multilib --enable-plugin --enable-shared --enable-threads=posix --disable-fixincludes --disable-libssp --disable-libstdcxx-pch --disable-werror
-Thread model: posix
-Supported LTO compression algorithms: zlib zstd
-gcc version 16.1.1 20260725 (GCC)
-```
-
+### 使用
-## 编写一个程序
-
-- 创建一个cpp文件(以cpp为后缀)
-
-```bash
-touch hello.cpp
-```
-
-- 使用你喜欢的编辑器打开
-
-```bash
-vim hello.cpp
-# 如果你不会用 vim 就用nano
-# nano hello.cpp
-```
-
-- 写入下面的内容
-
-```cpp
-#include <iostream>
-
-int main() {
- std::cout << "hello world" << std::endl;
- return 0;
-}
-```
-
-- 保存并退出
-
-- 编译成二进制文件
-
-```bash
-g++ hello.cpp -o hello
-```
-
-> -o <file> Place the output into <file>.
-这里 -o 表示 output(输出的二进制文件), 后面跟上你起的二进制文件名, 随便叫啥,一般会叫main或者你的程序名。
-
-写法是 g++ 源文件路径 -o 二进制文件。
-
-- 运行程序
-
-```bash
-./hello # ./ 表示当前目录, 后面直接跟上文件名, 表示运行该二进制文件
-```
+请参考`man g++`。
-这个时候终端会打印 hello world, 恭喜你成功用命令行成功编写并运行了一个C++程序。
-现在你已经学会如何使用命令行编译cpp程序了,当然还有各种的编译方式,有各种编译工具,但是入门的话现在这些知识就够了。
-祝贺你。
diff --git a/docs/applications/programming/miniconda.md b/docs/applications/programming/miniconda.md
index 72ba4f9..ba1d605 100644
--- a/docs/applications/programming/miniconda.md
+++ b/docs/applications/programming/miniconda.md
@@ -1,84 +1,40 @@
# Miniconda
-## 什么是Miniconda
+## 概述
-相信不少人是因为自己需要学习人工智能,跑云端训练才学Linux
-所以我在这里写了相关的内容,希望可以帮助到大家。
+Miniconda的上游Anaconda是一个**Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。但Anaconda过于臃肿,因此官方也推出了最小化版本,也就是Miniconda。
-Anaconda 是一个 **Python的管理器**,让你在同一个操作系统上**拥有多个共存的Python环境,按需使用和激活**。
-但是 Anaconda 预装太多东西,甚至达到几个G的体积,所以官方也推出了mini版 —— Miniconda。
+Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,让用户按需安装。
-Miniconda 跟Anaconda的最大区别就是砍掉了很多预装的东西,比如numpy之类的。
-它的设计理念就是让用户按需安装,我是比较同意这个理念的,个人也一直在用Miniconda。
+## 安装
-**下面的教程适用于Linux环境(包括原生Linux,WSL,虚拟机等)**
-
-## 安装步骤
-
-- 下载官方安装脚本
-访问官方下载链接(<https://www.anaconda.com/download/success)>
-
-选择 Linux,选择右边这个 Miniconda x86 版本 (大多数电脑都是x86, 但是macBook不是,在这之前确认自己的架构)。
+下载官方安装脚本,访问[官方下载链接](https://www.anaconda.com/download/success),选择 Linux,选择右边Miniconda,架构请自行查询,一般情况为x86。
![Anaconda安装脚本下载](../../img/miniconda/pic1.png)
-- 使用bash执行脚本
+使用bash执行脚本
```bash
-# 首先需要把你的 Miniconda脚本放到Linux系统可以访问的地方
-
-# 然后执行这个安装脚本
bash Miniconda3-latest-Linux-x86_64.sh
```
-然后中间有引导,保持默认即可,叫你输yes你就yes回车。安装完之后重启终端或者使用下面的命令重新加载环境变量。
+选项保持默认即可。安装完之后重启终端或者使用下面的命令重新加载环境变量。
```bash
source ~/.bashrc
```
-- 配置镜像源
-
-很多同志连官方源不太流畅,推荐换成中科大。
+## 镜像源
-访问这个链接进行配置即可: <https://mirrors.ustc.edu.cn/help/anaconda.html>
+访问[中科大源](https://mirrors.ustc.edu.cn/help/anaconda.html)进行配置即可
-一般是创建一个 ~/.condarc 文件然后把 channels 开头的那些东西复制粘贴进去即可。
+创建一个`~/.condarc`文件然后把channels开头的文本复制粘贴进去即可。
```bash
# 创建配置文件
touch ~/.condarc
-# 然后编辑
+# 编辑配置文件
nano ~/.condarc
```
-- 配置pip源
-
-我们很多时候还是使用 pip 来安装的,所以这里也需要配置一下pip的镜像源
-
-访问这个网址进行配置 <https://mirrors.ustc.edu.cn/help/pypi.html>
-**只需要执行设为默认的命令即可**, 剩下的不需要配置。
-
-- 创建环境测试
-
-```bash
-# 这边的 -n 后面的是虚拟环境名, 这里既是 test-env. 然后后面可以指定python版本,根据实验需要来
-conda create -n test-env python=3.12
-```
-
-- pip安装测试
-
-```bash
-# 先激活刚才创建的虚拟环境
-conda activate test-env
-
-# 然后装个 numpy 试试
-pip install numpy
-```
-
-- 查看当前环境
-
-```bash
-conda env list
-# 列出所有环境, 如果是当前的环境, 会标有 *
-```
+此外,还需要配置pip源,建议访问[中科大源](https://mirrors.ustc.edu.cn/help/pypi.html)进行配置
diff --git a/docs/applications/programming/python.md b/docs/applications/programming/python.md
index 1180d39..29ad315 100644
--- a/docs/applications/programming/python.md
+++ b/docs/applications/programming/python.md
@@ -1,62 +1,25 @@
-# Python
+# Python开发套件
-## 安装 Python
+## Python3
-Linux 上装Python还是非常轻松的,因为不用装,大部分发行版自带。
+### 安装
-Linux 里面一般都是 `python3`。
-如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。
-
-- Debian: `sudo apt install python-is-python3 -y`
-- Fedora: `sudo dnf install python-is-python3 -y`
-
-## 编写第一个脚本
-
-- 创建一个脚本
-
-```bash
-touch hello.py
-```
-
-- 写入内容
+除个别极简发行版外(如Arch),大多数发行版已自带。
+Arch系:
```bash
-echo "print('hello python')" > hello.py
+sudo pacman -S python
```
-- 查看内容
-
-```bash
-cat hello.py
-
-# 会输出
-# print('hello python')
-```
+### 使用
-## 运行
+Linux里面一般以`python3`命令使用Python。
-有很多Windows来的同志不知道怎么运行,但实际上非常简单。
+???+ tip "通过`python`使用"
+ 如果你想要用 `python` 这个命令, 可以装一个 `python-is-python3`, 来用软链接骗过操作系统(开个玩笑)。
-用法:
-
-```bash
-# python <要运行的脚本路径>
-
-python hello.py
-```
-
-这样你就成功运行起 Python 脚本了。
-实际上就是给 Python 指定需要运行的文件, 就这么简单。
-
-恭喜你在Linux上成功运行了Python脚本。
-
-## 编辑器
-
-- 如果你使用WSL, 推荐使用 VSCode 的 WSL 插件来连接写代码, 当然勇敢牛牛可以尝试 LazyVim 写代码
-- 如果你使用原生 Linux, 还是这两种推荐haha
-
-VSCode 资料很多, 我也用的比较少,可以直接上Bilibili搜索VSCode Python环境搭建
-[LazyVim入坑视频](https://www.bilibili.com/video/BV1TJCvYFE2T?t=286.5)
+ - Debian: `sudo apt install python-is-python3 -y`
+ - Fedora: `sudo dnf install python-is-python3 -y`
## 库
@@ -75,11 +38,11 @@ Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。ä½
╰─> To install Python packages system-wide, try 'pacman -S
python-xyz', where xyz is the package you are trying to
install.
-
+
If you wish to install a non-Arch-packaged Python package,
create a virtual environment using 'python -m venv path/to/venv'.
Then use path/to/venv/bin/python and path/to/venv/bin/pip.
-
+
If you wish to install a non-Arch packaged Python application,
it may be easiest to use 'pipx install xyz', which will manage a
virtual environment for you. Make sure you have python-pipx
@@ -89,5 +52,5 @@ Python拥有规模庞大的PyPi库。通常,我们使用`pip`进行安装。ä½
hint: See PEP 668 for the detailed specification.
```
由于系统的部分组件依赖Python的依赖,因而外来库可能破坏系统本身的依赖关系。
-
- 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。 \ No newline at end of file
+
+ 这个时候,我们建议您使用`venv`创建虚拟环境,或者寻找发行版的软件源是否有对应的库可供安装(一般包名为`python3-库`或`python-库`)。
diff --git a/docs/applications/ssh.md b/docs/applications/ssh.md
index c26fa72..9b05a55 100644
--- a/docs/applications/ssh.md
+++ b/docs/applications/ssh.md
@@ -1,133 +1,29 @@
# SSH
-在 Linux 中, 远程操控服务器是基本操作,这个时候,就需要使用 `ssh` 这个工具。
+???+info "注意!"
+ SSH指ssh协议,也指ssh的客户端/服务端,且SSH实现种类较多,此处特指ssh客户端/服务端,且以最普及的openSSH为示例
-具体的概念和介绍参考[百度百科](https://baike.baidu.com/item/%E5%AE%89%E5%85%A8%E5%A4%96%E5%A3%B3%E5%8D%8F%E8%AE%AE)或[Wikipedia](https://zh.wikipedia.org/zh-hans/Secure_Shell)。
+## 概述
-很多 Windows 用户可能有**连接 Linux 虚拟机**进行实验的需求,
-以及人工智能专业的同学可能需要 **使用云端服务器来进行模型的训练**
-
-所以我在这里简单介绍一下如何在 Windows 下使用 ssh 命令远程连接虚拟机或者服务器。
-
-## 前置条件
-
-Windows客户端和被连接的Linux**必须满足下面的条件之一**:
-
-- 处于同一个网络下(内网穿透也可)
-- Linux 服务器有公网ip,并且windows可以正常上网
-
-> 一般虚拟机就是在宿主机拉起的虚拟网络中, 所以可以直接连接。
+OpenSSH是SSH(Secure Shell)协议的免费开源实现。它通过对所有传输流量进行加密,为不安全的网络提供安全的远程登录、命令执行、文件传输及TCP端口转发(隧道),是跨平台管理远程系统的核心工具。
## 安装
-- 首先使用 win + r , 然后输入cmd
-- 按住 ctrl + shift 然后回车打开管理员的命令提示符
-
-- 之后使用 `winget` 来安装 ssh 客户端
-
-```cmd
-winget install Microsoft.OpenSSH.Beta
-```
-
-- 检验是否安装成功
-
-```cmd
-ssh -V
-```
-
-## 查看Linux端信息
-
-如果你是虚拟机,打开虚拟机内部的终端 (一般叫做Terminal):
+大多数情况下,ssh已经被系统自带。
-```bash
-user@hostname:~$
-# 开启之后会看到这个, 叫做命令提示符, @ 前面的就是用户名
-# 然后你输入的命令会出现在 $ 右侧
-```
+## 使用
-查看 `ip` 地址:
+**示例**:以example账户连接到10.0.0.1。
```bash
-ip a
-
-```
-
-参考输出讲解:
-
-```bash
-1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
- link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
- inet 127.0.0.1/8 scope host lo
- valid_lft forever preferred_lft forever
- inet6 ::1/128 scope host noprefixroute
- valid_lft forever preferred_lft forever
-2: enp1s0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
- link/ether 52:54:00:0d:46:77 brd ff:ff:ff:ff:ff:ff
- altname enx5254000d4677
-3: enp7s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
- link/ether 52:54:00:21:7d:76 brd ff:ff:ff:ff:ff:ff
- altname enx525400217d76
- inet 192.168.200.2/24 brd 192.168.200.255 scope global enp7s0
- valid_lft forever preferred_lft forever
- inet6 fe80::5054:ff:fe21:7d76/64 scope link proto kernel_ll
- valid_lft forever preferred_lft forever
-```
-
-我们先找到**状态为UP**的网卡, 也就是显示 state UP 的卡, 这里是 `lo` 以及 `enp7s0`
-
-- `lo`: 本地回环, 用于这个机器内部自己的通信, 无法跟外界通信,所以我们不使用这个网络接口连接
-- `enp7s0`: 有线网卡,可以与同一网络下的机器通信,我们将使用这个接口进行 ssh 连接
-
-下一步是找到我们目标网卡的 inet 这一行,在这里的例子中是:
-
-```
-inet 192.168.200.2/24 brd 192.168.200.255 scope global enp7s0
-```
-
-这里的 192.168.200.2 就是对应的ip地址, 至于后面的 /24 表示子网掩码,这里不需要管。
-
-然后我们记住这个ip地址(当然你可以后面返回来看)。
-
-???+ note "环境"
- 文章演示环境为内网环境。所使用的是内网ip。由于IPv4资源紧张与NAT的存在,大部分家用计算机并不会被分配公网IPv4,所使用的也是经过NAT转发的公网地址。当然,您也可以尝试配置公网IPv6。
-
-## 进行连接
-
-下面的操作就是在你的 cmd 或者 powershell 当中运行(也就是windows)
-我们刚才已经拿到了两个信息:
-
-- 用户名: 也就是 @ 前面的那个
-- ip地址: 也就是 3 个点分割的ipv4 (一般 192开头)
-
-我们现在使用这两个信息进行ssh连接,语法是:
-
-```shell
-ssh 用户名@ip地址
-```
-
-举个例子:
-
-```shell
-ssh cabin@192.168.200.2
+ssh example@10.0.0.1
```
-表示我要使用ssh登陆 192.168.200.2 对应的主机的 cabin 这个账户。
-
-## 测试
-
-当你看到出现了类似这种提示符, 就代表连接成功了。
-
-```shell
-cabin@linux-handbook:~$
-```
-
-接下来你可以试着跟linux打个招呼。
-
+**示例**:systemd环境下启动ssh服务。
```bash
-echo hello linux
-# 输出 hello linux
+sudo systemctl start ssh # 个别发行版为sshd
```
-然后如果需要推出的话, 可以使用 `exit` 命令。
+## 关于更多
-当然Windows用户更习惯关掉命令行, 因为不常用haha。 \ No newline at end of file
+请根据`man ssh`中的信息进行专门性学习。
diff --git a/docs/applications/vim.md b/docs/applications/vim.md
index cd494cf..7c5eece 100644
--- a/docs/applications/vim.md
+++ b/docs/applications/vim.md
@@ -1,6 +1,8 @@
# Vim
-`vim` 是一款终端文本编辑器, 几乎所有的Linux发行版都会预装。
+## 概述
+
+`vim` 是一款轻量高效的终端文本编辑器, 几乎所有的Linux发行版都会预装。
第一次使用vim的人,最大的感受一定是: 反人类。
Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的)。
@@ -8,27 +10,41 @@ Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接å�
话虽如此,在终端用Vim改个配置文件依旧是很多Linux玩家的日常
所以我们有必要稍微学习一下如何使用Vim完成以下基础的操作。
----
+## 安装
+
+Debian系:
+```bash
+sudo apt install vim
+```
+
+红帽系:
+```bash
+sudo dnf install vim
+```
+
+Arch系
+```
+sudo pacman -S vim
+```
## 模式
-模式是vim中最具特色的概念,我们只需要看编辑器的左下角就可以分别当前的模式
-对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是
+模式是vim中最具特色的概念,我们只需要看编辑器的左下角就可以分别当前的模式,对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是。
- **INSERT** -> 插入模式
- - 插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式
- - 当你处于插入模式的时候, **左下角会出现 INSERT**
+
+插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式。
+当你处于插入模式的时候, **左下角会出现 INSERT**。
- **NORMAL** -> 普通模式
- - 普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**
- - 当你处于普通模式的时候, **左下角是空的**,普通是默认的模式
+
+普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**。
+当你处于普通模式的时候, **左下角是空的**,普通是默认的模式。
- **COMMAND** -> 命令模式
- - 命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**
- - 当然这个模式也是可以批量处理文本的(比如说替换之类的操作)
- - 当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中**
----
+命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**。
+这个模式也是可以批量处理文本的(比如说替换之类的操作),当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中**。
## 模式的转换
@@ -36,63 +52,50 @@ Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接å�
因为**所有的模式下,按esc键都能变成普通模式**。
并且 普通模式 只需要按一个键就可以切换到各种模式。
-所以我们只需要记住下面的内容即可 (对于新手来说):
+所以我们作为基础使用者只需要记住下面的内容即可:
当你处于非普通模式的时候:
-- Esc (键盘最左上角的键) -> 回到普通模式
+- `Esc` 回到普通模式
当你处于普通模式的时候:
-- i -> 进入插入模式
-- : -> 进入命令模式(没错这里就是打个冒号)
-
-## 一般流程
-
-- 打开文件
-
- ```bash
- # 使用 vim 打开你需要编辑的文件
- # 语法是 vim 路径
- vim /path/to/file
- ```
-
- 打开之后就是普通模式。
-
-- 移动
-
-这个时候如果不是空的文件,你一般需要移动
-可以直接使用方向键
-或者用这个**超人类语法** -> h j k l (分别对应 左 下 上 右 的方向键)
+- `i` 进入插入模式
+- `:` 进入命令模式
+## 使用
-- 进入插入模式进行编辑
+打开文件
+```bash
+# 使用 vim 打开你需要编辑的文件
+# 语法是 vim 路径
+vim /path/to/file
+```
- 按下 `i` 键, **看到左下角出现INSERT**,然后就是正常的编辑工作
+打开之后就是普通模式。
-- 保存修改
- 我们需要使用命令模式保存修改,所以第一步是先按 Esc 回到普通模式。
+移动
- 这个时候你会发现左下角的INSERT消失了,
+- 使用方向键或`h` `j` `k` `j`,对应为上下左右。
- 然后按 `:` 进入命令模式 -> 你会看到左下角出现冒号
+保存
- 输入 `w` (表示我要将修改写入文件, 也就是 write)
+- 在COMMAND模式下输入`:w`
- 回车 (这个时候你已经保存了修改)
+退出
- 输入 `q` (表示我要退出vim, 也就是quit)
+- 在COMMAND模式下输入`:q`
- 回车
+强制退出
- 这个时候你已经成功使用 vim 完成了编辑工作
+- 在COMMAND模式下输入`:q!`
- > 当然命令模式是可以一次执行多个命令的, 可以直接 `:wq` 表示保存并退出文件
+保存并退出
----
+- 在COMMAND模式下输入`:wq`
-## 教程补充
+## 关于更多
-> 这里补充一些教程,但是入门的话使用当前的文档足矣
+受限于我们的专门性,建议通过其他专门性教程学习vim。
-[蛋老师Bilibili教程](https://www.bilibili.com/video/BV13t4y1t7Wg?t=87.5)
+- [菜鸟教程](https://www.runoob.com/linux/linux-vim.html)
diff --git a/docs/applications/zsh.md b/docs/applications/zsh.md
index f99c5c1..bb8928a 100644
--- a/docs/applications/zsh.md
+++ b/docs/applications/zsh.md
@@ -1,5 +1,7 @@
# Zsh
+## 概述
+
Zsh是一款拥有高度自定义性的[Shell](../concepts/linux/shell.md),它具有强大的自动补全、语法高亮,并且由于Oh My Zsh的支持,拥有海量主题与插件,特别适合用于美化。
## 安装
@@ -8,13 +10,25 @@ Zsh是一款拥有高度自定义性的[Shell](../concepts/linux/shell.md),它
以下命令用于安装Zsh与部分推荐扩展。
-- Debian: `sudo apt install zsh zsh-autosuggestions zsh-syntax-highlighting`
-- Fedora: `sudo dnf install zsh zsh-autosuggestions zsh-syntax-highlighting`
-- Arch: `sudo pacman -S zsh zsh-completions zsh-autosuggestions zsh-syntax-highlighting`
+Debian系:
+```bash
+sudo apt install zsh zsh-autosuggestions zsh-syntax-highlighting
+```
+
+红帽系
+```bash
+sudo dnf install zsh zsh-autosuggestions zsh-syntax-highlighting
+```
+
+Arch系
+```bash
+sudo pacman -S zsh zsh-autosuggestions zsh-syntax-highlighting
+```
安装好后,您可以运行`chsh -s /bin/zsh`来设置Zsh为默认终端。
-部分发行版源的`zsh`包,在初次运行`zsh`时,会询问您想要如何配置`.zshrc`(Zsh的配置文件)。我们建议您输入2来选择`(2) Populate your ~/.zshrc with the configuration recommended by the system administrator and exit (you will need to edit the file by hand, if so desired).`(默认推荐配置)。
+???+info "注意"
+ 部分发行版源的`zsh`包,在初次运行`zsh`时,会询问您想要如何配置`.zshrc`(Zsh的配置文件)。我们建议您输入2来选择`(2) Populate your ~/.zshrc with the configuration recommended by the system administrator and exit (you will need to edit the file by hand, if so desired).`(默认推荐配置)。
### Oh My Zsh