我正在记录一个操纵XML数据格式的软件库。我希望能够在文档中编写XML示例,这样做的自然方式就是
@code{.xml}
... xml here ...
@endcode
除了Doxygen不像其他内容(如C ++)那样对内容进行语法突出显示。 (我在那里尝试过.html
而不是.xml
,以防Doxygen支持HTML但不支持XML,但是Doxygen似乎无法识别任何一个。)
有没有人对如何实现XML代码片段的语法高亮有任何建议?
(在主题上,我在哪里可以找到Doxygen在@code
/ @endcode
块中识别并突出显示的语言列表?到目前为止,我还没有在Doxygen手册中找到它。)
假设Doxygen只能对它可以解析的语言进行语法高亮(对于变量EXTENSION_MAPPING列出,如下面的注释中用户“albert”所指出的那样),则这意味着需要进行一些外部预处理。有没有人建议聪明的方法来做到这一点?
对于像我这样的人,在原始帖子之后可能会遇到这么多年,Doxygen支持通过Markdown Extensions支持语言的语法高亮。只需使用Fenced Code Blocks或\code
命令并指定显式文件扩展名即可。
我也找到了a Javascript library that can be used with Doxygen,但我还没有尝试过。