0

如您所知,NetBeans IDE 将根据 phpDocumentor 语法在您的 PHP 源代码中弹出内联文档。

我发现当我在 phpDocumentor 文档中使用特殊的 HTML 字符时,它们在 NetBeans 中被视为 HTML,但在 phpDocumentor 生成的 HTMl 文档中被视为文本。

例如:

/**
 * Add a new <link> to the <head> of the document.
 */

在 phpDocumentor 生成的 HTML 中,会显示为:

Add a new <link> to the <head> of the document.

但在 NetBeans IDE 中,它将显示为:

Add a new <link> to the <head> of the document.

哪一个是对的?在 phpDocumentor 注释中嵌入特殊 HTML 字符的正确方法是什么?

4

3 回答 3

0

我会认为 phpDocumentor 的定义肯定是正确的?毕竟这是他们的格式。

在这个阶段进行 HTML 解码似乎是不可取的。像这样的文本标记系统的整个想法是避免实体引用转义等 HTML 细节。您输入的任何文字 HTML 会发生什么,NetBeans 是否尝试呈现它?

于 2010-02-11T19:37:33.910 回答
0

就处理特殊字符而言,做任何事情的正确方法是使用您想要的实际字符并在需要时转换它们。

因此,正确的方法是在您的评论中使用实际的 < > & 字符,并且 phpDoc 插件需要将它们转换为 .HTML 文件的 HTML 编码版本,如果它不这样做,那么就是他们错了,尽管他们做什么或说什么。

于 2010-02-11T21:02:52.623 回答
0

经过一些研究,似乎 phpDocumentor/NetBeans 必须解释一些 标签。正如您在此处的 Wikipedia 上看到的那样,只有以下标签应被解释为 HTML:

  • b
  • 代码
  • br
  • 一世
  • kbd
  • 奥尔
  • p
  • 采样
  • ul
  • 变量

所有其他标签应显示为纯文本。目前 NetBeans 解释所有标记。这是一个错误 IMO,因为 phpDocumentor docBuilder 只解释一些标签。

我在 NetBeans 网站上打开了一个问题 ( 180636 )。

希望它会尽快修复...

于 2010-03-09T14:04:43.363 回答