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

特殊文字の処理に関して、何かを行う正しい方法は、必要な実際の文字を使用して、必要なときに変換することです。

したがって、正しい方法はコメントに実際の<>＆文字を使用することであり、phpDocアドオンはそれらを.HTMLファイルのHTMLエンコードバージョンに変換する必要があります。変換しない場合は、それが間違っているにもかかわらず、間違っているのはそれらです。彼らが何をするか、何を言うか。

于 2010-02-11T21:02:52.623 に答える
0

いくつかの調査の後、phpDocumentor/NetBeans はいくつかの タグを解釈する必要があるようです。ここのウィキペディアでわかるように、次のタグのみを HTML として解釈する必要があります。

  • b
  • コード
  • br
  • 私
  • kbd
  • 李
  • オール
  • p
  • 前
  • サンプル
  • ウル
  • 変数

他のすべてのタグは、プレーン テキストとして表示する必要があります。現在、NetBeans はすべてのタグを解釈します。phpDocumentor docBuilder は一部のタグのみを解釈するため、これは IMO のバグです。

NetBeans Web サイトで問題 ( 180636 ) をオープンしました。

うまくいけば、それはすぐに修正されます...

于 2010-03-09T14:04:43.363 に答える
0

確かにphpDocumentorは定義上正しいと思いましたか？結局のところ、それは彼らのフォーマットです。

この段階で HTML デコードを行うのは、かなり望ましくないように思われます。このようなテキスト マークアップ システムの全体的な考え方は、エンティティ参照のエスケープなどの HTML の詳細を回避することです。入力したリテラル HTML はどうなりますか? NetBeans はそれをレンダリングしようとしますか?

于 2010-02-11T19:37:33.910 に答える