Vim 中嵌套注释折叠的语法高亮

Question

在 Vim 中，我使用标准折叠标记 {{{,}}} 以及折叠的命名约定（例如 {{{ collection） 。一些命名的折叠定义了注释（例如{{{documentation），我希望这些能够如此突出显示。所有折叠都以相同的 }}} 标记结束。

我在以下方面取得了一些成功：

syn region cComment start="{{{ documentation" end="}}}"
    contains=@cCommentGroup,cCommentStartError,cSpaceError,@Spell fold

但问题是注释折叠也可以包含通用 collection 折叠，如下例所示：

{{{ documentation
    {{{ collection
    // some text
    }}}
    {{{ collection
    // some text
    }}}
}}}}

在这种情况下，注释在第一个 } 时停止}} 已到达，因此第二个 collection 折叠不会突出显示为注释。

contains 选项似乎不相关，因为这使得包含的折叠具有其标准突出显示。

我希望注释折叠内的任何折叠都继承注释语法，而不影响注释折叠外的默认语法。

考虑到所有折叠都具有相同的结束标记，这在 Vim 中可能吗？

Answer 1

" Hi. Two syntax regions aren't enough, you have to use a third. There
" are two important things to note. First, 'matchgroup' (see :help
" :syn-matchgroup) prevents contained items from matching in the start
" and end patterns of the containing item. Second 'transparent' (see
" :help :syn-transparent) allows the inheriting of an item's containing
" syntax colouring.
"
" Save this entire text in a file and then :source it to see the effect.
"
"   blah
"   {{{ collection
"       blah
"   }}}
"   blah
"   {{{ documentation
"       {{{ collection
"           blah
"       }}}
"       blah
"       {{{ collection
"           blah
"       }}}
"   }}}
"   blah
"   {{{ collection
"       // some text
"   }}}
"   blah

syn clear

hi documentation guifg=darkcyan ctermfg=darkcyan
hi collection guifg=darkmagenta ctermfg=darkmagenta

syn region genericdoc start="{{{" end="}}}" transparent
syn region collection start="{{{ collection" end="}}}"
syn region documentation matchgroup=documentation
\ start="{{{ documentation" end="}}}" contains=genericdoc

Answer 2

老实说，我不完全确定你想要什么，但似乎确实有一种方法可以区分“文档”折叠的末尾和“集合”折叠的末尾。仅当发现三个右括号作为一行中的第一个字符时，下面的代码才会结束 cComment 区域：

syn region cComment start="{{{ documentation" end="^}}}"
    contains=@cCommentGroup,cCommentStartError,cSpaceError,@Spell fold

此外，如果您使用标记来指定折叠，则语法区域命令中的 'fold' 选项不相关。仅当您使用语法指定折叠时，将折叠与 syn-region 结合使用才有用，但事实并非如此。