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

ここのブログに引っ越しして当日早々、間違ってテンプレートを公開してしまった…('A`) それも、2度も。 まぁ、それはともかく、テンプレートを公開するにあたって色々と情報を整理してまとめなければなりませんので、 項目別にまとめてみました

コンセプト

• XHTML 1.0 準拠
  目標としては w3.org の validate が通る事。これは既に通過しているので問題無し。 JUGEM 独自タグが生成する HTML はどうしようもないが…('A`)
• CSS 2.1 準拠
  目標としては w3.org の validate が通る事。これも既に通過しているので問題無いが、CSS では特に 2.0 や 2.1 を 意識したコーディングを行っていない。何故なら対応ブラウザがないから
  
• JavaScript に依存しない
  よくサイトを閲覧している時に感じるのが、ブラウザ側で JavaScript が有効でないと情報の閲覧がままならないという事。 JavaScript が有効ならばこういう事もできますよ。というのは別に構わないが、これを前提としたデザインはしない。 全てのサイト閲覧者が JavaScript を有効にしている訳ではないのだから
  
• 画像などの外部リソースは使用しない
  あくまでもテンプレート部分に置いて別リソースが必要となるようなデザインはしない。 とにかくブラウジングが軽く、素早く表示される事

特徴

• XHTML 1.0 準拠
• CSS 2.1 準拠
• JavaScript が無効でもデザインは基本的に変わらない
• 画像未使用(テンプレートのみ)
• 使用配色は 2色(アンカー、ハイパーリンク部分は除く) なので、配色変更が容易
• 相対単位を用いているので閲覧者は好みのフォントサイズで閲覧できます

文書(HTML) 構造

う～ん…こうして見ると、内容は違うのに全く同じスタイルを適用している所があるな…この辺は要検討です

後は、設定方法、免責事項を等を考えればいいですね…近日中に公開…できると、いいナァ…('A`)