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 公式ドキュメントを見て使いそうなタグの種類を把握するのが一番手っ取り早い感じ．
CSS のコメントの書き方コレアレ
CSSもHTMLと同じように、ソース中にコメントを挿入することができます。 /*と*/で囲った文字列がコメントになりますが、入れ子にすることはできません。また、他のプログラムにあるような「#」や「//」といった単一行コメントはありません。 適切なコメントを挿入することで、複数人での作業するときや、時間がたってから編集するときなどにコードの見通しが良くなります。ブラウザ間の差異を埋めるための宣言やハックなんかも、適用させるブラウザ名や理由などをきちんとコメントで書いておきたいですね。 僕は、スタイルをグループに分けて記述するときなど、コメントを目立たせるために次のように記述しています。 /* ------------------------------ Header ------------------------------ */ div#header { } . . /* -------
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
