Estensioni del contenuto della guida

org.eclipse.help.contentExtension

Questo punto di estensione supporta il contenuto dinamico e riutilizzabile nelle pagine della guida. Consente di aggiungere contenuto a una pagina esistente della guida. Qualsiasi pagina XHTML nella guida può "dichiarare" che accetta aggiunte al contenuto specificando esplicitamente questi punti mediante l'elemento anchor. I frammenti XHTML possono quindi essere dinamicamente inseriti in questi documenti al runtime.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Definisce l'estensione del contenuto in una o più pagine della guida. Il percorso del file di estensione del contenuto è specificato dall'attributo file.



Di seguito è riportato un esempio di utilizzo del punto di estensione contentExtension.

(nel file plugin.xml).

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(nel file contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

Il contributo precedente inserisce il contenuto del file XHTML, topicA.xhtml, nella pagina della guida di destinazione specificata dall'attributo path. In questo caso, l'estensione del contenuto verrà inserita nel percorso di un anchor chiamato topicAnchor nella pagina someHelpPage.xhtml nel plugin org.xxx.yyy.somePluginId.

Il contributo precedente inserisce il contenuto del file XHTML, topicA.xhtml, nella pagina della guida di destinazione specificata dall'attributo path. In questo caso, l'estensione del contenuto verrà inserita nel percorso di un anchor chiamato topicAnchor nella pagina someHelpPage.xhtml nel plugin org.xxx.yyy.somePluginId.

Non è richiesto alcun codice per questo punto di estensione. Occorre soltanto fornire i file content appropriati, menzionati nel file plugin.xml.

L'implementazione predefinita della guida di base fornita con la piattaforma Eclipse supporta completamente questo punto di estensione contentExtension.