diff options
Diffstat (limited to 'docs/applications/editors')
| -rw-r--r-- | docs/applications/editors/emacs.md | 224 | ||||
| -rw-r--r-- | docs/applications/editors/nano.md | 182 | ||||
| -rw-r--r-- | docs/applications/editors/vim.md | 101 | ||||
| -rw-r--r-- | docs/applications/editors/vscode.md | 42 |
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 + + + +## 概述 + +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的核心代码开源,但诸如扩展市场、同步等功能仍然闭源且由微软掌控,仅仅在微软进行编译时被加入源代码。 + + + +## 安装 + +!!! 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)。 |
