• ロードマップ
• プロジェクト
• コーディング
  • モジュールオーナー
  • ハック
  • ソースの入手
  • ビルド
• テスト
  • リリース
  • ナイトリービルド
  • 問題の報告
• ツール
  • Bugzilla
  • Tinderbox
  • Bonsai
  • LXR
• FAQ

• MDC 日本語版

導入:

概観:

LXR を通して Mozilla の中心的な検索コンポーネントの ソースコード を見ることができます。
 

新しい検索エンジンを追加するために JavaScript を使う

function addEngine()
{
    if ((typeof window.sidebar == "object") && (typeof window.sidebar.addSearchEngine == "function"))
    {
        window.sidebar.addSearchEngine(
            "http://www.mozilla.org/projects/search/mozilla.src",  /* engine URL */
            "http://www.mozilla.org/projects/search/mozilla.gif",  /* icon URL */
            "mozilla.org",                                         /* engine name */
            "Web" );                                               /* category name */
    }
    else
    {
        alert("Mozilla M15 or later is required to add a search engine.");
    }
}

実装 - どのように働くか

あなたは Apple の Sherlock に 関する技術資料 のファイルを良く読んでおくべきです。   Mozilla は現在 "LDAP" のサポートを除く "Sherlock 2" 仕様バージョン 1.3 をサポー トしています。
 
 

Mozilla 拡張部分 - Sherlock 仕様に対する追加仕様

# Netscape Search - Sherlock Plug-in

<SEARCH
    name="Netscape"
    description = "Netscape Search"
    method="GET"
    action="http://search.netscape.com/cgi-bin/search"
    update="http://www.someurl.com/test.src.hqx"
    updateCheckDays="3"
>

<INPUT NAME="search" user>

<INTERPRET
    browserResultType = "category"
    bannerStart="<!--AD_TAG VENDOR=AOL WIDTH=468 HEIGHT=60-->"
    bannerEnd="<!--/AD_TAG-->"
    resultListStart = "Groups of reviewed web sites related to your search term."
    resultListEnd = "Web sites reviewed and categorized by a team of editors."
    resultItemStart = "<LI>"
    >

<INTERPRET
    browserResultType = "result"
    bannerStart="<!--AD_TAG VENDOR=AOL WIDTH=468 HEIGHT=60-->"
    bannerEnd="<!--/AD_TAG-->"
    resultListStart = "Web sites reviewed and categorized by a team of editors."
    resultItemStart = "<LI>"
    >

</SEARCH>

<BROWSER
        alsomatch="http://search.netscape.com/search.tmpl"
        update="http://www.someurl.com/test.src"
        updateIcon="http://www.someurl.com/test.gif"
        updateCheckDays="3"
>

これは Mozilla の Sharlock 仕様に対する拡張( 太字の赤の部分)だけでなく、複数の <INTERPRET> タグ ("Sherlock 2" 仕様で新たに認められた)の使い方を説明するよい例です。

<INTERPRET> セクション毎に、使用される検索結果の"タイプ"を指定する "browserResultType" 属性が追加されています。現在 2 つのタイプが定義され ています: "category" と "result" (指定されなかった場合のデフォルトのタイ プ)です。

"category" タイプは "Search" サイドバーパネルにフォルダアイコンで表示 されるのに対して、 "result" タイプは "Search" サイドバーパネルに検索エン ジンのブランドのアイコン/画像で表示されるでしょう。

<BROWSER> セクションでは "alsomatch" 属性を指定できます。   <SEARCH> セクションの "action" 属性とともに、この URL はブラウザウィ ンドウのコンテキスト領域に表示されている、現在の HTML ページと対応付けさ れ、その HTML が検索結果用かどうか、そして、サイドバーの "Search" パネル に短縮した検索結果を表示するために使われるかどうかを決定します。

Mozilla M17 で新しくなったこと:

また、 <BROWSER> セクションに "update" 、 "updateIcon" 、 "updateCheckDays" 属性が加わりました。仕様では "update" 属性は <SEARCH> セクションに定義されていますが、あいにくそれは Macintosh 特 有の binhex 化されたファイル(ファイルネームは ".src.hqx" でなければなら ない) でなければなりません。   プラットフォームに依存しないように、 Mozilla はテキストのみで、 binhex 化されていない ".src" 検索ファイルへの URL を代わりに <BROWSER> セクション内の "update" 属性を通して指定でき るようにし、加えて <BROWSER> セクションの "updateIcon" 属性(サポート されている画像フォーマットのどれかでなければなりません)を通して画像への 参照も可能です。ファイルの一貫性のために、 Mozilla は <BROWSER> セク ションの "updateCheckDays" 属性を調べます。これは、検索ファイルの変更を 何日で調べるかを指定します。

これらの属性が <BROWSER> セクションで指定されていなくても、 Mozilla は <SEARCH> セクションの "update" 属性を見て、もしそれが "src.hqx" で終っているなら、 Mozilla は ".hqx" を取り去ってチェックする URL として使うでしょう。それゆえ、例えば、もし <SECTION update=" http://www.someurl.com/test.src.hqx"> が指定されてたら、 Mozilla は URL " http://www.someurl.com/test.src" (.hqx が取 り除かれていることに注目)を調べます。  こうすることで、 Mozilla はウェブサイトが指定するのにテキストのみのファ イル同様 binhex 化されたファイルも使うことを可能とし、それで Mozilla 同 様に Mocintosh でも検索ファイルを使用することができます。  [注:こう するためには、両方のファイルを同期させておくことがウェブサイトの責任とな ります。]
 
 

追跡

サーチエンジンはしばしばそのサービスを介した検索を"追跡"する能力 を必要とします。   これを達成するために、ひとつの手段として <SEARCH> セクションの "action" 属性で指定された URL へのヒット数を記 録するというものがあります。   必要であれば、この URL には HTTP リ ダイレクションページを指すことができ、その時 <BROWSER> セクションの "alsomatch" 属性が"最終的な"目的の URL を含んでいます。[これでもしユーザー が直接"最終的な" URL へ行ったとしても(例えば、直接 URL をタイプしたりそ こへ連れて行くリンクをクリックしたりして)、問題の Sherlock ファイルはそ れでも"対応して"、検索サイドバーパネルはユーザーに便利なよう検索結果の短 縮リストを表示することができます。]

上記の "http://search.netscape.com/" にある Netscape の Netcenter 検 索エンジンを使った検索ファイルの例で、"action" 属性が action="http://search.netscape.com/cgi-bin/search" なことに気付 くでしょう。   もし、 HTTP リダイレクションをページカウントに使いたいなら(同時に直接 URL にヒットした正確なカウントも持っていて)、 "action" 属性は action="http://info.netscape.com/fwd/sidb_ns/http://search.netscape.com/cgi-bin/search" のような HTTP リダイレクションページにすることができ、また "alsomatch" 属性を最終的な目的の URL 、すなわち alsomatch="http://search.netscape.com/cgi-bin/search" に修正しま す。

注: <BROWSER> セクション内の "alsomatch" 属性は、それぞれ 1 つのス ペースで区切られたいくつかの URL を含むことがあります。これで、最終的に 目的の URL に解決される複数の URL を持つ複雑な検索エンジンを便利に使える ようにします。

マルチエンジン構想で、内部的な問題により検索エンジンは他の検索エンジ ンに送信された情報を知ることができません。例えば、もしユーザーが検索エン ジン "A" と "B" を使ったマルチエンジン検索をすることにしたとして、エンジ ン "B" はユーザーが同時に検索エンジン "A" を使ったことが分かりません。し かし、シングルエンジン検索とマルチエンジン検索を区別することはできます。 それはサーバーへの問い合わせで送信される HTTP リクエストが追加の HTTP ヘッ ダーで "MultiSearch: true" を持つからです。
 

一般的な問題 - 何がうまくいかなくてどうすれば修正できるか

追加の参照: