SYNTAX
*syntax.txt* For Vim version 7.0. 最近更新: 2006年5月
VIM 参考手册 by Bram Moolenaar
译者: Willis
http://vimcdoc.sf.net
语法高亮 *syntax* *syntax-highlighting* *coloring*
语法高亮使得 Vim 可以用不同的字体或颜色显示文本的不同部分。这些部分可以是特定
的关键字，或者匹配某模式的文本。Vim 不会分析整个文件 (为了保持快速)，所以高亮
功能有其限制。词法高亮或者是一个更合适的名字，但既然大家都使用语法高亮，我们也
就如此称呼。
Vim 支持所有终端上的语法高亮。但因为多数普通的终端只有有限的高亮的选择，GUI 版
本 gvim 的语法高亮的效果最好。
用户手册里:
|usr_06.txt| 介绍语法高亮。
|usr_44.txt| 介绍如何写语法文件。
1. 快速入门 |:syn-qstart|
2. 语法文件 |:syn-files|
3. 语法载入过程 |syntax-loading|
4. 语法文件附注 |:syn-file-remarks|
5. 定义语法 |:syn-define|
6. :syntax 参数 |:syn-arguments|
7. 语法模式 |:syn-pattern|
8. 语法簇 |:syn-cluster|
9. 包含语法文件 |:syn-include|
10. 同步 |:syn-sync|
11. 列出语法项目 |:syntax|
12. Highlight 命令 |:highlight|
13. 链接组 |:highlight-link|
14. 清理 |:syn-clear|
15. 高亮标签 |tag-highlight|
16. 彩色 xterm |xterm-color|
{Vi 无此功能}
如果编译时关闭了 |+syntax| 特性，就不会有语法高亮的功能。
*:syn-enable* *:syntax-enable*
这个命令打开语法高亮:
:syntax enable
:source $VIMRUNTIME/syntax/syntax.vim
:syntax on
*:hi-normal* *:highlight-normal*
如果你运行在 GUI 环境里，你可以这样得到黑底白字:
:highlight Normal guibg=Black guifg=White
关于色彩终端，见 |:hi-normal-cterm|。
关于设置你自己的语法高亮色彩，见 |syncolor|。
注意: MS-DOS 和 Windows 上的语法文件以 <CR><NL> 结束每一行。Unix 上则以 <NL>
结尾。这意味着你需要为自己的系统选择合适的文件。不过，在 MS-DOS 和 Windows
上，如果 'fileformats' 选项非空，会自动选择正确的格式。
注意: 使用反转视频时 ("gvim -fg white -bg black")，'background' 的缺省值直到
GUI 窗口打开时才会设置。这发生在 |gvimrc| 的读入之后，从而会使用错误的缺省高
亮。要在打开高亮前设置 'background' 的缺省值，在 |gvimrc| 文件里包含 ":gui" 命
令:
:gui " 打开窗口并设置 'background' 的缺省值
:syntax on " 启动语法高亮，使用 'background' 来设置颜色
注意: 在 |gvimrc| 里使用 ":gui" 意味着 "gvim -f" 不会在前台打开！这时，要使用
":gui -f"。
你可以用这个命令切换语法的打开/关闭
:if exists("syntax_on") | syntax off | else | syntax enable | endif
:map <F7> :if exists("syntax_on") <Bar>
\ syntax off <Bar>
\ else <Bar>
\ syntax enable <Bar>
\ endif <CR>
[使用 |<>| 记法，按本义输入]
细节
":syntax" 命令是用执行文件脚本实现的。要了解它到底干了什么，察看以下文件:
命令 文件
:syntax enable $VIMRUNTIME/syntax/syntax.vim
:syntax on $VIMRUNTIME/syntax/syntax.vim
:syntax manual $VIMRUNTIME/syntax/manual.vim
:syntax off $VIMRUNTIME/syntax/nosyntax.vim
另见 |syntax-loading|。
某个语言的语法和高亮命令通常存在一个语法文件里。命名惯例是: "{name}.vim"。其
中，{name} 是语言的名字或者缩写 (一旦在 DOS 文件系统上，要适用 8.3 字符的名字
限制)。
例如:
c.vim perl.vim java.vim html.vim
cpp.vim sh.vim csh.vim
语法文件可以包含任何 Ex 命令，就像 vimrc 文件那样。但应该只有适用于特定语言的
命令才放在里面。如果该语言是另外一个语言的超集，它可以包含那个语言对应的文件。
例如，cpp.vim 可以包含 c.vim 文件:
:so $VIMRUNTIME/syntax/c.vim
:au Syntax c runtime! syntax/c.vim
:au Syntax cpp runtime! syntax/cpp.vim
这些命令通常出现在 $VIMRUNTIME/syntax/synload.vim 文件里。
如果你有多个文件，可以用文件类型作为目录名。该目录下的所有 "*.vim" 文件都会被
使用。例如:
~/.vim/after/syntax/c/one.vim
~/.vim/after/syntax/c/two.vim
创 立 你 自 己 的 语 法 文 件 *mysyntaxfile*
一旦你创立自己的语法文件，并且需要 Vim 在使用 ":syntax enable" 的时候自动调用
它们的时候，按如下操作进行:
1. 建立自己的用户运行时目录。通常，把它放在 'runtimepath' 选项的第一项。Unix
的例子:
mkdir ~/.vim
mkdir ~/.vim/syntax
:w ~/.vim/syntax/mine.vim
:set syntax=mine
这时，你并不需要退出 Vim。
如果你想 Vim 也实现文件类型的检测，见 |new-filetype|。
如果你想为多个用户设立系统，而不希望每个用户增加相同的语法文件的话，可以使用
'runtimepath' 里的其它目录。
添 加 到 已 存 在 的 语 法 文 件 *mysyntaxfile-add*
如果你对已有的语法文件大体满意，只需要增加或者修正一些高亮项目，执行以下步骤即
可:
1. 建立你的 'runtimepath' 里的用户目录，见上。
2. 在那里建立目录 "after/syntax"。Unix 上:
mkdir ~/.vim/after
mkdir ~/.vim/after/syntax
highlight cComment ctermfg=Green guifg=Green
:w ~/.vim/after/syntax/c.vim
{group-name}* *E669* *W18*
高亮或者语法组的名字必须由 ASCII 字母，数字和下划线组成。如使用正规表达式表示:
"[a-zA-Z0-9_]*"。
要允许每个用户选择他自己喜欢的色彩系列，许多语言应该使用相同的高亮组名。以下是
建议的组名 (如果语法高亮能够正确工作，你应该能看到实际的颜色，除了 "Ignore" 以
外):
*Comment v 任何注释
*Constant v 任何常数
String v 一个字符串常数: "这是一个字符串"
Character v 一个字符常数: 'c'、'\n'
Number v 一个数字常数: 234、0xff
Boolean v 一个布尔型常数: TRUE、false
Float v 一个浮点常数: 2.3e10
*Identifier v 任何变量名
Function v 函数名 (也包括: 类的方法名)
*Statement v 任何语句
Conditional v if、then、else、endif、switch 等
Repeat v for、do、while、etc.
Label v case、default 等
Operator v "sizeof"、"+"、"*" 等
Keyword v 任何其它关键字
Exception v try、catch、throw
*PreProc v 通用预处理命令
Include v 预处理命令 #include
Define v 预处理命令 #define
Macro v 等同于 Define
PreCondit v 预处理命令 #if、#else、#endif 等
*Type v int、long、char 等
StorageClass v static、register、volatile 等
Structure v struct、union、enum 等
Typedef v 一个 typedef
*Special v 任何特殊符号
SpecialChar v 常数中的特殊字符
Tag v 这里可以使用 CTRL-]
Delimiter v 需要注意的字符
SpecialComment v 注释里的特殊字符
Debug v 调试语句
*Underlined v 需要突出的文本，HTML 链接
*Ignore v 留空，被隐藏
*Error v 任何有错的构造
*Todo v 任何需要特殊注意的部分；多是关键字 TODO FIXME 和 XXX
* 标记的名字是主要组，其它是次要组。对主要组而言，"syntax.vim" 文件包含缺省的
高亮设置。次要组则链接到主要组。所以它们拥有相同的高亮设置。不过，你可以通过
":highlight" 命令在 "syntax.vim" 文件之后改变所有组的缺省值。
注意高亮组的名字对大小写不敏感。"String" 和 "string" 可用来表示相同的组。
以下名字是保留字，它们不应用作组名:
NONE ALL ALLBUT contains contained
这里解释命令 ":syntax enable" 执行的细节。Vim 初始化自身时，它寻找运行时文件的
位置。其值用来设置这里使用的变量 |$VIMRUNTIME|。
":syntax enable" 和 ":syntax on" 完成以下步骤:
执行 $VIMRUNTIME/syntax/syntax.vim
|
+- 清除旧的语法: 执行 $VIMRUNTIME/syntax/nosyntax.vim
|
+- 先执行 'runtimepath' 里的 syntax/synload.vim
| |
| +- 为语法高亮设置色彩。如果已经定义了色彩方案，使用 ":colors {name}"
| | 再次载入。不然，执行 ":runtime! syntax/syncolor.vim"。":syntax on"
| | 会覆盖已有的颜色，而 ":syntax enable" 只会设置没有设置过的组。
| |
| +- 设置 syntax 自动命令，以便在设置 'syntax' 选项时，自动载入合适的语
| | 法文件。 *synload-1*
| |
| +- 通过 |mysyntaxfile| 变量，载入用户可选的文件。这只是为了和 Vim 5.x
| | 兼容。 *synload-2*
|
+- 执行 ":filetype on"，后者又执行 ":runtime! filetype.vim"。它载入任何找
| 到的 filetype.vim。其中，总会执行 $VIMRUNTIME/filetype.vim。后者执行:
| |
| +- 根据后缀名，安装自动命令来设置 'filetype' 选项。这为已知的文件类型
| | 建立了文件名和文件类型的联系。 *synload-3*
| |
| +- 通过 *myfiletypefile* 变量，载入用户可选的文件。这只是为了和 Vim
| | 5.x 兼容。 *synload-4*
| |
| +- 安装自动命令，在没有检测到文件类型时执行 scripts.vim 。
| | *synload-5*
| |
| +- 执行 $VIMRUNTIME/menu.vim，设置 Syntax 菜单。|menu.vim|
|
+- 安装 FileType 自动命令，在检测到文件类型时，设置 'syntax' 选项。
| *synload-6*
|
+- 执行 syntax 自动命令，为每个已经载入的缓冲区启动语法高亮。
载入文件时，Vim 这样查找相关的语法文件:
文件的载入激活 BufReadPost 自动命令。
|
+- 如果和 |synload-3| 中的一个自动命令匹配 (已知的文件类型) 或者
| |synload-4| (用户的文件类型)，'filetype' 选项设为文件的所属类型。
|
+- 如果文件类型没有找到，激活 |synload-5| 中的自动命令，并在
| 'runtimepath' 里找寻 scripts.vim。其中，总是会执行
| $VIMRUNTIME/scripts.vim。后者执行以下步骤。
| |
| +- 通过 *myscriptsfile* 变量，载入用户可选的文件。这只是为了和 Vim
| | 5.x 兼容。
| |
| +- 如果文件类型仍然未知，检查文件的内容，并使用类似于
| "getline(1) =~ pattern" 的检查确定文件类型能否识别，并设置
| 'filetype'。
|
+- 如果文件类型被确定并且设置了 'filetype'，激活 FileType 自动命令，见上
| 面的 |synload-6|。根据确定的文件类型设置 'syntax'。
|
+- 上面设置 'syntax' 选项的步骤激活 |synload-1| (和 |synload-2|) 设置的自
| 动命令。它会使用以下命令找到 'runtimepath' 里的主语法文件:
| runtime! syntax/<name>.vim
|
+- 激活任何用户安装的 FileType 或 Syntax 自动命令。这可以用来为某项语法修
正高亮方式。
*b:current_syntax-variable*
根据当前激活的是哪部语法，Vim 把载入的语法的名字保存在 "b:current_syntax" 变量
里。例如:
:au BufReadPost * if b:current_syntax == "csh"
:au BufReadPost * 做一些事
:au BufReadPost * endif
:runtime! syntax/2html.vim
警告: 这挺慢的！
*:TOhtml*
也可以使用 ":TOhtml" 用户命令。它是在一个标准插件里定义的。":TOhtml" 可用于行
范围和可视区域:
:10,40TOhtml
:let html_start_line = line("'<")
:let html_end_line = line("'>")
:let html_number_lines = 1
设为零则强制关闭行号:
:let html_number_lines = 0
要回到缺省情况，即使用 'number' 的设置，可删除此变量:
:unlet html_number_lines
:let html_ignore_folding = 1
:let html_use_css = 1
<pre>" 和 "</pre>" 围绕文本。使得这些文本看起来和 Vim 的一致，但没有
回绕。如果你希望有回绕，且可以忍受不太一致的外观，可使用:
:let html_no_pre = 1
这会在每行结束的地方使用 <br>，而用 " " 来显示连续的空格。
'encoding' 的当前值用于指定 HTML 文件的字符集。这只适用于 'encoding' 的值有对
应的 HTML 字符集名字的时候。要改变这种机制，设置 g:html_use_encoding 为要用的
字符集名:
:let html_use_encoding = "foobar"
如果不想产生指定字符集的那行，设置 g:html_use_encoding 为空字符串:
:let html_use_encoding = ""
要回到自动的机制，删除 g:html_use_encoding 变量:
:unlet html_use_encoding
关于 diff 模式，多于三行的填充行序列显示为三行，中间行提到插入的总行数。如果你
宁愿看到所有的插入行，用:
:let html_whole_filler = 1
要回到三行的显示方式:
:unlet html_whole_filler
*convert-to-XML* *convert-to-XHTML*
另一个选择是使用该脚本产生 XHTML (XML 兼容的 HTML)。这可以通过设置 "use_xhtml"
变量完成:
:let use_xhtml = 1
要关闭此选择，删除该变量:
:unlet use_xhtml
这里产生的 XHTML 文件可以在 DocBook XML 文档里使用。见:
http://people.mech.kuleuven.ac.be/~pissaris/howto/src2db.html
评注:
- 只有在 GUI 支持的版本里，才能工作。如果没有运行 GUI (可能仍然使用 X11)，或许
也可以，但是效果不一定好 (颜色可能不对)。
- 较旧的浏览器不会显示背景色。
- 你可以在大多数浏览器里打印文件 (而且有颜色)！
此处是一个如何在 Unix 外壳上给所有的 .c 和 .h 文件运行此脚本的例子:
for f in *.[ch]; do gvim -f +"syn on" +"run! syntax/2html.vim" +"wq" +"q" $f; done
ABEL *abel.vim* *ft-abel-syntax*
ABEL 高亮设置提供一些用户定义的选项。要打开这些选项，给相应的选项设置任意值。
例如:
:let abel_obsolete_ok=1
可用 ":unlet" 关闭。例如:
:unlet abel_obsolete_ok
变量 高亮
abel_obsolete_ok 废弃的关键字接受为 statement，而非 error
abel_cpp_comments_illegal 不把 '//' 解释为行内注释的引导符
ADA *ada.vim* *ft-ada-syntax*
本模块为 1995 年版的 Ada ("Ada95") 设计，它支持面向对象编程，受保护的类型，等
等。它也能处理为原始 Ada 语言的代码 ("Ada83" 或 "Ada87")，不过 Ada83 代码里如
果使用 Ada95 才有的关键字的话，颜色显示会不正确 (不过这样的代码本来也应该修
正)。更多关于 Ada 的信息，见 http://www.adapower.com。
Ada 模式正确地处理一些情况。例如，它知道 "-5" 里的 "-" 是数字的一部分，但
"A-5" 里的该字符则是操作符。通常，引用别的编译单元的 "with" 或 "use" 语句使用
C 里面的 "#include" 相同的色彩。如果你为 "Conditional" 或 "Repeat" 组指定了不
同的色彩，那么 "end if" 和 "end loop" 会根据它们所在的组被分别标色。你可以用
vim 的 "highlight" 命令来给出不同的颜色 (例如，要改变循环的显示方式，输入命令
":hi Repeat"，后面跟色彩的规格说明；在普通终端上，色彩规格 ctermfg=White 通常
就有不错的显示效果)。
本 Ada 模式可以设置若干选项。给选项赋值就可以打开。例如，要打开一个选项:
let ada_standard_types = 1
可用 ":unlet" 关闭。例如:
unlet ada_standard_types = 1
使用 ":" 并在命令行输入这些命令就可以在载入 Ada 文件时临时设置选项。要永久设
置，把 "let" 命令加到你的 "~/.vimrc" 文件里，无需冒号。
以下是 Ada 模式选项:
变量 动作
ada_standard_types 高亮 Standard 包里的类型 (例如，"Float")
ada_space_errors 高亮空格里的错误...
ada_no_trail_space_error 但忽略行尾的空格
ada_no_tab_space_error 但忽略空格之后的制表
ada_withuse_ordinary 把 "with" 和 "use" 显示为普通的关键字
(用于引用别的编译单元时，它们不再特殊高亮)。
ada_begin_preproc 使用 C 预处理命令的色彩来显示所有 begin 风格的关键
字。
即使在慢速 (90Mhz) PC 上，该模式也很快。但如果你还是觉得速度无法忍受，可以打开
ada_withuse_ordinary。
ANT *ant.vim* *ft-ant-syntax*
ant 语法文件缺省提供了 javascript 和 python 的语法高亮。其他脚本语言的语法高亮
可以通过 AntSyntaxScript() 函数安装。它接受的第一个参数是标签名，而第二个是脚
本语法文件名。例如:
:call AntSyntaxScript('perl', 'perl.vim')
<script language = 'perl'><![CDATA[
# 这里的一切都作为 perl 脚本高亮
]]></script>
:let apache_version = "2.0"
*asm.vim* *asmh8300.vim* *nasm.vim* *masm.vim* *asm68k*
ASSEMBLY *ft-asm-syntax* *ft-asmh8300-syntax* *ft-nasm-syntax*
*ft-masm-syntax* *ft-asm68k-syntax* *fasm.vim*
匹配 "*.i" 的可以是 Progress 或者汇编文件。如果自动检测对你不工作，或者你从来
不编辑 Progress，在你启动的 vimrc 里这么用:
:let filetype_i = "asm"
把 "asm" 替换成你实际使用的汇编语言。
许多类型的汇编语言都使用相同的文件扩展名。因而，你或者需要自己选择类型，或者在
汇编文件里增加使 Vim 能识别的行。目前，包含了以下的语法文件:
asm GNU 汇编 (缺省)
asm68k Motorola 680x0 汇编
asmh8300 Hitachi H-8300 版本的 GNU 汇编
ia64 Intel Itanium 64
fasm Flat 汇编 (http://flatassembler.net)
masm Microsoft 汇编 (可能适用于任何 80x86)
nasm Netwide 汇编
tasm Turbo 汇编 (提供到 Penitum 和 MMX 的 80x86 操作码)
pic PIC 汇编 (目前支持 PIC16F84)
最灵活的方式是在你的汇编文件里加上如下一行:
:asmsyntax=nasm
把 "nasm" 换成实际的汇编语法的名字。该行必须是文件头五行中的一行。
语法类型可以为某个缓冲区定制。方法是设置 b:asmsyntax 变量:
:let b:asmsyntax=nasm
:let asmsyntax=nasm
Netwide 汇编器 (nasm.vim) 可选高亮特性
要打开特性:
:let {variable}=1|set syntax=nasm
要关闭特性:
:unlet {variable} |set syntax=nasm
变量 高亮
nasm_loose_syntax 非正式的分析器允许的语法不视为错误 (取决于分析器；不推
荐)
nasm_ctx_outside_macro 宏之外的上下文不视为错误
nasm_no_warn 潜在有危险的语法不视为 Todo 那样的警告
ASPPERL 和 ASPVBS *ft-aspperl-syntax* *ft-aspvbs-syntax*
*.asp 和 *.asa 文件可以是 Perl 或者 Visual Basic 脚本。因为很难检测，你可以设
置两个全局变量，来告诉 Vim 你要用哪一个。Perl 脚本可用:
:let g:filetype_asa = "aspperl"
:let g:filetype_asp = "aspperl"
Visual Basic 可用:
:let g:filetype_asa = "aspvbs"
:let g:filetype_asp = "aspvbs"
let baan_code_stds=1
let baan_fold=1
可以在源代码块级别上打开折叠，如 if、while、for，... 这里开始/结束关键字之前的
缩进必须一致 (空格不等于制表)。
let baan_fold_block=1
可以为内嵌的 SQL 块打开折叠，如 SELECT、SELECTDO、SELECTEMPTY，... 这里开始/结
束关键字之前的缩进必须一致 (空格不等于制表)。
let baan_fold_sql=1
注意: 代码块级别的折叠可能产生许多小的折叠。建议在 .vimrc 里用 |:set| 设置选项
'foldminlines' 和 'foldnestmax'，在 .../after/syntax/baan.vim 里用 |:setlocal|
设置也可以 (见 |after-directory|)。例如:
set foldminlines=5
set foldnestmax=6
:let c_comment_strings=1
可用 ":unlet" 关闭。例如:
:unlet c_comment_strings
变量 高亮
c_gnu GNU gcc 专用的项目
c_comment_strings 注释里的字符串和数字
c_space_errors 行尾的空格和 <Tab> 之前的空格
c_no_trail_space_error ... 不包括行尾的空格
c_no_tab_space_error ... 不包括 <Tab> 之前的空格
c_no_bracket_error 不高亮 {}；如果在 [] 里面视为错误
c_no_curly_error 不高亮 {}；如果在 [] 和 () 里面视为错误；
除了出现在首列的 { 和 } 以外
c_no_ansi 不使用 ANSI 标准类型和常数
c_ansi_typedefs ... 但使用 ANSI 标准类型
c_ansi_constants ... 但使用 ANSI 标准常数
c_no_utf 不高亮字符串里的 \u 和 \U
c_syntax_for_h *.h 文件使用 C 语法，而不是 C++ 的
c_no_if0 不把 "#if 0" 块高亮为注释
c_no_cformat 不高亮字符串里的 %-格式
c_no_c99 不高亮 C99 标准的项目
如果 'foldmethod' 设为 "syntax"，那么 /* */ 注释和 { } 块成为折叠。如果你不想
让注释成为折叠:
:let c_no_comment_fold = 1
"#if 0" 块也被折叠，除非:
:let c_no_if0_fold = 1
注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可以修正的话，尝试设置
"c_minlines" 内部变量为较大的值:
:let c_minlines = 100
这使得语法同步在第一个显示行之前的 100 行开始。缺省值为 50 (如果设置了
c_no_if0，则为 15)。使用较大的值的缺点是重画会变慢。
如果使用 "#if 0" / "#endif" 风格的注释高亮，注意它只适用于 "#if 0" 出现在窗口
顶部往上不超过 "c_minlines" 行的场合。如果你有很长的 "#if 0" 构造，它不会被正
确地高亮。
要匹配注释里的附加项目，使用 cCommentGroup 簇。例如:
:au Syntax c call MyCadd()
:function MyCadd()
: syn keyword cMyItem contained Ni
: syn cluster cCommentGroup add=cMyItem
: hi link cMyItem Title
:endfun
:hi link cConstant NONE
{' 和 '}' 被高亮为错误，而实际并非如此的时候，复位 cErrInParen 和
cErrInBracket 的高亮。
如果想在你的 C 文件里使用折叠，可以在 'runtimpath' 的 "after" 目录下的一个文件
里加上这些行。Unix 上，这会是 ~/.vim/after/syntax/c.vim.
syn region myFold start="{" end="}" transparent fold
syn sync fromstart
set foldmethod=syntax
:let ch_syntax_for_h = 1
let g:changelog_spacing_errors = 0
下次你编辑 changelog 文件时，就会应用。你也可以使用
"b:changelog_spacing_errors" 来为每个缓冲区分别设置 (在载入语法文件以前)。
你可以改变现在使用的高亮，例如把空格标记为错误:
:hi link ChangelogError Error
或者避免高亮:
:hi link ChangelogError NONE
这些会立即生效。
COBOL *cobol.vim* *ft-cobol-syntax*
COBOL 高亮对传统的代码和新开发的代码有不同的需要。这来自于需求的差异 (维护还是
开发)，以及一些其它因素。要使用传统代码的高亮，在 .vimrc 里加上此行:
:let cobol_legacy_code = 1
要再次关闭，可用:
:unlet cobol_legacy_code
:let html_wrong_comments = 1
注意 有的系统实际使用的 tcsh.
要检测一个文件是 csh 还是 tcsh 异常困难。有的系统把 /bin/csh 符号链接到
/bin/tcsh，使得区别 csh 和 tcsh 几乎不可能。如果 VIM 猜错，你可以自己设置
"filetype_csh" 变量。要使用 csh:
:let filetype_csh = "csh"
:let filetype_csh = "tcsh"
:let cynlib_cyntax_for_cc=1
:let cynlib_cyntax_for_cpp=1
:unlet cynlib_cyntax_for_cc
:unlet cynlib_cyntax_for_cpp
CWEB *cweb.vim* *ft-cweb-syntax*
匹配 "*.w" 的文件可为 Progress 文件或者 cweb 文件。如果自动检测不行，或者你从
来不编辑 Progress，可以在启动的 vimrc 文件里用:
:let filetype_w = "cweb"
:let enforce_freedesktop_standard = 1
let dircolors_is_slackware = 1
:let docbk_type = "sgml"
或者:
:let docbk_type = "xml"
你需要在载入语法文件前作如此设置，这有点复杂。
更简单的方法是设置文件类型为 "docbkxml" 或 "docbksgml":
:set filetype=docbksgml
或:
:set filetype=docbkxml
:let dosbatch_cmdextversion = 1
:let g:dosbatch_syntax_for_btm = 1
:set syntax=c.doxygen
或
// vim:syntax=c.doxygen
{filetype} 用相应的值替代。
:let g:syntax_extra_{filetype}='doxygen'
:let g:load_doxygen_syntax=1
变量 缺省 效果
g:doxygen_enhanced_color
g:doxygen_enhanced_colour 0 Doxygen 注释使用非标准的高亮。
doxygen_my_rendering 0 关闭 HTML 粗体、斜体和
html_my_rendering 下划线的高亮。
doxygen_javadoc_autobrief 1 如果为 0，关闭 Javadoc autobrief 色彩
高亮。
doxygen_end_punctuation '[.]' 匹配 brief 结束标点的正规表达式。
还有一些高亮组值得提提，你可以对它们进行配置。
高亮 效果
doxygenErrorComment 如果 code、verbatim 或 dot 段里丢失标点，注释
尾部的颜色。
doxygenLinkError 如果丢失 \link 段的 \endlink，注释尾部的颜色。
DTD *dtd.vim* *ft-dtd-syntax*
DTD 语法高亮缺省是大小写敏感的。如果不想如此，在你的启动文件里加入以下一行:
:let dtd_ignore_case=1
:let dtd_no_tag_errors=1
:let dtd_no_param_entities=1
:let eiffel_ignore_case=1
:let eiffel_strict=1
:let eiffel_pedantic=1
:let eiffel_lower_case_predef=1
:let eiffel_ise=1
:let eiffel_hex_constants=1
:let erlang_keywords = 1
如果你想关闭内建函数的高亮，在 .vimrc 里加上:
:let erlang_functions = 1
如果你想关闭特殊字符的高亮，在 .vimrc 里加上:
:let erlang_characters = 1
:let flexwiki_maps = 1
注意 缺省，form.vim 语法文件使用相同的语法组里实现 FORM 预处理器命令和指令。
预定义的 FORM 增强色彩模式可以用来区别头部语句和 FORM 程序本体的语句。要激活此
模式，在你的 vimrc 文件里定义以下变量
:let form_enhanced_color=1
缺省高亮方式和方言
缺省使用适合 f95 (Fortran 95) 的高亮方式。这样的选择应该适用于绝大多数的用户，
因为 Fortran 95 是 Fortran 90 的超集，也差不多是 Fortran 77 的超集。
Fortran 源代码形式
Fortran 9x 可以使用固定宽度的源代码，也可以使用自由形式。注意如果形式设置错
误，语法高亮也不会正确。
创建新的 Fortran 文件时，语法脚本假定使用的是固定宽度的源代码。如果你总是使用
自由形式，那么在你的 .vimrc 里，把
:let fortran_free_source=1
放在 :syntax 命令前。如果你总是使用固定宽度格式，那么在你的 .vimrc 里，把
:let fortran_fixed_source=1
放在 .syntax 命令前。
如果源代码的格式取决于文件扩展名，那么最方便的方法是在 ftplugin 文件里设置
fortran_free_source。见 |ftplugin|。例如，假定你所有的使用 .f90 扩展名的
Fortran 文件使用自由形式编写，而其它的则使用固定宽度，那么在你的 ftplugin 文件
里加上以下的行
let s:extfname = expand("%:e")
if s:extfname ==? "f90"
let fortran_free_source=1
unlet! fortran_fixed_source
else
let fortran_fixed_source=1
unlet! fortran_free_source
endif
注意，要使之工作，你需要在 .vimrc 文件的 "syntax on" 命令前加上 "filetype
plugin indent on" 命令。
编辑已有的 Fortran 文件时，如果定义了 fortran_free_source 变量，语法脚本假定使
用自由形式，如果定义了 fortran_fixed_source 变量，则假定使用固定宽度形式。如果
两者都没有，语法脚本检验文件的头 250 行的头 5 列。如果没有发现自由形式的迹象，
那么假定文件为固定宽度形式的源文件。这个算法应该在绝大多数情况下适用。有的情况
下，比如文件的开始有 250 行或更多完整行的注释，该脚本也许会错误地认为该
Fortran 代码使用的是固定宽度形式。如果此种情况真的发生，只要在前 250 行的头 5
列里的任何地方加上一个非注释的语句，然后保存 (:w) 并重新读入 (:e!) 文件就可以
了。
Fortran 文件里的制表键
Fortran 标准不识别制表键。在固定宽度格式的 Fortran 源代码里，制表不是一个好主
意，因为需要固定的列边界。因此，制表被识别为错误。不过，有的程序员喜欢使用制
表。如果你的 Fortran 文件里包含制表，那么需要在 .vimrc 里使用这样的命令来设置
变量 fortran_have_tabs
:let fortran_have_tabs=1
并把它放在 :syntax 命令之前。不幸的是，制表的使用意味着语法文件无法识别不正确
的边界。
Fortran 文件的语法折叠
如果你希望使用 foldmethod=syntax，那么你需要先使用命令设置变量 fortran_fold
:let fortran_fold=1
来指示语法脚本为程序单元定义折叠区域。程序单元 (program unit) 包括程序语句开始
的主程序、子例程、函数子程序、块数据子程序、接口块和模块。如果你也使用如下命令
设置变量 fortran_fold_conditionals
:let fortran_fold_conditionals=1
那么也会为 do 循环、if 块和 select case 构造定义折叠区域。如果你同时使用如下命
令设置变量 fortran_fold_multilinecomments
:let fortran_fold_multilinecomments=1
那么还会为三行或更多连续的注释定义折叠区域。注意 定义折叠区域会使大文件变慢。
如果设置了 fortran_fold 和可能的 fortran_fold_conditionals 与/或
fortran_fold_multilinecomments，vim 会在你使用 foldmethod=syntax 时折叠文件。
两个程序单元之间的注释或空行不会被折叠，因为它们不被视作任何一个程序单元的一部
分。
更精确的 Fortran 语法
如果使用如下命令设置变量 fortran_more_precise
:let fortran_more_precise=1
那么语法高亮会更精确，但也更慢。特别是，能够识别 do、goto 和算术 if 语句使用的
语句标签，还有 do、if、select、或 forall 构造结尾的构造名。
非缺省的 Fortran 方言
本语法脚本支持五种 Fortran 方言: f95、f90、f77、Lahey 子集 elf90 和 Imagine1
子集 F。
如果你使用扩展的 f77，包括常见的能被大多数 f77 编译器，包括 g77 (GNU Fortran)
所支持的构造，如 do/enddo 循环，do/while 循环和自由形式的源代码，那么也许缺省
的高亮设置就够用了。如果你使用严格的不带扩展的 f77，甚至没有自由形式的源代码或
者 MIL STD 1753 扩展等特性，那么设置 f77 方言的好处就包括，诸如 SUM 这样的名字
可以作为变量名识别，而不会作为高亮为 f9x 内建的函数；另外废弃的构造，比如
ASSIGN 语句，也不会被高亮为 todo 项目；还有，总是假定使用固定宽度的源程序。
如果你使用 elf90 或 F，设置合适的方言的优点包括，这些方言排除的 f90 特性会被高
亮为 todo 项目；还有，它们总是假定使用固定宽度的源程序。
可以通过设置变量 forran_dialect 来选择方言。可以接受的 fortran_dialect 的值是
大小写敏感的，而且必须是 "f95"、"f90"、"f77"、"elf" 或 "F" 之一。不合法的
fortran_dialect 的值被忽略。
如果你的 Fortran 文件使用相同的方言，在你的 .vimrc 文件里 syntax 命令之前设置
fortran_dialect。如果源代码的格式取决于文件扩展名，那么最方便的方法是在
ftplugin 文件里设置，见 |ftplugin|。例如，如果你使用 .f90 扩展名的所有 Fortran
文件都使用 elf 子集，那么在你的 ftplugin 文件里应该包含代码
let s:extfname = expand("%:e")
if s:extfname ==? "f90"
let fortran_dialect="elf"
else
unlet! fortran_dialect
endif
注意 只有在你的 .vimrc 文件的 "syntax on" 命令前加上了
"filetype plugin indent on" 命令，才能使这段代码工作。
如果文件扩展名还不能唯一确定方言，那么你需要更精细的控制。可以为每个文件定制方
言。方法是在文件的头三行内加上指令 "fortran_dialect=xx" (其中 xx=f77 或 elf 或
F 或 f90 或 f95)。例如，你较老的 .f 文件可能以扩展 f77 方言编写，但较新的那些
可能使用 F，那么你需要在后者每个文件的头三行内加上以下形式的 Fortran 注释，以
便标识
! fortran_dialect=F
如果两个指令都存在，F 覆盖 elf。
限制
括号检查不能发现过少的闭括号。也不能识别 Hollerith 字符串。有些关键字可能高亮
不正确，因为 Fortran90 没有保留字。
更多关于 Fortran 的信息可见 |ft-fortran-indent| 和 |ft-fortran-plugin|。
FVWM 配 置 文 件 *fvwm.vim* *ft-fvwm-syntax*
要使得 Vim 识别不符合模式 *fvwmrc* 或 *fvwm2rc* 的 Fvwm 配置文件，你需要在你
myfiletypes.vim 文件里放入附加适合你系统的模式。对于这些模式，你需要设置变量
"b:fvwm_version" 为 Fvwm 的主版本号，同时设置 'filetype' 选项为 fvwm。
例如，要使 Vim 识别 /etc/X11/fvwm2/ 里的所有文件为 Fvwm2 的配置文件，可以这样
设置:
:au! BufNewFile,BufRead /etc/X11/fvwm2/* let b:fvwm_version = 2 |
\ set filetype=fvwm
:let rgb_file = "/usr/X11/lib/X11/rgb.txt"
:let hs_highlight_delimiters = 1
要把 True 和 False 识别为关键字而不是普通的标识符，加上:
:let hs_highlight_boolean = 1
要把基本类型的名字识别为关键字:
:let hs_highlight_types = 1
要把更多相对常用的类型识别为关键字:
:let hs_highlight_more_types = 1
如果想高亮调试函数的名字，在你的 .vimrc 里加上:
:let hs_highlight_debug = 1
:let hs_allow_hash_operator = 1
:let lhs_markup = none
就可完全关闭高亮。或者
:let lhs_markup = tex
强制使用 Tex 标记风格的高亮。更灵活的方法是使用该变量的局部于缓冲区的版本，例
如
:let b:lhs_markup = tex
会强制为特定的缓冲区使用 TeX 高亮。必须在该缓冲区打开语法高亮或者载入文件前设
置。
HTML *html.vim* *ft-html-syntax*
HTML 文件里，标签的色彩方案工作方式如下。
开放标签的 <> 和关闭标签的 </> 的颜色不同。这是有意的！开放标签使用 'Function'
色，而关闭标签使用 'Type' 色 (察看 syntax.vim 了解它们是如何为你定义的)。
已知的标签名使用 C 语句 (Statement) 的色彩。未知的标签名分别和相应的 <> 或 </>
颜色相同，以便纠错。
注意 这同样适用于参数 (或属性) 名。已知的属性名和未知的颜色不同。
一些 HTML 标签用于改变文本的显示。html.vim 语法色彩文件识别以下的标签，并相应
地改变普通文本的显示方式: <B> <I> <U> <EM> <STRONG> (<EM> 是 <I> 的别名，而
<STRONG> 是 <B> 的别名)，<H1> - <H6>，<HEAD>，<TITLE> 和 <A> (<A> 必须在作为链
接，即包含了 href，才会如此。如 <A href="somfile.html">)。
如果你想改变文本显示的方式，必须重定义以下的语法组:
- htmlBold
- htmlBoldUnderline
- htmlBoldUnderlineItalic
- htmlUnderline
- htmlUnderlineItalic
- htmlItalic
- htmlTitle 设定标题
- htmlH1 - htmlH6 设定标题头部 (header) 的文本
要使得重定义能够工作，你必须重定义所有的组，最后两组 (htmlTitle 和 htmlH[1-6]
可选) 可以除外。在你的 vimrc (这是根据初始化时读入文件的顺序) 里定义下面的变量
:let html_my_rendering=1
:let html_no_rendering=1
<!-- 开始并以 --!> 结束) 的风格，可以定义
:let html_wrong_comments=1
注意 现在只支持 JavaScript
和 Visual Basic，还没有加入其它的脚本语言。
内嵌和内含 (inline) 的层叠样式表 (CSS) 也被高亮。
有多种 html 预处理器语言，html.vim 的编写方式使得包含它非常容易。要想这么做，
只要在相应语言的语法高亮文件里加入如下两行 (该例子来自 asp.vim 文件) 就可以了:
runtime! syntax/html.vim
syn cluster htmlPreproc add=asp
现在你只需要把所有包含预处理语言的区域项目加到 htmlPreproc 簇里就可以了。
HTML/OS (Aestiva 提供) *htmlos.vim* *ft-htmlos-syntax*
HTML/OS 的色彩高亮方案工作方式如下:
缺省为函数和变量名使用相同的颜色，因为 VIM 并不为 Function 和 Identifier 指定
不同的颜色。要改变这一点 (如果你希望函数名能用不同的颜色加以识别的话，建议使
用)，你需要在 ~/.vimrc 里加入下行:
:hi Function term=underline cterm=bold ctermfg=LightGray
:set syntax=htmlos
<< 或 [[ 和 >>
或 ]]。
IA64 *ia64.vim* *intel-itanium* *ft-ia64-syntax*
为 Intel Itanium 64 汇编语言提供高亮。|asm.vim| 说明如何识别该文件类型。
要识别 *.inc 文件为 IA64，在你的 .vimrc 文件里加入这行:
:let g:filetype_inc = "ia64"
:let inform_highlight_simple=1
:let inform_highlight_glulx=1
:let inform_suppress_obsolete=1
:let inform_highlight_old=1
变量 效果
idl_no_ms_extensions 关闭一些 Microsoft 专用的扩展
idl_no_extensions 关闭复杂扩展
idlsyntax_showerror 显示 IDL 错误 (可能过于侵略性，但很有用)
idlsyntax_showerror_soft 使缺省的错误颜色柔和一些
JAVA *java.vim* *ft-java-syntax*
java.vim 语法高亮文件提供若干选项:
在 Java 1.0.2 里，小括号里不可能有大括号，所以这被标识为错误。但从 Java 1.1 开
始，这是合法的 (无名类的使用)，因而它不再标为错误。如果你喜欢旧的方式，在 vim
启动文件里加入下行:
:let java_mark_braces_in_parens_as_errors=1
:let java_highlight_java_lang_ids=1
:let java_highlight_java_io=1
察看 javaid.vim 文件，可以得到它支持的所有包的列表。
函数名不会高亮，因为找到函数的方法取决于你如何写 Java 代码。语法文件知道两种可
以高亮函数的方法:
如果你的函数定义总是使用一个制表、8 个空格或者 2 个空格的缩进，可以设置
:let java_highlight_functions="indent"
不过，如果你遵循 Java 指南里函数和类的命名规则 (关于大小写)，就可以用
:let java_highlight_functions="style"
如果两个选项都不合适，但你仍然期望高亮函数声明，修改 java.vim 里的定义或者创建
你自己的 java.vim。你自己的版本应该包含原来的版本，并增加高亮函数的代码。
Java 1.1 里，只应该用函数 System.out.println() 和 System.err.println() 来进行
调试。所以你可以用不同的方式高亮调试语句。要这么做，你必须在启动文件里加上以下
定义:
:let java_highlight_debug=1
结果那些语句会被高亮为 'Special' 字符序列。如果你喜欢用不同的方式分别高亮，必
须为以下各组定义新的高亮:
Debug、DebugSpecial、DebugString、DebugBoolean、DebugType
它们分别用来高亮语句本身，调试字符串里的特殊字符、字符串、布尔常量和类型
(this，super)。我本人喜欢给语句设置别的背景。
为了帮助你编写在 Java 和 C++ 之间容易移植的代码，Java 程序里的所有的 C++ 关键
字被标为错误。不过，如果你经常使用，可以在 .vimrc 文件里定义如下变量:
:let java_allow_cpp_keywords=1
:let java_ignore_javadoc=1
:let java_javascript=1
:let java_css=1
:let java_vb=1
:hi link javaParen Comment
或
:hi javaParen ctermfg=blue guifg=#0000ff
注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可以修正的话，尝试设置
"java_minlines" 内部变量为较大的值:
:let java_minlines = 50
这使得语法同步在第一个显示行之前的 50 行开始。缺省值为 10。使用较大的值的缺点
是重画会变慢。
LACE *lace.vim* *ft-lace-syntax*
Lace (Language for Assembly of Classes in Eiffel，Eiffel 类整合语言) 对大小写
不敏感，但风格指南不是这么建议的。如果你喜欢对大小写不敏感的高亮，在启动文件里
定义 vim 变量 'lace_case_insensitive':
:let lace_case_insensitive=1
:syn sync minlines=300
的值。
LISP *lisp.vim* *ft-lisp-syntax*
Lisp 语法高亮提供两个选项:
g:lisp_instring : 如果存在，那么 "(...)" 字符串会被高亮，就像字符串里
的内容是 Lisp 代码一样。对 AutoLisp 有用。
g:lisp_rainbow : 如果存在且非零，那么不同的括号层次产生不同的高亮。
g:lisp_rainbow 选项为小括号和反引号提供 10 层不同的色彩。因为色彩层次的数量关
系，不同于非 rainbow (彩虹) 方式，rainbow 模式直接使用 ctermfg 和 guifg 指定高
亮色彩，而回避了标准的使用高亮组的色彩方案控制。实际使用的高亮值仍然取决于深/
浅设置 (见 |'bg'|)。
LITE *lite.vim* *ft-lite-syntax*
lite 语法高亮有两个选项。
如果你喜欢字符串里的 SQL 语法高亮，使用:
:let lite_sql_query = 1
:let lite_minlines = 200
:let lpc_syntax_for_c = 1
:let lpc_pre_v22 = 1
:let lpc_compat_32 = 1
:let lpc_use_lpc4_syntax = 1
:let lua_version = 4
:let lua_version = 5
:let lua_subversion = 0
:let lua_version = 5
:let lua_subversion = 1
:let mail_minlines = 30
:let make_no_commands = 1
:let mvpkg_all= 1
mv_DEtools mv_genfunc mv_networks mv_process
mv_Galois mv_geometry mv_numapprox mv_simplex
mv_GaussInt mv_grobner mv_numtheory mv_stats
mv_LREtools mv_group mv_orthopoly mv_student
mv_combinat mv_inttrans mv_padic mv_sumtools
mv_combstruct mv_liesymm mv_plots mv_tensor
mv_difforms mv_linalg mv_plottools mv_totorder
mv_finance mv_logic mv_powseries
let filetype_m = "mma"
:let moo_extended_cstyle_comments = 1
:let moo_no_pronoun_sub = 1
:let moo_no_regexp = 1
:let moo_unmatched_quotes = 1
:let moo_builtin_properties = 1
:let moo_unknown_builtin_functions = 1
:syn keyword mooKnownBuiltinFunction sprintf contained
:let msql_sql_query = 1
:let msql_minlines = 200
:let ncf_highlight_unknowns = 1
:let b:nroff_is_groff = 1
:let nroff_space_errors = 1
hi def nroffDefinition term=italic cterm=italic gui=reverse
hi def nroffDefSpecial term=italic,bold cterm=italic,bold
\ gui=reverse,bold
let b:preprocs_as_sections = 1
:let ocaml_revised = 1
:let ocaml_noend_error = 1
:let papp_include_html=1
:let filetype_p = "pascal"
:let pascal_traditional=1
:let pascal_delphi=1
:let pascal_symbol_operator=1
:let pascal_no_functions=1
:let pascal_gpc=1
:let pascal_fpc=1
:let pascal_one_line_string=1
<Tab> 字符，你可以设置 pascal_no_tabs 变量。制表会被高亮为 Error。
:let pascal_no_tabs=1
:let perl_include_pod = 1
:let perl_no_scope_in_variables = 1
{${"foo"}}':
:let perl_no_extended_vars = 1
:let perl_no_sync_on_sub
:let perl_no_sync_on_global_var
:let perl_sync_dist = 100
:let perl_fold = 1
:let perl_fold_blocks = 1
:unlet perl_nofold_packages
:unlet perl_nofold_subs
注意: 以前这被称为 "php3"，但因为现在这也支持 php4，它被改名为 "php"]
php 的语法高亮支持以下选项。
如果你喜欢字符串里的 SQL 语法高亮:
let php_sql_query = 1
let php_baselib = 1
let php_htmlInStrings = 1
let php_oldStyle = 1
let php_asp_tags = 1
let php_noShortTags = 1
let php_parent_error_close = 1
let php_parent_error_open = 1
let php_folding = 1
let php_sync_method = x
let g:plaintex_delimiters = 1
{}" 的话。
PPWIZARD *ppwiz.vim* *ft-ppwiz-syntax*
PPWizard 是 HTML 和 OS/2 INF 文件的预处理器。
该语法文件有如下选项:
- ppwiz_highlight_defs : 决定 PPWizard 定义的高亮模式。可能值是
ppwiz_highlight_defs = 1 : PPWizard #define 语句保留其内容的色彩 (比如，
PPWizard 的宏和变量)
ppwiz_highlight_defs = 2 : 预处理器 #define 和 #evaluate 语句使用单色显示，
除了行继续符以外
缺省 ppwiz_highlight_defs 的设置为 1。
- ppwiz_with_html : 如果该值为 1 (缺省)，高亮按本义出现的 HTML 代码；如果为
0，把 HTML 代码当成普通的文本。
PHTML *phtml.vim* *ft-phtml-syntax*
phtml 语法高亮有两个选项。
如果你喜欢字符串里的 SQL 语法高亮，使用:
:let phtml_sql_query = 1
:let phtml_minlines = 200
:let postscr_level=2
注意，不是所有的 PS 解释器都支持某一特定语言级别的所有语言特性。特别是，PS 文
件开头的 %!PS-Adobe-3.0 并_不_意味着使用的 PostScript 是 Level 3 的
PostScript！
如果你使用 Display PostScript，可以这样定义 postscr_display 变量来包含 Display
PS 语言特性的高亮:
:let postscr_display=1
:let postscr_ghostscript=1
:let postscr_fonts=1
:let postscr_encodings=1
:let postscr_andornot_binary=1
*ptcap.vim* *ft-printcap-syntax*
PRINTCAP + TERMCAP *ft-ptcap-syntax* *ft-termcap-syntax*
该语法文件适用于 printcap 和 termcap 数据库。
要使得 Vim 识别不匹配模式 "printcap" 或 "termcap" 的 printcap/termcap 文件，你
需要在 |myfiletypefile| 文件里定义合适你的系统的附加的模式。对这些模式，你必须
设置变量 "b:ptcap_type" 为 "print" 或 "term"，然后设置 'filetype' 选项为
ptcap。
比如，要使得 Vim 识别 /etc/termcaps/ 里的所有文件为 termcap 文件，加入下行:
:au BufNewFile,BufRead /etc/termcaps/* let b:ptcap_type = "term" |
\ set filetype=ptcap
注意到往回滚动时高亮有问题，但 CTRL-L 又可以修正的时候，尝试设置
"ptcap_minlines" 内部变量为一个大的数字:
:let ptcap_minlines = 50
:let filetype_w = "progress"
这同样适用于可为汇编文件的 "*.i" 和可为 Pascal 文件的 "*.p"。如果你不使用汇编
和 Pascal，你可以这么用:
:let filetype_i = "progress"
:let filetype_p = "progress"
:let python_highlight_numbers = 1
:let python_highlight_builtins = 1
:let python_highlight_exceptions = 1
:let python_highlight_space_errors = 1
:let python_highlight_all = 1
:let quake_is_quake1 = 1
:let quake_is_quake2 = 1
:let quake_is_quake3 = 1
let readline_has_bash = 1
注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可以修正的话，尝试设置
"rexx_minlines" 内部变量为较大的值:
:let rexx_minlines = 50
这使得语法同步在第一个显示行之前的 50 行开始。缺省值为 10。使用较大的值的缺点
是重画会变慢。
RUBY *ruby.vim* *ft-ruby-syntax*
Ruby 语法高亮有若干选项。
缺省，"end" 关键字根据它关闭的块对应的打开语句设定颜色。尽管很有用，该特性很消
耗资源: 如果你发现重画变慢 (或者你所在的终端色彩支持不好)，你可能想关闭该特
性，只要定义 "ruby_no_expensive" 变量即可:
:let ruby_no_expensive = 1
注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可以修正
的话，尝试设置 "ruby_minlines" 变量超过 50:
:let ruby_minlines = 100
:let ruby_no_identifiers = 1
:let ruby_no_special_methods = 1
:let ruby_space_errors = 1
:let ruby_fold = 1
:let sdl_2000=1
:let SDL_no_96=1
:let highlight_sedtabs = 1
<> 和关闭标签的 </> 的色彩不同。这是有意的。开放标签使用 'Function'
色彩，而关闭标签使用 'Type' 色彩 (见 syntax.vim 察看它们是怎么定义的)。
已知的标签名和 C 语句的色彩相同。未知的标签名和相应的 <> 或 </> 颜色相同，以便
纠错。
注意 这也适用于参数 (或属性) 的名字。已知的属性名和未知的标色不同。
一些 SGML 标签用于改变文本的显示。sgml.vim 语法色彩文件识别以下的标签，并相应
地改变普通文本的显示方式: <varname> <emphasis> <command> <function> <literal>
<replaceable> <ulink> 和 <link>。
如果你想改变文本显示的方式，必须重定义以下的语法组:
- sgmlBold
- sgmlBoldItalic
- sgmlUnderline
- sgmlItalic
- sgmlLink 设定链接
要使得重定义能够工作，你必须重定义所有的组。在你的 vimrc (这是根据初始化时读入
文件的顺序) 里定义下面的变量
:let sgml_my_rendering=1
:let sgml_no_rendering=1
<claudio@fleiner.com> 的 html.vim 的帮助文本转来)
SH *sh.vim* *ft-sh-syntax* *ft-bash-syntax* *ft-ksh-syntax*
这里讨论 "普通的" Unix 外壳，即 (Bourne) sh、bash 和 Korn shell。
(译者注: 原文作 Borne Shell。似为拼写错误，因为 Steve Bourne 是 sh 的作者)
Vim 试图根据文件名决定使用的 shell 类型:
ksh : .kshrc* *.ksh
bash: .bashrc* bashrc bash.bashrc .bash_profile* *.bash
如果这些都不符，那么就检查文件的第一行 (比如 /bin/sh /bin/ksh /bin/bash)。如
果第一行指定了外壳类型，那么就使用该类型。不过有的文件 (比如 .profile) 肯定是
外壳文件，但其类型并不容易推出。另外，有的系统里 sh 被符号链接到 "bash"
(linux、Windows+cygwin) 或 "ksh" (posix)。
你可以在 <.vimrc> 里设置下列三个变量中的一个，以指定全局的缺省值:
ksh:
let g:is_kornshell = 1
posix: (和设置 is_kornshell 为 1 效果相同)
let g:is_posix = 1
bash:
let g:is_bash = 1
sh: (缺省) Bourne shell
let g:is_sh = 1
译者注: 此处大概指希望使用其它缺省值的用户) -- 在 <.vimrc>
文件里自己选择系统使用的缺省 sh 版本就可以了。
如果你在 <.vimrc> 里设定
let g:sh_fold_enabled= 1
那么若干语法项目 (Here 文档和函数体) 就可以进行语法折叠 (见 |:syn-fold|)。
如果你注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可以修正的话，尝试设置
"sh_minlines" 内部变量为较大的值:
:let sh_minlines = 500
这使得语法同步在第一个显示行之前的 500 行开始。缺省值为 200。使用较大的值的缺
点是重画会变慢。
如果你没有要同步的东西，但显示又很慢，可以设置 "sh_maxlines" 内部变量来加速。
比如:
let sh_maxlines = 100
缺省值是 sh_minlines 的两倍。设置为较小的值可以提高显示的速度。缺点是高亮错误
出现的可能性也较大。
SPEEDUP (AspenTech plant simulator) *spup.vim* *ft-spup-syntax*
Speedup 语法文件有如下选项:
- strict_subsections : 如果定义该变量，只有段 (section) 和子段 (subsection) 里
的关键字会作为 Statement 高亮，而其它关键字不会 (比如 OPERATION 段里的
WITHIN)。
- highlight_types : 该变量的定义使得流类型 (stream type)，比如 temperature 或
pressure，用 Type 高亮，而不是普通的 Identifier。这里包括 DECLARE 段常见的类
型；如果定义了自己的类型，要在语法文件里自己加入。
- oneline_comments : 该值可选 1 到 3，它决定了 # 风格的注释的高亮方式。
oneline_comments = 1 : 允许偶数个 # 之后的正常 Speedup 代码。
oneline_comments = 2 : 第二个 # 开始的代码显示为出错。这是缺省设置。
oneline_comments = 3 : 如果某行包含超过一个 #，把整行显示为出错。
特别因为 OPERATION 段因为 PRESET (预设) 的变量而可能会很大，同步的正确设置很重
要。如果你的机器足够快，你可以在语法文件的末尾增加 minlines 和/或 maxlines 的
值。
SQL *sql.vim* *ft-sql-syntax*
*sqlinformix.vim* *ft-sqlinformix-syntax*
*sqlanywhere.vim* *ft-sqlanywhere-syntax*
尽管有 ANSI 的 SQL 标准，多数数据库引擎都增加了自己的扩展。Vim 目前支持 Oracle
和 Informix 的 SQL 方言。Vim 缺省假设 "*.sql" 文件使用 Oracle SQL。
Vim 目前通过不同语法脚本提供不同供应商的 SQL 支持。你可以把 Vim 的缺省设置从
Oracle 改为任何目前支持的 SQL 类型。你也可以方便地为每个缓冲区设置不同的 SQL
方言.
详细的操作可见 |sql.txt|。
TCSH *tcsh.vim* *ft-tcsh-syntax*
这里讨论名为 "tcsh" 的外壳。这是 csh 的超集。关于如何检测文件类型，见
|csh.vim|。
Tcsh 不允许字符串里的 \"，除非设置了 "backslash_quote" 外壳变量。如果你希望
VIM 认定不应该存在反斜杠 + 引号的构造，在 .vimrc 里加入这行:
:let tcsh_backslash_quote = 0
注意到往回滚动时，高亮出现问题，但 CTRL-L 重画又可