NetBeans IDE中phpDocumentor中的特殊HTML字符

时间:2010-02-11 19:23:00

标签: php netbeans special-characters phpdoc

如您所知,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字符的正确方法是什么?

3 个答案:

答案 0 :(得分:0)

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

在这个阶段进行HTML解码似乎非常不合适;像这样的文本标记系统的整个想法是避免HTML细节,如实体引用转义。您放入的任何文字HTML会发生什么,NetBeans是否尝试渲染它?

答案 1 :(得分:0)

在处理特殊字符方面,正确的做法是使用您想要的实际字符并在需要时转换它们。

因此,正确的方法是使用实​​际的&lt; &GT; &安培;你的评论中的字符和phpDoc插件需要将它们转换为.HTML文件的HTML编码版本,如果不这样做,那么不管他们做了什么或者说什么都是错误的。

答案 2 :(得分:0)

经过一些研究后,似乎phpDocumentor / NetBeans必须解释 some 标签。正如你在维基百科here上看到的,只有 以下标记应解释为HTML:

  • B'/ LI>
  • BR
  • I
  • KBD
  • P
  • SAMP
  • UL
  • VAR

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

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

希望很快就会修好......