Difference between revisions of "TeamJapan/ja:support/docs/search/index.php"

From Camino Wiki
Jump to navigation Jump to search
m (updated translation)
m (updated translation)
 
Line 22: Line 22:
 
最後に、SearchURLList.plistにはPreferredSearchEngineと呼ばれる特殊なキーがあります。このキーは、デフォルトで選択される検索エンジンを指定するのに使われます。キーに一致する検索エンジンがないと、SearchURLList.plistの読み出しが正しく行われません。キーの値は、plist内にある検索エンジン名のうちのひとつと同じにしなければいけません。 デフォルトでは、値は「Google」です。もし別の検索エンジンを追加してそれをデフォルトにしたい場合は、PreferredSearchEngine の値をその検索エンジン名に変更します。
 
最後に、SearchURLList.plistにはPreferredSearchEngineと呼ばれる特殊なキーがあります。このキーは、デフォルトで選択される検索エンジンを指定するのに使われます。キーに一致する検索エンジンがないと、SearchURLList.plistの読み出しが正しく行われません。キーの値は、plist内にある検索エンジン名のうちのひとつと同じにしなければいけません。 デフォルトでは、値は「Google」です。もし別の検索エンジンを追加してそれをデフォルトにしたい場合は、PreferredSearchEngine の値をその検索エンジン名に変更します。
  
====
+
==具体例==
  
 
デフォルトのSearchURLList.plistの内容は以下のようになっています:
 
デフォルトのSearchURLList.plistの内容は以下のようになっています:
Line 42: Line 42:
 
</pre>
 
</pre>
  
新しい検索エンジン(例えば、Dictionary.com、dMoz.org、eBay、Google Newsなど)を追加するには、まず各エンジンの検索URLを調べます。 方法はいろいろありますが、最も簡単なのはそのサイトを訪れて “CAMINO_SEARCH_STRING” のような目立つ文字列を検索し、検索結果ページのURLを確認するというものです。 例えば、Dictionary.comでの検索結果は “http://dictionary.reference.com/search?q=CAMINO_SEARCH_STRING” になります。 CAMINO_SEARCH_STRING を %sで置き換えると、“http://dictionary.reference.com/search?q=%s” になります。
+
新しい検索エンジン(例えば、Dictionary.com、dMoz.org、eBay、Google News)を追加するには、まず各エンジンの検索URLを調べます。 方法はいろいろありますが、最も簡単なのはそのサイトを訪れてCAMINO_SEARCH_STRINGのような目立つ文字列を検索し、検索結果ページのURLを確認するというものです。 例えば、Dictionary.comでの検索結果は、http://dictionary.reference.com/search?q=CAMINO_SEARCH_STRINGになります。ここで、CAMINO_SEARCH_STRING を%s に置き換えると、http://dictionary.reference.com/search?q=%sになります。
  
 
他の検索エンジンについても同じ方法を使い、最終的に以下のようにします:
 
他の検索エンジンについても同じ方法を使い、最終的に以下のようにします:
Line 58: Line 58:
 
     http://news.google.com/news?hl=en&q=%s&btnG=Search+News
 
     http://news.google.com/news?hl=en&q=%s&btnG=Search+News
  
注:plistはXML形式なので、特定の文字を実体参照に置き換える必要があります。 特に重要なのが検索URLによく存在する「&」で、「&amp;」に置き換える必要があります。 HTML/XMLで使われる実体参照の全リストはこちらです。置き換えが必要な文字が集められています。 Mac OS Xのdeveloper toolsに含まれているPropertyList Editorなら置き換えを自動で行ってくれるので、作業が少し楽になります。
+
注記:plistはXML形式なので、Caminoが正しく読み込めるように特定の文字を実体参照に置き換える必要があります。 特に重要なのが検索URLによく存在する「&」で、これは&amp; に置き換える必要があります。 こちらにHTML/XMLで使われる実体参照の全リストがあります。 AppleのMac OS X developer toolsに含まれているPropertyList Editorなら置き換えを自動で行ってくれるので、作業が少し楽になります。
  
少しテストすれば(そして検索エンジンの動作を少し理解すれば)、
+
ここで少し実験をしてみましょう(検索エンジンの仕組みも少し分かります)。eBayとGoogle Newsの検索URLを短くして、それぞれhttp://search.ebay.com/search/search.dll?query=%s とhttp://news.google.com/news?q=%sにしてみます。 必須の作業ではありませんが、少し読みやすくなります。
eBayとGoogle Newsの検索URLを http://search.ebay.com/search/search.dll?query=%sと http://news.google.com/news?q=%sのように簡略化できるでしょう。 簡素化は必須ではありませんが、わかりやすくなります。
 
  
最終的に、検索エンジン名と検索URLのリストはこのようになります:
+
こうすると、検索エンジンとその検索URLは次のようになります:
  
 
Dictionary.com
 
Dictionary.com
Line 74: Line 73:
 
     http://news.google.com/news?q=%s
 
     http://news.google.com/news?q=%s
  
あとはこれらをSearchURLList.plistに追加するだけです。 SearchURLPlist.plistを好みのテキストエディタ(TextEditがよいでしょう)で開きます。 <key>SEARCH_ENGINE_TITLE</key> <string>SEARCH_URL</string> をペアで記述します。SEARCH_ENGINE_TITLEには検索エンジンの名前 (例:Dictionary.com)を記述し、SEARCH_URLには前のステップで決定した検索URLを記述します。 (例:http://dictionary.reference.com/search?q=%s) この文字列は <dict> と </dict> タグの間に入れる必要があります。
+
あとはこれらをSearchURLList.plistに加えるだけです。SearchURLPlist.plist テキストエディタ(TextEditがよいでしょう)で開きます。 リストの各検索エンジンに対して、次のようなラインを追加する必要があります:<key>SEARCH_ENGINE_TITLE</key>と、さらに続けて<string>SEARCH_URL</string>とします。ここでSEARCH_ENGINE_TITLE には検索エンジンの名前 (例: Dictionary.com)を記入し、SEARCH_URL には前のステップで決定した検索URLを記述します。(例: http://dictionary.reference.com/search?q=%s) この文字列は<dict> と</dict> タグとの間に入れる必要があります。
  
 
Dictionary.comを追加すると以下のようになります。 赤字の部分が変更箇所です。
 
Dictionary.comを追加すると以下のようになります。 赤字の部分が変更箇所です。
Line 120: Line 119:
 
</plist>
 
</plist>
 
</pre>
 
</pre>
注記:検索エンジンの順番は気にしないでください。 検索欄では、検索エンジン名がアルファベット順で表示されます。
+
注記:検索エンジンの順番は気にしないでください。 検索欄では、検索エンジン名が自動的にアルファベット順で表示されます。
  
別の検索エンジンをデフォルトにしたい場合は、PreferredSearchEngineの値をデフォルトにしたい検索エンジン名に変更します。 以下の例は“Google News”をデフォルトに設定したものです:
+
別の検索エンジンをデフォルトにしたい場合は、PreferredSearchEngineの値をデフォルトにしたい検索エンジン名に変更します。 以下の例は「Google News」をデフォルトに設定したものです:
 
<pre>
 
<pre>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>

Latest revision as of 22:14, 13 March 2006

検索エンジンのカスタマイズ

Camino Project : Documentation : Customizing Search Engines

検索エンジンの変更

Caminoプロジェクト:ドキュメント:検索エンジンの変更

ツールバーの検索欄

Caminoのツールバーには、Googleの通常検索やイメージ検索、サイト内検索などを行える検索欄があります。検索欄の検索エンジンリストを編集できるインターフェイスはありませんが、テキストエディタがあればリストを編集できます。まず、ツールバーに検索欄を表示しておきましょう。 デフォルトではツールバーにあるはずですが、ない場合は次のCaminoの設定に従って検索欄を追加してください。

仕組み

検索エンジンを記述するplistファイルは~/Library/Application Support/Camino/SearchURLList.plistです。 SearchURLList.plist のフォーマットは単純です。 基本的には、検索エンジン名と検索URLのリストです。 検索エンジン名は検索欄の拡大鏡メニューで使用され、検索URLはCaminoが検索を行うのに使用されます。

検索を行うために、検索URLに2つの特殊な文字列を使用します:

%s — ユーザの検索語句

ユーザの検索語句に置き換えられます。 例えば、検索URLがhttp://www.google.com/search?q=%sの時、ユーザが「Mac Browser Camino」と入力すると、Caminoはhttp://www.google.com/search?q=Mac Browser Caminoを実行します。 %s は検索URLに必須です。

%d — 現在のURLのホストネーム

現在ユーザが訪れているURLのホストネームに置き換えられます。 例えば、ユーザがhttp://www.apple.comを閲覧している時に、http://www.google.com/search?q=%s site:%dとなっている検索URLに「Mac OS X」と入力すると、Caminoはhttp://www.google.com/search?q=Mac OS X site:www.apple.comを実行します。Googleのサイト内検索のように%d が使用できる検索エンジンはほとんどありません。

最後に、SearchURLList.plistにはPreferredSearchEngineと呼ばれる特殊なキーがあります。このキーは、デフォルトで選択される検索エンジンを指定するのに使われます。キーに一致する検索エンジンがないと、SearchURLList.plistの読み出しが正しく行われません。キーの値は、plist内にある検索エンジン名のうちのひとつと同じにしなければいけません。 デフォルトでは、値は「Google」です。もし別の検索エンジンを追加してそれをデフォルトにしたい場合は、PreferredSearchEngine の値をその検索エンジン名に変更します。

具体例

デフォルトのSearchURLList.plistの内容は以下のようになっています:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Google</key>
<string>http://www.google.com/search?q=%s</string>
<key>Google Images</key>
<string>http://images.google.com/images?q=%s</string>
<key>PreferredSearchEngine</key>
<string>Google</string>
<key>Search this Site</key>
<string>http://www.google.com/search?q=%s site:%d</string>
</dict>
</plist>

新しい検索エンジン(例えば、Dictionary.com、dMoz.org、eBay、Google News)を追加するには、まず各エンジンの検索URLを調べます。 方法はいろいろありますが、最も簡単なのはそのサイトを訪れてCAMINO_SEARCH_STRINGのような目立つ文字列を検索し、検索結果ページのURLを確認するというものです。 例えば、Dictionary.comでの検索結果は、http://dictionary.reference.com/search?q=CAMINO_SEARCH_STRINGになります。ここで、CAMINO_SEARCH_STRING を%s に置き換えると、http://dictionary.reference.com/search?q=%sになります。

他の検索エンジンについても同じ方法を使い、最終的に以下のようにします:

Dictionary.com

   http://dictionary.reference.com/search?q=%s

dmoz.org

   http://search.dmoz.org/cgi-bin/search?search=%s

eBay

   http://search.ebay.com/search/search.dll?
   cgiurl=http%3A%2F%2Fcgi.ebay.com%2Fws%2F&krd=1&
   from=R8&MfcISAPICommand=GetResult&ht=1&
   SortProperty=MetaEndSort&query=%s

Google News

   http://news.google.com/news?hl=en&q=%s&btnG=Search+News

注記:plistはXML形式なので、Caminoが正しく読み込めるように特定の文字を実体参照に置き換える必要があります。 特に重要なのが検索URLによく存在する「&」で、これは& に置き換える必要があります。 こちらにHTML/XMLで使われる実体参照の全リストがあります。 AppleのMac OS X developer toolsに含まれているPropertyList Editorなら置き換えを自動で行ってくれるので、作業が少し楽になります。

ここで少し実験をしてみましょう(検索エンジンの仕組みも少し分かります)。eBayとGoogle Newsの検索URLを短くして、それぞれhttp://search.ebay.com/search/search.dll?query=%s とhttp://news.google.com/news?q=%sにしてみます。 必須の作業ではありませんが、少し読みやすくなります。

こうすると、検索エンジンとその検索URLは次のようになります:

Dictionary.com

   http://dictionary.reference.com/search?q=%s

dmoz.org

   http://search.dmoz.org/cgi-bin/search?search=%s

eBay

   http://search.ebay.com/search/search.dll?query=%s

Google News

   http://news.google.com/news?q=%s

あとはこれらをSearchURLList.plistに加えるだけです。SearchURLPlist.plist テキストエディタ(TextEditがよいでしょう)で開きます。 リストの各検索エンジンに対して、次のようなラインを追加する必要があります:<key>SEARCH_ENGINE_TITLE</key>と、さらに続けて<string>SEARCH_URL</string>とします。ここでSEARCH_ENGINE_TITLE には検索エンジンの名前 (例: Dictionary.com)を記入し、SEARCH_URL には前のステップで決定した検索URLを記述します。(例: http://dictionary.reference.com/search?q=%s) この文字列は<dict> と</dict> タグとの間に入れる必要があります。

Dictionary.comを追加すると以下のようになります。 赤字の部分が変更箇所です。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Google</key>
<string>http://www.google.com/search?q=%s</string>
<key>Google Images</key>
<string>http://images.google.com/images?q=%s</string>
<key>PreferredSearchEngine</key>
<string>Google</string>
<key>Search this Site</key>
<string>http://www.google.com/search?q=%s site:%d</string>
<key>Dictionary.com</key>
<string>http://dictionary.reference.com/search?q=%s</string>
</dict>
</plist>

残りの3つも追加すると、以下のようになります:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Google</key>
<string>http://www.google.com/search?q=%s</string>
<key>Google Images</key>
<string>http://images.google.com/images?q=%s</string>
<key>PreferredSearchEngine</key>
<string>Google</string>
<key>Search this Site</key>
<string>http://www.google.com/search?q=%s site:%d</string>
<key>Dictionary.com</key>
<string>http://dictionary.reference.com/search?q=%s</string>
<key>dMoz.org</key>
<string>http://search.dmoz.org/cgi-bin/search?search=%s</string>
<key>eBay</key>
<string>http://search.ebay.com/search/search.dll?query=%s</string>
<key>Google News</key>
<string>http://news.google.com/news?q=%s</string>
</dict>
</plist>

注記:検索エンジンの順番は気にしないでください。 検索欄では、検索エンジン名が自動的にアルファベット順で表示されます。

別の検索エンジンをデフォルトにしたい場合は、PreferredSearchEngineの値をデフォルトにしたい検索エンジン名に変更します。 以下の例は「Google News」をデフォルトに設定したものです:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Google</key>
<string>http://www.google.com/search?q=%s</string>
<key>Google Images</key>
<string>http://images.google.com/images?q=%s</string>
<key>PreferredSearchEngine</key>
<string>Google News</string>
<key>Search this Site</key>
<string>http://www.google.com/search?q=%s site:%d</string>
<key>Dictionary.com</key>
<string>http://dictionary.reference.com/search?q=%s</string>
<key>dMoz.org</key>
<string>http://search.dmoz.org/cgi-bin/search?search=%s</string>
<key>eBay</key>
<string>http://search.ebay.com/search/search.dll?query=%s</string>
<key>Google News</key>
<string>http://news.google.com/news?q=%s</string>
</dict>
</plist>