update chapter title

dofy · Nov 15, 2023 · 78e04fc · 78e04fc
1 parent cd547d4
commit 78e04fc
Show file tree

Hide file tree

Showing 17 changed files with 209 additions and 160 deletions.
diff --git a/README.md b/README.md
@@ -61,8 +61,8 @@ symbols such as the current line)_
 > [!NOTE]
 >
 > If you already have your own `.vimrc` file (refer to
-> [Chapter 4](en/chapter04.md)) and have changed some of the defaults in it, it may
-> cause some operations to not match the tutorial. In this case, you can run
+> [Chapter 4](en/chapter04.md)) and have changed some of the defaults in it, it
+> may cause some operations to not match the tutorial. In this case, you can run
 > `Vim` with the following command:
 >
 > ```bash
@@ -76,17 +76,17 @@ symbols such as the current line)_
 
 ### Basic operations
 
-1. [Cursor movement](en/chapter01.md)
-1. [Opening Files, Finding Content](en/chapter02.md)
-1. [Modify and save documents](en/chapter03.md)
-1. [Some tips](en/chapter04.md)
-1. [Split screen and tabs](en/chapter05.md)
-1. [Block operations](en/chapter06.md)
-1. [Macros in Vim](en/chapter07.md)
-1. [Vim Modes](en/vim-modes.md)
+1. [Chapter 1: Cursor Movement](chapter01.md)
+1. [Chapter 2: Opening Files, Finding Content](chapter02.md)
+1. [Chapter 3: Modify and Save Documents](chapter03.md)
+1. [Chapter 4: Some Tips](chapter04.md)
+1. [Chapter 5: Split Screen and Tabs](chapter05.md)
+1. [Chapter 6: Block Operations](chapter06.md)
+1. [Chapter 7: Macros in Vim](chapter07.md)
 
 ### Additional content
 
+1. [Vim Modes](en/vim-modes.md)
 1. [Vim plugins](en/plugin.md)
 1. [Plugin Recommendations](en/plugins/index.md)
    1. [NERDTree](en/plugins/nerdtree.md)

diff --git a/en/README.md b/en/README.md
@@ -76,18 +76,18 @@ symbols such as the current line)_
 
 ### Basic operations
 
-1. [Cursor Movement](chapter01.md)
-1. [Opening Files, Finding Content](chapter02.md)
-1. [Modify and Save Documents](chapter03.md)
-1. [Some Tips](chapter04.md)
-1. [Split Screen and Tabs](chapter05.md)
-1. [Block Operations](chapter06.md)
-1. [Macros in Vim](chapter07.md)
-1. [Vim Modes](vim-modes.md)
+1. [Chapter 1: Cursor Movement](chapter01.md)
+1. [Chapter 2: Opening Files, Finding Content](chapter02.md)
+1. [Chapter 3: Modify and Save Documents](chapter03.md)
+1. [Chapter 4: Some Tips](chapter04.md)
+1. [Chapter 5: Split Screen and Tabs](chapter05.md)
+1. [Chapter 6: Block Operations](chapter06.md)
+1. [Chapter 7: Macros in Vim](chapter07.md)
 
 ### Additional content
 
-1. [Vim plugins](plugin.md)
+1. [Vim Modes](en/vim-modes.md)
+1. [Vim plugins](en/plugin.md)
 1. [Plugin Recommendations](plugins/index.md)
    1. [NERDTree](plugins/nerdtree.md)
    1. [EasyAlign](plugins/easyalign.md)

diff --git a/en/chapter01.md b/en/chapter01.md
@@ -1,4 +1,4 @@
-# Cursor Movement
+# Chapter 1: Cursor Movement
 
 Welcome to Chapter 1, this chapter will learn simple cursor movement operations.
 

diff --git a/en/chapter02.md b/en/chapter02.md
@@ -1,4 +1,4 @@
-# Opening Files, Finding Content
+# Chapter 2: Opening Files, Finding Content
 
 ## Open Files
 
@@ -76,7 +76,7 @@ the buffer is the file history of the current Vim session.
 > Now you should have two files in your buffer, you can use `:buffers` or `:ls`
 > command to view, see the buffer list, probably like this:
 
-```
+```vim
 :ls
   1 #h   "chapter01.md"                  line 47
   2 %a   "chapter02.md"                  line 1

diff --git a/en/chapter03.md b/en/chapter03.md
@@ -1,9 +1,10 @@
-# 文档的修改与保存
+# Chapter 3: Modifying and Saving Files
 
 ## 修改文档
 
-你现在已经学会了控制光标、打开文件、切换文件、并在文件中查找内容，这些操作都是在 Vim 的 normal
-模式下进行的。现在，是时候进入 Vim 的另外一种模式 —— insert 模式，学习一下如何修改文件了。
+你现在已经学会了控制光标、打开文件、切换文件、并在文件中查找内容，这些操作都是在
+Vim 的 normal 模式下进行的。现在，是时候进入 Vim 的另外一种模式 —— insert 模式，
+学习一下如何修改文件了。
 
 ### 插入
 
@@ -14,8 +15,9 @@
 - `o` 在下一行插入
 - `O` 在上一行插入
 
-_注意：以上任何一个命令都会使 Vim 进入 insert 模式，进入该模式后光标会发生变化，这时输入的
-文字会直接出现在文档中，按 `Esc` 键或 `Ctrl-[` 或 `Ctrl-C` 退出 insert 模式。_
+_注意：以上任何一个命令都会使 Vim 进入 insert 模式，进入该模式后光标会发生变化，
+这时输入的文字会直接出现在文档中，按 `Esc` 键或 `Ctrl-[` 或 `Ctrl-C` 退出 insert
+模式。_
 
 ### 删除（并保存到 Vim 剪贴板）
 
@@ -28,8 +30,9 @@ _注意：以上任何一个命令都会使 Vim 进入 insert 模式，进入该
 - `cc` 删除当前行并保存到 Vim 剪贴板，同时进入 `INSERT` 模式
 - `c<X>` 删除指定内容并保存到 Vim 剪贴板，同时进入 `INSERT` 模式
 
-_说明： `<X>` 部分是对操作内容的描述，如果要删除一个单词，就输入 `dw` 或者 `de`，要复制当前
-位置到行尾的内容，就输入 `y$`，要删除后面 3 个字符并插入，就输入 `c3l` 诸如此类。_
+_说明： `<X>` 部分是对操作内容的描述，如果要删除一个单词，就输入 `dw` 或者
+`de`，要复制当前位置到行尾的内容，就输入 `y$`，要删除后面 3 个字符并插入，就输入
+`c3l` 诸如此类。_
 
 ### 复制
 
@@ -67,7 +70,8 @@ _说明： `<X>` 部分是对操作内容的描述，如果要删除一个单词
 Change this line to UPPERCASE, THEN TO lowercase.
 ```
 
-> 还有个更好玩的命令 `g~<X>`，先将光标定位到上面那行文本，执行 `0g~$` 看看发生了什么。
+> 还有个更好玩的命令 `g~<X>`，先将光标定位到上面那行文本，执行 `0g~$` 看看发生了
+> 什么。
 
 ### 撤销、重做
 
@@ -83,4 +87,5 @@ Change this line to UPPERCASE, THEN TO lowercase.
 - `:saveas <new filename>` 文件另存为
 - `:w <new filename>` 文件另存一份名为 `<new filename>` 的副本并继续编辑原文件
 
-> 你可以试着把当前（也许已经改得面目全非的）文件另存一份，然后继续[下一章](chapter04.md)的学习。
+> 你可以试着把当前（也许已经改得面目全非的）文件另存一份，然后继
+> 续[下一章](chapter04.md)的学习。
diff --git a/en/chapter04.md b/en/chapter04.md
@@ -1,4 +1,4 @@
-# 一些小技巧
+# Chapter 4: Some Tips
 
 ## 简单设置 Vim
 

diff --git a/en/chapter05.md b/en/chapter05.md
@@ -1,4 +1,4 @@
-# 分屏与标签页
+# Chapter 5: Splitting Windows and Tabs
 
 ## 窗口分屏
 

diff --git a/en/chapter06.md b/en/chapter06.md
@@ -1,11 +1,11 @@
-# 块操作
+# Chapter 6: Block Operations
 
-我们经常会遇到这种情况：某处有一个多行文本，我们要把他复制到代码中用来初始化一个数组。 大部分
-时候我们会这么做：
+我们经常会遇到这种情况：某处有一个多行文本，我们要把他复制到代码中用来初始化一个
+数组。 大部分时候我们会这么做：
 
 - 写好数组声明；
 - 把内容复制到中括号内（大概长成下面那段文本的样子）
-- 然后行首加 `'` 行尾加 `',`，重复直到最后一行（想象一下这段文本有50行）
+- 然后行首加 `'` 行尾加 `',`，重复直到最后一行（想象一下这段文本有 50 行）
 
 > 有了 Vim 块操作就不用这么麻烦了，按 `014gg`，然后跟着选中那一行的指示操作。
 
@@ -21,17 +21,19 @@ https://www.yahaha.net
 ];
 ```
 
-> 现在已经完成了第一步，还需要补前面的 `'`，按 `14gg` 回到那一行，再操作一次，但是这次有三个
-> 地方要变化一下：
+> 现在已经完成了第一步，还需要补前面的 `'`，按 `14gg` 回到那一行，再操作一次，但
+> 是这次有三个地方要变化一下：
 >
 > 1. 第一行按 `$` 时改按 `0`，因为这次要在行首插入；
 > 1. 末行按 `A` 时改按 `I`，块操作中 `A` 是字符后插入， `I` 是字符前插入；
 > 1. 最后按 `<单引号><Esc>`。
 >
-> 最后再做些收尾工作，`19gg$x` 删掉最后一行结尾处的 `,`，然后 `14gg7==` 把代码缩进一下。
+> 最后再做些收尾工作，`19gg$x` 删掉最后一行结尾处的 `,`，然后 `14gg7==` 把代码缩
+> 进一下。
 >
 > Done!
 
-_注意：选择行首行尾的操作也可以在选择完要处理的内容之后执行，即 `Ctrl-v jjj$A',<Esc>`_
+_注意：选择行首行尾的操作也可以在选择完要处理的内容之后执行，即
+`Ctrl-v jjj$A',<Esc>`_
 
 接下来我们说说 [Vim 中的宏](chapter07.md)。
diff --git a/en/chapter07.md b/en/chapter07.md
@@ -1,42 +1,55 @@
-# Vim 中的宏
+# Chapter 7: Vim Macros
 
-宏操作在 Vim 中（甚至任何编辑器中）属于比较复杂的操作了，如果前面的内容都已经掌握了，那么你
-已经可以算是一个 Vim 高手了，所以，这位高手，我们不妨再来进阶一下吧。
+Macros are a more advanced topic in Vim (and any other editor). If you've
+mastered the previous chapters, you're already a Vim master. So, let's take it
+to the next level.
 
-还记得[上一章](chapter06.md)中把文本转成数组的例子吧，我们还做同样的事，不过这次是用宏来操作。
+Do you remember the example of converting text to an array in the
+[previous chapter](chapter06.md)? We'll do the same thing, but this time with
+macros.
 
-> `12gg` 跳转到准备开始处理的起始行，按指示进行操作，先看效果后解释。
+> `16gg` Jump to the start line where you're ready to start processing, follow
+> the instructions, see the effect first and then explain.
 
 ```javascript
 var myArray = [
-按 qa 开启宏录制，前方高能，连续按 I<单引号><Esc>A<单引号><逗号><Esc>jq7@a
-我也要
-我也要
-我也要
-我也要
-我也要
-我也要
-我也要
+Press qa to start recording the macro, and then press I<single quote><Esc>A<single quote><comma><Esc>jq7@a
+Me too
+Me too
+Me too
+Me too
+Me too
+Me too
+Me too
 ];
 ```
 
-OMG! 发生了什么，有没有惊出一身冷汗，之前两次块操作的结果瞬间就完成了，最后再简单做些收尾工作，
-去掉最后一行的逗号，集体缩进一下，搞定！
+OMG! What happened, did you get a cold sweat? The results of the previous two
+block operations were completed in an instant, and finally a little finishing
+work, remove the comma at the end of the last line, indent the collective, done!
 
-下面来解释一下刚才的操作：
+Next, let's explain the operation just now:
 
-- `q` 是开启录制宏，`a` 是给这次宏的录制过程一个存储位置，可以是 0-9 或 a-z；
-- 然后 `I<单引号><Esc>A<单引号><逗号><Esc>j` 是你这次录制的整个宏的操作过程，意思就是行首
-插入单引号，行尾插入单引号和逗号，跳到下一行；
-- 接下来的 `q` 是结束本次宏的录制；
-- `@` 是唤起宏，`a` 是要唤起的宏的名字（存储位置），前面的 `7` 你应该明白吧，就是执行 7 次。
+- `q` is to start recording the macro, `a` is to give the macro recording
+  process a storage location, which can be 0-9 or a-z;
+- Then `I<single quote><Esc>A<single quote><comma><Esc>j` is the operation
+  process of the entire macro you recorded this time, which means inserting a
+  single quote at the beginning of the line, inserting a single quote and a
+  comma at the end of the line, and jumping to the next line;
+- Pressing `q` next ends this macro recording;
+- `@` is to call up the macro, `a` is the name (storage location) of the macro
+  to be called up, and the `7` in front of it should be clear, that is, to
+  execute 7 times.
 
-_Tips：`@@` 再次唤起最后一次执行的宏。_
+_Tips: `@@` calls up the last macro executed again._
 
 ---
 
-日常工作中频繁用到的和不怎么用得上的在这七章中应该都已经涉及到了，如果 Vim 中遇到了什么问题，
-或者教程中遗漏了什么常规操作，欢迎在 [issues](../../issues) 中提出来，我会尽我所能给予回答
-或完善到教程中。
+All the frequently used and not so frequently used in these seven chapters
+should have been covered. If you encounter any problems in Vim, or if you miss
+any regular operations in the tutorial, please feel free to raise them in
+[issues](../../issues), and I will do my best to answer them or improve them in
+the tutorial.
 
-**再次感谢您的关注！如果爱，请分享。爱极客公园，爱 VIM！**
+**Thanks again for your interest! If you love, please share. Love life, love
+VIM!**
diff --git a/zh-CN/README.md b/zh-CN/README.md
@@ -68,17 +68,17 @@ _注意：命令区分大小写（需要注意的事项会出现在当前行这
 
 ### 基础操作
 
-1. [光标的移动](chapter01.md)
-1. [打开文件、查找内容](chapter02.md)
-1. [文档的修改与保存](chapter03.md)
-1. [一些小技巧](chapter04.md)
-1. [分屏与标签页](chapter05.md)
-1. [块操作](chapter06.md)
-1. [Vim 中的宏](chapter07.md)
-1. [Vim 的模式](file-modes.md)
+1. [第一章：光标的移动](chapter01.md)
+1. [第二章：打开文件、查找内容](chapter02.md)
+1. [第三章：文档的修改与保存](chapter03.md)
+1. [第四章：一些小技巧](chapter04.md)
+1. [第五章：分屏与标签页](chapter05.md)
+1. [第六章：块操作](chapter06.md)
+1. [第七章：Vim 中的宏](chapter07.md)
 
 ### 附加内容
 
+1. [Vim 的模式](file-modes.md)
 1. [Vim 插件](plugin.md)
 1. [插件推荐](plugins/index.md)
    1. [NERDTree](plugins/nerdtree.md)

diff --git a/zh-CN/chapter01.md b/zh-CN/chapter01.md
@@ -1,4 +1,4 @@
-# 光标的移动
+# 第一章：光标移动
 
 欢迎进入第一章，这一章将学习简单的光标移动操作。
 
@@ -7,12 +7,14 @@
 ## 移动光标
 
 ### 单位级
+
 - `h` 向左一字符
 - `j` 下一行
 - `k` 上一行
 - `l` 向右一字符
 
 ### 单词级
+
 - `w` or `W` 向右移动到下一单词开头
 - `e` or `E` 向右移动到单词结尾
 - `b` or `B` 向左移动到单词开头
@@ -29,6 +31,7 @@ and welcome to https://yahaha.net :)
 ```
 
 ### 块级
+
 - `gg` 到文档第一行
 - `G` 到文档最后一行
 - `0` 到行首（第 1 列）
@@ -45,12 +48,13 @@ and welcome to https://yahaha.net :)
 - `:+<N>` or `<N>j` 向下跳 N 行
 - `:-<N>` or `<N>k` 向上跳 N 行
 
-_注意：所有命令前都可以加一个数字 N，表示对后面的命令执行 N 次，例如你想向下移动 3 行，除了
-可以用 `:+3` 之外，还可以用 `3j` 来实现同样的效果。另外，上面实际上有两种命令：一种是键入后
-立即执行的，比如 `gg`；还有一种是先输入 `:` 的（后面还会出现先按 `/` 的），这类命令需要在
-输入完成后按回车执行，后面的教程中也是一样。_
+_注意：所有命令前都可以加一个数字 N，表示对后面的命令执行 N 次，例如你想向下移动
+3 行，除了可以用 `:+3` 之外，还可以用 `3j` 来实现同样的效果。另外，上面实际上有
+两种命令：一种是键入后立即执行的，比如 `gg`；还有一种是先输入 `:` 的（后面还会出
+现先按 `/` 的），这类命令需要在输入完成后按回车执行，后面的教程中也是一样。_
 
-> 现在你可以在当前文件中畅游了，当你熟悉了各种移动操作后就可以通过 `G` 定位到当前文档到最后
-> 一行，按照提示进入下一章了。
+> 现在你可以在当前文件中畅游了，当你熟悉了各种移动操作后就可以通过 `G` 定位到当
+> 前文档到最后一行，按照提示进入下一章了。
 >
-> 将光标定位到后面文件名的任意位置上，直接敲键盘 `gf` 进入[第二章](chapter02.md)。
+> 将光标定位到后面文件名的任意位置上，直接敲键盘 `gf` 进
+> 入[第二章](chapter02.md)。