Instalace samostatného systému nápovědy

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:

Instalace/balení

Popsané úkony jsou určeny pro integrátora systému nápovědy a neuvádějí všechny možné situace. Předpokládejme, že je veškerá vaše dokumentace dodána v podobě modulů plug-in Eclipse a že jste obecně obeznámeni se systémem nápovědy Eclipse.
  1. Stáhněte binární ovladač běhové komponenty platformy Eclipse z adresy www.eclipse.org.
  2. Instalujte (rozbalte) ovladač do adresáře své aplikace, např. d:\myApp. Vytvoří se podadresář d:\myApp\eclipse, který obsahuje kód požadovaný platformou Eclipse (který obsahuje systém nápovědy).

Volání tříd nápovědy z prostředí Java

  1. Ujistěte se, že v cestě ke třídě vaší aplikace máte d:\myApp\eclipse\plugins\org.eclipse.help.base_3.1.0.jar. Třída používaná k aktivaci, spuštění a vypnutí systému nápovědy je org.eclipse.help.standalone.Help.
  2. Vytvořte pole řetězců obsahující volby, které chcete předat podpoře systému nápovědy. V běžném případě je zapotřebí volba eclipsehome.
    String[] options = new String[] { "-eclipsehome", "d:\\myApp\\eclipse" }; 
  3. Ve své aplikaci vytvořte instanci třídy nápovědy předáním voleb. Tento objekt by měl být uchováván až do ukončení vaší aplikace.
    Help helpSystem = new Help(options); 
  4. Spuštění systému nápovědy:
    helpSystem.start(); 
  5. Volání nápovědy dle potřeby:
    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");
  6. Chcete-li spustit kontextovou nápovědu, použijte příkaz helpSystem.displayContext(idKontextu, x, y), kde contextId je úplné ID kontextu. Souřadnice obrazovky x a y se v současné době nepoužívají.
  7. Vypnutí systému nápovědy při ukončování vaší aplikace:

    helpSystem.shutdown(); 

Volání nápovědy z příkazového řádku

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

[Optional] Instalace minimální sady modulů plug-in.

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