タグ

コメントアウトに関するalphabet_hのブックマーク (2)

  • phpDocumentorを導入して,Ext JSのAPIドキュメントっぽく出力

    phpDocumentorのインストール phpDocumentorは,PHPのコメントを解析して,自動でドキュメントを出力してくれます. とりあえずpearでインストール % sudo pear install phpdocumentor するするっと. インストールとか使い方は,このあたりを参考に phpDocumentor - PHPDocに代わるAPIドキュメント自動生成ツール - Do You PHP? 基的な説明が一通り. phpDocumentorでドキュメントの自動生成 同じく基の解説系.文字化け対策等も色々ありますが,生成されたHTMLに含まれるcharset=iso-8859-1をざっくりとcharset=UTF-8とかに置換するだけでOKっぽい. phpDocumentor tags 公式ドキュメントを見て使いそうなタグの種類を把握するのが一番手っ取り早い感じ.

    phpDocumentorを導入して,Ext JSのAPIドキュメントっぽく出力
  • CSS のコメントの書き方コレアレ

    CSSHTMLと同じように、ソース中にコメントを挿入することができます。 /*と*/で囲った文字列がコメントになりますが、入れ子にすることはできません。また、他のプログラムにあるような「#」や「//」といった単一行コメントはありません。 適切なコメントを挿入することで、複数人での作業するときや、時間がたってから編集するときなどにコードの見通しが良くなります。ブラウザ間の差異を埋めるための宣言やハックなんかも、適用させるブラウザ名や理由などをきちんとコメントで書いておきたいですね。 僕は、スタイルをグループに分けて記述するときなど、コメントを目立たせるために次のように記述しています。 /* ------------------------------ Header ------------------------------ */ div#header { } . . /* -------

  • 1