files/ja/creating_mozsearch_plugins/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

---
title: MozSearch プラグインの作成
slug: Creating_MozSearch_plugins
tags:
  - Add-ons
  - Search plugins
translation_of: Mozilla/Creating_MozSearch_plugins
---
<p>
Firefox 2 は検索プラグインの格納に <a class="external" href="http://opensearch.a9.com/">OpenSearch</a> フォーマットを単純化した形式を使います。MozSearch 検索プラグインは検索エンジンとその URL、URL を解釈するのに必要なパラメータを記述した XML ファイルです。
</p>
<div class="warning"><b>警告:</b> MozSearch は非標準で Mozilla プロジェクトの中での利用だけを目的としています。検索プラグインを <a href="ja/Bundles#Application-specific_Extension_Files">Firefox の拡張機能</a>にパックして配布するのが目的か、標準で Firefox ビルドに含まれる検索プラグインを作るためのみに使うべきです。ウェブからインストールする検索プラグインをつくなら、<a href="ja/Creating_OpenSearch_plugins_for_Firefox">Creating OpenSearch plugins for Firefox</a> を参照してください。</div>
<h2 id=".E3.83.97.E3.83.A9.E3.82.B0.E3.82.A4.E3.83.B3.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB">プラグインファイル</h2>
<p>MozSearch 形式は <a href="ja/Creating_OpenSearch_plugins_for_Firefox">OpenSearch</a> フォーマットに似ています。違いはルート要素と XML 名前空間だけです(ただし XML としては非常に重大な違いです)。
</p>
<h2 id=".E4.BE.8B:_Yahoo.21_.E3.82.92.E6.A4.9C.E7.B4.A2.E3.81.99.E3.82.8B">例: Yahoo! を検索する</h2>
<p>以下の XML は Yahoo! で検索するために Firefox 2 にバンドルされている検索プラグインです:
</p>
<pre>&lt;SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/"&gt;
&lt;ShortName&gt;Yahoo&lt;/ShortName&gt;
&lt;Description&gt;Yahoo 検索&lt;/Description&gt;
&lt;InputEncoding&gt;UTF-8&lt;/InputEncoding&gt;
&lt;Image width="16" height="16"&gt;data:image/x-icon;base64,R0lGODlhEAAQAJECAP8AAAAAAP///wAAACH5BAEAAAIALAAAAAAQABAAAAIplI+py+0NogQuyBDEnEd2kHkfFWUamEzmpZSfmaIHPHrRguUm/fT+UwAAOw==&lt;/Image&gt;
&lt;Url type="application/x-suggestions+json" method="GET"
     template="http://ff.search.yahoo.com/gossip?output=fxjson&amp;command={searchTerms}" /&gt;
&lt;Url type="text/html" method="GET" template="http://search.yahoo.com/search"&gt;
  &lt;Param name="p" value="{searchTerms}"/&gt;
  &lt;Param name="ei" value="UTF-8"/&gt;
  &lt;MozParam name="fr" condition="pref" pref="yahoo-fr" /&gt;
&lt;/Url&gt;
&lt;SearchForm&gt;http://search.yahoo.com/&lt;/SearchForm&gt;
&lt;/SearchPlugin&gt;
</pre>
<p>仮にユーザが Yahoo! 検索エンジンプラグインを選び、検索ボックスに 'mozilla' と入力しエンターキーを押しとします。Firefox は以下のような検索 URL を作成するために上の検索エンジンの記述を使います。
</p>
<pre class="eval"><span>http://search.yahoo.com/search?p=mozilla&amp;ei=UTF-8&amp;fr=moz2</span>
</pre>
<p>もしユーザが検索バーの虫眼鏡のアイコンをクリックするか、検索バーが表示されていない時にツールメニューのウェブ検索オプションを選ぶと、ブラウザは &lt;SearchForm&gt; 要素の値である <a class=" external" href="http://search.yahoo.com/">http://search.yahoo.com/</a> に移動します。
</p>
<h2 id=".E4.BE.8B:_MDC_.E3.82.92.E6.A4.9C.E7.B4.A2.E3.81.99.E3.82.8B">例: MDC を検索する</h2>
<p>このプラグインで Mozilla Developer Center の Web サイト{{ 訳注("以下は日本語版用。このページの英語版にMozilla Developer Center 英語版用がある") }}を簡単に検索することができます。
</p>
<pre>&lt;SearchPlugin xmlns="http://www.mozilla.org/2006/browser/search/"&gt;
&lt;ShortName&gt;MDC&lt;/ShortName&gt;
&lt;Description&gt;Mozilla Developer Center search&lt;/Description&gt;
&lt;InputEncoding&gt;UTF-8&lt;/InputEncoding&gt;
&lt;Image width="16" height="16"&gt;data:image/x-icon;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8%2F9hAAAABGdBTUEAAK%2FINwWK6QAAABl0RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAHWSURBVHjaYvz%2F%2Fz8DJQAggJiQOe%2Ffv2fv7Oz8rays%2FN%2BVkfG%2FiYnJfyD%2F1%2BrVq7ffu3dPFpsBAAHEAHIBCJ85c8bN2Nj4vwsDw%2F8zQLwKiO8CcRoQu0DxqlWrdsHUwzBAAIGJmTNnPgYa9j8UqhFElwPxf2MIDeIrKSn9FwSJoRkAEEAM0DD4DzMAyPi%2FG%2BQKY4hh5WAXGf8PDQ0FGwJ22d27CjADAAIIrLmjo%2BMXA9R2kAHvGBA2wwx6B8W7od6CeQcggKCmCEL8bgwxYCbUIGTDVkHDBia%2BCuotgACCueD3TDQN75D4xmAvCoK9ARMHBzAw0AECiBHkAlC0Mdy7x9ABNA3obAZXIAa6iKEcGlMVQHwWyjYuL2d4v2cPg8vZswx7gHyAAAK7AOif7SAbOqCmn4Ha3AHFsIDtgPq%2FvLz8P4MSkJ2W9h8ggBjevXvHDo4FQUQg%2FkdypqCg4H8lUIACnQ%2FSOBMYI8bAsAJFPcj1AAEEjwVQqLpAbXmH5BJjqI0gi9DTAAgDBBCcAVLkgmQ7yKCZxpCQxqUZhAECCJ4XgMl493ug21ZD%2BaDAXH0WLM4A9MZPXJkJIIAwTAR5pQMalaCABQUULttBGCCAGCnNzgABBgAMJ5THwGvJLAAAAABJRU5ErkJggg%3D%3D&lt;/Image&gt;
&lt;Url type="text/html" method="GET" template="http://developer.mozilla.org/en/docs/Special:Search?search={searchTerms}"/&gt;
&lt;SearchForm&gt;http://developer.mozilla.org/ja/docs/Special:Search&lt;/SearchForm&gt;
&lt;/SearchPlugin&gt;
</pre>
<p>この例では検索エンジンのパラメータを定義するために <code>&lt;Param&gt;</code> ではなく単純にテンプレート URL の中に埋め込んでいることに注意してください。これは実際にメソッドとして <code>GET</code> を使うときに都合のよい方法です。<code>&lt;Param&gt;</code> は <code>POST</code> のために使うべきです。
</p><p><br>
</p>
<h2 id=".E5.8F.82.E7.85.A7">参照</h2>
<ul><li><a href="ja/Creating_OpenSearch_plugins_for_Firefox#Troubleshooting_Tips">検索プラグイントラブルシューティングのヒント</a>
</li></ul>
<div class="noinclude">
</div>
{{ languages( { "ca": "ca/Creaci\u00f3_de_connectors_MozSearch", "en": "en/Creating_MozSearch_plugins", "es": "es/Creaci\u00f3n_de_plugins_MozSearch", "fr": "fr/Cr\u00e9ation_de_plugins_MozSearch", "it": "it/Creare_Plugin_MozSearch", "pl": "pl/Tworzenie_wtyczek_MozSearch", "zh-tw": "zh_tw/\u88fd\u4f5c_MozSearch_\u641c\u5c0b\u6a21\u7d44" } ) }}