Súgótartalom kiterjesztése

org.eclipse.help.contentExtension

Ez a kiterjesztési pont a dinamikus és újra felhasználható tartalom támogatására szolgál a súgórendszer oldalain. Lehetővé teszi tartalom meglévő súgórendszer oldalhoz adását. A súgórendszer minden XHTML oldala "meghatározhatja", hogy el tudja fogadni a tartalokiegészítéseket ezen kiegészítési pontok explicit megadásával az anchor elem segítségével. Az XHTML részletek ezután futás közben dinamikusan beilleszthetők ezekbe a dokumentumokba.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Tartalomkiterjesztéseket ad meg legalább egy súgórendszer oldalhoz. A tartalomkiterjesztési fájl helyét a file attribútum adja meg.



Az alábbiakban egy példa látható az Extension kiterjesztési pont használatára:

(a plugin.xml fájlban)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(a contentExtensionFile.xml fájlban)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

A fenti hozzáadás beszúrja a topicA.xhtml XHTML fájl tartalmát a a path attribútum által megadott cél súgórendszer oldalba. Ebben az esetben a tartalomkiterjesztés a topicAnchor nevű horgony helyére kerül beszúrásra a someHelpPage.xhtml oldalon az org.xxx.yyy.somePluginId bedolgozóban.

A fenti hozzáadás beszúrja a topicA.xhtml XHTML fájl tartalmát a a path attribútum által megadott cél súgórendszer oldalba. Ebben az esetben a tartalomkiterjesztés a topicAnchor nevű horgony helyére kerül beszúrásra a someHelpPage.xhtml oldalon az org.xxx.yyy.somePluginId bedolgozóban.

A kiterjesztési pont használatához nem szükséges kód. Mindössze a plugin.xml fájlban említett megfelelő tartalomfájlokat kell biztosítani.

Az Eclipse környezettel biztosított alap súgórendszer alapértelmezett megvalósítása teljes mértékben támogatja a contentExtension kiterjesztési pontot.