在@snippets命令后面放置HTML标记

Question

我已经创建了一个别名，将\snippet嵌入到<div></div>中。

ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 </div>"

然后我用这样的别名：

@snippetLang{CS,ExampleForm.cs OnShow example}

参数扩展得很好，但是由于代码片段的第二个参数spands扩展到行尾，因此将包含</div>标记。

<div id='CS' class='snippetcontent'> \snippet ExampleForm.cs OnShow example </div>

\snippet命令现在将查找引用"OnShow example </div>“，而不仅仅是"OnShow example”

有什么方法可以让doxygen展开命令( \snippet \1位于自己的行中)，就像这样？

<div id='CS' class='snippetcontent'>
\snippet ExampleForm.cs OnShow example
</div>

DO2版本为1.8.14

Answer 1

来自doxygen文档(1.8.15)：

别名--此标记可用于指定许多别名，这些别名在文档中充当命令。别名有一个表单: name=value，例如，添加"sideeffect=@par副作用：\n“将允许您将命令\ Side Effect(或@Side Effect)放入文档中，这将导致一个带有标题”副作用：“的用户定义的段落。您可以将\n放在别名的值部分，以插入换行符(在结果输出中)。您可以将^^放入别名的值部分，以插入换行符，就好像物理换行符在原始文件中一样。当您需要一个文字{或}或者，在别名的值部分，您必须通过反斜杠()来转义它们，这可能导致与命令{和}的冲突，为此建议使用版本@{和@}或使用双重转义({和})。

版本：

ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 ^^</div>"

将适用于版本1.8.14及更高版本

版本

ALIASES += "snippetLang{2}=<div id='\1' class='snippetcontent'> \snippet \2 \n</div>"

将适用于1.8.14之前的版本