translate commands and common problems

chapter/Commands.md

@@ -0,0 +1,61 @@
+## 命令
+
+下面的命令都比较有用，最好了解一下。用 `:h :<command name>` 来了解更多关于它们的信息，如：`:h :global`。
+
+
+### :global 和 :vglobal
+
+在所有符合条件的行上执行某个命令。如： `:global /regexp/ print` 会在所有包含 "regexp" 的行上执行 `print` 命令（译者注：regexp 有正则表达式的意思，该命令同样支持正则表达式，在所有符合正则表达式的行上执行指定的命令）。
+
+趣闻：你们可能都知道老牌的 grep 命令，一个由 Ken Thompson 编写的过滤程序。它是干什么用的呢？它会输出所有符合指定正则表达式的行！现在猜一下 `:global /regexp/ print` 的简写形式是什么？没错！就是 `:g/re/p` 。 Ken Thompsom 在编写 grep 程序的时候是受了 vi `:global` 的启发。（译者注： https://robots.thoughtbot.com/how-grep-got-its-name）
+
+它的名字是 `:global`，理应仅作用在所有行上，但是它也是可以带范围限制的。假设你想使用 `:delete` 命令删除从当前行到下一个空行（由正则表达式 `^$` 匹配）范围内所有包含 "foo" 的行：
+
+```vim
+:,/^$/g/foo/d
+```
+
+如果要在所有 _不_ 匹配的行上执行命令的话，可以使用 `:global!` 或是它的别名 `:vglobal` （ V 代表的是 inVerse ）。
+
+
+
+### :normal 和 :execute
+
+这两个命令经常在 Vim 的脚本里使用。
+
+`:normal` 用于使用命令行进行普通模式的映射。如：`:normal! 4j` 会令光标下移4行（由于加了"!"，所以不会使用自定义的映射 "j"）。
+
+需要注意的是 `:normal` 同样支持数量，故 `:%norm! Iabc` 会在所有行前加上 "abc"。
+
+借助于 `:execute` 可以将命令和表达式混合在一起使用。假设你正在编辑一个 C 语言的文件，想切换到它的头文件：
+
+```vim
+:execute 'edit' fnamemodify(expand('%'), ':r') . '.h'
+```
+
+（译者注：头文件为与与源文件同名但是扩展名为 `.h` 的文件。上面的命令中 expand 获得当前文件的名称，fnamemodify 获取不带扩展名的文件名，再连上 '.h' 就是头文件的文件名了，最后在使用 edit 命令打开这个头文件。）
+
+这两个命令经常一起使用。假设你想让光标下移 N 行：
+
+```vim
+:let n = 4
+:execute 'normal!' n . 'j'
+```
+
+
+### :redir
+
+许多命令都会输出消息，`:redir` 可以重定向这些输出。可以输出到文件、[寄存器](#register)中或是某个变量中。
+
+```vim
+:redir => neatvar
+:reg
+:redir END
+:echo neatvar
+:" 为了有趣，我们把它输出到当前缓冲区
+:put =neatvar
+```
+
+（译者注：原文最后一条命令是 `:put =nicevar` 但是实际会变量未定义的错误）
+
+帮助文档：`:h :redir`

chapter/Common-problems.md

@@ -0,0 +1,113 @@
+## 常见问题
+
+### 编辑小文件时很慢
+
+有两个对性能影响非常大的因素：
+
+1. 过于复杂的 **正则表达式** 。尤其是 Ruby 的语法文件，造成性能的下降。（见[调试语法文件](#debugging-syntax-files)）
+
+2. **屏幕重绘** 。有一些功能会强制重绘所有行。
+
+| 肇事者 | 原因？ | 解决方案？|
+|--------|--------|-----------|
+| `:set cursorline` | 会导致所有行重绘 |  `:set nocursorline` |
+| `:set cursorcolumn` | 会导致所有行重绘 | `:set nocursorcolumn` |
+| `:set relativenumber` | 会导致所有行重绘 | `:set norelativenumber` |
+| `:set foldmethod=syntax` | 如果语法文件已经很慢了，这只会变得更慢 | `:set foldmethod=manual`，`:set foldmethod=marker` 或者使用[快速折叠](https://github.com/Konfekt/FastFold)插件 |
+| `:set synmaxcol=3000` | 由于内部表示法，Vim 处理比较长的行时会有问题。让它高亮到3000列…… | `:set synmaxcol=200` |
+| matchparen.vim | Vim 默认加载的插件，用正则表达式查找配对的括号 | 禁用插件：`:h matchparen` |
+
+
+**注意**：只有在你真正遇到性能问题的时候才需要做上面的调整。在大多数情况下使用上面提到的选项是完全没有问题的。
+
+
+### 编辑大文件的时候很慢
+
+Vim 处理大文件最大的问题就是它会一次性读取整个文件。这么做是由于缓冲区的内部机理导致的。（在 [vim_dev](https://groups.google.com/forum/#!topic/vim_dev/oY3i8rqYGD4/discussion) 中讨论）
+
+如果只是想查看的话，`tail hugefile | vim -` 是一个不错的选择。
+
+如果你能接受没有语法高亮、禁用所有插件和设置的话：
+
+```sh
+$ vim -u NONE -N
+```
+
+这将会使得跳转变快很多，尤其是省去了基于很耗费资源的正则表达式的语法高亮。你还可以告诉 Vim 不要使用交换文件和 viminfo 文件，以避免由于写这些文件而造成的延时：
+
+```sh
+$ vim -n -u NONE -i NONE -N
+```
+
+简而言之，尽量避免使用 Vim 写过大的文件。 :\
+
+
+
+### 持续粘贴（为什么我每次都要设置 'paste' 模式）
+
+持续粘贴模式让终端模拟器可以区分输入的文本与粘贴的文本。
+
+你有没有遇到过往 Vim 里粘贴代码之后被搞的一团糟？
+
+这在你使用 `cmd+v`、`shirt-insert`、`middle-click` 等进行粘贴的时候才会发生。因为那样的话你只是向终端模拟器扔了一大堆的文本。 Vim 并不知道你刚刚是粘贴的文本，它以为你在飞速的输入。于是它想缩进这些行但是失败了。
+
+这明显不是个问题，如果你用 Vim 的寄存器粘贴，如：`"+p` ，这时 Vim 就知道了你在粘贴。
+
+使用 `:set paste` 就可以解决这个问题正常进行粘贴。见 `:h 'paste'` 和 `:h 'pastetoggle` 获取更多信息。
+
+如果你受够了每次都要设置 `'paste'` 的痛苦的话，看看这个能帮你自动设置的插件：[bracketed-paste](https://github.com/ConradIrwin/vim-bracketed-paste)。
+
+[点此](http://cirw.in/blog/bracketed-paste)查看该作者对于该插件的更多描述。
+
+
+### 在终端中按 ESC 后有延时
+
+如果你视命令行如命的话，那么你肯定会用一个叫 _终端模拟器_ 的软件，如 xterm、gnome-terminal、iTerm2等等。（与实际的[终端](https://en.wikipedia.org/wiki/Computer_terminal)不同）
+
+终端模拟器与他们的祖辈一样，使用 [escape sequences](https://en.wikipedia.org/wiki/Escape_sequence) （也叫 _control sequences_ ）来控制如移动光标、改变文本颜色等。它们就是简单的以 escape 字符 开头的 ASCII 字符串（显示成 caret notation 是 `^[` ）。当遇到这样的字符串后，终端模拟器会从[终端信息](https://en.wikipedia.org/wiki/Terminfo)数据库中查找对应的动作。
+
+为了使用问题更加清晰，我会先来解决一下什么是映射超时。在映射存在歧义的时候就会产生映射超时：
+
+```vim
+:nnoremap ,a :echo 'foo'<cr>
+:nnoremap ,ab :echo 'bar'<cr>
+```
+
+两个映射都能正常工作，但是当输入 `,a` 之后，Vim 会延时1秒，因为它要确认用户是否要输入那个 `b`。
+
+Escape sequence 会产生同样的问题：
+
+* `<esc>` 作为返回普通模式或取消某个动作的按键而被大量使用
+* 光标 keys 使用 escape sequences 进行了编码
+* Vim 期望 <kbd>Alt</kbd> （也叫作 _Mate Key_）会发送一个正确的 8-bit 编码的高位，但是这么多终端模拟器并不支持这个（也可能默认没有启用），而只是发送一个 escape sequence 作为代替。
+
+
+你可以这样测试上面的问题： `vim -u NONE -N` 然后输入 `i<c-v><left>` ，你会看到一个以 `^[` 开头的代表了 escape sequence 的字符串。
+
+默认情况下，Vim 用 `:set timeout timeoutlen=1000`，就是说它会等有歧义的映射1秒。这对于映射来说是一个比较合理的值，但是你可以自行定义它的长短：
+
+```vim
+set timeout           " for mappings
+set timeoutlen=1000   " default value
+set ttimeout          " for key codes
+set ttimeoutlen=10    " unnoticeable small value
+```
+
+在 `:h ttimeout` 里你可以找到一个关于这些选项之间关系的小表格。
+
+而如果你在终端里使用了 tmux ，又在 tmux 中使用 Vim 的话，别忘了把下面的配置加入到你的 `~/.tmux.conf`文件中：
+
+```
+set -sg eacape-time 0
+```
+
+
+### Function search undo
+
+* 在命令中的搜索（`/`、`:substitute` 等）会改变『上次使用的搜索内容』。（它保存在`/`寄存器中，用 `:echo @/` 可以输出它里面的内容）
+* 简单的文本变化可以通过 `.` 重做。（它保存在 `.` 寄存器，用 `:echo @.` 可以输出它的内容）
+
+而在你在函数中进行这些操作的时候，一切就会变得不同。因为你不能简单的查找某个函数刚刚查找的内容，也不能重做函数中对文本的修改。
+
+帮助文档：`:h function-search-undo`。
+