========== Readme.txt  for  BooRandomImageLink ver1.04 ==========


＊BooRandomImageLinkは、Perlで記述されたプログラムです。


＊このプログラムを使用する前に以下のことをご確認下さい。

　１．サーバーでＣＧＩを使用できること
　２．サーバーでＰｅｒｌを使用できること


＊利用方法

　１．まず以下のファイルを用意します。( )内はファイル名。
　　　BooRandomImageLink　（bril.pl）

　２．次に bril.pl の拡張子を pl から cgi に変更します。

　３．bril.cgiを、エディタで開き、以下の部分を変更してく
　　　ださい。（変更箇所は先頭行と#set data部分です）　　

　　　＊先頭行の#! /usr/local/bin/perl の部分を 自分のサ
　　　　ーバーでのPerlへのパスに書き換えてください。分か
　　　　らない方は、サーバー管理者へお問い合わせください。

　　　＊$dat = の''内は、画像ファイルへのパスとリンク先
　　　　ＵＲＬを格納するファイル(path.dat)へのパスを記述
　　　　してください。

　　　＊$tmp = の''内は、作業用ファイル(temp.dat)へのパ
　　　　スを記述してください。

　４．メモ帳などのエディタで、画像パスとＵＲＬを格納する
　　　ファイルを作ります。１行に１つ、以下の形式で画像フ
　　　ァイルパスとリンク先ＵＲＬを記述します。
　　　左が画像ファイルへのパス、右がその画像に対応するリ
　　　ンク先で、[半角スペース]=[半角スペース]で繋ぎます。
　　　なお、画像ファイルは必ず同一サーバ上にある画像ファ
　　　イルでなければいけません。（画像ファイルの指定にＵ
　　　ＲＬを指定することはできません）
　　　対応画像ファイルは、GIF，JPEG，PNGです。

　　　例）
　　　./image1.jpg = http://url.to.link/1
　　　./image2.png = http://url.to.link/2
　　　./image3.gif = http://url.to.link/3

　　　ＣＧＩは、ここで記述した画像のいずれかを選んで表示
　　　し、その画像から対応するＵＲＬにリンクします。なお、
　　　ＣＧＩは１行を１データーと認識しますので、空行は作
　　　らないで下さい。
　　　記述できましたら、ファイル名を path.dat にして保存
　　　してください。

　５．メモ帳などのエディタで、作業用ファイルを作ります。
　　　こちらは何も内容は書かずに、ファイル名を temp.dat
　　　にして保存してください。

　６．bril.cgi，path.dat，temp.dat を、 サーバーにascii
　　　モードで転送します。
　　 （ＣＧＩプログラムの設置場所をプロバイダ側で指定し
　　　ている場合がありますので、分からない場合はサーバ
　　　ー管理者にお問い合わせください）

　７．以下のようにパーミッションを設定します。
 　　（パーミッションの設定方法についてはＦＴＰソフトの
　　　 操作説明をお読みください）
　　　　bril.cgi 　→　755
　　　　path.dat　 →　644
　　　　temp.dat　 →　666

　　　パーミッションの設定方法例
　　　｜　FTP.exeを使用する場合
　　　｜　例）ftp>quote site chmod 755 bril.cgi



＊使用方法１（ランダム画像リンクＣＧＩとしてご利用の場合）

　リンク画像を表示したい場所に以下のようなタグを記載します。
　例）
　<a href="./bril.cgi?link"><img src="./bril.cgi"></a>

　つまり、<a>タグでは、bril.cgiへのパスに?linkをつけて指定
　し、<img>タグではbril.cgiへのパスを何もつけずに指定します。
　<a>タグのalt=や<img>タグのwidth=やheight=などを指定しても
　かまいません。

　これでこのタグを挿入した場所に、path.datで設定した画像がラ
　ンダムに表示され、表示された画像をクリックするとその画像に
　対応したＵＲＬにアクセスできるようになります。


＊使用方法２（ランダム画像表示ＣＧＩとしてご利用の場合）

　ランダムに画像を表示したいだけの場合は、まずtemp.datは必要
　ありませんので、上記設置方法のうちtemp.datの作成と転送は無
　視してください。

　また、１行１画像ファイルパスというだけの記述で構いません。
　例）
　./image1.jpg
　./image2.png
　./image3.gif

　ＨＴＭＬには、以下のように記述してください。
　例）
　<img src="./bril.cgi?img">

　つまり、bril.cgiへのパスに?imgをつけて指定します。width=や
　height=などを指定してもかまいません。

　これでこのタグを挿入した場所に、path.datで設定した画像がラ
　ンダムに表示されます。


＊ご注意

　BooRandomImageLink はフリーソフトウエアですが、寄付は歓
　迎いたします。
　送金したくなった場合、下記アドレスまでメールしてくださ
　い。送金先をご連絡させていただきます。

　利用などに当たっては「ＣＧＩご利用上のルール」（下記Ｕ
　ＲＬ参照）に記載されているすべてのルールが適用されます
　ので、同意の上ご利用ください。

　・ＣＧＩご利用上のルール
　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
　１,単体の画像表示機能がうまく動かない不具合を修正

・Ver1.03
　１,乱数取得処理の一部を改善