Eclipse フレームワークに基づいていないアプリケーションを作成している場合でも、Eclipse ヘルプ・システムを使用することができます。 ご使用のアプリケーションは、スタンドアロン・ヘルプ・システム (取り除かれたヘルプ・システム以外のすべてが入っている非常に小さいバージョンの Eclipse) をパッケージし、インストールできます。 これで、アプリケーションはそのヘルプ・メニューまたは UI オブジェクトから API 呼び出しを行い、ヘルプ・ブラウザーを起動できるようになります。 スタンドアロン・ヘルプ・システムには、ワークベンチに組み込まれたコンテキスト・ヘルプ、ヘルプ・ビュー、およびアクティブ・ヘルプを除く、統合ヘルプ・システムのすべてのフィーチャーがあります。アプリケーションが Java ベースではない場合、またはアプリケーションが実行されていないときにヘルプが必要な場合は、システム・シェル、シェル・スクリプト、またはデスクトップ・ショートカットからスタンドアロン・ヘルプを使用して、 Java API を呼び出す代わりにコマンド行オプションを指定することができます。
スタンドアロン・ヘルプ・システムを使用すると、ヘルプ・システムの様々な面をカスタマイズするために使用可能なオプションの数を渡すことができます。 次のオプションがサポートされています。
-nl fr_FR
これにより、マシン・ロケールで指定されている言語ではなく、フランス語でヘルプ・システムを開始します。d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar
がクラスパスにあることを確認します。ここで、
[version]
は使用しているプラグインのバージョン
(org.eclipse.help.base_3.2.0.jar
など) です。ヘルプ・システムを開始、起動、およびシャットダウンするために使用するクラスは、
org.eclipse.help.standalone.Help
です。
String
オブジェクトの配列を作成します。通常、eclipsehome
オプションが必要です。
String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" };
Help
クラスのインスタンスを作成します。このオブジェクトは、アプリケーションの終了まで保持される必要があります。
Help helpSystem = new Help(options);
helpSystem.start();
helpSystem.displayHelp();
また、特定の 1 次 TOC ファイルやトピックについてのヘルプを呼び出すこともできます。
helpSystem.displayHelp("/com.mycompany.mytool.doc/toc.xml"); helpSystem.displayHelp("/com.mycompany.mytool.doc/tasks/task1.htm");
アプリケーションの終了時にヘルプ・システムをシャットダウンするには:
helpSystem.shutdown();
org.eclipse.help.standalone.Help
クラスには、コマンド行からスタンドアロン・ヘルプを起動するために使用できるメイン・メソッドがあります。コマンド行引数の構文は次のとおりです。
-command start | shutdown | (displayHelp [href]) [-eclipsehome eclipseInstallPath] [-data instanceArea] [-host helpServerHost] [-port helpServerPort] [-dir rtl] [platform options] [-vmargs JavaVMarguments]
ヘルプを表示する簡単な方法は、
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command displayHelp
(d:\myApp\eclipse ディレクトリー内より)。ここで、version
はプラグインのバージョンです。特定の TOC ファイルまたはトピックを表示するには、以下を使用します。
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command displayHelp /com.mycompany.mytool.doc/tasks/task1.htm
ヘルプを表示するための上記の呼び出しによって、ヘルプ・システムが開始し、ヘルプが表示されて、コマンドの実行後もユーザーが引き続きヘルプをブラウズできるようにするために続けて実行されます。 ヘルプ・システムのライフ・サイクルを制御するには、displayHelp コマンドだけでなく、 start および shutdown コマンドを使用します。 たとえば、次のものを呼び出すことができます。
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_[version].jar org.eclipse.help.standalone.Help -command start
スタンドアロン・ヘルプは、完全な Eclipse プラットフォーム・パッケージを必要としません。
eclipse/plugins
ディレクトリーに以下のプラグインを追加した RCP ランタイム・バイナリーによって、スタンドアロン・ヘルプを実行できます。
org.apache.lucene
org.eclipse.help
org.eclipse.help.appserver
org.eclipse.help.base
org.eclipse.help.ui
org.eclipse.help.webapp
org.eclipse.tomcat
org.eclipse.ui.forms
注: 以下の行が、eclipse/configuration/config.ini
ファイルにあることを確認してください。
osgi.bundles=org.eclipse.equinox.common@2:start, org.eclipse.update.configurator@3:start, org.eclipse.core.runtime@start
ドキュメンテーション・プラグインには、他のプラグインと依存関係にあるものがあります。通常、マニフェストで必須プラグインを指定することにより関係が成立します。依存プラグインもインストールする必要があります。また、Eclipse 3.0 より前のバージョン用に設計されたプラグインが機能するためには、暗黙的に org.eclipse.core.runtime.compatibility
をプラグインが必要になります。
ヘルプ・システムのカスタマイズについて詳しくは、 製品のカスタマイズを参照してください。