aboutsummaryrefslogtreecommitdiff
path: root/docs/applications/editors
diff options
context:
space:
mode:
authorsayo <rg32@ciallo.tech>2026-08-19 10:48:09 +0000
committersayo <rg32@ciallo.tech>2026-08-19 10:50:17 +0000
commit6f7b9128cec783d4032faf8a17b528d9d98c91e4 (patch)
treebf8c50fd1dfc1418a477e8cfb781e6f48c813f60 /docs/applications/editors
parentflatpak hyperlink fix (diff)
parentMerge pull request 'docs: 完成了关于fastfetch的介绍' (#21) from a42-good/linux-handbook-d... (diff)
merged upstream into branch obs-studio
Diffstat (limited to 'docs/applications/editors')
-rw-r--r--docs/applications/editors/emacs.md224
-rw-r--r--docs/applications/editors/nano.md182
-rw-r--r--docs/applications/editors/vim.md101
-rw-r--r--docs/applications/editors/vscode.md42
4 files changed, 549 insertions, 0 deletions
diff --git a/docs/applications/editors/emacs.md b/docs/applications/editors/emacs.md
new file mode 100644
index 0000000..bbc5662
--- /dev/null
+++ b/docs/applications/editors/emacs.md
@@ -0,0 +1,224 @@
+# Emacs
+
+![emacs](https://www.gnu.org/software/emacs/images/emacs.png)
+
+## 概述
+
+GNU Emacs ,简称 Emacs ,是一个文本编辑器,采用 Emacs Lisp 作为配置语言。作为 Lisp 解释器,Emacs 功能强大 (包括但不限于发邮件,使用irc聊天,阅读新闻和RSS订阅,玩俄罗斯方块) 。
+
+Emacs 是[自由软件](https://www.gnu.org/philosophy/free-sw.html),是 [GNU 操作系统](https://www.gnu.org/) 的一部分。
+Emacs 采用 [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0) 协议发布。
+
+## 安装
+
+Debian系:
+```bash
+sudo apt install emacs
+```
+
+???- note "如果您正在使用 Wayland"
+ 默认的 `emacs-gtk` 在 Wayland 下可能会导致各种问题。使用 `emacs-pgtk`:
+ ```bash
+ sudo apt install emacs emacs-gtk- emacs-pgtk+ --purge
+ ```
+
+红帽系:
+```bash
+sudo dnf install emacs
+```
+
+Arch系:
+```bash
+sudo pacman -S emacs
+```
+
+Emacs 可以使用 [Flatpak](../../applications/apps.md#flatpak) 安装,但我们不建议使用该方法。
+```bash
+flatpak install org.gnu.emacs
+```
+
+## 使用
+
+### 快捷键
+
+???+ note "Emacs 风味的组合键描述"
+ - `C`-`...`: `C` 是 Ctrl
+ - `M`-`...`: `M` 是 Alt
+ - `s`-`...`: `s` 是 Super,或者在大多数键盘上,Windows
+ - `...`-`SPC`: `SPC` 是 space,空格
+
+ 最后一项是基础键,前面的全都是修饰键。 `C`-`c` 是 Ctrl + C; `M`-`c` 是 Alt + C; `C`-`M`-`c` 是 Ctrl + Alt + C ...
+
+ **Shift去哪里了?
+ 没有 Shift!**在 Emacs 里我们用已经“被大写”的字符来代替 Shift。比如
+
+ - `M`-`<`: Alt + Shift + ,
+ - `M`-`,`: Alt + ,
+
+**文件**
+`C-x C-c` 退出Emacs
+`C-x C-s` 保存文件
+
+**光标**
+`C-p/n/b/f` 或 `<up>/<down>/<left>/<right>` 使光标上下左右移动
+
+`M-{/}` 纵向移动一个段落
+`M-b/f` 横向移动一个单词
+`C-a/e` 移动到行头或行尾
+`M-</>` 移动到文件头或文件尾
+
+**删除,撤销**
+`C-k` 删除光标后面的所有文本
+`C-d` 向后删除
+`C-/` 或 `C-x` `u` 撤销操作
+
+**搜索**
+`C-s` 搜索关键词(向后)
+`C-r` 搜索关键词(向前)
+`M-%` 查找并替换
+
+**命令**
+`M-x` 输入命令
+
+**多任务**
+`C-x C-f` 打开一个文件
+`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` 官方快速指南
+
+???+ info "注意"
+ 显然这些不是所有的官方配置快捷键,事实上用户可以自己更改快捷键,受限于篇幅和难度这里不多赘述。请参阅 [#关于更多](#_14)。
+
+
+### 简短教程
+
+???+ note "注意"
+ 这篇文章的标题不是《Emacs:从入门到精通》,本篇文章只介绍 Emacs 作为文本编辑器最基础的部分。如果读者想要一篇综合的,完整的教程,请参阅 [#关于更多](#_14)
+
+虽然非常强大,Emacs 出了名地难以学习。下面是一篇入门级教程,以对本文源代码的编辑为例来阐述 Emacs 的基础部分。
+
+#### 下载并打开这篇文章
+
+???+ question "我不熟悉 Markdown"
+ 没有关系!我们不要求读者理解 Markdown 的语法。
+
+用终端运行以下命令:
+```bash
+# 下载
+curl https://codeberg.org/LinuxCabin/linux-handbook/raw/branch/main/docs/applications/editors/emacs.md --output emacs.md
+# 打开
+emacs emacs.md
+```
+如果看到 Emacs 打开并载入了这篇文档,恭喜你,你的 Emacs 安装没有问题!
+
+#### 移动光标
+
+屏幕上闪烁的“小黑方框”就是我们的光标。我们用上下左右键来移动光标。
+
+你应该会感到一格一格移动光标很慢,不妨试试下面的快速移动方法。
+
+- 纵向移动一个段落:`M`-`{` , `M`-`}`
+- 横向移动一个单词:`M`-`b` , `M`-`f`
+
+??? tip "更多组合键"
+ - 移动到行首或行尾:`C`-`a` , `C`-`e`
+ - 移动到整个文件的开头和末尾:`M`-`<` , `M`-`>`
+
+现在试试把光标移到这一行吧。按住下箭头,或者感到足够勇敢,按几次 `M`-`}`。
+
+#### 写入,删除与撤销
+
+和 GNU Nano 很相似,直接打字就可以在 Emacs 里写东西,按退格键就可以删除。
+
+现在把光标移到这一行下面,写下 `Hello world!`
+
+
+
+delete this
+
+试试 `C`-`<backspace>`,这个组合键能删除一整个单词,用它删掉 `delete this`
+
+d e l e t e t h i s
+
+把光标移到 ``d e l e t ...`` 这一行,按下 `C`-`a` `C`-`k`,这个组合键能删除一整行。
+
+按下 `C-/`,它能撤销刚刚做的更改(比如删除)。
+
+??? tip "更多组合键"
+ 用 `C`-`d` 或 `<delete>` 就能向后删除,用 `C`-`<delete>` 向后删除一个单词。
+
+#### 选中,拷贝和粘贴
+
+想象我们在图形化的编辑器里。要选中一段文字,我们会把鼠标指针移到这段文字的头部,按下鼠标,再把指针移到尾部
+
+在 Emacs 里也是这样的,只不过我们用键盘移动光标到头部,按一下 `C`-`SPC`,再移动光标到尾部。试试看吧:
+
+选中这句文字。
+
+
+
+
+???+ tips "提示"
+ [#移动光标](#_6) 的内容可以在这里用哦。
+
+
+连续按两下 `C`-`SPC` 以退出选区。
+
+`C`-`w` 是剪切,`C`-`y` 是粘贴。现在选中上面那段文字,按下 `C`-`w`,再按下 `C`-`y` 试试。
+
+`M`-`w` 是拷贝。把 `C`-`w` 换成 `M`-`w`,重复上面的步骤试试。
+
+
+#### 查找与替换
+
+##### 查找
+
+- 向后查找:`C`-`s`
+- 向前查找:`C`-`r`
+
+现在试试向前查找 ``backspace`` 吧。按 `C`-`r`,输入 ``backspace``,回车。
+
+??? tip "回到搜索前的位置..."
+ 按 `C`-`u` `C`-`SPC` 就可以回到上一个标记的位置。搜索会留下标记,所以可以回到上一个搜索前的位置。
+
+##### 替换
+
+下面的 Emacs 有拼写错误,我们使用 `M`-`%` 查找并替换它。按下 `M`-`%` ,输入 ``Eamcs`` ,再输入 ``Emacs`` ,输入 ``y`` 确认替换。
+
+??? tip "如果不想逐个确认..."
+ Eamcs 有一个命令,叫 ``replace-string``,但是默认不绑定至任何键位。如果要运行它,我们先按 `M`-`x` ,再手动输入 `replace-string`。
+
+#### 保存和退出
+
+我们已经做好了所有更改,是时候保存了。按下 `C`-`x` `C`-`s` ,Emacs 就会保存未更改的内容。
+
+如果要退出 Emacs,按下 `C`-`x` `C`-`c`。
+
+???+ tip "退出且不保存"
+ 当未保存但是按了退出键时,Emacs 会问你需不需要保存,此时输入 ``n`` 就可以不保存并退出。
+
+##### 重置所有内容
+
+Emacs 的 ``revert-buffer`` 命令能删除所有没保存的内容,但是默认不绑定至任何键位。先按 `M`-`x` ,手动输入 ``revert-buffer`` 来执行它。
+
+## 关于更多
+
+受限于我们的专门性,我们不能提供详尽的教程。如果对 GNU Emacs 感到有兴趣,可以前往其他专业性教程进行学习。
+
+- 社区文档
+ - [Emacs轻奢之路](https://www.bilibili.com/video/BV1T64y1R7EL/)
+ - [21天学会Emacs 2022年版本](https://www.bilibili.com/video/BV12P4y1j7EL/)
+ - [Emacs高手修炼手册](https://www.bilibili.com/video/BV13g4y167Zn/)
+ - [专业 Emacs 入门教程](https://www.zhihu.com/column/c_1440829147212279808)
+ - [Emacs Lisp 简明教程](https://smacs.github.io/elisp/)
+
+- [官方文档](https://www.gnu.org/software/emacs/manual/emacs.html)
+
+- [什么是自由软件?](https://www.fsf.org/about/what-is-free-software) \ No newline at end of file
diff --git a/docs/applications/editors/nano.md b/docs/applications/editors/nano.md
new file mode 100644
index 0000000..ae0470d
--- /dev/null
+++ b/docs/applications/editors/nano.md
@@ -0,0 +1,182 @@
+# nano
+
+<!-- 这篇文档使用 GNU nano 编写! -->
+
+```text
+ GNU nano 8.4 Welcome-to-GNU-nano
+
+ :::
+ iLE88Dj. :jD88888Dj:
+.LGitE888D.f8GjjjL8888E; .d8888b. 888b 888 888 888
+iE :8888Et. .G8888. d88P Y88b 8888b 888 888 888
+;i E888, ,8888, 888 888 88888b 888 888 888
+ D888, :8888: 888 888Y88b 888 888 888
+ D888, :8888: 888 88888 888 Y88b888 888 888
+ D888, :8888: 888 888 888 Y88888 888 888
+ D888, :8888: Y88b d88P 888 Y8888 Y88b. .d88P
+ 888W, :8888: "Y8888P88 888 Y888 "Y88888P"
+ W88W, :8888:
+ W88W: :8888: 88888b. 8888b. 88888b. .d88b.
+ DGGD: :8888: 888 "88b "88b 888 "88b d88""88b
+ :8888: 888 888 .d888888 888 888 888 888
+ :W888: 888 888 888 888 888 888 Y88..88P
+ :8888: 888 888 "Y888888 888 888 "Y88P"
+ E888i
+ tW88D
+
+^G Help ^O Write Out ^F Where Is ^K Cut ^T Execute
+^X Exit ^R Read File ^\ Replace ^U Paste ^J Justify
+```
+
+<!-- ascii art from https://www.nano-editor.org/ . licensed under GPL-3.0 . -->
+
+## 概述
+
+GNU nano,简称 nano,是一款小巧易用的终端文本编辑器。
+
+nano 提供撤销/重做、代码高亮、单词补全、查找与替换等基本功能,能够满足一般 Linux 用户的终端文本编辑需求,界面简单易操作,是笔者心目中“功能与复杂度完美平衡”的典例。
+
+<!-- unix哲学,你崛起罢... -->
+
+nano 是[自由软件](https://www.gnu.org/philosophy/free-sw.html),是 [GNU 操作系统](https://www.gnu.org/) 的一部分。
+nano 采用 [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0) 协议发布。
+
+## 快捷键
+
+在 nano 里我们这样表示快捷键:
+
+**Ctrl** 是 `^`,`^x` 表示 **Ctrl** + 一个键*x*
+**Alt** 是 `M-`,`M-x` 表示 **Alt** + 一个键*x*
+<!-- **Shift** 是 `Sh-`,`Sh-x` 表示 **Shift** + 一个键*x* -->
+
+???+ note "示例"
+ `^K` = Ctrl + K
+
+ `^/` = Ctrl + /
+
+ `M-6` = Alt + 6
+
+<!-- `Sh-Tab` = Shift + Tab
+
+ `Sh-^Del` = Shift + Ctrl + Del
+
+我不确定要不要加入shift。如果这是wiki,我绝对会加,但是作为新手向,没几个快捷键用到shift。 -->
+
+nano 窗口的底部会出现一些可用快捷键的提示。
+
+??? info "一些常用的快捷键"
+
+ **文件**
+
+ - `^X`: 退出
+ - `^R`: 打开
+ - `^R` `^T`: 图形化打开
+ - `^O`: 保存为
+ - `^O` `^T`: 图形化保存
+
+ **导航**
+
+ - `^C`: 显示目前光标的位置
+ - `^/`: 前往某一行
+ - `^F`: 查找
+ - `^A`/`^E`: 移直行首/行尾
+ - `^Space`/`M-Space`: 向后/向前一个单词
+
+ **编辑**
+
+ - `^\`: 查找并替换
+ - `M-A`: 进入/退出选区模式
+ - `^K`/`M-6`: 剪切/拷贝
+ - `^U`: 粘贴
+ - `M-U`: 撤销
+ - `M-Bsp`/`^Del`: 向前/向后删除一个单词 (注:`Bsp`是 Backspace,退格键)
+
+ **帮助**
+
+ - `^G`: 帮助
+
+## 安装
+
+大部分 Linux 发行版已经预装了 nano。
+
+??? note "如果需要安装 nano ..."
+
+ [Debian 系](../../distros/debian/graph.md):
+ ``sudo apt install nano``
+
+ [Redhat 系](../../distros/rhel/graph.md):
+ ``sudo yum install nano``
+
+ [Arch 系](../../distros/arch/archlinux.md):
+ ``sudo pacman -S nano``
+
+ [Gentoo Linux](../../distros/gentoo.md):
+ ``sudo emerge nano``
+
+## 使用
+
+<!-- 不像emacs,这篇教程确实是《nano从入门到精通》(笑)-->
+
+### 打开文档
+
+打开终端,输入``nano``,再输入想修改或创建的文件的路径。
+```bash
+nano /path/to/your/file
+```
+
+或者,直接打开``nano``,按 `^R`,再按 `^T`,用方向键选中想打开的文档,按`回车键`。
+```bash
+nano
+```
+
+### 编辑文档
+
+正在闪烁的是光标,使用`方向键`(上下左右)移动光标,在键盘上输入内容会出现在光标处。
+
+#### 复制粘贴
+
+按 `M-A` 进入选区模式,移动光标使选区覆盖想操作的文本。
+
+按 `^K` 剪切选区内的文本;
+按 `M-6` 复制选取内的文本;
+按 `^U` 粘贴到光标的位置。
+
+如果没有设置选区,会剪切或复制光标所在的一整行。
+
+???+ info "从外部粘贴"
+ 如果要从其他软件粘贴(比如游览器),按**终端**设置的快捷键。这通常是 `Sh-^V`( Shift + Ctrl + V )。
+
+#### 查找替换
+
+##### 仅查找
+
+按 `^F`,输入要查找的字符,按`回车键`。
+
+如果找到了,字符会以黄色高亮。
+如果没找到,窗口底部会出现红色的 `not found` 字样。
+
+##### 查找并替换
+
+按 `^\`,输入要替换的字符,按`回车键`;再输入要替换成的字符,按`回车键`。
+nano 会依个询问您每处是否要替换,按 `Y` 替换此处,`N` 保留此处,`A` 替换每处且不再询问,`^C` 取消替换。
+
+如果没找到,窗口底部会出现红色的 `not found` 字样。
+
+### 保存文档
+
+完成更改后,按 `^O`,确认要保存的路径,按`回车键`保存。
+
+或者,按 `^O` 再按 `^T`,使用方向键移动到想保存为的文件,按`回车键`保存。
+
+要退出 nano,按 `^X`。
+
+???+ "可能导致退出不了的原因"
+ 如果有未保存的更改,nano 会询问您是否保存:按 `Y` 保存更改,按 `X` 放弃更改。
+
+## 关于
+
+[GNU nano 官方网站](https://nano-editor.org/): `https://nano-editor.org/`
+
+[GNU nano 在线文档](https://nano-editor.org/dist/latest/nano.html): `https://nano-editor.org/dist/latest/nano.html`
+
+[什么是自由软件?](https://www.gnu.org/philosophy/free-sw.html): `https://www.gnu.org/philosophy/free-sw.html` \ No newline at end of file
diff --git a/docs/applications/editors/vim.md b/docs/applications/editors/vim.md
new file mode 100644
index 0000000..2f96a66
--- /dev/null
+++ b/docs/applications/editors/vim.md
@@ -0,0 +1,101 @@
+# Vim
+
+## 概述
+
+`vim` 是一款轻量高效的终端文本编辑器, 几乎所有的Linux发行版都会预装。
+
+第一次使用vim的人,最大的感受一定是: 反人类。
+Vim 虽然前期学起来困难, 但是上限极高,一旦熟练你很难接受其他的编辑器(我自己是这样的)。
+
+话虽如此,在终端用Vim改个配置文件依旧是很多Linux玩家的日常,
+所以我们有必要稍微学习一下如何使用Vim完成以下基础的操作。
+
+## 安装
+
+Debian系:
+```bash
+sudo apt install vim
+```
+
+红帽系:
+```bash
+sudo dnf install vim
+```
+
+Arch系
+```bash
+sudo pacman -S vim
+```
+
+## 模式
+
+模式是vim中最具特色的概念,我们只需要看编辑器的左下角就可以分别当前的模式,对于新手来说,只需要掌握**三种模式**即可使用vim, 分别是。
+
+- **INSERT** -> 插入模式
+
+插入模式下,你可以**直接编辑内容**,在键盘上面打的每一个字都会如实出现在文件中,相当于普通编辑器的模式。
+当你处于插入模式的时候, **左下角会出现 INSERT**。
+
+- **NORMAL** -> 普通模式
+
+普通模式下,不能使用常规的编辑方式修改文件,而是完全使用**vim语法**实现超级快速的**移动和修改**。
+当你处于普通模式的时候, **左下角是空的**,普通是默认的模式。
+
+- **COMMAND** -> 命令模式
+
+命令模式下,我们通过某些简单的命令来**控制编辑器的行为或者控制终端**。
+这个模式也是可以批量处理文本的(比如说替换之类的操作),当你处于命令模式的时候,**左下角有一个冒号,所有键盘打出来的都会出现在冒号后方,而不是文本中**。
+
+## 模式的转换
+
+我们可以将 **NORMAL** 视作 vim 模式的中心枢纽。
+因为**所有的模式下,按esc键都能变成普通模式**。
+并且 普通模式 只需要按一个键就可以切换到各种模式。
+
+所以我们作为基础使用者只需要记住下面的内容即可:
+
+当你处于非普通模式的时候:
+
+- `Esc` 回到普通模式
+
+当你处于普通模式的时候:
+
+- `i` 进入插入模式
+- `:` 进入命令模式
+
+## 使用
+
+打开文件
+```bash
+# 使用 vim 打开你需要编辑的文件
+# 语法是 vim 路径
+vim /path/to/file
+```
+
+打开之后就是普通模式。
+
+移动
+
+- 使用方向键或`h` `j` `k` `j`,对应为上下左右。
+
+保存
+
+- 在COMMAND模式下输入`:w`
+
+退出
+
+- 在COMMAND模式下输入`:q`
+
+强制退出
+
+- 在COMMAND模式下输入`:q!`
+
+保存并退出
+
+- 在COMMAND模式下输入`:wq`
+
+## 关于更多
+
+受限于我们的专门性,建议通过其他专门性教程学习vim。
+
+- [菜鸟教程](https://www.runoob.com/linux/linux-vim.html)
diff --git a/docs/applications/editors/vscode.md b/docs/applications/editors/vscode.md
new file mode 100644
index 0000000..8408cb0
--- /dev/null
+++ b/docs/applications/editors/vscode.md
@@ -0,0 +1,42 @@
+# VS Code / VSCodium
+
+全称: Visual Studio Code
+
+## 概述
+
+Visual Studio Code是由微软开发的开源IDE,因其庞大的扩展市场与广泛的语言支持而闻名,多数的在线IDE基于VSCode二次开发。VSCodium为VSCode的自由版本,削减了微软提供的遥测等服务,不收集用户数据。
+
+???+ question "VSCodium为什么被称作“自由版本”?"
+ 尽管微软将VSCode的核心代码开源,但诸如扩展市场、同步等功能仍然闭源且由微软掌控,仅仅在微软进行编译时被加入源代码。
+
+![vscode.dev](https://code.visualstudio.com/assets/home/swimlane-anywhere-light.png)
+
+## 安装
+
+!!! warning "警告"
+ 我们**不推荐您安装该应用的Flatpak版本**。由于Flatpak的容器特性,宿主机的部分开发工具可能需要[特殊处理](https://github.com/flathub/com.visualstudio.code#usage)后才能在Flatpak容器内部使用。
+
+### VSCode
+
+微软官方提供了[Linux版的安装教程](https://code.visualstudio.com/docs/setup/linux),该教程主要通过添加微软官方软件源的方式来进行安装。您也可以到[VSCode官网](https://code.visualstudio.com/)下载预编译包来安装。社区也构建了其[Flatpak版本](https://flathub.org/zh-Hans/apps/com.visualstudio.code)。
+
+Arch用户可以通过AUR安装`visual-studio-code-bin`。
+
+同时,微软还提供了[网页版VSCode](https://vscode.dev),在功能上可能略有损失。
+
+### VSCodium
+
+您需要手动前往VSCodium的[Github Releases](https://github.com/VSCodium/vscodium/releases)页面下载安装包,或者使用[Flatpak](https://flathub.org/zh-Hans/apps/com.vscodium.codium)安装。
+
+Arch用户可以通过AUR安装`vscodium-bin`。
+
+## 使用
+
+您可以按下`Ctrl+Shift+P`打开功能面板,进行打开终端、切换语言、预览Markdown等操作。
+
+### 扩展
+
+VSCode的扩展市场涵盖编程语言支持、界面语言支持、IDE插件、界面主题等等扩展(一切皆扩展),您可以根据自己的工作情况按需安装。
+
+???+ note "本地化"
+ 对于中文用户来说,您可能需要安装[中文(简体)界面语言包](https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans)。