将 Doxygen detaileddescription 标签替换为 HTML 标签

Replace Doxygen detaileddescription tags with HTML tags

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

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

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

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

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

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

这背后的原因。

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