Python中doxygen样式docstring的Vim语法高亮显示

我开始使用doxygen来生成Python代码的文档。 我使用

doxypy

filter来预处理Python文档字符串。 我的目标是在Python中对doxygen注释进行漂亮的语法突出显示

在专用的.dox文件中编写主页时，我发现可以使用以下命令在vim中突出显示doxygen注释：

set syntax=c.doxygen

我对Python尝试了相同的命令，但没有得到任何结果： set syntax=python.doxygen

我也做了一些谷歌搜索，没有找到任何有趣的东西

下面是我想强调的一段典型代码：

class CompilationTab:
    """
    The compilation tab of the verif GUI. It contains the layout description
    and the functions required to deal with specific behaviors of the tab
    """
    def __init__(self, notebook, tab_name):
        """
        The class constructor.

        @param notebook Notebook: The parent @c Notebook widget
        @param tab_name String: The display name of the tab
        """

有人已经解决了这个问题吗？

---

谢谢你的帮助

如果查看

syntax/doxygen.vim

，您可以在当前仅包含

cpp, c, idl, doxygen and php

支持文件

由于

doxygen.vim

与

syn region

命令配合使用，我在

syntax/python.vim

中搜索了定义多行字符串的行

命令中定义此区域的有趣部分是

syn region pythonString start=+[uU]\=\z('''\|"""\)+ end="\z1" keepend

由此派生出

doxygen.vim

中的内容，您可以添加以下行

"delete the following line if you don't want to have enhanced colors
let g:doxygen_enhanced_color=1
runtime! syntax/doxygen.vim
syn region doxygenComment matchgroup=pythonString start=+[uU]\=\z('''\|"""\)+ end="\z1" contains=doxygenSyncStart,doxygenStart,doxygenTODO keepend fold containedin=pythonString

到

~/.vim/after/syntax/python.vim

或手动执行

此外，您可能必须手动自定义添加的强氧突出显示组的颜色。至少我会这么做，因为结果看起来不符合我的口味

您可能对

syn

命令的

fold

参数特别感兴趣。如果将

foldmethod

设置为

syntax

，则可以折叠和展开多行注释。如果你再也无法忍受这些颜色，并且懒得调整它们，那么这似乎很有用：）

---

没有强氧突出显示：

带强氧突出显示和

g:doxygen\u增强\u颜色==1

：

---

非常感谢，它很好用：）！我在使用ftplugin/python.vim时遇到了一个问题。语法没有加载，即使我在上有

文件类型插件，并且
文件类型
给出了我的
python
。我通过在/python.vim语法中添加您给我的3行代码暂时解决了这个问题。我担心我的设置有点问题。顺便说一句，正如你所说的突出显示并不完美。稍后我可能会尝试更新它……实际上，将命令添加到
ftplugin/python.vim
中是行不通的。您应该将它们放在
~/.vim/after/syntax/python.vim
中。我将在回答中纠正这一点。非常感谢您的更新。实际上，它在/syntax

目录之后的

中正常工作。