にしし ふぁくとりー:西村文宏 個人サイト

No.548 - 今日のひとことログ

更新

■LOG No.548

にししふぁくとりーHOMEに掲載している「今日のひとこと」の過去ログ(掲載履歴)です。 RSS

No.548 〔504文字〕

ソース内に記述しているコメントが豊富な点を時々お褒め頂くので嬉しい。配布しているHTMLやCSSにコメントを詳しめに記述しているのは、活用して頂くためには自在にカスタマイズできる必要があるだろう、という考えのためだ。もう少し詳しく、書き換え例まで書いておく方が役に立つかなと思わなくもないのだが、あまりにもコメントを含めすぎると(無駄に)重たくなる上に全体を見通しにくくなる可能性もあるので避けた。そもそもHTMLやCSSソースを直接編集しようと考える人々は、それなりに編集経験はあるだろうから、そこまでの情報は要らないだろうとも思える。単なるWebテンプレートならそこまで書いても良いが、CGIに付属するHTMLやCSSの場合、対象は「CGIを自力で設置しようと思えるくらいのスキルはある人」なわけだから。なお、プログラムソース内に詳しくコメントを書いているのは(99%くらいは)自分のためだ。自分で書いたソースでも、半年も経てばほとんど他人が書いたようなものなので、その当時の意図などすっかり忘れてしまっているのが常だから、何故そう書いたのかをしっかりコメントとして残しておかないと自分が困ることになる。
Powered by てがろぐ Ver 2.6.0

--- 当サイト内を検索 ---