Ohjesisällön laajennus

org.eclipse.help.contentExtension

Tämä laajennuspiste tukee dynaamista ja uudelleen käytettävää sisältöä ohjejärjestelmän sivuilla. Sen avulla voi lisätä sisältöä aiemmin luodulle ohjejärjestelmän sivulle. Jokainen ohjejärjestelmän XHTML-sivu voi esitellä, että se voi hyväksyä sisällönlisäyksiä määrittämällä nämä lisäyspisteet erikseen anchor-elementin avulla. XHTML-katkelmat voi sitten lisätä dynaamisesti näihin asiakirjoihin ajonaikaisesti.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Määrittää ohjejärjestelmän yhden tai usean sivun sisältölaajennuksen. Sisältölaajennustiedoston sijainti on määritetty määritteen file avulla.



Seuraavassa on esimerkki laajennuspisteen contentExtension käytöstä.

(Määritystiedosto plugin.xml.)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(tiedostossa contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

Edellinen lisäys lisää XHTML-tiedoston, topicA.xhtml, sisällön kohteena olevaan ohjejärjestelmään sivuun, joka on määritetty määritteessä path. Tässä tapauksessa sisältölaajennus lisätään ankkurisijaintiin topicAnchor sivulla someHelpPage.xhtml lisäosassa org.xxx.yyy.somePluginId.

Edellinen lisäys lisää XHTML-tiedoston, topicA.xhtml, sisällön kohteena olevaan ohjejärjestelmään sivuun, joka on määritetty määritteessä path. Tässä tapauksessa sisältölaajennus lisätään ankkurisijaintiin topicAnchor sivulla someHelpPage.xhtml lisäosassa org.xxx.yyy.somePluginId.

Tämän laajennuspisteen käyttö ei edellytä koodia. Riittää, että plugin.xml-tiedoston mukaiset sisältötiedostot on luotu.

Eclipse-käyttöympäristön mukana toimitettava perusohjejärjestelmän oletustoteutus tukee contentExtension-laajennuspistettä.