The Guest Book Manager - gbm

 ***************************************
   ざ、げすとぶっくまねーじゃー gbm
 ***************************************

gbmてなにゃ
いんすとーる
実験
運用
お返事書き書き
整理
漢字コードについて
「いっつにゅう」機能について
こまった!
すすんだ使い方

●gbmてなにゃ

見ためはちみがさっき見てた通り。なに見てない? んじゃわしんとことか。ランダムの御題がついてゲストはその御題に答えて、持ち主が返事を書くというスタイルのゲストブックさね。御題や返事は無しにもできるが。

で使う場合の話では、まず誰かが書き込みをすると書いた内容のメイルが来る。メイルをもらったらそれに返事を書けばゲストブック上の返事になるという仕組みである。返事を書く方法にはいくつかあって

来たメイルを引用して返事を書いてやはりメイルとして返送する
実際に書き込みファイルを直接開いて返事の文章を追加する
手元で返事を書いてあとで一気に送信する(UNIX+Emacsの場合)

のどれかが使える。まあ大抵は(1)の方法が楽チンじゃな。自分のゲストブック見なくても、速攻で返事が書けるというものじゃ。その他主な機能を列挙してみた。

古い書き込みの整理
最大表示日数の設定(ゲストブックを見る人向け)
前回読んだとき以降の新着書き込みマークの表示 (ゲストブックを見る人向け)
リロード猿牽制機能
狙いうち御題
自動お返事カスタマイズ

興味が出たら次を読もう。

●いんすとーる [さいしょに] 少なくとも CGI が使えるHTTPDじゃないとだめっす。ONにしてくださいな。デフォルトでSSI(Server Side Include)も使っているので、 SSIが使えないとちょっと面倒。「CGIよりSSIのほうが危ない」という迷信を信じてSSIだけを禁止している脳の無いプロバイダが世の中多くて困る。おっと、話を戻そう。 もしそれらの使えるプロバイダでも、ユーザ側で明示的にSSIとCGI が使えるようにする必要があるかも。たいていapacheだとおもうが、 apache 1.3.5以降(かな?)の場合は .htaccess というファイルに Options ExecCGI Includes AddHandler server-parsed .shtml AddHandler cgi-script .cgi なんて書く必要があるかも。 [さて] 適当なディレクトリを掘ってそこに移動してgbmを展開する。ゲストブックを books というディレクトリに保存するのでさらに掘る。 % mkdir books HTTPデーモンちゃんが書けるように chmod する。 % chmod 1777 books もしログファイルを書いて欲しかったら同じように % mkdir log % chmod 1777 log して大体の準備は完了。 [自分専用に書き換え] gbm ちうファイルの先頭に変数がわらわら書いてあるので、自分用に書き換えておくれ。でもgbmを直接書き換えるとバージョンアップしたときにまた最初からやり直さないといけなくなるので、gbmの「ここからENDまで」っていう範囲をこぴってgbconf.pl という新規ファイルを作ってそこにブチ込む。あ、gbconf.plの最後には必ず 1; という行を入れてな(元々入ってるけど)。すくなくとも、$owner はかきかえてちょ! これ書き換えないといつまで経っても書き込み通知メイルが来ない。 あと messages というファイルにランダムに出て来るメッセージをいれる。messages.sample というファイルがあるのでこいつをmessages というファイルにコピーして適当にかきかえてちょ。人と同じじゃつまんないもんね。少なくとも、HELLO, RAKU, FIELD, ANSWER タグのデータは全部書き換えてちょ。んで、ANSWERのところを、 ANS19990101 あけおめことよろ のように「ANS日付」というタグにしておけば、対応する日にそのタグに書き込まれた返事を書くようになる。これもうまく利用するよろし。 ということで、 [HTML書こう] gbmを呼び出すHTMLをかきませう。こんな感じ。gb.shtmlという名前にしてね。 ---------------------------------------------------------------------- <html> <head><title>Join us!</title></head> <body> やー!  </body> </html> ----------------------------------------------------------------------

●実験

早速ページを表示して書き込んでみやう。
どうなりましたか?

おしまい。

●運用

書き込みがあると、あたかも書いてくれた人が送ったかのようなメイルが届くの。そのメイルに対してお返事メイルを送っても良いんじゃが、通常は上で掘った books ディレクトリに `年月日-メイルアドレス' というファイルができていてるので _EOM_ 以降の行にお返事を追加してちょ。

●お返事書き書き

楽にお返事を書きたい。そんなちみのために楽々お返事ツールが用意されているのでつこてみてくれ。腹野もなんかためになるもん書いてるみたいだから読んで見るよろし。

●整理

書き込みが溜りすぎるとページが重くなって嫌われちゃう。ぜし月毎にわけるべし。gbm-1.29から、gbmが月毎の仕分け作業をするようになったので

	% ./gbm -refile

とやると先月分の書き込みを "先月の年月/" というディレクトリに格納してくれ、ついでにバックアップも取る。書き込みが多くてファイルサイズが気になるようなら、

	% ./gbm -refile -compress
	(./gbm -compressだけでもOK)

とすれば、圧縮してくれる。以上の操作で先月のディレクトリがうまく出来ているかを実際に自分のゲストブックを見て確かめて、うまくいったようなら

	% ./gbm -wipe

とすると、./books/ ディレクトリから(不要になった)先月分の書き込みを消去してくれる。cronで ~/public_html/gb/gbm -refile を起動しうまく先月ディレクトリが出来ていることが分かったら

	% ~/public_html/gb/gbm -wipe

なんてするといいかも。

./gbm -refile で先月ディレクトリを作っておくと gbm が自動的にゲストブックページにリンクを作ってくれるのだ。なお、先月分でなくて、特定の月のものを整理したいときは

	% ./gbm -month 199709 -refile

のように -month オプションで年月を指定するべし。さらに、長期に渡ってgbmを使っていると、月毎にリンクを張っても一杯になってしまうので、年毎に分類してしまっても良い。そういう場合は年/ のディレクトリを掘ってそこに過去の月分類ディレクトリを入れてしまえば良い。年/index.html を作ったら messages ファイルの REPLY 項目でリンクを張ればよろし。

●漢字コードについて

ファイルに保存するときはPerlやshが混乱しないようにEUCで書き、ブラウザに渡すときはブラウザが文字コード判定しやすいようにJISで表示するようにしている。

●「いっつにゅう」機能について

書き込みに「にゅう」が付くのは、来てくれた人が前回gbmページを開いた時間以降に書かれたやつ。

●こまった!

いろいろなトラブルの解決法である。

[SSIが使えないじょ!]

BIGLOBEとかはそうらしい。しゃーないので、gbmを呼び出すのを全部 CGIにする。まず gbm.cgi っていうシェルスクリプトを以下のようにする。

----------------------------------------------------------------------
        #!/bin/sh
        echo Content-type: text/html
        echo ''
        echo "<html><head><title>Guest Book</title></head><body>"
        ./gbm -init
        echo "</body></html>"
----------------------------------------------------------------------

背景を変えたかったら↑の <body> のところを適当に変えるべし。で、gbm自身の名前がある $html という変数があるのでこれを変更する。具体的には、gbconf.pl に $html = "gbm.cgi"; という一行を加える。

[ファイル名に@記号が使えない!]

どうもangelとかはそうらしい。gbmのブックファイル生成は出来るものの、ftpでファイル転送しようと思うと@マークを弾かれてしまうらしい。そういうときは、gbconf.pl に次の行を足してみる。

$atmarkalt = ":";

すると書き込みファイル作成時に@マークを使わないようになる。

[とにかく動かん!]

ぢゃあチェックリスト。

gbmとcgi2args.plの先頭の /usr/local/bin/perl はあっとる?
which perl などとして正しいパスに変えちくり。
nkfはある?
which nkf などとして正しい nkf のパス名を入れちくり。
もしくは gbconf.pl に
```
	      $tojis="/opt/bin/nkf";
	      $toeuc="/opt/bin/nkf -e";
	      
```
のように書くべし。また、rndmsg.pl にも nkf のPATH記述があるのでそこを
```
	      $nkf = "/opt/bin/nkf";
	      
```
と変更すべし。
別にnkfでなくても漢字コード自動変換が出来るツールなら何でもええ。

[通知メイルがこないじょ!]

変数 $sendmail に sendmail コマンドの位置をちゃんと指定しても「書き込みがあったよ」通知メイルが送られない場合があるらしい。そんなときは

変数 $viasmtp にメイルサーバのホスト名を入れてみる
それでもだめなら変数 $telnetsmtp を1にしてみる
それでもだめなら作者に泣きつく
それでもだめならプロバイダを変える
それができなきゃ変数 $doreport を0にしてあきらめる

なり。

●すすんだ使い方

[お返事に凝る]
いつもランダムな返事ばかりではつまらない。そう嘆いているちみにプレゼントだ。answer.pl というファイルを用意してその中で answer という関数を定義するとgbmはお返事作成のときにその関数を使うようになる。answer.plの大体の形はこんな感じになる。
```
----ここから----------------------------------------------------------
        sub answer {
            local($email, $url, $name, $odai, $mes) = @_;
            # ↑で各変数にそれぞれ、
            # (メイルアドレス, ホームページURL, 名前, お題, 書き込み)
            # が入るので、それを元に返事となる文字列を生成する
            "文字列"    # で最後にその文字列を返しておしまい
        }
        1;              # ファイル末の 1; を忘れずに
----ここまで----------------------------------------------------------
```
あ、ちなみに関数末で "" や 0 を返すとデフォルトのランダムメッセージを採用するのでうまく利用すると良い。まあ、これをやろうっていうちみはぴろぞーさんレベルなのでこれ以上説明せんでもわかるっすな。おしまい。
[御題に凝る]
相手によって御題を切り替えたいとな。まったくもう。

普通の御題は FIELD というタグに列挙していく。が特定のドメインから来た人に特定の御題リストを出したいときは、
```
	 FIELD.*.domain.or.jp	やーおはよー
	                        待ってたよー
	
```
のように書くよろし。*.domain.or.jp からのアクセスに対する御題となる。ちなみに . と * は正規表現の . と * なので、うるさいことをいうと上の書き方は間違い。正規表現的に正しく書くなら
```
	 FIELD\..*\.domain\.or\.jp
	
```
としなければならないが、最初の例でもたまたま . の次に * がくるし裸のピリオドはピリオド自身にも一致するのでうまいぐあいにマッチして結果オーライである。また、IPアドレスでも書けて、
```
	 FIELD.131.113.37	管理の授業厳しい?
	                        ほげー
	
```
とすると、131.113.37.* にたいする御題となる。netmaskを考慮しようかと思ったけどめんどいのでやめ。そのかわり正規表現つかえるので厳密に制御したいときは FIELD.131.113.16.3[0-5] みたいにしてちょ。もしくは次の、再帰タグをつこてちょ

一つのリストを複数のタグで参照できて
```
	 FIELD.gentei.org	がっちゃんげんきー?
	                        おはよー
	 FIELD.hoge.co.jp	&FIELD.gentei.org
	
```
と、データ部分に &タグと書くと、そのタグの持つリストを別名で参照できるのだ。

あと、もうひとつ、
```
	  FIELD.yuuji@gentei.org
	
```
のように FIELD.メイルアドレスをタグにすると、そのメイルアドレスを持つ人に対する御題となる。あらかじめクッキー値でemailアドレスを焼いた人だけに有効ね。
[入力フィールドを増やしたい]
ああんもう、わがままでちゅね～

「ちみの愛称」と書き込み領域の間に任意個のフィールドを増やせるようにしたんよ。じゃあ二個増やすとしよう。項目は、「愛車」、と「今日の朝御飯」にするとしよう。
1. gbconf.pl の $Xfieldlist 変数に追加項目をカンマで区切って足す。
```
	       $Xfieldlist = "愛車,今日の朝御飯";
	      
```
  上記の場合追加項目は、「愛車」、「今日の朝御飯」となる。
2. それぞれ gbm スクリプト中では $Xfield1, $Xfield2 という変数で管理される。そのための専用プロンプト(入力窓の一行上に出る説明文)を用意したければmessagesファイルに以下の項目を足す。
```
	       Xfield1.PROMPT	「のってるくるま」
	                        「愛車」
				 「今日の足」
	       Xfield2.PROMPT	「あさめし」
	                        「朝食ったもの」
	      
```
  もし、入力フィールドの説明が「愛車」、「今日の朝御飯」のままでよいのなら Xfield?.PROMPTは定義しなくて良い。
3. $Xfield1, $Xfield2 をクッキーに焼きたければ、gbconf.pl の中で変数 $Xcookie_list に焼きたい番号をカンマで区切って列挙する。
```
	       $Xcookie_list = "1,2";
	      
```
  なお、デフォルトで最初の五個の変数のクッキーを焼くようになっているので明示的に指定しないとほいほい焼かれることになっちゃうのでちうい。
4. 拡張フィールドを書き込みデータに埋め込むときの接頭辞、中間辞、接尾辞を設定する。例えば、$Xfield1 となる項目「愛車」にたいして「さそり」を入力したときにファイルに書かれるデータは、
```
	       $Xfield1.PREFIX	<center>「
	       $Xfield1.MIDDLE	」は、[
	       $Xfield1.SUFFIX	]</center>
	      
```
  と設定すると
```
	       <center>「愛車」は、[さそり]</center>
	      
```
  となる。
ほれ、結構面倒じゃろ。やめとけやめとけ。

yuuji@

Fingerprint16 = FF F9 FF CC E0 FE 5C F7 19 97 28 24 EC 5D 39 BA
HIROSE Yuuji - ASTROLOGY / BIKE / EPO / GUEST BOOK / YaTeX