きてーや.ねっと / スクリプト / msearch

□トップページ
　■msearchとは　 ■ダウンロード　 ■更新履歴　 ■動作環境
　■インストール方法　 ■高度な設定　 ■カスタマイズの方法　 ■FAQ

インデックス切り替え機能，インデックス補助ツール搭載．
最新バージョン(1.50)を公開開始．

■ユーザサイト一覧	こんなに使われている！使用されている方は，ご連絡下さい．
■msearch掲示板	msearchに関する質問やご要望をどうぞ．
■スキン配布サイト一覧	好きなスキンを選ぼう！　スキンを配布されている方は，ご連絡下さい．

　ホームページ内全文検索エンジンmsearchとは，個人または比較的小規模の法人ホームページ内の検索を提供するCGIプログラムです．
　以下のような機能があります．

検索用インデックスを作るので，作らないタイプの検索エンジンより高速．
インデックス作成，検索ともにperlで動作．
提供するperlスクリプトのみで動作するので，カスタムCGIを設置できるWebサーバならどこでもインストール可能．
and検索，or検索，not検索，タイトル検索，URL検索が可能．
3種類(降順，昇順を含め6種類)のランキング(結果表示のソート)が可能．
キーワードがマッチした部分の強調表示が可能．
検索対象HTMLページの漢字コードはSJIS，JIS，EUC全てをサポート．
全角１文字の検索キーワードも正しく検索可能．しかも高速．
様々なインデックス化のオプションをインデックス作成CGIから指定可能．
インデックスの更新は，自動的に差分を調べて作られるので高速．
インデックスに登録したくないキーワードの指定が可能．
検索結果表示画面をHTMLで記述できるので，簡単にカスタマイズ可能．
検索ログを出力可能．
Cookieによるインデックス作成オプション記憶で更新が簡単．
複数のインデックスを切り替えて検索可能．
無料．(^o^)

　実際に動作しているmsearchを使うには，作成者のホームページでどうぞ．
　作成者への連絡はメールどうぞ．

強力バックアップサイト

□msearch導入記水沢・penguin-19・和彦さんによるmsearch導入記です．インストール方法，評価，改造方法，インストール時のチェックツールの配布等，役に立つ情報が満載です．

□Unicode版msearch 毛流麦花(もーるばっか)さんによるunicode版msearchの配布サイトです．現在，正式公開に向けた準備中ですが，Unicode対応に尽力されています．msearch がグローバル化！！　非常に楽しみです．

　ダウンロード

　本ソフトウェア(msearch)をダウンロードされる場合は，以下の利用規定に同意したとみなさせて頂きます．

本ソフトウェア(msearch)はフリーソフトウェアですが，著作権は作成者(Katsushi Matsuda)に属します．
本ソフトウェアを利用したことによる，いかなる結果，損害，トラブルについて作成者は一切の責任を免れます．
有料，無料を問わず，再配布する場合は作成者に連絡して下さい．
作成者に許可なく，営利目的での利用(有償でのレンタルや販売，設置代行等)はできません．
本ソフトウェアの改造は非営利目的の範囲内で自由にできますが，ソフトウェア内に記述された作成者の著作権表示部分を削除，修正することはできません．
バグ報告を除き，改造依頼や改造方法については基本的にお答えできません．
設定ファイル(config.dat)は，作成者に許可なく配布することができます．
msearch 1.51bのダウンロード(LZH圧縮)
msearch 1.50のダウンロード(LZH圧縮)
msearch 1.46のダウンロード(LZH圧縮)

　現在の最新バージョンは1.50です．
【重要】 1.50では，インデックスと設定ファイルの名前とが変更になりました．旧バージョンからアップグレードされる方は，mindex.datおよびconfig.datをそれぞれdefault.idxとdefault.cfgに変更して下さい．これに伴って，フォーマット変数$$index$$と$$config$$が新規に追加となりました．また，フォーマット変数$$date_format$$が$$dateformat$$と変更になりました．
1.4xの設定方法に関する説明はこちらをご覧下さい．
1.33の設定方法に関する説明はこちらをご覧下さい．
1.3x以上より高速ですが，or検索ができない，結果表示が全て大文字になるという仕様の1.21はこちらで公開しています． 1.21の設定方法に関する説明はこちらをご覧下さい．

　更新履歴

更新日内容

ver. 1.51β
12/03/03 1.51のβ版のこっそりリリース
なお，1.50から以下の修正・追加があります．
(1) HTMLのタグ除去方法の修正．インデックスの不具合解消？
(2) ロック解除失敗時のロックファイル削除のバグ修正．
(3) インデックス化抑制タグの導入(<msearch>)．thanks 毛流麦花さん．
(4) クエリーの漢字コード判定ヒント文字列への対応．thanks 毛流麦花さん．
(5) 添付jcode.plを2.13にバージョンアップ
(6) 添付fold.plを1.6にバージョンアップ

ver. 1.50
08/21/03 1.50の正式リリース
なお，1.50b2から以下の修正・追加があります．
(1) マッチ部分の抽出文字数を設定ファイルで指定可能に．
(2) genindex.cgiのHTMLでtrタグが抜けていたのを修正．

ver. 1.50β2
07/22/03 以下の修正
(1) genindex.cgiのデフォルトインデックスが古いままだったのを修正．
(2) 最終更新日時($$indexdate$$)のバグを修正．

ver. 1.50β
07/16/03 以下の修正
(1) 検索結果ページ数が1ページの場合にcsetを非表示にしました．
(2) ログ出力形式のフォーマット変数化($logformat)．
(3) 『( aaa bbb)』のようなor検索で文字化けするバグの修正．
(4) 『aaa b』のような検索式でハイライトが2重化するバグの修正．
(5) HTML中の非タグ文章『＆lt;1章＆gt;』が『<1章>』で検索可能に．
(6) genindex.plの非インデックスキーワードの問い合わせが変だったのを修正．
(7) genindex.plでランキングが効かなかったバグを修正．
(8) フォーマット変数$date_formatを$dateformatに変更．
(9) CPU時間の測定開始が設定ファイルを読んだ後だったのを前に変更．
以下の機能追加
(1) インデックス切り替え機能に対応．詳しくは高度な設定とFAQをご覧下さい．
(2) インデックス毎に設定ファイルを切り替えられるように．詳しくは高度な設定とFAQをご覧下さい．
(3) alt属性中の文字をインデックスに追加できるオプションを設置．
(4) インデックス補助ツールを追加．

ver. 1.46
12/25/02 以下の修正
(1) Cross Site Scriptingの<script>タグ等のタグ以外の脆弱性に対応しました．
(2) 検索結果のサマリー表示の「．．．」を半角にしました．
(3) 日時表示のフォーマット変数化($date_format)．
(4) ログファイルの漢字コードが指定可能に($logencoding)．
(5) HTML出力漢字コードが指定可能に($encoding)．
(6) config.datとスクリプト中のHTMLの</tr>と</td>タグを入れました．
(7) PHP等のタグ除去．
(8) <title lang=**>に対応．
(9) genindex.plの出力漢字コードにJISを追加．

ver. 1.45
4/10/02 以下の修正
(1) '$'と'?'を含む検索式で正常に検索できなかったバグを修正しました．
ver. 1.44
4/1/02 以下の修正
(1) インデックスの形式を変えました．これは英語等の日本語以外のページの検索にも対応するためです．
(2) 悪意ある検索式を排除するようにしました．
(3) インデックス作成時の出力メッセージを整理しました．
(4) インデックス作成時のデバッグ情報出力をフォームから指定できるようにしました．

ver. 1.43
3/4/02 以下の修正
(1) URL検索で"foo/bar"のように"/"等のメタキャラクタが含まれる場合に正しく検索できなかったが，それを修正．
(2) フォーマット変数$$url$$がURL検索の際，正しいURLではなく，HTMLのタグが含まれてしまう仕様上のバグを修正
フォーマット変数についてはFAQをご覧下さい．

ver. 1.42
1/31/02 Cross-Site Scriptingに対応(その2)
1.41では<script>しか対応していなかったのを他の危険なタグにも対応．

ver. 1.41
1/31/02 Cross-Site Scriptingに対応
1.40以下のmsearchではCross-Site Scriptingに対するバルナビリティがありました．1.41ではこの問題を解決しています．
1.41へのバージョンアップは，1.40のmsearch.cgiを1.41のものに入れ替えるだけでOKです．

ver. 1.40
1/24/02 1.40を正式公開開始
1.40は以下の特徴があります．
(1) 全角１文字検索の速度向上．他の検索とほぼ同じ速度(10倍以上)を実現．
(2) 半角英文字検索の速度向上．2割程度向上．
(3) 検索結果画面のフォーマット(HTMLによるスキン作成)化．
(4) 検索ログ出力に対応．

ver. 1.40β3
1/21/02 以下の修正
(1) helpフォーマットでもindexnum変数が参照できるように修正．
(2) ログを出力できるように修正．
(3) キーワードに半角英文字がある場合の検索速度向上．

ver. 1.40β2
1/20/02 以下の修正
(1) 全件表示ができないバグの修正．
(2) 検索結果が0件のときにcsetとnsetを表示してしまうバグの修正．
(3) CGI引数でquery引数に値がない場合にも対応．

ver. 1.40β1
1/18/02 1.40のベータテスト開始

ver. 1.33
10/10/01 1.33を正式公開開始

ver. 1.33β
09/29/01 以下のバグを修正
(1) 半角カタカナのキーワードで検索できない．
以下の機能の追加
(1) インデックス時の非対象ディレクトリと非対象ファイルの指定に正規表現が使えるように．
(2) インデックスに登録したくないキーワードを指定できるように．
これらの追加機能については，インストール方法をご覧下さい．

ver. 1.32
09/12/01 1.31の検索結果のリンクが変になるバグを修正

ver. 1.31
09/11/01 全角１文字の検索を正しくできるように修正 (FAQで詳しく説明)

ver. 1.3
08/25/01 1.3を正式公開開始

ver. 1.3β3
08/18/01 以下の修正
(1) マイナスから始まるキーワードに対応．
(2) カッコで囲まれたキーワードに対応．
(3) URL検索で強調表示されないバグを修正．
(4) 少しだけ高速化．

ver. 1.3β2
08/17/01 以下の仕様変更
(1) 検索結果を表(table)から定義(dt)に．
(2) マッチした部分の強調表示が変更可能に．

ver. 1.3β
08/16/01 以下の新規機能を追加
(1) OR検索が可能に．
(2) 検索結果の各項目をナンバリング．
以下の仕様の修正
(1) 検索結果の一部表示が先頭ではなく，マッチした部分に．
(2) マッチした部分のボールド表示．
(3) 英数文字が全角の大文字で表示されていたのを元ページに忠実に．
以下の様に機能を縮小
(1) ソートの種類からページ内容の昇順・降順を削除．
(2) 検索時のソートの指定を削除し，インデクシング時に指定する．
大幅な機能増強ですが，ほとんど速度は落ちないように苦慮しました．

ver. 1.21
07/28/01 以下のバグの修正
(1) 対象ファイルを「.html」とした時，「.shtml」も含まれてしまう．
(2) タイトルに含まれる英数文字が検索漏れしてしまう．
(3) タイトルのみに含まれる文字が「:t」なしで検索できない．
(4) クエリーが全角の場合に検索漏れが発生する．
(5) 検索結果を全件表示にした場合にHTMLフッタを出力しない．
(6) 検索結果の件数が表示件数の倍数の時，ありもしない次の検索結果へのリンクが作られる．
Special thanks 水沢さん

ver. 1.2
02/19/01 ローカルでインデックス作成可能に．

ver. 1.1b
02/18/01 インデックス作成CGIがデバッグ情報出力可能に．

ver. 1.1a
01/09/01 インデックス差分更新のアルゴリズムを変更．

ver. 1.1
12/26/00 インデックス作成CGIをCookieに対応．

ver. 1.0
12/22/00 公開開始．

ver. 1.0β
12/21/00 作成者のホームページで運用開始．

　動作環境

　msearchは以下の環境での動作します．

プラットフォーム LINUXを含むUNIX系OS
Perlバージョン Perl 5.004以降，jperlは不可

　インストール方法

　インストールの方法について説明します．なお，ここでは，HTMLやCGI，perlについてある程度わかっている人を前提にしています．

まずあなたのホームページにCGIが設置できるか調べて下さい．
あなたのホームページが無料ホームページならば，そのサービスガイドを見て下さい．またあなたのホームページがプロバイダやレンタルサーバ，ホスティングサービスならば，それぞれのサービスガイドを見るか，管理者に尋ねてCGIが利用できるか調べて下さい．

msearchをダウンロードして下さい．
必ず上の利用規定を読んでからダウンロードして下さい． LZH形式です．解凍すると，以下の7つのファイルが作成されます．

genindex.cgi インデックス作成CGI
genindex.pl ローカルインデックス作成プログラム
indexing.pl インデックス作成ライブラリ
msearch.cgi 検索CGI
default.cfg 設定ファイルの例
jcode.pl 歌代さん作の漢字コード変換ライブラリ
fold.pl 歌代さん作の日本語文字列折り返しライブラリ

各種設定を変更して下さい．
　jcode.plとfold.pl以外のファイルの漢字コードはEUCですので，EUCで読み込めて，EUCで書き込めるテキストエディタを用意して下さい．
　あなたのサーバのperlのパスを調べ，genindex.cgiとmsearch.cgiのそれぞれ先頭行を書き換えて保存して下さい．配布時には，perlのパスは/usr/local/bin/perlになっています．もし，あなたのサーバのperlのパスが同じならば，書き換える必要はありません．
　次にgenindex.cgiの変数$g_passwordの値を書き換えて下さい．配布時には，パスワードは"msearchpass"となっていますので，これを好きなパスワードに必ず変更して下さい．
　基本的に，上の2つの設定さえすれば他に修正する必要はありません．その他検索結果画面をカスタマイズしたい場合は，下のカスタマイズの方法を参照して下さい．

サーバにアップロードして下さい．
　6つのファイル(default.cfg, genindex.cgi，msearch.cgi，indexing.pl, jcode.pl，fold.pl)をFTP等でサーバにアップロードして下さい．アップロードする先は，CGIが動作するディレクトリです．各サーバ毎に違いますので各自調べて下さい．例えば，freewebでは，各自のホームディレクトリ内にcgi-binというディレクトリを作ってそこにCGIをインストールします．
　アップロードする際のモードはテキスト，漢字コードは変換しない，改行はサーバに合わせる，パーミッションはgenindex.cgiとmsearch.cgiが 755で，indexing.plとjcode.plとfold.plが 644で，default.cfgが644です．もし，jcode.plやfold.plがすでにサーバにあり，perlのパスが通っているなら， jcode.plやfold.plはアップロードする必要はありません．ただし，genindex.cgiとmsearch.cgiのrequireを修正する必要があります．分からない人はjcode.plとfold.plをアップロードして下さい．

動作チェックして下さい．
　ブラウザを使い，CGIが動作するかチェックして下さい．各サーバによって違いますが，ここではfreewebを例に取り説明します．各自のホームディレクトリのcgi-binというディレクトリ直下に6つのファイルをアップロードしたとします．すると，msearchの検索CGIを呼び出すURLは，
http://www??.freeweb.ne.jp/???/???/cgi-bin/msearch.cgi
となります．"?"の部分はユーザ毎に違います．同様に，msearch用インデックス作成CGIを呼び出すURLは，
http://www??.freeweb.ne.jp/???/???/cgi-bin/genindex.cgi
となります．
　ブラウザに上のURLを入れてみて，エラーが出なければOKです．

インデックスを作成して下さい．
　上のmsearch用インデックス作成CGIをブラウザで開いて下さい．下のようなインデックス作成フォームが表示されます(各入力欄は空白です)．

それぞれについて説明します．
　インデックス名とは，検索対象とするインデックスの名前です．何も記入しなければ，デフォルトの"default"となります．実際に作られるインデックスファイルは，このインデックス名に".idx"が付加されます．また，デフォルト以外のインデックスを検索対象にする時には，msearchの検索CGIを呼び出すURLにそのインデックス名を指定する必要があります．例えば，インデックス名が"test"だとすると，"msearch.cgi?index=test"と指定する必要があります．デフォルトインデックスの場合は指定する必要はありません(指定しても構いません)．なお，複数のインデックスを同時に検索することはできません．インデックスを切り替えて使うことになります．一つの検索エンジン(msearchのこと)が複数の検索対象(インデックス単位)に対応できるということです．
　対象ディレクトリとは，インデックスに登録するHTMLファイルがあるトップディレクトリです．絶対パスまたはgenindex.cgiがあるディレクトリ(アップロードしたディレクトリ) からの相対パスで指定します．必ず1つだけ(複数指定したい場合についてはFAQを参照のこと) 指定します．この例では，genindex.cgiがあるcgi-binディレクトリの親ディレクトリを指定しています．インデックス作成CGIは，この対象ディレクトリより下にある全てのディレクトリに含まれるファイルをインデックス対象とします．
　対象ディレクトリのURLには，上の対象ディレクトリが実際にはどのようなURLで表されるかを指定します．この例では，サーバ内の"../"ディレクトリが"http://www.foo.co.jp/~bar/"という URLに相当するとしています．そしてサーバ内の"../index.html"ファイルは"http://www.foo.co.jp/~bar/index.html" というURLになります．
　対象ファイルの拡張子には，インデックス対象となるファイルの拡張子を指定します．デフォルトは".html"と".htm"です．この場合はこの欄は空白でOKです．例では，上のデフォルト拡張子に".shtml"を加えています．デフォルト以外の拡張子を指定する場合は，インデックス対象としたいファイルの拡張子を全て指定しなければなりません．複数の拡張子を指定する場合は半角のカンマ","で繋げて下さい．
　非対象ディレクトリには，対象ディレクトリより下にあるインデックス化したくないディレクトリを指定します．このディレクトリ以下はインデックス対象となりません．対象ディレクトリからの相対パスで指定します．この例では，サーバ内の"../cgi-bin/"というディレクトリ以下と"../secret/"というディレクトリ以下をインデックス化したくないため，その相対パスである"cgi-bin/" と"secret"を指定しています．
また，非対象ディレクトリの指定では，正規表現を使って指定することが可能です．ただし，この場合は，相対パスではなく，ディレクトリ名のみでの正規表現のマッチが行われます．例えば，"(_vti_cnf)"と指定すると，対象ディレクトリ以下にあるディレクトリのうち，"_vti_cnf"という名前のディレクトリが全て非対象ディレクトリとなります．この正規表現による非対象ディレクトリの指定のためには，正規表現を"("と")"で囲む必要があります．もちろん，正規表現ですから，上の"(_vti_cnf)"は"(^_.*f)"のように記述しても構いません．ただしこの場合は，"_conf"というディレクトリも非対象ディレクトリとなります．正規表現によるものと相対パスによるものは同時に指定可能です．
　非対象ファイルには，対象ディレクトリより下にあるインデックス化したくないファイルを指定します．非対象ディレクトリ以下のファイルは指定する必要はありません．対象ディレクトリ以下だけど，あるファイルのみインデックス化したくない場合，そのファイルを指定します．非対象ディレクトリと同様に対象ディレクトリからの相対パスで指定します．複数指定する場合は半角のカンマ","で繋げて下さい．
非対象ディレクトリの指定と同様に非対象ファイルの指定にも正規表現が使えます．この場合も相対パスではなく，ファイル名単位での正規表現マッチとなります．
　非対象キーワードには，検索対象に入れたくないキーワードを指定します．ここで指定したキーワードで検索した場合，検索結果は0件となります．半角カンマ(",")を使い，複数指定できます．例えば，「検索」と「私」というキーワードを検索対象にしたくない場合は， "検索,私"と指定します．ここで指定したキーワードは検索結果の一部表示にも出てきませんので注意して下さい．ただし，タイトルに含まれるキーワードは削除しません．
　ランキング方法では，検索結果の表示に順序(ソート方法)を選択します．選択できるランキング方法には，以下の7種類があります．

なし　：見つけた順
最終更新時刻-降順　：新しい順
最終更新時刻-昇順　：古い順
タイトル-降順　：タイトル文字のアルファベット逆順
タイトル-昇順　：タイトル文字のアルファベット順
URL-降順　：URL文字のアルファベット逆順
URL-昇順　：URL文字のアルファベット順
好きなランキング方法を選んで下さい．インデックスを更新する際にも変更可能です．
　alt文字の追加は，imgタグ中のalt属性の文字列を検索対象に加えるかどうかを指定します．この例では「追加する」になっていますので，alt属性内の文字列も検索対象となります．
　パスワードには，3の各種設定で設定したパスワードを入力して下さい．このCGIはインターネットでつながっているどこからでも動かすことができるので，パスワードがばれると悪意ある人がインデックスを壊したり，改変したり，またサーバに対して高負荷をかけたりする恐れがあります．
　デバッグモードをチェックすることで，インデックス作成時に詳しい情報を出力します．インデックスが作成できない場合は，ここをチェックして実行した結果を見ることで原因究明が行える場合があります．インデックス作成が正常にできる場合は，ここをチェックする必要はありません．また，インデックスに登録するページが多い場合，Webサーバによって強制的に CGIの実行が中断される場合があります．ここをチェックすることで，これを防ぐことが可能です．
　入力が終われば，インデックス作成ボタンを押します．すると，下のような表示がされるはずです．

途中で止まったり，「インデックスを保存しています．完了(?ファイル)」という表示がされなかった場合は，FAQを参照のこと．
　ver1.2から，ローカルPCでインデックスを作るPerlプログラムを添付しました． ActivePerl等のPerl環境がインストールされているPCのDOS Promptで，genindex.pl を実行します(genindex.plの他にindexing.plも同じディレクトリにある必要があります)．すると，genindex.cgiのインデックス作成フォームと同じ入力項目を順に質問してくるので，genindex.cgiと同じオプションを入力して下さい(コマンドラインでの入力になりますので，genindex.cgiのようにCookieによるインデックス作成オプションの記憶はできません)．するとその実行ディレクトリにdefault.idxが作られます． FTP等でサーバにアップロードすることで上のgenindex.cgiと同様のことが行えます．
　また，インデックスは一度作ればそれで終わりではなく，自分のホームページの更新を行った都度インデックスを更新して下さい．ページを追加したり，ページの修正をしたり，ページを削除した場合です．追加されたページ，修正されたページ，削除されたページは自動的に判別し，インデックスを更新しますので，基本的に上で入力した値のままインデックスを作成するだけです．

検索してみて下さい．
　これで準備が整いました．いよいよ実際に検索してみて下さい．ブラウザに以下の様なURL(各ユーザ，プロバイダーによって違います)を入力し，開いてみて下さい．
http://www??.freeweb.ne.jp/???/???/cgi-bin/msearch.cgi
以下のようなヘルプ画面が表示されます．

例えば，旅行記という文字が含まれているページを検索する場合は，テキストボックスにキーワード("旅行記")を入力し，検索ボタンを押します．
　後はgooや googleと同じ要領です．　検索フォームを自分のホームページに貼り付けたい場合は，FAQ を参照して下さい．

インデックスを管理しましょう．
　インデックス型検索エンジンの場合，インデックスを作成した時点での検索対象ファイルの中身で検索が実行されます．そのため，インデックスを作成した後でホームページの内容に修正や追加が削除があったとしても，それは自動的に反映されません．その度ごとにインデックスを作り直す必要があります．ただし，msearchではなるべく簡単にインデックスが更新できるようにCookieに対応したり，差分のみを更新しています．
　ver.1.50からはインデックス管理に関わるメニューを追加しました．と言っても，大した管理機能ではありません．ftpのクライアントソフトを使わなくても基本的な操作ができるようにしただけです．(汗)
6のインデックス作成フォームに「msearch用インデックス補助ツール」というリンクがあります．これをクリックすると下の様なインデックス補助ツールが表示されます(省略しています)．

インデックス作成フォームに戻るには，「msearch用インデックス作成フォーム」というリンクをクリックして下さい．
　メニューには，(1)各種情報の取得，(2)インデックスの削除， (3)空インデックスの作成，(4)インデックスの結合，があります．詳細な説明はメニューに書いてあるので省きますが，補足だけしておきます． (1)の各種情報の取得は，インデックスが上手くできない時などにその原因を調査するための情報が一通り出てきます．掲示板で質問する時にご利用下さい．ただし，セキュリティ上問題のある項目も出てきますので，適宜削除して下さい． (4)のインデックスの結合は，サーバの制限で一度に対象ファイル全部のインデックスができない場合に，ディレクトリ単位毎にインデックスを作り，それらのインデックスをマージするために使って下さい．もちろん，ディレクトリ単位のインデックスを作る時には，"default"以外のユニークな名前を付けて下さい("dir01","dir02"等)．

　高度な設定

　ここでは，msearch.cgiの引数について説明します． cgiの引数は，URLで直接指定するか，HTMLのinputタグを用いて指定します．以下は引数の一覧です．

変数名説明

query 検索式が入ります．queryが空の場合は，help画面が表示されます．検索式は検索結果画面が表示された後でも引き継がれます．

num 一画面に表示する検索結果の件数です．デフォルトでは，設定ファイルの resultフォーマット変数の繰り返し数が使われますが，URL等で明示的に指定するとこちらを優先します．

set 表示する検索結果のページ番号です．先頭ページは1です．検索フォーム(HTML) でinputタグを使ってset=2のように引数として与えると，必ず2ページ目が表示されることになります(意味はないし，迷惑ですが...)．

index 検索対象のインデックスを指定します．indexが空の場合は，デフォルトのインデックス(default)を検索対象とします．検索フォーム(HTML)でselectタグを使ってインデックスを切り替える等ができます．

config 設定ファイルを指定します．configが空の場合は，indexの値と同じ設定ファイルを読み込みます．

　検索フォーム(HTML)を用いてもう少し具体的に説明します．以下の検索フォームはFAQで示しているものです．
<form action="/cgi-bin/msearch.cgi" accept-charset="x-euc-jp"> ---(1) <table border=0 cellspacing=0 cellpadding=3> <tr> <td align=left bgcolor=#F8FE00> <small><font color=black><b>HP内検索エンジン</b></font></small> <td align=right bgcolor=#F8FE00> <small><a href="/cgi-bin/msearch.cgi">help</a></small> ---(2) <tr> <td valign=center align=center bgcolor=#F8FE00> <small><input type=text size=20 name="query" value=""></small> ---(3) <td valign=center align=left bgcolor=#F8FE00> <small><input type=submit value="検索"></small> </table> </form>
(1)と(2)の行でmsearch.cgiを呼び出す設定をしています． (2)は特にヘルプ画面を出す呼び出しで，引数なしになっています． (3)はinputタグのtextボックスに入力された検索式をquery変数にバインドして，引数としています．
　ここで少し引数を追加してみます．
<form action="/cgi-bin/msearch.cgi" accept-charset="x-euc-jp"> ---(1) <table border=0 cellspacing=0 cellpadding=3> <tr> <td align=left bgcolor=#F8FE00> <small><font color=black><b>HP内検索エンジン</b></font></small> <td align=right bgcolor=#F8FE00> <small><a href="/cgi-bin/msearch.cgi">help</a></small> ---(2) <tr> <td valign=center align=center bgcolor=#F8FE00> <small><input type=text size=20 name="query" value=""></small> ---(3) <td valign=center align=left bgcolor=#F8FE00> <small><input type=submit value="検索"></small> <tr> <td valign=center align=right bgcolor=#F8FE00> <small>検索対象を選んで下さい</small> <td valign=center align=left bgcolor=#F8FE00> <select name="index"> ---(4) <option value="default">すべて ---(5) <option value="northamerica">北米旅行記 ---(6) <option value="asia">アジア旅行記 ---(7) <option value="europe"ヨーロッパ旅行記 ---(8) </select> </table> <input type=hidden name="num" value="20"> ---(9) </form>
(4)の行でindex変数を使っています．続く(5)～(8)で検索ユーザに検索対象のインデックスを選択させています．それぞれ選んだインデックスの名前(defaultや northamerica等)がindex変数にバインドされて引数となります．
また，(9)の行で一度に表示する件数を20件にしています(検索フォームでこのように指定するより，設定ファイルで設定することをお勧めします)．
　次に，インデックスと設定ファイルの関係について説明します．以下では，検索フォーム(HTML)ではなく，URLを用います．

インデックス設定ファイル説明

1つ(デフォルト) 1つ(デフォルト) それぞれデフォルト(default.idxとdefault.cfg)を使う場合には，何も設定する必要はありません．
msearch.cgi?query=○○

1つ(別名) 1つ(デフォルト) インデックスをデフォルトではない名前(例えば，camera.idx)を付けて作成して，設定ファイルがデフォルト(default.cfg)の場合は，indexのみ指定すればOKです．
msearch.cgi?index=default&query=○○

1つ(デフォルト) 1つ(別名) インデックスがデフォルト(default.idx)で，設定ファイルがデフォルトでない名前(例えば，my.cfg)の場合は，configのみ指定すればOKです．
msearch.cgi?config=my&query=○○

複数(デフォルトを含む) 1つ(デフォルト) インデックスが複数あり(camera.idx等)，設定ファイルがデフォルトの場合は， indexのみ指定すればOKです．
msearch.cgi?index=camera&query=○○
もちろん，デフォルトインデックスを使う場合はindexも不要です．

複数(デフォルトを含む) 複数(デフォルトを含む) インデックスに応じて設定ファイルを切り替えたい場合は，URLで明示的に両方を指定して下さい．
msearch.cgi?index=camera&config=my&query=○○
ただし，インデックスと同じ名前の設定ファイルを用意した場合は，configは設定する必要ありません．
msearch.cgi?index=camera&query=○○
この例では，camera.idxというインデックスに対応するcamera.cfgという設定ファイルがあることを前提としています．

すなわち，設定ファイルが明示的に指定されていれば(config=○○) それを使い，指定されなければ，インデックスと同じ名前の設定ファイルを使い，それもなければデフォルトの設定ファイルを使います．
　ログファイルについてですが，設定ファイルが切り替えられるとその設定ファイルで指定されたログファイルにログを出力します．すなわち，設定ファイルを切り替えて使っていて，その設定ファイルすべてで同じログファイル名を指定した場合は，すべて同じログファイルにログを出力します．逆に，ある設定ファイルのみログファイル名を違うファイル名にした場合は，その設定ファイルを使った検索のログのみ別のログファイルに出力されます．

　カスタマイズの方法

　ここでは，設定ファイル(default.cfg)を用いた各種設定方法と検索結果画面およびヘルプ画面のカスタマイズの方法について説明します．ヘルプ画面とは，引数なしでmsearch.cgiを呼び出した時に表示される画面です． 1.40からカスタマイズは設定ファイルで行うようになり，perlのパスの変更以外の全ての設定をこの設定ファイルで行うことができます． perlのパスさえ，ご自身の環境に合っていれば，msearch.cgiは全く触る必要がなくなりました．
　設定ファイルは，漢字コードがEUCで，改行コードが LFのみとなっています．ローカルで編集する場合はどのような漢字コードや改行コードでも構いませんが，アップロードする際には，EUCとLFに変換しておいて下さい．ほとんどのftpクライアントソフトはこの変換をサポートしているはずです．
　default.cfgファイルは下の図のような構成になっています．

　1の変数設定では，msearchが用いる各種変数を設定します． 2のフォーマット設定では，検索結果画面やヘルプ画面の見た目（フォーマット）を設定します．以下，それぞれについて説明します．なお，default.cfg中では，行頭に'#'を入れると，行末までをコメントとして解釈します．

変数設定
ここで設定できる変数は以下の通りです．

変数名デフォルト値説明

$home ""(なし) フォーマット中で使える変数$$home$$の値となる(後述)．

$highlight 1 検索結果に表示されるマッチ箇所の部分文字列中のキーワードをハイライト (強調表示)するかどうか．しない場合は0にする．

$highlight_deco <b> 上のハイライトの方法．HTMLのタグで書く．

$tzdiff 0 サーバマシンのタイムゾーンと表示したいタイムゾーンとの時間差．例えば，サーバが米国西海岸にあり，日本時間で表示したい場合は17とする．

$notitle タイトルなしタイトルがないページのタイトル部分表示($$title$$で使用．後述)文字列．

$log 0 検索のログを出力するかどうか．出力する場合は1とする．

$logfile msearch.log 上の検索ログのファイル名．msearch.cgiの置いてあるディレクトリからの相対パスで書く．

$logformat 略ログ出力の書式を指定する．使える変数はdate(日時)，remote(接続元)， ua(ユーザエージェント)，hit(ヒット数)，query(検索式)です．dateは，下の$dateformatで指定した書式です．config.datを参考のこと．

$logencoding euc-jp ログの漢字コードを指定する．SJIS(shift_jis)またはJIS(iso-2022-jp)も指定できる．

$dateformat 略日時表示の書式を指定する．使える変数はyear(年)，month(月)，day(日)， hour(時)，minute(分)，second(秒)．1桁の数値は先頭に0が付く． config.datを参考のこと．

$encoding euc-jp msearch.cgiが出力するHTMLの漢字コードを指定する．例えば，i-mode用の検索システムを作る場合はshift_jisを指定すればOK．iso-2022-jp(JIS)は正常に検索できない可能性が高い(漢字INと漢字OUTの関係で)．

これらの変数の設定は，default.cfgのどこでも構わないが，各変数単位で，行頭から以下のように記述する必要がある．

set $home=http://www.kiteya.net/
変数名(この場合$home)と=と値(この場合http://www.kiteya.net/)との間と，値の後にはスペースやタブを入れないで下さい．
　これらの変数はデフォルト値以外の値を設定したい場合にのみ設定すれば OKです．添付のdefault.cfgのサンプルでは，$homeのみ値を設定しています．

フォーマット設定
　フォーマット設定とは，msearch(実際にはmsearch.cgi)の実行結果の画面表示のテンプレートを作ることです． msearchの実行結果の画面は，検索結果画面とヘルプ画面の2つがあります．検索結果画面とは，msearchを検索キーワードをつけて実行した時に出てくる画面です．ヘルプ画面とは，msearchを引数なしで実行した時に出てくる画面です．こんな感じです．
　フォーマットは，各画面毎にHTMLを使って定義します．この定義の一般系は，以下の通りです．
begin format [num]
HTML
end
formatはフォーマットの種類を指定し，numは繰り返し回数が必要なフォーマットの場合に指定し，HTMLの部分にフォーマットをHTMLを使って定義し， endで終了します．なお，変数設定(set)と同様にbeginとendは行頭から記述して下さい．
　formatには，以下のものがあります．

フォーマット繰り返し回数説明

page 不要検索結果画面のフォーマット．

result 必要検索結果のヒット項目のフォーマット(pageの下位フォーマット)．

previous 不要検索結果の直前の結果ページへのリンクのフォーマット (pageの下位フォーマット)．現在表示中の検索結果が2ページ目だったら， 1ページ目に戻るためのリンク．

next 不要検索結果の直後の結果ページへのリンクのフォーマット (pageの下位フォーマット)．現在表示中の検索結果が1ページ目だったら， 2ページ目に進むためのリンク．

pset 必要検索結果の現在表示ページより前のページを表示するリンクのフォーマット (pageの下位フォーマット)．

cset 不要検索結果の現在表示ページを表示するフォーマット(pageの下位フォーマット)．

nset 必要検索結果の現在表示ページより後のページを表示するリンクのフォーマット (pageの下位フォーマット)．

help 不要ヘルプ画面のフォーマット．

　各フォーマット中では，どのようなHTMLでも記述することができます．スタイルシート等も使うことができますので，検索結果やヘルプ画面の見かけはほぼ完全に自由に設定できます．ただ，1つ違うのは，このHTMLの中に特殊な変数を埋め込んでおくと，msearchが自動的にその変数を該当する値に差し替えて表示する，という点です．この特殊な変数をフォーマット変数と呼びます．フォーマット変数は以下の通りです．

フォーマット変数使えるフォーマット説明

$$result$$ page resultフォーマット．

$$previous$$ page previousフォーマット．

$$next$$ page nextフォーマット．

$$pset$$ page psetフォーマット．

$$cset$$ page csetフォーマット．

$$nset$$ page nsetフォーマット．

$$encoding$$ page,help 漢字コードの種類．charsetに使う．

$$msearch$$ page,help msearchのcgi名．

$$home$$ page,help ホームページのURL．

$$index$$ page,help インデックス名．サフィックス(.idx)は除く．

$$config$$ page,help 設定ファイル名．サフィックス(.cfg)は除く．

$$query$$ page 現在の検索式．

$$rpp$$ page,help 1ページあたりの表示件数．

$$total$$ page 検索結果の総数．

$$set$$ page,cset 現在の検索セット(表示ページ)の番号．

$$from$$ page 現在の表示ページに表示される先頭項目の通し番号．

$$to$$ page 現在の表示ページに表示される後尾項目の通し番号．

$$displaynum$$ page 現在の表示ページに表示される項目の件数．

$$cputime$$ page,help かかった処理時間．

$$indexdate$$ page,help インデックスの最終更新日時．

$$indexnum$$ page,help インデックスに登録されているページ総数．helpフォーマットでこの変数を使うと若干表示が遅くなります(インデックスを読み込むため)．

$$nowdate$$ page,help 現在日時．

$$msearchhp$$ page,help msearchの配布ページのURL．

$$version$$ page,help msearchのバージョン．

$$resultnum$$ result ヒット項目の通し番号．

$$url$$ result ヒット項目のURL．

$$urldeco$$ result ヒット項目のURL．ただし，URL検索の場合は，マッチ部分が強調されたURL となります．そのため，<a>タグ内では使わないで下さい．

$$title$$ result ヒット項目のタイトル．

$$summary$$ result ヒット項目のサマリー(マッチ部分文字列)．

$$previousurl$$ previous 直前セット(前ページ)へのアクセスURL．

$$nexturl$$ next 直後セット(次ページ)へのアクセスURL．

$$seturl$$ pset,nset 検索セットへのアクセスURL．

$$setnum$$ pset,nset 検索セットの番号．

　この表のフォーマット変数のうち，赤字で書かれているフォーマット変数は特殊な変数です．上のフォーマットの表に全く同じ名前のフォーマットがあることがポイントです． msearchは，pageフォーマット(検索結果画面)中のこれらの赤字のフォーマット変数を見つけると，そのフォーマット変数を，フォーマット設定で定義した同じ変数名のフォーマットで差し替えます．分かり難いかもしれないので図で説明します．

　msearchは，pageフォーマットを用いて検索結果画面を作成します． pageフォーマット中に現れる普通のフォーマット変数(上の図だと$$msearch$$ や$$total$$などの青字で書かれた変数)は，msearch のメモリ中の値で入れ替えます．図だと，$$msearch$$はmsearch.cgiに$$total$$は100という値で差し替えられます．
　そして特殊なフォーマット変数(上の図だと$$result$$や$$previous$$などの赤字で書かれた変数)は，対応するフォーマット(この場合はresultフォーマットやpreviousフォーマット)のHTMLで差し替えられます．この時対応するフォーマットの中にある普通のフォーマット変数は同様にmsearch のメモリ中の値に差し替えられます(上の図だと$$resultnum$$や$$url$$など)．
　特殊なフォーマット変数のうち，$$result$$と$$pset$$と$$nset$$は，それぞれ対応するフォーマットで設定した繰り返し回数分が繰り返されます．上の図の場合だと，pageフォーマット中に$$result$$があります．そして$$result$$に対応するフォーマットresultは10回の繰り返し回数が設定されています．従って，pageフォーマットの$$result$$の位置に，begin result 10からendまでの間にある3行が10回繰り返して表示されます． resultフォーマットで参照できるフォーマット変数は呼ばれる毎に値が変わります．この場合，検索結果のマッチ項目が順々に(検索結果の1件目，2件目というように) これらのフォーマット変数に入ることになります．
　また，これら繰り返し回数を指定するフォーマットは，指定された繰り返し回数に満たない場合は途中で終了します．例えば，begin result 10としていても，検索結果の件数が8件だと，8回しか繰り返されません．また，begin pset 5としていても，現在表示しているページが3ページ目だと， 1ページ目と2ページ目の2回しか繰り返されません．
　繰り返し回数の指定をしなくても良いpreviousとnextも同様に表示すべき検索セット(ページ)がない場合は表示されません．例えば，検索結果の1ページ目だと，その前のページはないので，previous フォーマットは表示されず，$$previous$$は""(空文字列)で差し替えられます．

　以上でdefault.cfgの設定方法の説明を終りますが，具体的な書き方は添付の default.cfgをご覧下さい．
　また，default.cfg等の設定ファイルは，作者の許可なく再配布が可能です．かっこいいフォーマットができたら公開してみては如何でしょうか？
公開するHPのURLを作者まで連絡して頂ければ，フォーマット公開ページとしてリンクしたいと思います．よろしくお願いします．

　FAQ

msearch.cgiやgenindex.cgiをメモ帳で見ると文字化けしているのですが．[全]
msearchの各スクリプトはEUCという漢字コードで書かれています．そのため，windowsのメモ帳などSJIS漢字コードしか表示できないエディタでは文字化けしているように見えてしまいます． EUCで書かれたファイルを表示，編集できるエディタをお使い下さい．
そのようなエディタは Vectorのテキストエディタカテゴリーでたくさん見つけることができます．

検索フォームをページに貼り付けるには？[全]
以下に例を示します．
<form action="/cgi-bin/msearch.cgi" accept-charset="x-euc-jp"> <table border=0 cellspacing=0 cellpadding=3> <tr> <td align=left bgcolor=#F8FE00> <small><font color=black><b>HP内検索エンジン</b></font></small> <td align=right bgcolor=#F8FE00> <small><a href="/cgi-bin/msearch.cgi">help</a></small> <tr> <td valign=center align=center bgcolor=#F8FE00> <small><input type=text size=20 name="query" value=""></small> <td valign=center align=left bgcolor=#F8FE00> <small><input type=submit value="検索"></small> </table> </form>
このHTMLソースを検索フォームを入れたい場所に貼り付けるだけでOKです．ただし，赤色の部分は，そのページのURLから見たCGIの相対パスか絶対パスを入れて下さい．

複数の対象ディレクトリをインデックス化するには？[全]
　基本的に不可能です．しかし，同じことを別の方法で実現することが可能です．以下のようにします．
　あなたのホームディレクトリを"public_html/"以下とし，そのURLを "http://www.homepage.com/~id/"，genindex.cgiがあるディレクトリを "cgi-bin/msearch/"とします．そして"public_html"以下のの"aaa/"ディレクトリと"bbb/"ディレクトリについてインデックスを作りたいとします．
　一方，"public_html/"以下には"aaa/"と"bbb/"以外に"ccc/"と"ddd/"というディレクトリと"index.html"と"test.html"というファイルがあると仮定します．この場合，"aaa/"ディレクトリと"bbb/"ディレクトリの2つのディレクトリを対象ディレクトリとしてインデックスを作るには，以下のようにします．

対象ディレクトリ ../
対象ディレクトリのURL http://www.homepage.com/~id/
非対象ディレクトリ cgi-bin,ccc,ddd
非対象ファイル index.html,test.html
すなわち，2つのディレクトリを対象ディレクトリとするのではなく，2つのディレクトリ以外を非対象ディレクトリとしてインデックスを作るのです．

インデックスが作れないのですが？[全]
　いくつか原因が考えられます．

ディレクトリ移動のパーミッションがない．
genindex.cgiを置いてあるディレクトリのパーミッションは 755である必要があります(サーバによっては705でも OK)．
CGIからファイルを作ることができない制限になっている．
サーバによってはCGIから新しいファイルを作ることができない設定になっている場合があります．この場合は，mindex.datという大きさ0のファイルをgenindex.cgiの置いてあるディレクトリに作って下さい．ファイルのパーミッションは666にして下さい (サーバによっては606でもOK)．
CGIからのファイル読み込みに制限がかかっている．
サーバによってはCGIから読み込むことができるファイル数に制限をかける設定になっている場合があります．この場合は，少し手間がかかります．
　ファイル読み込みの制限がかからない程度をインデックス対象とするディレクトリを指定し，インデックスを作ります．このインデックス(mindex.dat)をFTP等でローカルにダウンロードし，別名(例えばmindex1.dat等)を付けて保存します．これを何度か繰り返し，インデックスに登録したい全部のファイルをインデックス化したところで，ローカルにコピーしたインデックスファイル(例えば，mindex1.dat， mindex2.dat，mindex3.dat，.....等)をつなげて1つのインデックスファイル (mindex.dat)にし，CGIと同じディレクトリにFTP等でアップロードします．
CGIのメモリ使用量に制限がかかっている．
サーバによってはCGI1プロセスあたりのメモリ使用量に制限をかける設定になっている場合があります．この場合も上と同様に分割してアップロードするか，genindex.plを使ってローカル PC上でインデックスファイルを作ってアップロードして下さい．
プログラムのバグ．
今のところバグは見つかっていませんが，可能性はあります．(^o^;

他のサーバにあるホームページをインデックスしたいのですが？[全]
　残念ながらできません． genindex.cgiが置いてあるサーバだけです．また，genindex.cgiを実際に動作させるユーザ(apache等のWebサーバ)が移動できるディレクトリと参照できるファイルに限りインデックスに登録できます．ほどんどのサーバでは，同一サーバ上の別のユーザ(あなた以外のユーザ)のディレクトリに移動したり，ファイルを参照したりすることはできなくなっていると思われますので，基本的にインデックスに登録できるのはあなたのホームディレクトリ以下だけです．

いちいちインデックスを作り直すのが面倒なのですが．[1.2以上]
　もしあなたのお使いのWebサーバでcronが使えるなら定期的にインデックスを自動更新することが可能です．(※cronって何？という人は諦めて下さい)
インデックスの自動更新にはgenindex.plを使います． genindex.plは以下のように質問してきます (ver.1.50以上に準拠しています．ver.1.4x以下のバージョンの場合はこちらを見てください)ので，それに合った値を用意し，shスクリプト(cshやperlでも勿論OK)を作ります．

インデックスの名前は？
インデックス対象ディレクトリは？
インデックス対象ディレクトリのURLは？
インデックス対象ファイルの拡張子は？
非インデックス対象ディレクトリは？
非インデックス対象ファイルは？
非インデックス対象キーワードは？
ランキング方法は？
alt属性の文字をインデックスに含めますか？
ただし，ランキング方法は0～6の数値で答えなければなりません．
[1] 最終更新日時-降順
[2] 最終更新日時-昇順
[3] タイトル-降順
[4] タイトル-昇順
[5] URL-降順
[6] URL-昇順
[0] なし
また，alt属性についても0～1の数値で答えなければなりません．
[1] 含める
[0] 含めない
例えばshスクリプトは以下のようになります．値はインストール方法で使っている値を使っています．ランキングは[1]最終更新日時-降順です．
(注)非対象キーワードに日本語を使う場合，shスクリプトの漢字コードはEUCでなければなりません．また，非対象ディレクトリや非対象ファイルに正規表現を用いる場合は， shが展開しないようにクオートして下さい (この意味が分からない人は正規表現を使うのを諦めて下さい)．
======== shスクリプトの例 ======= #!/bin/sh ./genindex.pl <<HERE msearch ../ http://www.foo.co.jp/~bar .html,.htm,.shtml cgi-bin,secret secretfile.html 検索,私 1 1 HERE ======== shスクリプトの例 =======
後は，このスクリプトをautogenindex.shとでもして，パスの通ったディレクトリに置きます． genindex.plはautogenindex.shと同じディレクトリに置いておきます． crontab -eで，このスクリプトを定期的に動かすようにすればOKです．例えば，毎日午前0にインデックスを更新するためには以下のようにします．
0 0 * * * autogenindex.sh

1.21と1.3のインデックスに互換性がありますか？[1.21＆1.3]
　残念ながらありません． 1.21から1.3にアップデートするためには，1.21で作ったインデックス(mindex.dat) を削除し，1.3のgenindex.cgiで新しくインデックスを作り直して下さい．

1.31の「正しい全角１文字の検索」とは何ですか？[1.3以上]
　msearch1.3を含むほとんどのフリーの全文検索エンジン(漢字コードにEUCを用いているもの)では，「好」や「粒」や「隆」などの全角文字の１文字だけを検索キーワードとして検索すると，それらの検索キーワードを含んでいないページを検索してしまったり(適合率が低下)，検索結果の一覧においてマッチ部分を強調表示している場合，文字化けが起こったりします．これはEUC(正しくはEUC-JP)の漢字コードの構造上の問題です．例えば，「好」という文字は，「0xB9 0xA5」という2バイトで構成されています．一方，「テスト」という文字列の「ス」と「ト」はそれぞれ「0xA5 0xB9」と「0xA5 0xC8」で構成されています．つまり，「スト」を連続して表すと，「0xA5 0xB9 0xA5 0xC8」です．本来なら「テスト」には「好」という文字は含まれないのですが，「スト」の 2バイト目と3バイト目(赤字部分)に「好」の「0xB9 0xA5」がマッチしてしまいます．そのため，過剰検索(キーワードが本当は含まれないのに含まれていると判断してしまう)が行われてしまいます．また，検索結果の一覧でマッチ部分を強調表示する時に「スト」の「ス」の後半から「ト」の前半にかけて例えば<b>と</b> などのタグを挿入してしまい，そこから文字化けが発生してしまいます．
　バージョン1.31は，このような過剰検索や文字化けが起こらないようになっています． and検索，or検索，not検索，title検索いずれにおいても正常に検索することができます．ただし，全角１文字の検索キーワードを使うと検索速度が格段に落ちてしまいます．作者のテスト環境では10倍以上遅くなってしまいます．しかし，全角１文字のキーワードを使わないなら，速度は1.3とほとんど変わりません．
(注) 1.40からはアルゴリズムを見直し，10倍以上の検索速度向上(つまり他の検索とほぼ同等)を実現しています．

全角１文字のキーワードで検索すると止まってしまうのですが？[1.31～1.33]
　WWWサーバマシンのメモリ不足が原因です．
　全角１文字のキーワードがある場合のみ，キーワードマッチのアルゴリズムを変えています．具体的には，perlのバージョン5以上で利用できる「先読み」の正規表現を使っています．そのため，マッチング対象(msearchでは対象ページ1ページに相当)の文字列の長さが長い場合，メモリ不足でマッチングが止まってしまいます．これを回避するための仕組みがmsearchには備わっています． msearch.cgiの$g_maxsizeというパラメータです．デフォルトでは，20,000バイト以上の長さのページは20,000バイト相当でページを分割してマッチングをします (この20,000バイトという数値は作者のサーバマシンでマッチングが止まらないサイズです．なお，1Gバイト以上のメモリを積んだサーバマシンで試したところ 20,000バイト以上でも大丈夫でした．)．ですので，検索が止まってしまう場合はこの$g_maxsizeの値を少なく(例えば10,000) してみて下さい．
(注) 1.40以上ではこの問題はなくなっています．

非対象キーワードで指定したキーワードが検索結果に出てくるのですが？ [1.33以上]
　1.32以前のインデックスが存在する場合は，一度インデックスを削除してから，もう一度インデックスを作り直して下さい．更新がされていないファイルは非対象キーワードを含んでいるかいないかに関わらず，インデックスの更新はしないため，更新されていないファイルに含まれる非対象キーワードが検索結果に出てくる可能性があります．
　また，非対象キーワードを変えた場合も同様にインデックスを一旦削除してから，インデックスを作り直して下さい．

検索結果を別フレームに表示する方法は？[全]
　FAQの2で示した検索フォームで説明すると，先頭の<form action...>を以下のようにします．
<form action="/cgi-bin/msearch.cgi" target=result accept-charset="x-euc-jp">
赤色の部分は検索結果を表示したいフレーム名に適宜変更して下さい．

フォーマット変数$$url$$はどこが変わったの？[1.43以上]
　1.40～1.42のフォーマット変数$$url$$にはバグが含まれており，URL検索が行われた場合，$$url$$には正しいURLではなく，強調表示されたURLがバインドされていました．そのため，検索結果のタイトル部分をクリックしても正しいURLに飛ぶことができませんでした．
　1.43では正しいURLがバインドされる$$url$$と，強調表示がされる可能性がある (URL検索の場合)URLがバインドされる$$urldeco$$に分かれました． URL検索以外の検索方法の場合は，$$url$$と$$urldeco$$は全く同じ値がバインドされます．

1.43と1.44のインデックスに互換性がありますか？[1.43＆1.44]
　残念ながらありません． 1.43から1.44にアップデートするためには，1.43で作ったインデックス(mindex.dat) を削除し，1.44のgenindex.cgiで新しくインデックスを作り直して下さい．

IBM拡張漢字が入っていると文字化けがするのですが？[全]
　msearchはIBM拡張漢字に対応していません．お手数ですが，同体異文字に修正の上，ご利用下さい．

genindex.plをWindowsのコマンドプロンプト上で実行すると文字化けするのですが？[全]
　Windowsのコマンドプロンプトの漢字コードはSJISです．genindex.plはデフォルトではEUCで出力します．実はgenindex.plには隠しコマンドがあります．
C:\> perl genindex.pl -s
のように"-s"とオプションを指定するとSJISでgenindex.plと対話できます．また，同様に"-j"とするとJISで出力されます(1.46以降)．

1.50にバージョンアップしたら，インデックスがありませんと言われました．[1.50以上]
　1.50からインデックスのファイル名が変更になりました．インデックス自体は 1.44～1.46と互換性がありますので，ftpクライアントソフト等を使って従来のインデックス(mindex.dat)を新しいデフォルトインデックス(default.idx)に変更して下さい．

インデックス名をデフォルト以外にしたら検索できなくなりました．[1.50以上]
　デフォルトのインデックス名(default.idx)の場合は，1.46以前と同様の呼び出しが使えますが，デフォルト以外のインデックス名でインデックスを作った場合には，そのインデックスを使うようにmsearchに指示する必要があります．例えば，インデックス名を"test"とした場合，↑のFAQの検索フォームは次のようにしなければなりません．
<form action="/cgi-bin/msearch.cgi?index=test" accept-charset="x-euc-jp"> <table border=0 cellspacing=0 cellpadding=3> <tr> <td align=left bgcolor=#F8FE00> <small><font color=black><b>HP内検索エンジン</b></font></small> <td align=right bgcolor=#F8FE00> <small><a href="/cgi-bin/msearch.cgi?index=test">help</a></small> <tr> <td valign=center align=center bgcolor=#F8FE00> <small><input type=text size=20 name="query" value=""></small> <td valign=center align=left bgcolor=#F8FE00> <small><input type=submit value="検索"></small> </table> </form>
赤字の部分が修正箇所です．

検索フォームではインデックスとスキンが正常に指定できるのですが，検索結果画面以降ではうまくいきません．[1.50以上]
　検索フォームと同じように設定ファイルの中でもインデックスと設定ファイルを引数として渡すように設定しなければなりません．すなわち，設定ファイルの検索結果画面のフォーマット(begin page～end)やヘルプ画面のフォーマット(begin help～end)でもインデックスとスキン(設定ファイル) が引数としてmsearch.cgiに渡るようにしなければならないということです．デフォルト設定ファイル(default.cfg)を見て下さい．検索結果画面のフォーマットの中で，次のような指定をしています．
<input type=hidden name="index" value="$$index$$"> <input type=hidden name="config" value="$$config$$">
この指定で直前に使われたインデックスとスキンを次の検索でも使うように msearch.cgiに指示している訳です．
また，ヘルプも同様です．
<a href="$$msearch$$?index=$$index$$&config=$$config$$">ヘルプ</a>
このように，検索結果画面に表示されるヘルプのリンクをクリックした場合には，同じインデックスとスキンでヘルプ画面を表示するようにmsearch.cgiに指示しています．
ヘルプ画面のフォーマットでも同じように設定して下さい．