■作成手順を説明します。

1. プログラムをダウンロードします．
2. ダウンロードしたプログラムをを解凍し、編集します.
3. サーバに転送し、実行権を設定をします.

1. ファイルのダウンロードの前に、あなたのパソコンにディレクトリを作ります。
   • ホームページのある場所(index.htmを置いてある場所)にbirthdayというサブディレクトリを作成します。（ここに解凍した全ファイルを置きます。）
   • サーバー側にもbirthdayというディレクトリを作成しておきます。

2. プログラムの名前を(左)クリックするとダウンロードを始めます。
   1. birthdayご利用の方：birthday.lzhをダウンして下さい。
   2. sayhappy_spご利用の方：birthday.lzh、sayhappy_sp.lzh、whatday.lzhをダウンして下さい。
      (birthday、whatdayを設置済みの方はsayhappy_spのみダウンします。)

   ■CGIを動かすのに必要なファイル達
   　　(1) birthday.cgi-----赤色のファイルが必要です。
   　　(2) sayhappy_sp.pl---赤色＋青色のファイルが必要です。

   (右クリックでなくて左クリックですのでご注意下さい。)

   ファイル名	このファイルに同梱されてるファイル内容	最新版	サンプル
   birthday.lzh 　(約31KB)	スクリプト：birthday.cgi、birthday.pl、jcode.pl データ：birthdaydat.cgi 画像：birthday.gif、home.gif、mail.gif、heart.gif	V2.9b	birthday.cgi
   sayhappy_sp.lzh 　(約8KB)	スクリプト：sayhappy_sp.pl、sayhappy_sp.cgi	V2.2	sayhappy_sp.cgi
   whatday.lzh 　(約98KB)	スクリプト：whatday.pl、whatday.cgi データ：birthday.txt、monthly.txt、event.txt、history.txt	V1.6	whatday.cgi

   ■downcnt.cgiという名前で保存されますので、birthday.lzhなど名前を変更して保存します。これをLhasaなどの解凍ソフトで解凍します。
   ■旧版(sayhappy、thismonth)のダウンロードはこちらbirthday_sub.lzh(約6KB)からできます。

1. ファイルの構成と内容

   birthday.lzhを解凍し以下のファイルを使います。

   1. birthday.cgi（ハッピーバースデイ本体）
   2. birthday.pl （誕生花・誕生石表示プログラム、Mamiko.Sさん作）
   3. birthdaydat.cgi（データファイル）
   4. birthday.gif (タイトル画像)
   5. mail.gif (メール用画像)
   6. home.gif (ホームページ用画像)
   7. heart.gif (お誕生日マーク画像)
   8. jcode.pl (日本語コード変換プログラム)

   sayhappy_sp.lzhを解凍し以下のファイルを使います。

   1. sayhappy_sp.pl(今日・今月の誕生日&今日は何の日表示プログラム)

   whatday.lzhを解凍し以下のデータファイルを使います。

   1. birthday.txt（有名人誕生日ファイル）
   2. monthly.txt (何の日ファイル)
   3. event.txt (行事ファイル)
   4. history.txt (歴史・出来事ファイル)

2. birthday.cgi
   • １行目： #!/usr/local/bin/perl をあなたのプロバイダの「perlのあるパス」に書き換えます。
     多くのプロバイダはこの指定で大丈夫と思いますが、うまくいかない場合はプロバイダに問い合わせて下さい。Infowebの場合は #!/usr/bin/perl になります。
     
   • 25行目： $home = '../index.htm';に「ホーム」ボタンで戻したい戻り先URLを指定します。
     
   • 41行目： $midi = $basedir.'/happybirthday.mid'; のhappybirthday.midをあなたの演奏したいMIDIデータの名前にします。演奏しない場合は$midi ='';に変更します。
     (注)happybirthday.midは同梱されておりません。MIDIデータをご自身で用意できない方は必ず$midi ='';に変更してください。このままだと「プラグインが要求したデータ-は、正常にダウンロードできませんでした。」とエラーになります。
   • 47行目： $delkey = 'abc123'; のabc123をあなた固有のキーに変更します。投稿者に変更・削除させたい時は $delkey = '';に変更します。
     
   • 51行目： $address = 'xxxx@xxx.infoweb.ne.jp'; のxxxx@xxx.infoweb.ne.jpにあなたのメールアドレスを指定します。変更・削除キー問い合わせメールがこのアドレスに届きます。

3. sayhappy_sp.pl
   • １行目： #!/usr/local/bin/perl をあなたのプロバイダの「perlのあるパス」に書き換えます。
     
   • 19行目： $sel = 0; に表示項目選択番号を指定します。詳細はカスタマイズの項を参照してください。
   • 24行目： $basedir = './birthday' を、このCGIを貼りつけたHTML文、から見たbirthdayディレクトリのパスにします。birthdayディレクトリに全てのファイルを置けるプロバイダーの方は変更しません。
   • 29行目： cgiと画像データ等を別のディレクトリに置かないといけないプロバイダーの方は$basedir2 = './birthday';に、このCGIを貼りつけたHTML文、から見た画像データ等のパスを指定して下さい。
     
   • 34行目： $basedir3 = './whatday' を、このCGIを貼りつけたHTML文、から見たwhatdayディレクトリのパスにします。

4. birthday.pl
   • １行目： #!/usr/local/bin/perl をあなたのプロバイダの「perlのあるパス」に書き換えます。

5. birthdaydat.cgi、birthday.gif、mail.gif、home.gif、heart.gif、jcode.pl
   birthday.txt、monthly.txt、event.txt、history.txt
   • なにも変更しません。そのまま使います。

6. birthday.cgiへのリンク
   • index.htmの中に以下のリンクを貼ります。
     <a href="./birthday/birthday.cgi">ハッピーバースデイ</a>

7. sayhappy_sp.plへのリンク
   • index.htmの中の表示したい場所に以下のSSI文を記述します。
     <!--#exec cmd="./birthday/sayhappy_sp.pl"-->

8. index.htmなどのSSI記述するファイルの拡張子について
   • プロバイダーによってはSSIを記述するファイルの拡張子はindex.shtmlと、shtmlでないと動作しないところがあります(freewebなど)。あなたのプロバイダーに確認してください。

9. jcode.plのディレクトリー指定の方法（手持ちの jcode.pl を使う方）
   • いくつかのＣＧＩを設置してて、jcode.plを共通に使ってる方は、jcode.plを違うディレクトリーに置いてあると思いますので、birthday.cgiの require './jcode.pl'; の赤の部分をそのディレクトリー指定に書き換えます。パスの指定のしかたはこちらです。

1. 画像データbirthday.gif、mail.gif、home.gif、heart.gifをサーバ側にバイナリモードで、それ以外のファイルをアスキーモードで、転送します。

2. ファイルの構成と実行権
   転送が終わったら、 CGI(拡張子xxxx.pl、xxxx.cgiのファイル)に実行権755を、 birthdaydat.cgi に666を、ディレクトリ birthday、whatday に777を設定します。ディレクトリの実行権の設定を忘れないで下さい。

   index.htm
   birthday(777)
       |--------- birthday.cgi (755)
       |--------- birthday.pl (755)
       |--------- birthdaydat.cgi (666)
       |--------- birthday.gif
       |--------- mail.gif
       |--------- home.gif
       |--------- heart.gif
       |--------- jcode.pl (755)
       |--------- sayhappy_sp.pl (755)
   whatday(777)
       |--------- birthday.txt
       |--------- monthly.txt
       |--------- event.txt
       |--------- history.txt
   

新しいプロバイダに設置された方情報提供よろしくお願いいたします。

プロバイダ	HTMLからCGIへのリンク	画像置場	birthday.cgiの$basedir指定
infoweb	./birthday/birthday.cgi	birthday.cgiと同じ	$basedir = '.';
@nifty	http://hpcgi?.nifty.com/****/ birthday/birthday.cgi	index.htmと同位置の birthdayディレクトリ	$basedir = 'http://homepage?.nifty.com /****/birthday';
hi-ho	http://www.hi-ho.ne.jp/cgi-bin/user /****/birthday.cgi(サブディレクトリ不可)	index.htmと同位置の birthdayディレクトリ	$basedir = '/****/birthday';
isweb	http://isweb?.infoseek.co.jp/**** /cgi-bin/birthday/birthday.cgi	birthday.cgiと同じ	$basedir = '.';

(注)****部分はあなたが取得した名前(ID)です。?部分にはHTML文で記述するURLの場合と同じ数字が入ります。

正常動作が確認できたら、もっとあなた好みに変更(カスタマイズ)しましょう。

■簡単に変更できる項目
個人設定の部分が変更できます。いろいろトライしてみて下さい。

■birthday.cgi

1. トップページの表示形式
   
   • $toppage = 2; #カレンダー表示 0、登録順一覧表示 1、誕生順一覧表示 2
2. １ページに表示する件数
   
   • $pmax = '50';
3. 登録コメント文の文字数限度...全角文字１文字で「2」100で全角文字50文字...
   
   • $commax = '80';
4. bodyタグの設定
   • $col_bg = 'white'; #背景色
     $col_txt = 'black'; #テキスト色
     $bgpic = './gif/haikei.gif'; #背景に画像を使う場合場所を指定
5. タイトルに画像＆横幅
   • $titpic = './birthday.gif'; #タイトルに画像を使う場合場所を指定
   • $width = '85%'; #タイトルの横幅(pixel指定or%指定)。あなたのページに合わせて調整します。
6. 文字色( カラー名 or カラーコードを変更 )
   • $col_name = 'crimson'; #名前
     $col_mess = 'blue'; #メッセージ
     $col_regi = 'navy'; #登録日
     $col_flow = 'brown'; #誕生花メッセージ
     $col_srch = 'red'; #検索文字

1. 表示項目選択
   
   • $sel = 0;
     0：今日の誕生日＋今日は何の日＋今月の誕生日
     1：今日の誕生日＋今日は何の日
     2：今日の誕生日　　　　　　　　　　＋今月の誕生日
     3：　　　　　　　　　　今日は何の日＋今月の誕生日
     4：今日の誕生日
     5：　　　　　　　　　　　　　　　　　　　　今月の誕生日
     　　(注)今日は何の日のみ表示はwhatday.plをご利用ください
2. 文字色( カラー名 or カラーコードを変更 )
   • $col_name = 'crimson'; #birthday名前の文字色
     $col_name2 = 'blue'; #whatday名前文字色
     $col_flow = 'brown'; #誕生花メッセージの文字色
     $scolor = "lightcyan"; #新着色
3. 文字サイズ(スタイルシート)
   • $size = "8pt";
4. 今月の誕生日で１行に表示する人数(2,4と偶数値を指定)。あなたのページに合わせて調整します。
   • $num = 4;
5. テーブル幅の指定。(%指定 or ピクセル指定)。あなたのページに合わせて調整します。
   • $wid = "95%";
6. 新着を、過去何日以内にするか日にちを指定
   • $new = '30';

プロバイダーの中には SSI は使えるが、 #exec コマンドを禁止してるプロバイダー(hi-hoなど)があります。この場合、#include コマンドが使えれば、sayhappy_sp.plを#include用に変更することで同じSSI動作をさせることが出来ます。

• sayhappy_sp.plの変更個所
  ・7行目：#print "Content-type: text/html\n\n";の # を削除します。
  ・24行目：$basedir = './birthday'; の/birthdayを削除し $basedir = '.'; にします。
  ・34行目：$basedir3 = './whatday'; に「 . 」を1つ追加し $basedir3 = '../whatday'; にします。
  ・112行目：onClick='location=\"$basedir/birthday.cgi?action=reg&vew=$mon&disp=rday\"'およびonClick='location=\"$basedir/birthday.cgi\"'の$basedir/birthday.cgiの部分に$basedir/birthday/birthday.cgi と/birthdayを追加します。

• index.htm中の表示したい場所に以下の記述をします。
  ( sayhappy_sp.plでうまく行かないときは拡張子をsayhappy_sp.cgiに変更してみてください。プロバイダによっては拡張子がcgiでないと動作しないことがあります)
  <!--#include file="./birthday/sayhappy_sp.pl"-->
  

[注]「file」引数で指定できるパスは、SSI記述したHTMLファイルと同じディレクトリかサブディレクトリにある場合にのみ使えます。絶対パスは使えません。また相対パスでも「..(親ディレクトリ)」は使えません。
それ以外の場合、つまりfileでは指定できない所にファイルがある場合は「virtual」引数でファイルの位置をURLのパスで指定します。
　URLのパスとはURLがhttp://kikuchisan.net/の場合以下のようになります。
　<!--#include virtual="/birthday/sayhappy_sp.pl"-->

ページトップとボトムとにバナーを入れる場合の挿入箇所と挿入文例を以下に示します。広告バナーをCGIに入れる必要のあるプロバイダーの方は参考にしてください。
(注)サンプルはfreewebのものですがfreewebは2000年/7月からバナー自動挿入になりましたのでこの追加は必要ありません。[2000.08.20修正：この情報はｈ２さんから頂きました]

■ birthday.cgi

1. ページヘッダーの追加。(145行目) sub header{ print "<html><head><title>$title</title></head>$body\n"; print "<P ALIGN=right><FONT SIZE=-1><I>$date_now</I></FONT></P>\n"; ○○○○○ if ($midi ne '' && $form{'disp'} eq ''){ #音楽演奏 print "<EMBED src=\"$midi\" autostart=true hidden=true loop=false>\n"; } } と○○○○○の場所に以下の部分を追加します。
   print "<center><a href='http://www.freeweb.ne.jp/cgi-bin/ad/redirect.cgi' target='_top'><img src='http://www.freeweb.ne.jp/cgi-bin/ad/getimage.cgi?region=freeweb' border=0></a></center>\n";

2. ページボトムの追加。(106行目) # フッタの設定 $footer = <<_END_; <p><div align="right"><font size="-1">birthday.cgi $version by <a href="http://kikuchisan.net/" target="_blank">kikuchisan</a><br> birthday.pl by <a href="http://www.nmt.ne.jp/~mamiko/" target="_blank">Mamiko.S</a> </font></div>○○○○○</body></html> _END_ と○○○○○の場所に以下の部分を追加します。
   <center><a href="http://www.try-net.or.jp/" target="_top"><img src="http://www.freeweb.ne.jp/ad/trynet.gif" border=0></a><a href="http://www.freeweb.ne.jp/" target="_top"><img src="http://www.freeweb.ne.jp/ad/freeweb_s.gif" border=0></a></center>

■ sayhappy_sp.cgi

1. ページヘッダーの追加。(125行目) #ここからハッピーバースディ表示 print "<html><head><title>セイハッピー</title></head> <body bgcolor=$bgcol background=$bgpic>\n"; ○○○○○ print "<center><form method=\"GET\" action=\"$basedir/sayhappy_sp.cgi\">"; と○○○○○の場所に以下の部分を追加します。
   print "<center><a href='http://www.freeweb.ne.jp/cgi-bin/ad/redirect.cgi' target='_top'><img src='http://www.freeweb.ne.jp/cgi-bin/ad/getimage.cgi?region=freeweb' border=0></a></center>\n";

2. ページボトムの追加。(242行目) print "</center>\n"; ○○○○○ print "</body></html>\n"; と○○○○○の場所に以下の部分を追加します。
   print "<center><a href='http://www.try-net.or.jp/' target='_top'><img src='http://www.freeweb.ne.jp/ad/trynet.gif' border=0></a><a href='http://www.freeweb.ne.jp/' target='_top'><img src='http://www.freeweb.ne.jp/ad/freeweb_s.gif' border=0></a></center>\n";

解決法は、現在のところ頻繁に(例えば１回/１日)ファイルをアップロードするしか方法が見つかりません。下の方法もありますがInfowebではうまく機能しないようです。プロバイダによっては機能するかも知れないので試してみて下さい。

1. ファイル拡張子を xxx.shtml と shtml にする。
2. metaタグでno-cacheを指定する。<meta http-equiv="pragma" CONTENT="no-cache">
3. SSIでなくてCGIで利用する。この場合小ウィンドウを開いて表示すると良いでしょう。
   <a href="javascript:;" onClick='window.open("./birthday/thismonth.pl","","scrollbars=yes,width=300,height=350");'>今月の誕生日</a>
4. 旧infowebの方は、下記のファイルをindex.htmと同じ場所にアップすることによって日付が自動的に更新されるようになります。他のプロバイダーの方も.htaccessファイルが使える場合は有効かも知れませんのでプロバイダーに確認してみてください。
   [2000.07.15追加：この情報はinfowebユーザのｍａｍｙさんから頂きました]
   • ファイル名：.htaccess
   • 内容：XBitHack off

1. 西暦１年１月１日が月曜日と定められてます。
2. うるう年の計算
   if ((($year % 4 == 0) && ($year %100 != 0)) || ($year % 400 == 0))
   が「真」の年はうるう年になります。
3. 曜日の計算−ツェラーの公式より西暦$year年$month月$day日の曜日を求める
   $week = ($year + int($year/4) - int($year/100) + int($year/400) + int((13*$month + 8)/5) + $day ) % 7;
   
   ・$week = 0:日曜日、1:月曜日、・・6=土曜日になります。
   ・1月または2月の場合は前年の13月および14月とみなして計算します。

   第２月曜日は何日の算出
   上記ツェラーの公式で$dayを１にしてその月の1日の曜日を計算（上段の式）した後、下段の式の$happyMonに何日が得られます。
   $week = ($year + int($year/4) - int($year/100) + int($year/400) + int((13*$month + 8)/5) + 1 ) % 7;
   if ($week <= 1) { $happyMon = 7+(2-$week);} else { $happyMon = 14-($week-2);}

   （応用）第２日曜日は下段の式をこうします。
   $week = ($year + int($year/4) - int($year/100) + int($year/400) + int((13*$month + 8)/5) + 1 ) % 7;
   if ($week <= 0) { $happyMon = 7+(1-$week);} else { $happyMon = 14-($week-1);}
   （応用）第n日曜日は下段の式をこうします。
   $week = ($year + int($year/4) - int($year/100) + int($year/400) + int((13*$month + 8)/5) + 1 ) % 7;
   if ($week <= 0) { $happyMon = (n-1)*7+(1-$week);} else { $happyMon = n*7-($week-1);}

■ birtday

1. 2004/02/21　V2.9b
   　・「敬老の日」が2003(平成15)年から9月第3月曜日になる「祝日法」の改正に未対応だったのを対応するように修正。
2. 2003/05/03　V2.9a
   　・「海の日」が2003(平成15)年から7月第3月曜日になる「祝日法」の改正に対応。
   　・振替休日が祝日の場合に振替休日をダブって表示してしまうバグ修正。
3. 2002/08/10　V2.9
   　・データファイルを表示できないように変更。
4. 2000/03/25　V2.8
   　・春分/秋分の日の自動計算ルーチン追加。
5. 2000/03/02　V2.7
   　・今日の誕生日表示がおかしくなる(birthday.plの修正ミス)不具合緊急修正。
6. 2000/03/01　V2.6
   　・重複登録チェック機能追加。
   　・誕生花＆誕生石(birthday.pl)表示が１ヶ月ずれる不具合修正。
7. 2000/02/25　V2.5
   　・今日の誕生日(sayhappy.pl)機能を組み込み。
8. 2000/02/12　V2.4
   　・「変更・削除キー問い合わせ」をフォームメールから可能にした。
9. 1999/12/03　V2.3
   　・背景画像が表示されないバグ修正。
10. 1999/11/27　V2.2
    　・ハッピーマンディ法(成人の日/体育の日第２月曜日)に対応。
    　・振替休日の自動計算。MIDI機能の追加。
11. 1999/11/02　V2.1
    　・変更・削除権限を管理者のみとする機能の追加＆バグ修正。
12. 1999/10/27　V2.0　V1.0の機能強化。V2.0として公開。
    　・変更・削除機能の追加。
    　・AND検索が可能な検索機能追加。
    　・トップページ表示形式にカレンダー表示、誕生順表示、登録順表示の選択機能追加。
    　・１ページに表示する最大件数をユーザ指定できる機能の追加。
    　・一覧表示で誕生順表示、登録順表示の表示切替機能の追加。
    　・登録コメント文の文字数限度設定およびオーバした場合削除文字数を通知する機能を追加。
    
13. 1999/10/10　V1.0　スクリプト公開。

1. 2002/08/10　V2.2
   　・データファイルを表示できないように変更。
   
2. 2001/01/05　V2.1
   　・新着表示機能の追加およびスタイルシート導入によるテーブル表示のコンパクト化。
   　・コメントに「'」があるとスクリプトエラーになるバグ修正。
3. 2000/03/25　V2.0
   　・sayhappy、thismonth、wahtdayをsayhappy_spに吸収統合。(sayhappy、thismonthを廃止)
   　・背景画像指定、一覧表示リンクの追加。
4. 2000/02/16　V1.2
   　・任意の指定日を見れるようにsayhappy_sp.cgiの機能追加。
   　・パス指定を簡易にできるようにsayhappy_sp、sayhappy、thismonthのパス指定方法を変更。
5. 2000/02/12　V1.1
   　・「今日の誕生日」「今月の誕生日」「今日は何の日」を一体表示するsayhappy_sp.pl公開。
   　・「今日の誕生日」の表示内容に「登録者コメント」表示を追加。
   　・「今月の誕生日」の表示形式を横２段(任意に設定可能)に変更。
   　・CGIバージョンsayhappy.cgi、thismonth.cgi、sayhappy_sp.cgiを新規追加。
6. 1999/10/27　V1.0
   　・「今日の誕生日」(sayhappy.pl)「今月の誕生日」(thismonth.pl)を好きなページに表示するSSI公開。