========== Readme.txt for BooWordsSearch ver1.11 ========== *BooWordsSearchは、Perlで記述されたプログラムです。 *このプログラムを使用する前に以下のことをご確認下さい。  1.サーバーでCGIを使用できること  2.サーバーでPerlを使用できること *利用方法  1.まず以下のファイルを用意します。( )内はファイル名。    BooWordsSearch   (bws.pl)    jcode      (jcode.pl)     検索フォーム    (bws.txt)    検索対象設定ファイル(searchdir.dat)  2.次に bws.pl の拡張子を pl から cgi に変更します。  3.次に bws.txt の拡張子を、txt からhtml に変更します。  4.searchdir.datをエディタで開き、検索対象ディレクト    リを設定します。    (デフォルトのままでは使用できません)    検索対象ディレクトリの設定書式は下のようになって    います。    [書式]    パス,URL,拡張子    パスは、検索時に検索対象トップディレクトリとなるデ    ィレクトリへのパスを指定します。    ここで指定したディレクトリと、そのすべてのサブディ    レクトリ内にあるHTMLファイルが検索対象になりま    す。    URLは、パスで指定したディレクトリのURLを指定    します。    拡張子は、検索したいディレクトリ内のファイルのうち、    検索対象に含みたいファイル拡張子を指定します。    複数ある場合は半角コロン(:)で区切ります。    検索対象ディレクトリが複数ある場合は、上の要領で複    数行記述してください。    例)    ./abc/def/,http://url/abc/def/,htm:html    ./xyz/,http://url/xyz/,htm:html:txt  5.bws.cgiを、エディタで開き、以下の部分を変更してく    ださい。(変更箇所は先頭行と#set data部分です)      *先頭行の#! /usr/local/bin/perl の部分を 自分のサ     ーバーでのPerlへのパスに書き換えてください。分か     らない方は、サーバー管理者へお問い合わせください。    *$sdfile = の''内は、検索対象ディレクトリ設定ファ     イル(デフォルトではsearchdir.dat)の パスを指定し     ます。    *$found = の''内は、検索結果を挿入するHTMLフ     ァイルを指定します。    *$head = の''内は、検索結果上部に表示されるテキス     トを指定します。HTMLタグも利用可能です。    *$view = の''内は、検索結果表示でHTMLタイトルをリ     ンクテキストとしてリンクしたい場合は title を、     URLをリンクテキストとしてリンクしたい場合は URL     を指定します。    *$sepa = の''内は、検索文字の区切りに使う文字を指     定します。デフォルトは半角スペースです。    *$log = の''内は、on か off を指定します。     onを指定すると、検索ワードのログを取得します。     offを指定すると、ログは取得しません。    *$logfile = の''内は、$logで on を指定した場合に、     検索ワードのログを保存するファイルのパスを指定し     ます。$logで off を指定した場合は 関係ありません     のでデフォルトのままで構いません。    *$logmax = の''内は、$logで on を指定した場合に、     保存するログの件数を指定します。これより多くなっ     た場合は古いものから削除されていきます。    注:$logで on を指定した場合は、ログファイルを用意      してください。中身が空で log.datというファイル      名のファイルを用意します。  6.メモ帳などのエディタで、検索フォーム(bws.html)を    自由にデザインなどを編集します。その際、フォーム関    連タグの name やvalueなど、CGIに影響する部分は    変更しないようご注意ください。    あるいは既にお持ちのHTMLに検索フォームを作って    もご利用できます。その際は当CGI付属の検索フォー    ムを参考にフォームを作成してください。  7.メモ帳などのエディタで、検索結果を挿入するHTML    を開きます。どんなHTMLファイルでもかまいません。    検索結果を表示させたい箇所に以下のコメントタグを挿    入してください。        このコメントタグの部分に検索結果が埋め込まれて表示    されることになります。  8.bws.cgi,jcode.pl,検索フォームHTML,検索結果を挿入    するHTML,searchdir.dat を、サーバーにAsciiモードで    転送します。    検索ワードのログを保存する設定にした場合は、log.dat    も転送してください。    (CGIプログラムの設置場所をプロバイダ側で指定し    ている場合がありますので、分からない場合はサーバ    ー管理者にお問い合わせください)  9.以下のようにパーミッションを設定します。   (パーミッションの設定方法についてはFTPソフトの     操作説明をお読みください)     bws.cgi  → 755     log.dat  → 666(ログを保存する場合)    パーミッションの設定方法例    | FTP.exeを使用する場合    | 例)ftp>quote site chmod 755 bws.cgi *使用方法  検索フォームの文字入力欄に検索文字を入力し、検索ボタンを  押すことで、検索結果を挿入するページに結果が埋め込まれて  表示されます。  複数の検索文字を 区切り文字(デフォルトは半角スペース)  でつないで"BooBoo 倶楽部 CGI"のように記述することができ ます。  その時、AND検索のラジオボタンにチェックが入っていると、  これら全ての文字が含まれたファイルを検索でき、OR検索のラ  ジオボタンにチェックが入っていると、これらのうちどれかの  文字が入ったファイルを検索できます。  「アルファベットの大文字小文字を区別する」のチェックボッ  クスにチェックしておくと、半角アルファベットの大文字小文  字が区別されて検索されます。つまりaとAは異なるものとして  検索されます。チェックを外した状態の場合はaとAは同じ文字  として検索されます。  ログを保存する設定にした場合、検索ワードログが log.datに  保存されていきます。適宜FTPソフトを使って Asciiモード  で log.datをダウンロードしてください。1行1検索ログの形  で保存されています。 *ご注意  BooWordsSearch はフリーソフトウエアですが、寄付は歓迎  いたします。  送金したくなった場合、下記アドレスまでメールしてくださ  い。送金先をご連絡させていただきます。  利用などに当たっては「CGIご利用上のルール」(下記U  RL参照)に記載されているすべてのルールが適用されます  ので、同意の上ご利用ください。  ・CGIご利用上のルール  http://www.booboo.ne.jp/contents/cgi/rule/  当プログラムの使用により生じたトラブルもしくはそれに伴  う損害に対し、制作者は一切責任を負いません。 *著作・制作  BooBooClub  E-mail: booboo@booboo.ne.jp  URL: http://www.booboo.ne.jp/  お問い合わせ詳細  http://www.booboo.ne.jp/contents/calendar/index.html *お願い  バグレポート、ご感想、お問い合わせなどありましたら、  上記アドレスまでメールをお願いいたします。 *バージョンアップ履歴 ・Ver1.00  1,各種不具合の修正  2,AND検索に対応  3,検索結果をHTMLに埋め込む方式に変更 ・Ver1.01  1,結果表示でHTMLタイトルからリンクする機能を追加 ・Ver1.02  1,内部処理を一部最適化 ・Ver1.03  1,検索結果タイトルがおかしくなることがある不具合を修正 ・Ver1.04  1,検索結果表示が化ける不具合を修正 ・Ver1.05  1,全ファイルが検索されないことがある不具合を修正 ・Ver1.06  1,区切り文字設定機能を追加  2,OR検索機能と検索方法指定機能を追加 ・Ver1.07  1,検索ワードログ保存機能を追加 ・Ver1.08  1,特定状況下で発生する検索結果リンクの不具合を修正 ・Ver1.09  1,検索結果表示HTMLの一部を修正 ・Ver1.10  1,複数の検索対象ディレクトリに対応  2,検索処理を高速化  3,内部処理を一部変更 ・Ver1.11  1,結果表示内容の一部を変更