Doxygen 在@snippets 命令之后放置 HTML 标记答案

【问题标题】：Doxygen put HTML tag after a @snippets commandDoxygen 在@snippets 命令之后放置 HTML 标记
【发布时间】：2019-09-22 12:04:41
【问题描述】：

我创建了一个别名来将 \snippet 嵌入 HTML <div></div>

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

然后我像这样使用别名：

@snippetLang{CS,ExampleForm.cs OnShow example}

参数扩展很好，但由于 sn-p 的第二个参数跨越到行尾，</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>

Doxygen 版本是 1.8.14

【问题讨论】：

您是否尝试将^^ 放在</div> 之前？这是强制换行。还请指定您使用的 doxygen 版本（确实会影响 ALIAS 中的换行符）。
@albert 我添加了 Doxygen 版本并且您的解决方案有效。如果您写了正确的答案，我可以将其标记为解决方案。但是我遇到了下一个问题并将发布一个新问题。

标签： html command alias doxygen

【解决方案1】：

来自 doxygen 文档 (1.8.15)：

ALIASES 这个标签可以用来指定一些别名作为文档中的命令。别名的形式为：name=value For 添加“sideeffect=@par Side Effects:\n”的示例将允许您放置文档中的命令 \sideeffect（或@sideeffect），其中将产生一个用户定义的段落，标题为“副作用：”。您可以将 \n's 放在别名的值部分以插入换行符（在结果输出）。您可以将 ^^ 放在别名的值部分中插入换行符，就好像物理换行符在原始文件中一样。当您需要文字 { 或 } 或时，在别名的值部分中，您必须通过反斜杠 () 来转义它们，这可能导致与命令{和}冲突，建议使用版本 @{ 和 @} 或使用双重转义（\{ 和 \}）

版本：

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 之前的版本

【讨论】：