Systém nápovědy Eclipse můžete rovněž použít, pokud vytváříte aplikaci, která není naložena na infrastruktuře Eclipse. Vaše aplikace může zabalit a instalovat samostatný systém nápovědy, velmi malou verzi platformy Eclipse, ze které je odebráno vše s výjimkou systému nápovědy. Potom může vaše aplikace provádět volání rozhraní API ze své nabídky nápovědy nebo z objektů uživatelského rozhraní, aby spustila prohlížeč nápovědy. Samostatný systém nápovědy je vybaven veškerými funkcemi integrovaného systému nápovědy s výjimkou rozevíracích informačních oken a aktivní nápovědy. Pokud nejde o javovskou aplikaci nebo má-li být nápověda k dispozici i v situacích, kdy aplikace není spuštěna, lze používat samostatnou nápovědu z nadstavby systému, skriptu nadstavby nebo ze zástupce pracovní plochy a poskytnout volby příkazového řádku namísto volání API.
Samostatný systém nápovědy podporuje řadu voleb, které lze použít k přizpůsobení různých aspektů systému nápovědy. Podporovány jsou tyto volby:
-nl fr_FR
spustíte systém nápovědy ve francouzštině místo v jazyce definovaném národním prostředím operačního systému.String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" };
Help helpSystem = new Help(options);
helpSystem.start();
helpSystem.displayHelp();
Rovněž můžete volat nápovědu určitých primárních souborů obsahu či hesel:
helpSystem.displayHelp("/com.mycompany.mytool.doc/toc.xml"); helpSystem.displayHelp("/com.mycompany.mytool.doc/tasks/task1.htm");
Vypnutí systému nápovědy při ukončování vaší aplikace:
helpSystem.shutdown();
Třída org.eclipse.help.standalone.Help má hlavní metodu, která vám umožňuje spouštět samostatnou nápovědu z příkazové řádky. Syntaxe argumentů příkazového řádku:
-command start | shutdown | (displayHelp [href]) [-eclipsehome eclipseInstallPath] [-data instanceArea] [-host helpServerHost] [-port helpServerPort] [-dir rtl] [platform options] [-vmargs JavaVMarguments]
Jednoduchým způsobem zobrazení nápovědy je zadání příkazu
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Help -command displayHelp
v adresáři d:\myApp\eclipse. Určitý soubor obsahu nebo heslo zobrazíte použitím
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
Výše uvedené příkazy zobrazující nápovědu způsobí spuštění systému nápovědy, zobrazení nápovědy a uchování nápovědy v chodu za účelem pokračování v prohlížení nápovědy po provedení příkazu. Ke kontrole životního cyklu systému nápovědy používejte kromě příkazu displayHelp příkazy spuštění a vypnutí. Například lze vyvolat
java -classpath d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar org.eclipse.help.standalone.Help -command start
Samostatná nápověda nevyžaduje kompletní balíček platformy Eclipse.
Samostatnou nápovědu lze provozovat již při použití těchto modulů plug-in (které jsou umístěny v adresáři 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
Ve Windows a v systému Linux jsou kromě minimální konfigurace k poskytnutí robustní podpory prohlížeče (Internet Explorer integrovaný se SWT ve Windows a Mozilla na systému Linux nebo samostatný systémový prohlížeč ve Windows.
org.eclipse.core.expressions
org.eclipse.help.ui
org.eclipse.jface
org.eclipse.swt
org.eclipse.swt.win32 nebo org.eclipse.swt.gtk
org.eclipse.ui
org.eclipse.ui.workbench
Některé moduly plug-in dokumentace mohou záviset na jiných modulech plug-in. V takovém případě se zadávají požadované moduly plug-in do souboru plugin.xml daného modulu plug-in.
Rovněž takovéto moduly plug-in závislostí musejí být instalovány do modulu InfoCenter.
Kromě toho moduly plug-in navržené pro verze Eclipse předcházející verzi 3.0 požadují ke své činnosti přítomnost modulu plug-in org.eclipse.core.runtime.compatibility
.
Další informace o přizpůsobení systému nápovědy viz Systémové předvolby nápovědy.
Předvolby org.eclipse.help.base