如何使Doxygen在包含XML片段的@code中进行语法高亮显示?

问题描述 投票:1回答:1

我正在记录一个操纵XML数据格式的软件库。我希望能够在文档中编写XML示例,这样做的自然方式就是

@code{.xml}
... xml here ...
@endcode

除了Doxygen不像其他内容(如C ++)那样对内容进行语法突出显示。 (我在那里尝试过.html而不是.xml,以防Doxygen支持HTML但不支持XML,但是Doxygen似乎无法识别任何一个。)

有没有人对如何实现XML代码片段的语法高亮有任何建议?

(在主题上,我在哪里可以找到Doxygen在@code / @endcode块中识别并突出显示的语言列表?到目前为止,我还没有在Doxygen手册中找到它。) 假设Doxygen只能对它可以解析的语言进行语法高亮(对于变量EXTENSION_MAPPING列出,如下面的注释中用户“albert”所指出的那样),则这意味着需要进行一些外部预处理。有没有人建议聪明的方法来做到这一点?

xml doxygen documentation-generation
1个回答
1
投票

对于像我这样的人,在原始帖子之后可能会遇到这么多年,Doxygen支持通过Markdown Extensions支持语言的语法高亮。只需使用Fenced Code Blocks\code命令并指定显式文件扩展名即可。

我也找到了a Javascript library that can be used with Doxygen,但我还没有尝试过。

© www.soinside.com 2019 - 2024. All rights reserved.