用HTML标记替换Doxygen详细描述标记

时间:2015-01-15 10:15:28

标签: html xml documentation doxygen

我正在使用Doxygen生成XML文档。我使用Markdown格式化我的描述,并且我感到困惑的是"详细描述"之间的标签。标签不是HTML标签。例如。

<heading level="1">Example</heading>

我检查了Oxygen的配置文件,看看是否可以强制它生成HTML标签而不是自定义HTML标签。我也用谷歌搜索看是否有人有同样的问题,但没有。

你看到这个问题的解决方案我应该自己写一个转换器吗?

1 个答案:

答案 0 :(得分:1)

虽然(理论上)doxygen可以为XML输出中的文档块生成XHTML,但它不会这样做。

所以是的,它是一种不同的格式,如果你需要HTML,你需要翻译它。

这背后的原因。

  • 灵活性:如果有人想要制作另一种输出格式,从使用XHTML开始比使用doxygen本身用于生成所有输出格式的相同内部表示更困难。
  • 遗留:在符合XML标准的HTML(即XHTML)之前,Doxygen已经生成了XML