Utvidelse av hjelpeinnhold

org.eclipse.help.contentExtension

Dette utvidelsespunktet er for støtte av dynamisk og gjenbrukbart innhold på sidene i hjelpesystemet. Det gjør det mulig å bidra med innhold på en eksisterende hjelpeside. Enhver XHTML-side i hjelpesystemet kan "deklarere" at den kan godta innholdsbidrag ved eksplisitt å spesifisere disse bidragspunktene ved hjelp av et anchor-element. XHTML-snutter kan så settes inn dynamisk i disse dokumentene under kjøring.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definerer innholdsutvidelsen til en eller flere hjelpesider. Plasseringen til innholdsutvidelsesfilen spesifiseres ved attributtet file.



Her finner du et eksempel på bruken av utvidelsespunktet contentExtension:

(i filen plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(i filen contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

Bidraget over setter inn innholdet i XHTML-filen topicA.xhtml på den siden i målhjelpesystemet som er angitt ved attributtet path. I dette tilfellet blir innholdsutvidelsen satt inn i plasseringen av et anker kalt topicAnchor på siden someHelpPage.xhtml i plugin-modulen org.xxx.yyy.somePluginId.

Bidraget over setter inn innholdet i XHTML-filen topicA.xhtml på den siden i målhjelpesystemet som er angitt ved attributtet path. I dette tilfellet blir innholdsutvidelsen satt inn i plasseringen av et anker kalt topicAnchor på siden someHelpPage.xhtml i plugin-modulen org.xxx.yyy.somePluginId.

Det er ikke nødvendig med kode for å bruke dette utvidelsespunktet. Alt som trengs, er at du oppgir riktige innholdsfiler nevnt i filen plugin.xml.

Standardimplementeringen av basishjelpesystemet som følger med Eclipse-plattformen, støtter fullt ut dette utvidelsespunktet contentExtension.