fold.cnx

Vim 中文文档

zD		循环删除 (Delete) 光标下的折叠。在可视模式下（基本上）所有在所选
		区域的折叠和嵌套的折叠都被删除。
		仅当 'foldmethod' 设为 "manual" 或 "marker" 时有效。
		参考 |fold-delete-marker|。

							*zE* *E352*
zE		除去 (Eliminate) 所有在窗口里的折叠。
		仅当 'foldmethod' 设为 "manual" 或 "marker" 时有效。
		参考 |fold-delete-marker|。


打 开 和 关 闭 折 叠 ~

一个小于 'foldminlines' 的折叠的显示就象它被打开时一样。所以，以下的命令对于小
折叠所起的作用与描述不同。

							*zo*
zo		打开 (open) 在光标下的折叠。当给定一个数字时，相应深度的折叠被
		打开。在可视模式下，所选区域的所有行的一级折叠被打开。

							*zO*
zO		循环打开 (Open) 光标下的折叠。不在光标下的折叠不改变。
		在可视模式下，打开所有的在选中区域里的折叠，包括被部分选中的。

							*zc*
zc		关闭 (close) 在光标下的折叠。当给定一个数字时，相应深度的折叠被
		关闭。在可视模式下，所选区域里的所有行的一级折叠被关闭。
		'foldenable' 被设定。

							*zC*
zC		循环关闭 (Close) 在光标下的所有折叠。不在光标下的折叠不改变。
		在可视模式下，关闭所有的在选中区域里的折叠，包括被部分选中的。
		'foldenable' 被设定。

							*za*
za		当光标位于一关闭的折叠上时，打开之。当折叠嵌套时，你可以使用
		"za" 数次。当给定一个数字时，打开相应数量的被关闭的折叠。
		当光标位于一打开的折叠上时，关闭之且设定 'foldenable' 。这仅关
		闭一级折叠，因为再次使用 "za" 将再次打开折叠。当给定一个数字时，
		关闭相应数量的折叠（这不同于重复 "za" 许多次）。

							*zA*
zA		当处在一关闭的折叠上时，循环的打开折叠。
		当处在一打开的折叠上时，循环的关闭折叠且设定 'foldenable' 。

							*zv*
zv		查看 (view) 光标所在的行：仅打开足够的折叠使光标所在的行不被折叠。

							*zx*
zx		更新折叠：撤消被手工打开和关闭的折叠：再次使 'foldlevel' 生效。然
		后使用 "zv" ：查看光标所在行。

							*zX*
zX		手工恢复被打开和关闭的折叠：再次使用 'foldlevel'

							*zm*
zm		折起更多 (more)：'foldlevel' 减 1。如果 'foldlevel' 已经为 0，
		则不会被减小。
		'foldenable' 被设定。

							*zM*
zM		关闭所有折叠：'foldlevel' 设为0。
		'foldenable' 被设定。

							*zr*
zr		减少 (reduce) 折叠： 'foldlevel' 加 1。

							*zR*
zR		打开所有的折叠。'foldlevel' 设为最高级别。

							*:foldo* *:foldopen*
:{range}foldo[pen][!]
		在 {range} 内打开折叠。当加上 [!] 时，所有的折叠都被打开。对查
		看在 {range} 内的所有文本很有用。没有 [!] 时，打开折叠的一级。

							*:foldc* *:foldclose*
:{range}foldc[lose][!]
		在 {range} 内关闭折叠。当加上 [!] 时，所有的折叠都被关闭。对隐
		藏在 {range} 内的所有文本很有用。没有 [!] 时，关闭折叠的一级。

							*zn*
zn		不折叠 (none)：复位 'foldenable'。所有的折叠被打开。

							*zN*
zN		一般折叠 (normal)：设定 'foldenable' 。所有的折叠都展现它们之
		前的样子。

							*zi*
zi		翻转 'foldenable' 的值.


在 折 叠 间 移 动 ~
							*[z*
[z		到当前打开的折叠的开始。如果已在开始处，移到包含这个折叠的折叠
		开始处。如果没有包含它的折叠，命令执行失败。
		当给定一数字，重复此命令 N 次。

							*]z*
]z		到当前打开的折叠的结束。如果已在结束处，移到包含这个折叠的折叠
		结束处。如果没有包含它的折叠，命令执行失败。
		当给定一数字，重复此命令 N 次。

							*zj*
zj		向下移动。到达下一个折叠的开始处。关闭的折叠也被计入。
		当给定一数字，重复此命令 N 次。
		此命令可在 |operator| 后使用。

							*zk*
zk		向上移动到前一折叠的结束处。关闭的折叠也被计入。
		当给定一数字，重复此命令 N 次。
		此命令可在 |operator| 后使用。


对 折 叠 执 行 命令 ~

:[range]foldd[oopen] {cmd}			*:foldd* *:folddoopen*
		对所有不在关闭的折叠中的行执行 {cmd}。
		给定 [range] 时，仅对范围内那些行起作用。
		每次命令被执行时，光标会被定位在要被操作的行上。
		就如 ":global" 命令：首先标记出所有不在关闭的折叠中的行。然后
		对所有标记过的行，执行 {cmd}。所以当 {cmd} 改变了文本的折叠时
		，对命令执行的位置没有影响（当然，删除行例外）。
		如： >
			:folddoopen s/end/loop_end/ge
<		使用标志 "e" 要避免当 "end" 不匹配时得到错误消息。

:[range]folddoc[losed] {cmd}			*:folddoc* *:folddoclosed*
		对所有在关闭的折叠里的行，执行 {cmd}。
		其它同 ":folddoopen" 命令。

==============================================================================
3. 折叠选项					*fold-options*

颜 色							*fold-colors*

对关闭的折叠的颜色的设定由 |hl-Folded| 决定。对折叠栏的颜色的设定由
|hl-FoldColumn| 决定。
下面是设定颜色的例子： >

	:highlight Folded guibg=grey guifg=blue
	:highlight FoldColumn guibg=darkgrey guifg=white


折 叠 级 别						*fold-foldlevel*

'foldlevel' 是个数字选项：数字越大则打开的折叠更多。
当 'foldlevel' 为 0 时，所有的折叠关闭。
当 'foldlevel' 为正数时，一些折叠关闭。
当 'foldlevel' 很大时，所有的折叠打开。
'foldlevel' 的改变生效后，折叠可以被手动地打开和关闭。
当其值增大，在新级别之上的折叠被打开。没被手工打开的折叠会被关闭。
当其值减小，在新级别之上的折叠被关闭。没被手工关闭的折叠会被打开。


折 叠 文 本						*fold-foldtext*

'folftext' 是个字符串选项，定义了一个表达式。这个表达式被用来求得对关闭的折叠
要显示文字的。如： >

    :set foldtext=v:folddashes.substitute(getline(v:foldstart),'/\\*\\\|\\*/\\\|{{{\\d\\=','','g')

显示了折叠的第一行，除去其中的 "/*", "*/" 和 "{{{" 。
Note：使用反斜杠是为了避免一些字符被 ":set" 命令解释。使用一个函数更简单： >

    :set foldtext=MyFoldText()
    :function MyFoldText()
    :  let line = getline(v:foldstart)
    :  let sub = substitute(line, '/\*\|\*/\|{{{\d\=', '', 'g')
    :  return v:folddashes . sub
    :endfunction

计算 'foldtext' 是在 |sandbox| 里完成的。所要显示的内容在当前窗口出现。错误被
忽略。

默认值是 |foldtext()|。对于大多数类型的折叠它可以返回适合的文字。如果你不喜欢
它，你可以自己指定 'foldtext' 。可以使用以下这些 Vim 变量：
	v:foldstart	在折叠里的第一行
	v:foldend	在折叠里的最后一行
	v:folddashes	一个含有逗号的字符串用来表示折叠级别
	v:foldlevel	折叠级别

在结果中，TAB 被替换为空格，且不可打印的字符被替换为可打印的字符。

结果行被截短以适合窗口的宽度，而不会使用换行。
当在文字后有空余时，用 'fillchars' 来填充。

Note：对那些 ":set" 命令作特殊处理的字符在其前面需加上反斜杠。如：空格，反斜杠
和双引号。 |option-backslash|


折 叠 栏						*fold-foldcolumn*

'foldcolumn' 是个数字，它设定了在窗口的边上表示折叠的栏的宽度。当为0时，没有折
叠栏。一个普通值是 4 或 5。最小可用的值是2，最大是12。

一个打开的折叠由一栏来表示，顶端是 '-' 其下方是 '|'。这栏在折叠结束的地方结
束。当折叠嵌套时，嵌套的折叠对其被包含的折叠右移一字符而成。

一个关闭的折叠由 '+' 表示。

当折叠栏太窄而不能显示所有折叠时，显示一数字来表示嵌套的级别。

在折叠栏点击鼠标，可以打开和关闭折叠：
- 点击 '+' 打开在这行关闭的折叠
- 在任何其他非空字符上点击，来关闭在这行上的折叠


其 他 选 项

'foldenable'  'fen':	当没有设定时，打开所有折叠。
'foldexpr'    'fde':	用于 "expr" 折叠的表达式。
'foldignore'  'fdi':	用于 "indent" 折叠的字符。
'foldmarker'  'fmr':	用于 "marker" 折叠的标志。
'foldmethod'  'fdm':	当前折叠方式。
'foldminlines' 'fml':	一个折叠的最小显示行数。
'foldnestmax' 'fdn':	用于"indent" 和 "syntax" 折叠的最大嵌套数。
'foldopen'    'fdo':	哪一种命令可以打开关闭的折叠。
'foldclose'   'fcl':	当光标不在折叠上时关闭折叠。

==============================================================================
4. 折叠表现						*fold-behavior*

当上下移动和滚动时，光标将移至连续折叠的行的第一行。当光标已在被折叠的行上时，
它移动到下一个没有被折叠的行上，或下一个关闭的折叠。

当光标在被折叠的行上时，光标总是显示在第一栏里。光标本应被在其实际位置被显示，
但因为被折叠而无法做到。

移动命令处理连续被折叠的行就象处理空行一样。如， "w" 命令在第一栏停一次。

在插入模式下，光标所在的行不会被折叠。这让你看得见你键入的内容。

当使用操作符时，一个关闭的行被作为整体处理。所以 "dl" 在光标下删除了整个关闭的
折叠。

对 Ex 命令的执行范围总是从折叠的第一行到折叠的最后一行。所以，命令： >
	:s/foo/bar/g
当光标在关闭的折叠上时，它将在整个折叠里用 "bar" 替换 "foo" 。
对 |:folddoopen| 和 |:folddoclosed| 不会产生这种情况。

当在编辑一个已经被编辑过的缓冲时，上次被使用的折叠设置会被再次使用。对手工定义
折叠方式，已经被定义的折叠会被恢复。对所有的折叠方式，手工打开和关闭的折叠会被
恢复。如果这个缓冲曾经在这个窗口里被编辑，过去用的值被恢复。否则，来自过去编辑
窗口的值被使用。

==============================================================================
 vim:tw=78:ts=8:ft=help:norl: