如您所知,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字符的正确方法是什么?
答案 0 :(得分:0)
我认为phpDocumentor肯定是正确的吗?毕竟这是他们的格式。
在这个阶段进行HTML解码似乎非常不合适;像这样的文本标记系统的整个想法是避免HTML细节,如实体引用转义。您放入的任何文字HTML会发生什么,NetBeans是否尝试渲染它?
答案 1 :(得分:0)
在处理特殊字符方面,正确的做法是使用您想要的实际字符并在需要时转换它们。
因此,正确的方法是使用实际的&lt; &GT; &安培;你的评论中的字符和phpDoc插件需要将它们转换为.HTML文件的HTML编码版本,如果不这样做,那么不管他们做了什么或者说什么都是错误的。
答案 2 :(得分:0)