Udvidelse til hjælpeindhold

org.eclipse.help.contentExtension

Dette udvidelsespunkt er til understøttelse af dynamisk og genbrugeligt indhold på siderne i hjælpen. Det tillader levering af indhold til en eksisterende side i hjælpen. Ethver XHTML-side i hjælpen kan "erklære", at den kan acceptere indholdsbidrag ved eksplicit at angive disse bidragspunkter vha. elementet anker. XHTML-stykker kan derefter blive dynamisk indsat i disse dokumenter under runtime.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST-udvidelse

point CDATA #REQUIRED

id    CDATA #IMPLIED

navn  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definerer indholdsudvidelser til en eller flere sider i hjælpen. Placeringen af indholdsudvidelsesfilen er angivet af attributten file.



Nedenfor er et eksempel på anvendelse af udvidelsespunktet 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 ovenfor indsætter indholdet af XHTML filen topicA.xhtml på målsiden i hjælpen, der er angivet med attributten path. I dette tilfælde indsættes indholdsudvidelsen på placeringen af ankret topicAnchor på siden someHelpPage.xhtml i plugin'en org.xxx.yyy.somePluginId.

Bidraget ovenfor indsætter indholdet af XHTML filen topicA.xhtml på målsiden i hjælpen, der er angivet med attributten path. I dette tilfælde indsættes indholdsudvidelsen på placeringen af ankret topicAnchor på siden someHelpPage.xhtml i plugin'en org.xxx.yyy.somePluginId.

Der kræves ingen kode for at anvende dette udvidelsespunkt. Det er kun nødvendigt at levere de relevante indholdsfiler, der er nævnt i filen plugin.xml.

Standardimplementeringen af basishjælpen, der leveres sammen med Eclipse-platformen, understøtter udvidelsespunktet til contentExtension.