Systemu pomocy Eclipse można użyć nawet w przypadku tworzenia aplikacji, która nie jest oparta na platformie Eclipse. Aplikacja może zawierać pakiet instalacyjny autonomicznego systemu pomocy, który jest mniejszą wersją platformy Eclipse pozbawioną wszystkich funkcji poza systemem pomocy. Po zainstalowaniu aplikacja może wykonywać wywołania funkcji API (z poziomu menu Pomoc lub z poziomu innych obiektów interfejsu użytkownika) w celu uruchamiania przeglądarki pomocy. Autonomiczny system pomocy ma wszystkie funkcje zintegrowanego systemu pomocy, z wyjątkiem pomocy kontekstowej i pomocy aktywnej. W przypadku aplikacji opartej na innym środowisku niż Java lub w sytuacji, gdy aplikacja nie działa i jest konieczne wyświetlenie pomocy, autonomiczny system pomocy można wywołać przy użyciu powłoki systemu, skryptu powłoki lub skrótu znajdującego się na pulpicie. Można przy tym podać odpowiednie opcje w wierszu komend zamiast wywoływać funkcje API języka Java.
Autonomiczny system pomocy umożliwia przekazywanie wielu opcji, których można użyć do dostosowywania różnych aspektów systemu pomocy. Obsługiwane są następujące opcje:
-nl fr_FR
spowoduje uruchomienie systemu pomocy w języku francuskim zamiast w języku określonym przez ustawienia narodowe komputera. String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" };
Help helpSystem = new Help(options);
helpSystem.start();
helpSystem.displayHelp();
Można także wywołać pomoc ze wskazaniem konkretnych tematów lub plików ze spisami treści:
helpSystem.displayHelp("/com.mycompany.mytool.doc/toc.xml"); helpSystem.displayHelp("/com.mycompany.mytool.doc/tasks/task1.htm");
Aby zamknąć system pomocy przy zamykaniu aplikacji:
helpSystem.shutdown();
Klasa org.eclipse.help.standalone.Help zawiera metodę main, która pozwala uruchamiać autonomiczny system pomocy z poziomu wiersza komend. Składnia argumentów w wierszu komend wygląda następująco:
-command start | shutdown | (displayHelp [href]) [-eclipsehome ścieżka_instalacyjna_eclipse] [-data obszar_instancji] [-host host_serwera_pomocy] [-port port_serwera_pomocy] [-dir rtl] [opcje platformy] [-vmargs argumenty_maszyny_Java_VM]
Prostą metodą wyświetlenia pomocy jest użycie komendy
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Help -command displayHelp
w katalogu d:\myApp\eclipse. Aby wyświetlić konkretny plik ze spisem treści lub temat, należy użyć komendy:
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Help -command displayHelp /com.mycompany.mytool.doc/tasks/task1.htm
Powyższe wywołania spowodują uruchomienie systemu pomocy i wyświetlenie tekstu pomocy oraz umożliwią użytkownikowi przeglądanie pomocy po wykonaniu komendy. Do sterowania systemem pomocy należy używać komend start, shutdown i displayHelp. Na przykład można użyć poniższej komendy:
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Help -command start
Autonomiczny system pomocy nie wymaga całego pakietu platformy Eclipse.
Aby można go było uruchomić, wystarczą następujące moduły dodatkowe (znajdują się one w katalogu eclipse\plugins):
org.apache.lucene
org.eclipse.core.runtime
org.eclipse.help
org.eclipse.help.appserver
org.eclipse.help.base
org.eclipse.help.webapp
org.eclipse.osgi
org.eclipse.tomcat
org.eclipse.update.configurator
W systemach Windows i Linux, aby zapewnić odpowiednią obsługę przeglądarek (wbudowanej przeglądarki Internet Explorer w systemie Windows i Mozilla w systemie Linux lub autonomicznej przeglądarki systemowej w systemie Windows), oprócz konfiguracji minimalnej są wymagane poniższe moduły dodatkowe i fragmenty.
org.eclipse.core.expressions
org.eclipse.help.ui
org.eclipse.jface
org.eclipse.swt
org.eclipse.swt.win32 lub org.eclipse.swt.gtk
org.eclipse.ui
org.eclipse.ui.workbench
Niektóre moduły dodatkowe dokumentacji mogą być zależne od innych modułów dodatkowych. Jest tak zwykle w przypadku, gdy wpisano wymagane moduły do pliku plugin.xml.
Zależne moduły dodatkowe także należy zainstalować na potrzeby centrum informacyjnego.
Moduły dodatkowe, które utworzono dla platformy w wersji wcześniejszej niż Eclipse 3.0, wymagają do działania obecności modułu dodatkowego org.eclipse.core.runtime.compatibility
.
Więcej informacji na temat dostosowywania systemu pomocy można znaleźć w sekcji Preferencje systemu pomocy.
org.eclipse.help.base preferences