php - PHP、Doxygen 和原始 HTML

Question

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

问题是，如果我这样做：

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

\\\ \endhtmlonly

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

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

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

Answer 1

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

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

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

Answer 2

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