========== Readme.txt for BooLinkTimer ver1.03 ========== ＊BooLinkTimerは、Perlで記述されたリンク定時変更プログラムです。 ＊このプログラムを使用する前に以下のことをご確認下さい。 　１．サーバーでＣＧＩを使用できること 　２．サーバーでＰｅｒｌを使用できること ＊利用方法 　１．まず以下のファイルを用意します。( )内はファイル名。 　　　BooLinkTimer　 （blt.pl） 　　　設定ファイル　　　（blt.dat） 　２．次に blt.pl の拡張子を pl から cgi に変更します。 　３．blt.cgiを、エディタで開き、以下の部分を変更してく 　　　ださい。（変更箇所は先頭行と#set data部分です）　　 　　　＊先頭行の#! /usr/local/bin/perl の部分を 自分のサ 　　　　ーバーでのPerlへのパスに書き換えてください。分か 　　　　らない方は、サーバー管理者へお問い合わせください。 　　　＊$set = の''内は、blt.datへのパスを指定します。 　４．必要に応じて、設定ファイルをテキストエディタで編集し 　　　ます。 　　　＊書式について 　　　　書式は１行１設定で、１行は下のように半角カンマで区 　　　　切られて３つの部分で構成されています。 　　　　2001/01/01-2001/01/02,00-01,http://url1 　　　　１番目の項目は年月日を指定します。 　　　　範囲を指定する場合は上の例のように、２つの日付の間 　　　　に半角ハイフンを挿入します。範囲指定をせず１日だけ 　　　　指定したい場合は2001/01/01のような形で指定します。 　　　　また、必ず年と月と日は半角スラッシュで分けなければ 　　　　いけません。 　　　　２番目の項目は時間帯です。00は午前０時、23は午後11 　　　　時です。範囲指定には年月日と同じく半角ハイフンを使 　　　　用します。時間帯は範囲指定しかできませんので、１時 　　　　間だけ指定したい場合は01-01のように指定します。 　　　　時間帯は、たとえば 01-02という指定の場合、01:00:00 　　　　から、02:59:59までを指します。ハイフンより左にある 　　　　時間はその数字の時間の０分０秒からを指し、ハイフン 　　　　より右にある時間はその数字の時間の59分59秒までを指 　　　　すということです。 　　　（01-02は 01:00:00 から 01:59:59までではないことに 　　　　ご注意下さい） 　　　　３番目の項目は、１番目と２番目の項目で指定された日 　　　　時期間にジャンプしたいリンク先ＵＲＬを指定します。 　　　＊ワイルドカードについて 　　　　年月日は、年，月，日で、それぞれワイルドカードが指 　　　　定できます。たとえば・・・ 　　　　2001/01/*,00-01,http://url1 　　　　という指定をすると、2001年の１月中は日に関係なく、 　　　　午前０時台から午前１時台までの間、http://url1 へジ 　　　　ャンプするということになります。 　　　　2001/*/*,00-01,http://url1 　　　　という指定なら、2001年中は月や日に関係なく、午前０ 　　　　時台から午前１時台までの間・・・という指定です。 　　　　*/01/*　は年と日に関係なく毎年１月となりますし、ま 　　　　た、*/*/* なら、年と月と日に関係なく毎日ということ 　　　　になります。 　　　　このように、年，月，日の好きな場所にワイルドカード 　　　　を指定することができます。 　　　 　　　　時間帯にもワイルドカードは利用できますが、時間帯で 　　　　指定できるワイルドカードは、単純な下のような形だけ 　　　　です。 　　　　2001/01/01,*,http://url1 　　　　この指定の場合は、2001年１月１日は１日中http://url1 　　　　へジャンプするということになります。 　　　　ワイルドカードをうまく使うと、いろいろな時間帯パタ 　　　　ーンが作れます。 　　　＊コメント行 　　　　先頭が半角の #で始まると、その行はコメントとして扱 　　　　われます。デフォルトでは #Set Time　という行があり 　　　　ますが、この行は #で始まっていますので、プログラム 　　　　では無視されるということです。 　　　　たとえば緊急に１つの設定を削除したい場合など、設定 　　　　行をまるごと削除しなくても、頭に #をつけるだけでそ 　　　　の行は無視されることになりますので、そういった用途 　　　　にも便利です。 　　　＊データの順番 　　　　プログラムは設定データを上から下に向かってチェック 　　　　していきます。そのため、 　　　　2001/01/01-2001/01/02,*,http://url1 　　　　2001/01/01,12-13,http://url2 　　　　という２行の設定データを書いても、2001年１月１日の 　　　　お昼の12時から１時までは、http://url2 にジャンプす 　　　　るのではなく、http://url1にジャンプします。 　　　　これは、１行目の設定で2001年１月１日から2001年１月 　　　　２日までの間は何時でも http://url1にジャンプするよ 　　　　うに設定されているためです。 　　　　こういう場合は、 　　　　2001/01/01,12-13,http://url2 　　　　2001/01/01-2001/01-02,*,http://url1 　　　　のように、設定を逆にするとうまく行きます。 　　　　１月１日のお昼の12時から１時までは１行目の設定に従 　　　　って http://url2にジャンプし、それ以外の場合には２ 　　　　行目のチェックが行われるからです。 　　　　さて、ここで問題が出てきます。上の１行目や２行目以 　　　　外の日時（たとえば１月３日など）ではどうなるのでし 　　　　ょうか。 　　　　これは下の項で説明します。 　　　＊ベースリンク先の設定 　　　　先に書いたように、指定した時間以外の場合、設定が存 　　　　在しないので、リンクは正常に機能しなくなります。 　　　　もちろん設定が存在しない時間帯がなくなるようにうま 　　　　く設定を行えば、このようなことは避けられますが、そ 　　　　れにしても、「どの設定にも当てはまらなかった場合」 　　　　というのができれば便利です。 　　　　これが、デフォルトのデータ内の一番下の行にある、 　　　　*/*/*,*,http://url2 　　　　という部分です。 　　　　よく見ると、これは日付と時間帯に全てワイルドカード 　　　　を指定しているだけです。年も月も日も時間帯も関係な 　　　　く、http://url2にジャンプするという設定です。 　　　　つまり、一番下の行でこのような設定を指定しておくこ 　　　　とで、「この設定より上の部分にある設定に該当しなか 　　　　った場合」という意味になるのです。 　　　　間違ってこれを一番上に書いてしまうと、プログラムは 　　　　上から下に向かってチェックしますので、いつもこの設 　　　　定が使われてしまい、リンク先は変化しなくなります。 　５．blt.cgi と bld.dat を、サーバーにAsciiモードで転送し 　　　ます。 　　 （ＣＧＩプログラムの設置場所をプロバイダ側で指定し 　　　ている場合がありますので、よく分からない場合はサー 　　　バー管理者にお問い合わせください） 　６．blt.datで 指定したＵＲＬにちゃんとアクセスできるか 　　　どうか、念のために確認して下さい。 　７．以下のようにパーミッションを設定します。 　　（パーミッションの設定方法についてはＦＴＰソフトの 　　　 操作説明をお読みください） 　　　　blt.cgi 　 →　755 　　　パーミッションの設定方法例 　　　｜　FTP.exeを使用する場合 　　　｜　例）ftp>quote site chmod 755 blt.cgi 　８．時間帯によって変化するリンクを置きたいＨＴＭＬ内の、 　　　当該リンク部分のタグを、下のようにします。 　　　リンクです 　　　"./blt.cgi"の部分は、各自そのＨＴＭＬからのblt.cgi 　　　へのパスに書き換えてください。 　　　また、ＨＴＭＬタグとしては、単純なリンクタグでＣＧ 　　　Ｉを呼び出しているだけで、上記例にある「リンクです」 　　　の部分はただのリンクテキストですので、自由に変更し 　　　てかまいません。 ＊使用方法 　blt.cgiへのリンクを埋め込んだＨＴＭＬに、ブラウザでアク 　セスすると、埋め込んだ場所のリンク先が 設定に従って所定 　ＵＲＬへのリンクとして機能します。 ＊ご注意 　BooLinkTimer は フリーソフトウエアですが、寄付は歓迎 　いたします。 　送金したくなった場合、下記アドレスまでメールしてくださ 　い。送金先をご連絡させていただきます。 　利用などに当たっては「ＣＧＩご利用上のルール」（下記Ｕ 　ＲＬ参照）に記載されているすべてのルールが適用されます 　ので、同意の上ご利用ください。 　・ＣＧＩご利用上のルール 　http://www.booboo.ne.jp/contents/cgi/rule/ 　当プログラムの使用により生じたトラブルもしくはそれに伴 　う損害に対し、制作者は一切責任を負いません。 ＊著作・制作 　ＢｏｏＢｏｏＣｌｕｂ 　E-mail: booboo@booboo.ne.jp 　ＵＲＬ: http://www.booboo.ne.jp/ 　お問い合わせ詳細 　http://www.booboo.ne.jp/contents/calendar/index.html ＊お願い 　バグレポート、ご感想、お問い合わせなどありましたら、 　上記アドレスまでメールをお願いいたします。 ＊バージョンアップ履歴 ・Ver1.00 　１,BooImageTimerをベースに採用 　２,内部処理を一部最適化 ・Ver1.01 　１,特定のケースで間違ったリンクになる不具合を修正 ・Ver1.02 　１,内部処理を一部修正 ・Ver1.03 　１,内部処理用タイムゾーン設定の追加