PHP、Doxygen 和原始 HTML答案

【问题标题】：PHP, Doxygen and raw HTMLPHP、Doxygen 和原始 HTML
【发布时间】：2012-10-21 07:16:27
【问题描述】：

我想在文档中包含一些原始 HTML。我正在使用 Doxygen 生成此文档，因此它包含在 PHP 脚本中。

问题是，如果我这样做：

\\\ \htmlonly
<table>
.... etc

\\\ \endhtmlonly

PHP 解析原始 HTML 并因此产生错误。

但是如果我在生成的页面中出现的每一行的开头添加“///”。

解决这个问题的方法是什么？或者是否可以让 Doxygen 使用各种标签生成表格？

【问题讨论】：

【解决方案1】：

我不确定您的示例代码的上下文，因为我不懂 PHP，但通常 doxygen cmets 看起来像：

/// \htmlonly
/// <table>
/// .... etc
/// \endhtmlonly

注意所有 comment 行（doxygen 解析 cmets，而不是生成文档的源代码）如何以 /// 开头，甚至是 HTML 代码。 /// 将在包含在文档中之前从 HTML 中删除。试试上面的方法，看看是否能解决你的问题。如果没有，您能否提供更多上下文，即一个最小的工作示例。

【讨论】：

感谢您的回答。问题是原始 HTML 在带有所有标签的文本编辑器中有点不可读。但是我（也不是这个董事会）想不出更好的解决方案。也许是对 Doxygen 的未来增强。
但是你得到了“tick”，因为没有其他人回答。

【解决方案2】：

你使用include()吗？这会解析 HTML，但这不是必需的。请改用fpassthru。

【讨论】：