Rozšíření obsahu nápovědy

org.eclipse.help.contentExtension

Tento bod rozšíření je určen k podpoře dynamického a opětovně použitelného obsahu na stránkách systému nápovědy. Umožňuje přispívání obsahu do stávajících stránek systému nápovědy. Libovolná stránka XML v systému nápovědy může "deklarovat", že je schopna přijímat příspěvky obsahu, a to zadáním těchto bodů příspěvků s použití prvku anchor. Poté lze do takovýchto dokumentů za běhu programu dynamicky vkládat úseky kódu XHTML.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definuje rozšíření obsahu pro jednu či více stránek systému nápovědy. Umístění souboru rozšíření obsahu určuje atribut file.



Následuje příklad použití bodu rozšíření contentExtension.

(v souboru plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(v souboru contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

"org.xxx.yyy.somePluginId/xhtml/someHelpPage.xhtml/topicAnchor"

/>

</contentExtension>

Výše uvedený příspěvek vkládá obsah souboru XHTML topicA.xhtml na cílovou stránku systému nápovědy určenou atributem path. V tomto případě bude rozšíření obsahu vloženo do umístění kotvy s názvem topicAnchor na stránce someHelpPage.xhtml v modulu plug-in org.xxx.yyy.somePluginId.

Výše uvedený příspěvek vkládá obsah souboru XHTML topicA.xhtml na cílovou stránku systému nápovědy určenou atributem path. V tomto případě bude rozšíření obsahu vloženo do umístění kotvy s názvem topicAnchor na stránce someHelpPage.xhtml v modulu plug-in org.xxx.yyy.somePluginId.

Pro použití tohoto bodu rozšíření není třeba žádný kód. Stačí pouze dodat vhodné soubory s obsahem uvedené v souboru plugin.xml.

Výchozí implementace základního systému nápovědy poskytovaná s platformou Eclipse plně podporuje tento bod rozšíření contentExtension.