========== Readme.txt for BooImageTimer ver1.02 ========== ＊BooImageTimerは、Perlで記述された画像定時変更プログラムです。 ＊このプログラムを使用する前に以下のことをご確認下さい。 　１．サーバーでＣＧＩを使用できること 　２．サーバーでＰｅｒｌを使用できること ＊利用方法 　１．まず以下のファイルを用意します。( )内はファイル名。 　　　BooImageTimer　 （bit.pl） 　　　設定ファイル　　　（bit.dat） 　２．次に bit.pl の拡張子を pl から cgi に変更します。 　３．bit.cgiを、エディタで開き、以下の部分を変更してく 　　　ださい。（変更箇所は先頭行と#set data部分です）　　 　　　＊先頭行の#! /usr/local/bin/perl の部分を 自分のサ 　　　　ーバーでのPerlへのパスに書き換えてください。分か 　　　　らない方は、サーバー管理者へお問い合わせください。 　　　＊$set = の''内は、bit.datへのパスを指定します。 　　　＊$dir = の''内は、対象となる画像のあるディレクト 　　　　リへのパスを指定します。 　４．必要に応じて、設定ファイルをテキストエディタで編集し 　　　ます。 　　　＊書式について 　　　　書式は１行１設定で、１行は下のように半角カンマで区 　　　　切られて３つの部分で構成されています。 　　　　2001/01/01-2001/01/02,00-01,image.gif 　　　　１番目の項目は年月日を指定します。 　　　　範囲を指定する場合は上の例のように、２つの日付の間 　　　　に半角ハイフンを挿入します。範囲指定をせず１日だけ 　　　　指定したい場合は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,image.gif 　　　　という指定をすると、2001年の１月中は日に関係なく、 　　　　午前０時台から午前１時台までの間、image.gif を表示 　　　　するということになります。 　　　　2001/*/*,00-01,image.gif 　　　　という指定なら、2001年中は月や日に関係なく、午前０ 　　　　時台から午前１時台までの間・・・という指定です。 　　　　*/01/*　は年と日に関係なく毎年１月となりますし、ま 　　　　た、*/*/* なら、年と月と日に関係なく毎日ということ 　　　　になります。 　　　　このように、年，月，日の好きな場所にワイルドカード 　　　　を指定することができます。 　　　 　　　　時間帯にもワイルドカードは利用できますが、時間帯で 　　　　指定できるワイルドカードは、単純な下のような形だけ 　　　　です。 　　　　2001/01/01,*,image.gif 　　　　この指定の場合は、2001年１月１日は１日中 image.gif 　　　　を表示するということになります。 　　　　ワイルドカードをうまく使うと、いろいろな時間帯パタ 　　　　ーンが作れます。 　　　＊コメント行 　　　　先頭が半角の #で始まると、その行はコメントとして扱 　　　　われます。デフォルトでは #Set Time　という行があり 　　　　ますが、この行は #で始まっていますので、プログラム 　　　　では無視されるということです。 　　　　たとえば緊急に１つの設定を削除したい場合など、設定 　　　　行をまるごと削除しなくても、頭に #をつけるだけでそ 　　　　の行は無視されることになりますので、そういった用途 　　　　にも便利です。 　　　＊データの順番 　　　　プログラムは設定データを上から下に向かってチェック 　　　　していきます。そのため、 　　　　2001/01/01-2001/01/02,*,image01.gif 　　　　2001/01/01,12-13,image02.gif 　　　　という２行の設定データを書いても、2001年１月１日の 　　　　お昼の12時から１時までは、image02.gif が表示される 　　　　のではなく、image01.gifが表示されます。 　　　　これは、１行目の設定で2001年１月１日から2001年１月 　　　　２日までの間は何時でも image01.gifを表示するように 　　　　設定されているためです。 　　　　こういう場合は、 　　　　2001/01/01,12-13,image02.gif 　　　　2001/01/01-2001/01/02,*,image01.gif 　　　　のように、設定を逆にするとうまく行きます。 　　　　１月１日のお昼の12時から１時までは１行目の設定に従 　　　　って image02.gifが表示され、それ以外の場合には２行 　　　　目のチェックが行われるからです。 　　　　さて、ここで問題が出てきます。上の１行目や２行目以 　　　　外の日時（たとえば１月３日など）ではどうなるのでし 　　　　ょうか。 　　　　これは下の項で説明します。 　　　＊ベース画像の設定 　　　　先に書いたように、指定した時間以外の場合、設定が存 　　　　在しないので、画像は表示されなくなります。 　　　　もちろん設定が存在しない時間帯がなくなるようにうま 　　　　く設定を行えば、このようなことは避けられますが、そ 　　　　れにしても、「どの設定にも当てはまらなかった場合」 　　　　というのができれば便利です。 　　　　これが、デフォルトのデータ内の一番下の行にある、 　　　　*/*/*,*,image02.gif 　　　　という部分です。 　　　　よく見ると、これは日付と時間帯に全てワイルドカード 　　　　を指定しているだけです。年も月も日も時間帯も関係な 　　　　く、image02.gif を表示するという設定です。 　　　　つまり、一番下の行でこのような設定を指定しておくこ 　　　　とで、「この設定より上の部分にある設定に該当しなか 　　　　った場合」という意味になるのです。 　　　　間違ってこれを一番上に書いてしまうと、プログラムは 　　　　上から下に向かってチェックしますので、いつもこの設 　　　　定が使われてしまい、画像は変化しなくなります。 　５．bit.cgi と bit.dat を、サーバーにAsciiモードで転送し 　　　ます。 　　 （ＣＧＩプログラムの設置場所をプロバイダ側で指定し 　　　ている場合がありますので、よく分からない場合はサー 　　　バー管理者にお問い合わせください） 　６．bit.cgiの $dir= で指定したパスに合うように、表示対象 　　　となる画像をバイナリモードで転送します。デフォルトの 　　　設定では、bit.cgi と同じ場所に画像を設置するようにな 　　　っています。 　７．以下のようにパーミッションを設定します。 　　（パーミッションの設定方法についてはＦＴＰソフトの 　　　 操作説明をお読みください） 　　　　bit.cgi 　 →　755 　　　パーミッションの設定方法例 　　　｜　FTP.exeを使用する場合 　　　｜　例）ftp>quote site chmod 755 bit.cgi 　８．画像を表示したいＨＴＭＬの、表示したい場所に、下の 　　　ようなタグを記述します。 　　　 　　　"./bit.cgi"の部分は、各自そのＨＴＭＬからのbit.cgi 　　　へのパスに書き換えてください。 　　　また、ＨＴＭＬタグとしては、単純なimgタグでＣＧＩを 　　　呼び出しているだけですので、widthやheightの設定も可 　　　能です。 ＊使用方法 　imgタグを埋め込んだＨＴＭＬに、ブラウザでアクセスすると、 　埋め込んだ場所に、設定に従って所定の画像が表示されます。 ＊ご注意 　BooImageTimer は フリーソフトウエアですが、寄付は歓迎 　いたします。 　送金したくなった場合、下記アドレスまでメールしてくださ 　い。送金先をご連絡させていただきます。 　利用などに当たっては「ＣＧＩご利用上のルール」（下記Ｕ 　ＲＬ参照）に記載されているすべてのルールが適用されます 　ので、同意の上ご利用ください。 　・ＣＧＩご利用上のルール 　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 　１,範囲指定機能を追加 　２,ワイルドカード設定機能を追加 ・Ver1.01 　１,特定のケースで間違った画像が選択される不具合を修正 ・Ver1.02 　１,内部処理を一部変更