禁用Doxygen中的自动链接

时间:2018-04-08 08:47:43

标签: 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链接[test](<a href="http://www.test.com">http://www.test.com</a>)会受到污染,这会在我将其提供给另一个Markdown处理器后中断链接。我需要这个,因为我想在评论中写一些降价,并将其提取为一些结构化数据格式,以便其他工具处理降价。我在Doxygen中禁用了MARKDOWN_SUPPORT

我已尝试在doxyfile中禁用AUTOLINK_SUPPORT,但它只能禁用类/方法/ ...的内部类型链接。

1 个答案:

答案 0 :(得分:1)

自动链接网址的上述问题的解决方案是使用[test](%http://www.test.com)。通过%符号,(自动)链接被抑制。

在文档中,段落&#34;步骤3:记录来源&#34;:

  

为与记录的类相对应的单词创建链接(除非单词前面带有%;然后单词将不会被链接,并且%符号将被删除)。

注意:在上面的引用中,措辞仅适用于类,但它也适用于其他地方。同样的问题&#34;发生在其他地方:

  • AUTOLINK_SUPPORT
  • 的说明
  • 常见问题解答Doxygen会自动生成某个MyClass类的链接 在正在运行的文本中。我如何在某个地方阻止这种情况?
  • 段落链接到类
  • 段落&#34; \%&#34;