Utökning av hjälpinnehåll

org.eclipse.help.contentExtension

Den här utökningspunkten gör det möjligt att använda dynamiskt och återanvändbart innehåll på hjälpsystemsidor. Det går att lägga till innehåll på befintliga hjälpsystemsidor. En XHTML-sida i hjälpsystemet kan "deklarera" att den accepterar tillägg av innehåll genom att den explicit anger tilläggspunkter med ett anchor-element. XHTML-kodstycken kan sedan infogas dynamiskt i de här dokumenten under körning.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definierar innehållsutökning till en eller flera hjälpsystemsidor. Platsen för innehållsutökningsfilen anges av attributet file.



Här följer ett exempel på hur utökningspunkten contentExtension används.

(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>

I det ovanstående tillägget infogas innehållet i XHTML-filen topicA.xhtml på den målhjälpsystemsida som anges av attributet path. I det här fallet infogas innehållsutökningen på platsen för det ankare som heter topicAnchor på sidan someHelpPage.xhtml i insticksprogrammet org.xxx.yyy.somePluginId.

I det ovanstående tillägget infogas innehållet i XHTML-filen topicA.xhtml på den målhjälpsystemsida som anges av attributet path. I det här fallet infogas innehållsutökningen på platsen för det ankare som heter topicAnchor på sidan someHelpPage.xhtml i insticksprogrammet org.xxx.yyy.somePluginId.

Ingen kod behöver användas för den här utökningspunkten. Allt som behövs är att tillhandahålla lämpliga innehållsfiler som omnämns i filen plugin.xml.

Standardimplementeringen av bashjälpsystemet som tillhandahålls med Eclipse-plattformen har fullständiga funktioner för utökningspunkten contentExtension.