在 Doxygen 中禁用自动 link

disable auto link in Doxygen

如果我在源代码注释中写一些 URL,例如:

/**
 * Here is an inline link [test](http://www.test.com).
 * More information:
 * <a href="http://www.test.com">test</a>
 */

我在 Doxygen 中启用了 GENERATE_XML。这是它生成的内容:

<para>Here is an inline link [test](<ulink url="http://www.test.com">http://www.test.com</ulink>).
More information:
<ulink url="http://www.test.com">test</ulink> </para> 

转换标签后,我可以创建如下 Markdown 内容:

Here is an inline link [test](<a href="http://www.test.com">http://www.test.com</a>).
More information:
<a href="http://www.test.com">test</a>

请注意,Markdown link [test](<a href="http://www.test.com">http://www.test.com</a>) 已被污染,这将在我将其输入另一个 Markdown 处理器后破坏 link。我需要这个,因为我想在评论中写一些降价,并将其提取为一些结构化数据格式,供其他工具处理降价。我在 Doxygen 中禁用了 MARKDOWN_SUPPORT

我试过在doxyfile中禁用AUTOLINK_SUPPORT,但它只能禁用内部类型link到class/method/...

上述问题的解决方法,自动link输入一个网址,就是使用[test](%http://www.test.com)。通过 % 符号,(自动)linking 被抑制。

在文档中,第 "Step 3: Documenting the sources" 段:

Links are created for words corresponding to documented classes (unless the word is preceded by a %; then the word will not be linked and the % sign is removed).

注意:在上面的引用中,措辞仅适用于 classes,但它也适用于其他地方。同样的"problem"出现在其他地方:

  • AUTOLINK_SUPPORT
  • 的描述
  • FAQ Doxygen 在某处自动生成 link 到 class MyClass 在 运行 文本中。我如何防止在某个地方出现这种情况?
  • classes
  • 的段落链接
  • 段落“\%”