Extensie voor Help-content

org.eclipse.help.contentExtension

Dit extensiepunt levert ondersteuning voor dynamische en herbruikbare content in pagina's van een Help-systeem. Er kan ook content worden aangeleverd voor een bestaande pagina van een Help-systeem. In een XHTML-pagina van het Help-systeem kan worden aangegeven dat contentaanleveringen zijn toegestaan door deze aanleveringspunten expliciet op te geven met het element anchor. Vervolgens kunnen XHTML-fragmenten tijdens runtime dynamisch in deze documenten worden ingevoegd.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definieert een contentuitbreiding voor een of meer pagina's van het Help-systeem. De locatie van het bestand met de contentuitbreiding staat in het kenmerk file.



Dit is een voorbeeld van de extensie contentExtension:

(in bestand plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(in bestand contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

In de bovenstaande aanlevering wordt de content van het XHTML-bestand topicA.xhtml ingevoegd in de doelpagina van het Help-systeem die met het kenmerk path is opgegeven. In dit geval wordt de contentuitbreiding ingevoegd op de locatie van het anker topicAnchor van de pagina someHelpPage.xhtml in de plugin org.xxx.yyy.somePluginId.

In de bovenstaande aanlevering wordt de content van het XHTML-bestand topicA.xhtml ingevoegd in de doelpagina van het Help-systeem die met het kenmerk path is opgegeven. In dit geval wordt de contentuitbreiding ingevoegd op de locatie van het anker topicAnchor van de pagina someHelpPage.xhtml in de plugin org.xxx.yyy.somePluginId.

Voor dit extensiepunt is geen code nodig. U hoeft alleen de gewenste contentbestanden uit het bestand plugin.xml aan te leveren.

De standaardimplementatie van het Help-basissysteem dat door het Eclipse-platform wordt geleverd, biedt volledige ondersteuning voor het extensiepunt contentExtension.