OpenSearch_maker 1.0.0

OpenSearch maker なるモノを作ったもののマニュアルがないので作成…('A`)

使い方

各入力フィールドやチェックボックス、ラジオボタンなどを設定して、generate searchplugin ボタンを押す事によって、OpenSearch に対応している UA で使用できます。以下、各項目について、PHP の関数を検索を行うプラグインを作成する例にならって説明していきます

• 使い方
• 各項目について
• ヘッダーの指定
• 検索エンジンの短い名前 : ShortName
• 検索エンジンの説明 : Description
• 入力エンコード : InputEncoding
• アイコン : Icon
• URL
• メソッド : Method
• パラメーター : Parameter
• サーチプラグインファイルの生成、ダウンロード
• サーチプラグインファイルのインストール
• 参照

各項目について

ヘッダーの指定

XML ヘッダーを出力する の項目をチェックする事によって XML ヘッダー が生成されるファイルの先頭に付きます。OpenSearch の仕様では、XML ヘッダー は付きません

1. <?xml version="1.0" encoding="UTF-8"?>

検索エンジンの短い名前 : ShortName

必須項目で省略できません。設定した名前が Firefox の検索バーに表示されます

1. <ShortName>PHP 関数検索</ShortName>

検索エンジンの説明 : Description

省略できます。検索エンジンの簡単な説明を記述します

1. <Description>PHP 関数を検索</Description>

入力エンコード : InputEncoding

省略できますが、省略された場合 UTF-8 が使われます。GET および POST メソッドで検索エンジンに対してリクエストされる際のエンコードを指定します。ここで指定するエンコード文字セット名称は IANA Character Set Assignments を参照してください

1. <InputEncoding>UTF-8</InputEncoding>

アイコン : Icon

省略できます。検索バーに表示される縦16ドット、横16ドットのアイコンファイルを指定します。base64 をチェックすると、アップロードされたアイコンファイルを Base64 でエンコードします。チェックしないと URL エンコード されます。アップロード処理が何らかの原因でエラーになった場合はサーチプラグインファイルは生成されません

1. <Image width="16" height="16">data:image/x-icon;base64,Qk02AwAAAAAAADYAAAAo… (省略)</Image>

URL

必須です。検索エンジンのサイト URL を記述します。実際に検索が行われる URL でなければなりません。URL として正しくない値を入力するとエラーとなり、サーチプラグインファイルは生成されません

メソッド : Method

GET または POST のいずれかを指定しなければなりません。簡単に説明すると GET メソッドは検索エンジンサイトのホスト名や検索語などのパラメーターを URL としてリクエストします。一方、POST メソッドは URL とは別に検索語などのパラメーターをデータとして送信し、検索エンジンにリクエストします

1. <Url type="text/html" method="POST" template="http://www.php.net/search.php">

GET メソッドを指定した場合の例を以下に示します。後述のパラメーターを指定する事によって以下の様に出力します

1. <Url type="text/html" method="GET" template="http://blog.alphaziel.info/">
2.   <Param name="s" value="{searchTerms}"/>
3. </Url>

GET メソッドを指定し、パラメーターを指定しなかった場合には以下の様に出力します

1. <Url type="text/html" method="GET" template="http://blog.alphaziel.info/?s={searchTerms}" />

パラメーター : Parameter

メソッドが POST の場合は必須です。検索バーで入力した検索語をサーチプラグインに渡す為のキーワード {searchTerms} は値のどこかに設定しなければ、サーチプラグインに検索語が渡りません。また。記述する名前、値のどちらかが欠けていれば、エラーとなり、サーチプラグインファイルは生成されません

1. <Param name="pattern" value="{searchTerms}"/>
2. <Param name="lang" value="ja"/>
3. <Param name="show" value="quickref"/>

サーチプラグインファイルの生成、ダウンロード

generate searchplugin を押す事によって、サーチプラグインを生成し、ダウンロードダイアログが表示されるのでダウンロードを行います。アップロードされたアイコンファイルや生成されたサーチプラグインはダウンロードの段階で削除されます

サーチプラグインファイルのインストール

ダウンロードしたサーチプラグインファイルを Firefox のプロファイルディレクトリの中の searchplugins ディレクトリにコピーまたは移動し、Firefox を再起動します

参照

• 今日もガクリ('A`) » Firefox 3 : サーチプラグインについて
• OpenSearch maker : 1.0.0
• Creating OpenSearch plugins for Firefox - MDC
• Creating MozSearch plugins - MDC (非標準)
• Specifications/OpenSearch/1.1/Draft 3 - OpenSearch