Warning: file_get_contents(/data/phpspider/zhask/data//catemap/3/html/69.json): failed to open stream: No such file or directory in /data/phpspider/zhask/libs/function.php on line 167

Warning: Invalid argument supplied for foreach() in /data/phpspider/zhask/libs/tag.function.php on line 1116

Notice: Undefined index: in /data/phpspider/zhask/libs/function.php on line 180

Warning: array_chunk() expects parameter 1 to be array, null given in /data/phpspider/zhask/libs/function.php on line 181
用HTML标记替换Doxygen detaileddescription标记_Html_Xml_Documentation_Doxygen - Fatal编程技术网

用HTML标记替换Doxygen detaileddescription标记

用HTML标记替换Doxygen detaileddescription标记,html,xml,documentation,doxygen,Html,Xml,Documentation,Doxygen,我正在使用Doxygen生成一个XML文档。我正在用Markdown格式化我的描述,我对“detaileddescription”标记之间的标记不是HTML标记感到困惑。比如说 <heading level="1">Example</heading> 示例 我检查了Oxygen的配置文件,看看是否有可能强制它生成HTML标记,而不是自定义标记。我还在谷歌上搜索,看看是否有人也有同样的问题,但什么都没有 你看到这个问题的解决方法了吗?我应该自己写一个转换器吗 虽然(理论

我正在使用Doxygen生成一个XML文档。我正在用Markdown格式化我的描述,我对“detaileddescription”标记之间的标记不是HTML标记感到困惑。比如说

<heading level="1">Example</heading>
示例
我检查了Oxygen的配置文件,看看是否有可能强制它生成HTML标记,而不是自定义标记。我还在谷歌上搜索,看看是否有人也有同样的问题,但什么都没有

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

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

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

这背后的原因

  • 灵活性:如果有人想要生成另一种输出格式,那么从XHTML开始将比使用doxygen本身用于生成所有输出格式的相同内部表示法更加困难
  • 遗留问题:在HTML(即XHTML)的XML兼容标准出现之前,Doxygen已经生成了XML

在这种情况下,我建议进行以下更改:将描述部分按原样保存在XML文件中。因此,如果我使用markdown编写描述,我可以在转换后获取它。我希望这个解决方案对你有意义。最好的。