Extensión de contenido de la ayuda

org.eclipse.help.contentExtension

Este punto de extensión proporciona soporte para un contenido dinámico y reutilizable de las páginas del Sistema de ayuda. Permite contribuir con contenido a una página existente del Sistema de ayuda. Cualquier página XHTML del Sistema de ayuda puede "declarar" que puede aceptar contribuciones de contenido especificando explícitamente estos puntos de contribución mediante un elemento anchor. Los fragmentos de código XHTML pueden insertarse dinámicamente en estos documentos en tiempo de ejecución.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Define la extensión de contenido para una o varias páginas del Sistema de ayuda. La ubicación del archivo de extensión de contenido se especifica mediante el atributo file.



A continuación figura un ejemplo de utilización del punto de extensión contentExtension

(en el archivo plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(en el archivo contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

La contribución anterior inserta el contenido del archivo XHTML, topicA.xhtml, en la página del Sistema de ayuda destino especificada por el atributo path. En este caso, la extensión de contenido se insertará en la ubicación de un ancla llamada topicAnchor en la página someHelpPage.xhtml, en el plug-in org.xxx.yyy.somePluginId.

La contribución anterior inserta el contenido del archivo XHTML, topicA.xhtml, en la página del Sistema de ayuda destino especificada por el atributo path. En este caso, la extensión de contenido se insertará en la ubicación de un ancla llamada topicAnchor en la página someHelpPage.xhtml, en el plug-in org.xxx.yyy.somePluginId.

No se necesita código adicional para utilizar este punto de extensión. Tan solo hay que suministrar los archivos de contenido apropiados que se mencionan en el archivo plugin.xml.

La implementación predeterminada del sistema de ayuda base proporcionada por la plataforma Eclipse soporta totalmente el punto de extensión contentExtension.