ICeCoffEE 1.3.3
31 May 2003

Cocoaアプリケーションにおいて、URLや電子メールアドレスのテキストを⌘-クリックすることで、それらを開きます。コンテクスト・メニューやメニューバーから、サービス・メニューへアクセスします。

作者：Nicholas Riley <mailto:icecoffee@sabi.net>.
アップデートはこちらから：<http://web.sabi.net/nriley/software/>.

ICeCoffEE概要

あなたは、Mac OS ９でのICeTEeの機能に慣れ親しんだMacユーザかも知れませんね。

または、Mac OS Xを使い始めて、テキスト、スティッキーズ、ソースコード等に表れるURLや電子メールアドレスを開き、またブックマークするための、より速い方法を探している最中かも知れません。

どちらだとしてもICeCoffEEはまさに、あなたの為にあります。

インストール

インストーラの説明に従ってインストールしてください。古いバージョンのICeCoffEEが既にインストールしてあるなら、それは自動でゴミ箱へ移動します。

アンインストール（削除）

一時的にICeCoffEEを使用停止とするには、APE Manager（下の“詳細設定” セクションを参照）で行います。ICeCoffEEを完全に削除する場合は、インストーラにある「アンインストール」ボタンで行うか、または“ICeCoffEE.ape”ファイルをゴミ箱へ捨てます。

使用法

ICeCoffEEを試用する:

	1.	テキストエディットがICeCoffEEをインストールした時からずっと起動したままならば、一旦終了してください。ICeCoffEEは、インストール後に起動したアプリケーションでのみ機能します。ICeCoffEEがアクティブであることを確認するには、インストール後に一旦ログアウト＆ログインしてください。
 
 2.	テキストエディットを起動します。（通常はアプリケーション・フォルダ内）
	
 3.	URLをタイプ入力します。例えば、http://www.google.com/
	
 4.	コマンド・キー（⌘）を押下しつつURLテキスト中のどこかをクリック（⌘-クリック）します。すると、あなたが設定しているウェブ・ブラウザが起動して、インタネット接続しているとすれば、Googleウェブ・サイトを表示します。ICeCoffEEは、接続自体には何も影響を及ぼしません。

ICeCoffEEを使用する：

Cocoaアプリケーションのテキスト・エリアにおいて、URLや電子メールアドレスのテキストを⌘-クリックします。Mac OS Xに付随するCocoaアプリケーションには、スティッキーズ、テキストエディット、Mail、iChat、ネットワークユーティリティ、等があります。加えて、⌘-クリックは、ターミナルやSimpleTextのウィンドウ内でも、またSafari browserで表示されるテキストでも最初にURLや電子メール・アドレスを選択しておけば機能します。

 ⌥⌘–クリックして表れるメニューからアプリケーションを選択すれば、そのアプリケーションで、選択したURLや電子メール・アドレスのテキストが開けます。これは、Finderの[このアプリケーションで開く]サブメニューに似ています。

ICeTEe 2のように、ICeCoffEE 1.3はURL Manager Pro（Alco Blom氏作）のようなブックマーク管理ソフトとの連携が可能です。ICeCoffEEは、ブックマーク・プロトコル用に定義されたヘルパー・アプリケーションを使います。一例：

	<http://web.sabi.net/nriley/software/icecoffee-bookmark/>

Control (⌃)-クリック（マルチボタン・マウスをお使いならば、右ボタンをクリック）を、Cocoaアプリケーションのテキスト・エリアですると、サービス・サブメニューが下方へ現れます。このメニューは、アプリケーション・メニューのサービス・サブメニューと同様に機能します。

ICeCoffEEはまた、ターミナルのウィンドウのコンテクスト・メニューや、Project Builderのソース・ウィンドウ、Safari browserで見るウェブ・ページへもサービス・メニューを付加します。

詳細設定

ICeCoffEEの設定を変更するには、システム環境設定（メニューにもありますね）を開き、APE Managerをクリック。それから、Application EnhancersリストからICeCoffEEを選択します。

[設定]タブでは、ICeCoffEEの様々な機能の入／切の切り替えが出来ます。現行バージョンのICeCoffEEがアクティヴならば、変更内容は即座に全てのアプリケーションへ反映されます。

もしもICeCoffEEが、アプリケーションの通常の働きとコンフリクトを生じて仕舞う時には、そのアプリケーション内では機能しないように、[除外リスト]タブでそのアプリケーションを設定します。もしもそのアプリケーションが起動中ならば、変更が反映される前に、一旦終了してから再起動しなくてはなりません。また、異常な働きを見出した際には私へご報告ください。ICeCoffEEの今後のバージョンで解決出来るでしょうから。

他の機能

Mac OS ９でICeTEeのような働きを提供するCarbonアプリケーションは幾つか在りますが、それらはMac OS Xにおいても同様に働きます。以下は私の気付いた２、３の左様なアプリケーションです。：

BBEdit 	<http://www.barebones.com/products/bbedit.html>
Tex-Edit Plus	<http://www.nearside.com/trans-tex/>

Appleは、⌘-クリックによるURLアクセスを、Mac OS X v10.2で提供しましたが、その後、２か所で提供しました。

AppleのMultilingual Text Editor (MLTE)サービスでは、⌘-クリックによるURLアクセス可能です。OS X Developer Toolsのインストールでインストール（ /Developer/Applications/Extras）されるWorldTextは、MLTEを使うアプリケーションの一例です。

ターミナルでは、⌘-ダブル・クリックで複数URLアクセスが可能ですが、
ICeCoffEEだと、⌘-クリック（クリックは一度）で同様に機能します。

Apple提供のこれらURLアクセス機構はどれも、ICeCoffEEのようには働きません。それらは、ターミナルがMLTEが受容しない沢山の事を受容するように、独立して記述されています。例えば、MLTEは<>によって共通して制限されることで、
URLアクセスを拒絶します。ICeCoffEEの今後のバージョンは、MLTEの代替として介入するかも知れません。

FAQ

Q. 何故ICeCoffEEは、「サービス」メニューではないのですか？

A.「サービス」メニューは、良いアイディアだと思います。然し乍ら私の見るところでは、Cocoaにおける「サービス」メニューはMac OS Xではパワー不足です。比較してみましょう。：

•	URL内でカーソル挿入や選択をして、⌘-クリック。　(１ステップ）

以下と比較：

•	URLテキストを慎重に選択。
•	アプリケーション・メニューへカーソル移動。
•	「サIービス」メニューを見つける。（いつも同じ場所に表示されるとは限らない。）
•	（ことによると、）URLを開くアプリケーションを起動する為に、階層メニュー項目を見つける。
•	「サービス」項目を選択。

どちらをあなたは使いたいですか？ どちらをAppleは提供しているでしょう？ 現状を改善するため、利用出来ない「サービス」項目は隠すことが出来、「サービス」メニューは最高レベルのメニューへと奨励・促進出来ます（NeXT OSやMac OS X Server 1.xがそうであったように）。あるいは、コンテクスト・メニューとして利用出来ます。ICeCoffEE 1.1以上はコンテクスト・メニューの「サービス」をサポートし、1.3以上ではメニューバーの「サービス」をサポートします。

Q.キーボード・ショートカットを「サービス」メニューに割り当てることは出来ますか？割り当てが可能ならば「サービス」メニューへのアクセスが、ほんの２ステップで済みますが。 

A.幾つかのアプリケーション、またその他によって重複しない、「サービス」メニューへアクセスするキーボード・ショートカットは一つも在りません。此れは、
Appleが曾てないほどより多くの⌘キー操作を、Mac OS Xでのみ使用するために確保しているために、とりわけ事実です。覚え易く、押し易く、更には他のどのアプリケーションともコンフリクトを起こさないキーボード・ショートカットを作る事は不可能のようです。

また、現在の「サービス」メニューの実行内容は選択箇所のみに働きますが、その前後には何もしません。しかし此れは、ICeCoffEEのようなプログラムがシームレスに機能するための本質的特徴であり、ICeCoffEEでは何も選択せずにURL内のどこかを只、⌘-クリックすればいいのです。

最後に、現在のMac OS Xにおける「サービス」メニューの実行に際しては、「サービス」メニューへのキーボード・ショートカットによるアクセスが使えるよりも前に、アプリケーション内で「サービス」メニューをプルダウン表示しなくてはなりません。ゆえに、最初にキーボード・ショートカットでアクセスすると「サービス」へのアクセスが出来なくなってしまうのです。

Q. ICeTEeは、まだ必要でしょうか？

A. Classic Mac OSでICeTEeをお使いならば、インストールしたままで良いです。残念乍ら、Classic Mac OSとMac OS XのInternet Config間に関しての情報交換がなされていないようです。ですから、補助情報を２回設定しなくてはなりません。

Q. なぜICeCoffEEは、私のよく使うアプリケーションをサポートしていないのでしょうか？

A. 提案は、どうぞ私へ送ってください。現時点でICeCoffEEは、私が機能させたいと思うほぼどこででも機能します。ただ例外は、MLTE（�ﾉ前掲）のテキスト・エリアですが、そこでも基本的なURLアクセスは可能です。

"幾つかのMac OS Xのアプリケーションが既にサポートしている、URLの直接⌘-クリックをあなたの良く使うアプリケーションがサポートするようにリクエストすることも可能です。個別のアプリケーションへ此の機能を備えるには、一時間程の作業のみ要します。（それに比較して、Mac OS X 10.1のターミナルへURL起動機能を備えるには一月以上を要しました。しかし、Mac OS X 10.2においてターミナルのプログラムは書き直された為に無駄となってしまいました。そのMac OS X 10.2バージョンへ対応させるには、更に６時間を要しました。）

Q. ICeCoffEEとは、何の略なのですか？

A. Internet Config Carbon/Cocoa Editing Extension.　或いは、そのようなものです。 

Q. 私の質問・疑問がここで回答されていません。

A. 問題ありません。ICeCoffEEに関して質問、提案、バグ・レポート等がありましたら、<icecoffee@sabi.net>へ電子メールをください。しかし、あらかじめ変更履歴内の既知のバグ・リストを参照してください。それにより、あなたは既知のバグ・レポートを送信する必要はなくなります。また、メッセージは、短く要点を得たものとしてください。それにより私は、時間の許す限り直ぐに返信が出来ます。よろしく！

変更履歴

1.3.3 / 31 May 2003
•	No longer accidentally display debug message “range of string {x, y}” in Console when opening URLs in Terminal
•	Non-ASCII characters act as URL boundaries instead of yielding confusing “conversion to cString failed” error
•	Respond to ⌘-click in non-ASCII text with “no URL was selected” instead of “conversion to cString failed”
•	Fixed small memory leak in contexual Services menu [Sven-S. Porst]
•	Remove disabled items and collapse single-item submenus in Services contextual menu [Sven-S. Porst]
•	Enable service keyboard shortcuts at application launch time [Sven-S. Porst]
•	Fixes text dragging behavior in Terminal: now ⌥-drag to copy within the same window, and ⌥ doesn't function as a toggle elsewhere
•	Added German localization [Sven-S. Porst]

既知のバグ
•	⌘-クリックを、AppleのメールソフトMailのメッセージ・ヘッダですると、過多に選択してしまいます。（NSSelectByWordの通常の機能が無視されます。
•	ターミナルで複数行に跨がるURLを⌘-クリックすると、過多な行数のテキストを選択する事があります。
•	⌘-clicking URLs in Proteus is ineffective

1.3.2 / 13 March 2003
•	ブックマーク追加における小さなメモリ・リークを解消しました。
•	非ローマン語システム上での⌥⌘-クリック・メニューのアピアランスを修正しました。
•	⇧⌘-クリックまたは⌥�ﾑ⌘-クリックにより、バックグラウンドでURLを開けます。[Paul Kafasis氏要望より]
•	最近のSafari browser β版のバグの為、一時的にSafari browserのサポート停止。
•	日本語ローカライズを追加。

1.3.1 / 9 February 2003
•	⌥⌘-メニュー内に、ヘルパー・アプリケーション名を含めました。
•	最早、バックグラウンド・オンリー(NS/LSUIElement, NS/LSBackgroundOnly)や、コマンド・ライン、またフルスクリーンのアプリケーションにおいては、作動しません。：スピーチ・フィードバック・ウィンドウが消える問題を解決。DiskCopyやXoundsとのコンフリクトを解決（APE Managerの制限の為に、これらのアプリケーションは未だに[対象アプリケーション]タブのリストへ表れます）。
•	APE Manager preferences pluginの小さなメモリ・リークを直しました。

1.3 / 3 February 2003
•	ブックマークのダイアログ・ボックス表示時、コンソールには其のCFLogメッセージが表示されます。

1.3b3 / 2 February 2003
•	デフォルトのプロトコル・ハンドラーを、それがたとえ働くことを要求せずとも、メニュー表示します。
•	⌥⌘-クリックのメニューへ「ブックマークへ追加」を付加した。
•	APE 1.2.1 final及び新しいUnsanity Installerへアップデートしました。：これにより、ICeCoffEEインストーラが、必要な時にAPEをアップデートせずICeCoffEEが全く機能しなくなる問題を解決しました。
•	OmniWebブラウザ及びiCabブラウザでスラックURLを開く時の問題を解決しました。（これまで、ICeCoffEEは無効なURLを生成していました。）[John Marriott氏指摘より]"
•	SimpleTextにおいて、⌥⌘-"クリックでテキストをハイライトするように修正しました。

1.3b2 / 29 January 2003
•	Carbonのサポートを開始。：ICeTEe 2.0に基づいてTEClickパッチを施しました。SimpleTextでのみ有効です。
•	アンインストールでの不正なバージョン番号を正しました。またも。(oops)
•	ターミナルにおけるエラー処理を正常化しました。
•	テキスト点滅がICeTEeと同様に機能するように修正しました。（特にターミナルにおいて顕著です。）
•	スラックURLを扱えるようにしました。（例：web.sabi.net/nriley）
•	無効なURLを解析中に生じる小さなメモリ・リークを解消しました。
•	⌥⌘-クリックで、「ロケーションをこのアプリケーションで開く」メニューを表示可能としました。
•	ローカライズ用にAPEの全テキストを用意しました。

1.3b1 / 26 January 2003
•	Mac OS X 10.2のターミナルをサポートしました。
•	URL解析の問題を直しました。

1.3d3 / 22 January 2003
•	インストールされた一部として検知されれば、ICeCoffEEのインプット・マネージャ・バージョンをアンインストールします。
•	インストーラに表れる不正なバージョン番号 "1.5a3"を正しました。（そのバージョンかそれ以前のバージョンでアンインストールする場合のみ）
•	除外アプリケーション・リストの機能をAPE Manager初期設定へ戻しました。(oops)
•	ICeCoffEE 1.0–1.2フォーマットから除外アプリケーション・リストが自動的に移ります。
•	APE ManagerにおいてICeCoffEE特定の設定が可能。

1.3d2 / 20 January 2003
•	Safari browserにおいて、ウィンドウでのコンテクスト・メニュー表示、部分的な⌘-クリックで開く（テキストを最初に選択）機能を付加しました。
•	Project Builderでの復帰機能を修復しサポートました。もはや⌘-クリックには応答しません。(oops)
•	“Services”のタイトルにローカライズしたテキストを使用しました。
•	Added Services in the menu bar [Ben Hines]
•	メニュー・バーへ「サービス」メニューを追加。[Ben Hines氏要望より]

1.3d1 / 19 January 2003
•	Application Enhancer (APE)をインプット・マネージャの代わりに使用します。
•	Unsanity Installerを使用します。
•	設定にはAPE Managerを使用します。
•	Read Meファイルを、プレイン・テキストからRTFDへ変換しました。
•	Mac OS X 10.1のターミナルはサポートしません。
•	Project Builder 2.0とMac OS X 10.2のターミナルでの「サービス」コンテクスト・メニューを修復しました。"

1.2b2 / 20 April 2002
•	タブでのデッド・テキストを直しました。[Dr.Suksiri Grams氏指摘より]

1.2b1 / 10 February 2002
•	URLの末尾に関して、解析能力をより寛大にしました。よって、http://... は正しく解析されます。
•	ターミナル起動時のメモリ・リークを修復しました。

1.2a2 / 10 February 2002
•	ターミナルで、テキストが既に選択されている時に⌘-クリックする時のバグを直しました。
•	ターミナルで、最後の行を⌘-クリックする時にクラッシュするバグを直しました。
•	URLの周囲の句読点等をフィルタします。（しかし、技術的にRFC 2396 §2.3を侵害するパーレン（()）は例外とします）[Chris Behm氏指摘より]
•	ターミナルの（可変ウィンドウ内において生じる）複数行に跨がるテキスト（ソフト・ラップト・ラインズ）をサポートします。
•	コード群を分解しました。一か所ではなく全所でのURL長チェッキングのバグを修復しました。

1.2a1 / 8 February 2002
•	Rewrote attributedSubstringFromRange: to only grab complete lines; many hours of pain and suffering for padding lines
•	Fixed off-by-one error in URL length checking

1.2d5 / 7 February 2002
•	Implemented minimal NSTextInput for Terminal.app since it doesn’t do so itself (buggy, crashes when trying to access beyond end of line)
•	Reduced memory consumption in NSTextInput URL launching code

1.2d4 / 30 January 2002
•	Fixed crashing bug when ICeCoffEE couldn’t get the selection and tried to call ICStop without ICStart
•	Intercept ⌘-click in Terminal.app (but can't do anything with it yet)
•	Version of URL launching code that only requires NSTextInput, not NSTextView (uses too much memory)

1.2d3 / 30 January 2002
•	Pass mailto hint (⌘-click email addresses)

1.2d2 / 29 January 2002
•	ターミナルのウィンドウへコンテクスト・メニューを追加。

1.2d1 / 28 January 2002
•	ターミナルへの実行可能が証明される。

1.1 / 28 January 2002 / installer 1.0.2
•	Read Me fileへ少々補足しました。
•	ドローア（Mac OS Xのインタフェイス・エレメント）を実際に動かします。
•	アンインストール/インストール後に生じる、インストーラがクラッシュするバグを直しました。（オブジェクトのインスタンスを可変に設定する為に常にアクセサーを用いて下さい。）"
•	CFBundleIDを持たないアプリケーションは、もはや除外しません。
•	何も無いツールバー・アイテム・ヴューを適正に操作します。
•	パッチ中のエラー操作を改善。

1.1d2 / 27 January 2002 / installer 1.0.1
・インストーラは、suidルート・バグの外で作動します。最早、NetInfoマネージャ、ディスク・ユーティリティの起動時にクラッシュはしません。[Peter Miller氏要望より]
•	初期設定ファイルの取り扱いを改善しました。
•	アクセス不可能なフォルダへインストールする場合に、ICeCoffEEが取り除けなくなるインストーラ・バグを解決しました。
•	除外したアプリケーションでは、「サービス」コンテクスト・メニューを停止させることは、最早出来ません。
•	ツールバーやドローア[ZnU]におけるデッド・テキスト・フィールドを解決しました。注意：ツールバーのテキスト・フィールドを⌘-クリックするには、まずクリックしてその直後に⌘-クリックをしてください。或いは、ご自分でツールバー項目を移動してください。

1.1d1 / 25 January 2002
コンテクスト・メニューへ「サービス」項目を付加する。

1.0 / 25 January 2002
Read Me fileへ若干の補足。

1.0a6 / 25 January 2002
除去機能を付加しました。UIはまだです。（必要ならば、plistを編集して下さい）。デフォルトでは、PBXを除去します。インストーラにアンインストール機能を付加しました。

1.0a5 / 24 January 2002
デッド・テキスト・フィールドのバグを直した、と私は考えます...。

1.0a4 / 23 January 2002
インストーラ付きの試験版

1.0a3 / 22 January 2002
⌘-左マウスボタン・クリックでのみ、機能します。

1.0a2 / 21 January 2002
デバッグのメッセージを除去しました。コンソールよりも、１ダイアログ・ボックスで複数エラー報告をします。URLを点滅させます。<>をクリックする時のエラーを直しました。機能の一時停止が出来ます。read meファイルを用意しました。

1.0d1 / 20 January 2002
ツール化可能が証明される。

謝辞

インスピレーションとテストにおいて、John Marriottに。
テストと提案において、Michael Dinsmore, John Hayes, Ben Hines, Philippe Martin と Raphaël Szwarcに。
彼等の素晴らしきソフトウェアと寛大さにおいて、Slava Karpenko and Rosyna Keller at Unsanityに。
ICeTEeでは、QuinnとMichael Schürigに。
Internet Configに関して働いた全ての人たちに。ありがとう。

This product  uses Application Enhancer system
 Copyright ©2002-2003, Unsanity LLC
http://www.haxies.com/ape/