Skip to content

Latest commit

 

History

History
114 lines (89 loc) · 6.68 KB

README_zh.md

File metadata and controls

114 lines (89 loc) · 6.68 KB

彩虹括号增强版 (Rainbow Parentheses Improved)

通过将不同层次的括号高亮为不同的颜色, 帮助你阅读世界上最复杂的代码

插件简介:

众所周知,最复杂的代码都是由一堆乱七八糟的括号组成。这款插件通过以不同的颜色展示不同层次的括号,致力于帮助你阅读这样的复杂代码。 你同样可以在Vim官网里看到这款插件

lisp

lisp

html

html

有哪些改进?

  • 更快速和流畅的体验。
  • 简短,高质量,并且易读的源代码。
  • 现在的版本将不再限制括号的嵌套层数。
  • 现在你可以分别自定义图形界面下和终端上所使用的各种括号颜色。
  • 现在你可以自定义括号的形式,不过在这之前你最好了解vim脚本的正则表达式。
  • 现在你甚至可以为不同类型的文件设定不同的配置。
  • 现在你甚至可以决定是否让某些符号跟着它们所在的括号一起高亮,你也可以对不同类型的文件分别设置。
  • 支持点分隔的复合文件类型 (:h ft)
  • 现在采用json风格的配置文件,更加可读,更易于进行高级配置。
  • 最后但并非不重要的一点是,如你所见,现在增加了中文说明。

以下是本插件所参考的旧版本:

安装说明:

使用Vundle安装:

Bundle 'luochen1990/rainbow'
let g:rainbow_active = 1 "0 if you want to enable it later via :RainbowToggle

手动安装:

  • 首先,执行以下命令 (Windows用户需要使用 ~/vimfiles 替代 ~/.vim) 。

     git clone https://github.com/luochen1990/rainbow.git
     cd rainbow
     cp plugin/* ~/.vim/plugin
     cp autoload/* ~/.vim/autoload
  • 然后,将以下句子,加入到你的vim配置文件中(windows下配置文件是_vimrc,而linux下是.vimrc

     let g:rainbow_active = 1 "0 if you want to enable it later via :RainbowToggle
  • 最后,重新启动你的vim,你就可以享受coding了。

高级配置:

以下是一个配置的样例(也是我在用的配置),将它加入到你的vimrc并按照你喜欢的方式修改它(但是保持格式)你就可以精确地控制插件的行为了。

	let g:rainbow_conf = {
	\	'guifgs': ['royalblue3', 'darkorange3', 'seagreen3', 'firebrick'],
	\	'ctermfgs': ['lightblue', 'lightyellow', 'lightcyan', 'lightmagenta'],
	\	'operators': '_,_',
	\	'parentheses': ['start=/(/ end=/)/ fold', 'start=/\[/ end=/\]/ fold', 'start=/{/ end=/}/ fold'],
	\	'separately': {
	\		'*': {},
	\		'tex': {
	\			'parentheses': ['start=/(/ end=/)/', 'start=/\[/ end=/\]/'],
	\		},
	\		'lisp': {
	\			'guifgs': ['royalblue3', 'darkorange3', 'seagreen3', 'firebrick', 'darkorchid3'],
	\		},
	\		'vim': {
	\			'parentheses': ['start=/(/ end=/)/', 'start=/\[/ end=/\]/', 'start=/{/ end=/}/ fold', 'start=/(/ end=/)/ containedin=vimFuncBody', 'start=/\[/ end=/\]/ containedin=vimFuncBody', 'start=/{/ end=/}/ fold containedin=vimFuncBody'],
	\		},
	\		'html': {
	\			'parentheses': ['start=/\v\<((area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr)[ >])@!\z([-_:a-zA-Z0-9]+)(\s+[-_:a-zA-Z0-9]+(\=("[^"]*"|'."'".'[^'."'".']*'."'".'|[^ '."'".'"><=`]*))?)*\>/ end=#</\z1># fold'],
	\		},
	\		'css': 0,
	\	}
	\}
  • 'guifgs': 一个guifg的列表 (:h highlight-guifg), 即GUI界面的括号颜色, 将按顺序循环使用
  • 'guis': 一个gui的列表 (:h highlight-gui), 将按顺序循环使用
  • 'ctermfgs': 一个ctermfg的列表 (:h highlight-ctermfg), 即终端下的括号颜色
  • 'cterms': 一个cterm的列表 (:h highlight-cterm)
  • 'operators': 描述你希望哪些运算符跟着与它同级的括号一起高亮(注意:留意需要转义的特殊字符,更多样例见这里, 你也可以读vim帮助 :syn-pattern)
  • 'parentheses': 一个关于括号定义的列表, 其中的每个项目描述了一种括号, 具体的语法见parentheses的语法
  • 'separately': 针对文件类型(由&ft决定)作不同的配置,未被单独设置的文件类型使用*下的配置,值为0表示仅对该类型禁用插件,值为"default"表示使用针对该类型的默认兼容配置 (注意, 默认兼容配置可能随着该插件版本的更新而改变, 如果你不希望它改变, 那么你应该将它拷贝一份放到你的vimrc文件里).
  • 'inherit': 指定应该在当前配置之前先加载的配置, 也即当前配置应该继承的配置. 注意: 如果想要完全采用另一个配置, 应该同时把'parentheses'设置成空列表, 否则'parentheses'仍然会读取默认配置.
  • 省略某个字段以使用默认设置

在 'separately' 的列表里, 可以用 'inherit' 来定义在应用当前文件类型的配置之前需要应用的配置, 这一字段可以是一个指示了文件类型的字符串, 也可以是一个文件类型的字符串列表. 可以用 '*' 来引用 'separately' 中的这一配置, 也可以用 '' 来引用默认的配置.

parentheses的语法

每一种括号的定义包含形如以下的部分: start=/(/, step=/,/, stop=/)/, fold, contained, containedin=someSynNames, contains=@Spell, cluster=someNames. 其中, start, stop, fold, contained, containedincontains 的具体含义可参考 :h syntax; stepcluster 为本插件的扩展定义. step 是一个正则, 匹配括号中间需要高亮的运算符. cluster 是一个用逗号分隔的列表 (和 containedin 类似), 指定了这种括号所属的括号组, 默认的括号组名称为 default, 也可以将它显式放在括号组名称的列表中.

containscontainein 中可以用 #name 的形式引用一个括号组, 这样相互嵌套的括号就会严格按照嵌套层次来高亮. 如果想要在某种或者某组括号里使用顶层的高亮, 可以使用为括号组生成的语法元素的名字.


最后,如果你喜欢这个插件,给它一个评价,我会心存感激,并且因为你的肯定继续改进这个插件!(从该页面下方,选择Life Changing选项,然后点击rate