web-dev-qa-db-ja.com

メソッドと属性のNetBeans PHP自動DocBlockをカスタマイズするにはどうすればよいですか？

メソッドを作成した後、/**<enter>を使用してDocBlockを生成します。その関数の@paramと@returnを自動的に入力します。例：

/**
 *
 * @param type $str
 * @return type 
 */
public function strlen($str){
    return strlen($str);
}

生成されるブロックをカスタマイズして、@authorも埋め、/**<enter>の後にこれで終わるようにするにはどうすればよいですか。

/**
 *
 * @param type $str
 * @return type 
 * @author John Doe <[email protected]>
 */
public function strlen($str){
    return strlen($str);
}

ありがとう

phpnetbeansdocumentationdocblocks
33
bxfckrclooo

これを行うためのより良い方法があるかもしれませんが、これが私が使用したものです：[ツール]> [オプション]> [エディター]> [コードテンプレート]の下に、コードをすばやく生成するための事前定義されたコンボがいくつかあります。 7.0のデフォルトテンプレートの1つは次のとおりです。

vdoc<tab>

これにより、疑似docblockと変数定義が生成されます。これを置き換えて、vimの略語のように、必要なテキストに展開する新しいテキストを追加できます。これについて詳しくは、Netbeansのドキュメントサイトをご覧ください。

http://netbeans.org/kb/docs/php/code-templates.html#using-templates

5
Bryan Agee

私はあなたが探している答えがここにあると信じています： phpDocumentorチュートリアル

--customtagsコマンドラインスイッチを確認することをお勧めします。

したがって、ほとんどの場合、[ツール]-> [オプション]-> [PHP]-> [PHPDoc]に移動すると、その--customtagsコマンドラインスイッチをPHPDocスクリプト行に追加できます。

私はこれを個人的に試みたことはありませんが、NetBeansをDocBlocksおよびPHPDocumentorと組み合わせて使用​​して、あまりにも精力的にならずに、大量の使用可能なドキュメントを「自動的に」作成するというアイデアを試してきました。 残りのコーダー。 ;-)

PHPDocumentorと連携するようにNetBeansを設定するための素晴らしいビデオチュートリアルがここにあります： Generating PHP Documentation With NetBeans IDE 7.

4
russsaidwords

適切な@authorタグのオートコンプリートを有効にするには、[ツール]-> [テンプレート]-> [PHP]-> [PHPクラス]に移動し、[設定]ボタンを押して、#user=で始まる行のコメントを解除します。これで、クラスのコメントに渡される名前とメールアドレスを編集できるようになりました。

3
zinovyev

さまざまなソースからの短い回答：いいえ、テンプレートを追加できるテンプレートを編集することはできません。

  1. それでも同様の機能を探している場合は、Macro doを作成してから、ショートカット（ "Alt + W"など）にバインドできます。

作成するにはマクロ：ツール->オプション->エディタ->マクロ

例：

Alt+W => insert-break "/**" insert-break

このマクロは、左手でPHPDocを追加するのに役立ち、高速になります。このマクロを使用して、カーソルを適切な場所に置き、コメントの最後に@author YOUR_NAMEを追加するなど、生成したいものを何でも生成できます。

  1. [ツール]-> [テンプレート]に移動して、プロジェクトの一般的な作成者を設定することもできます。 「設定」をクリックします

次の行を追加します：

user=YOUR NAME <email.prefix at domain.extension>

これにより、すべての新しいクラス/インターフェース定義に@authorが追加されます。

これがお役に立てば幸いです。

0
aneth101