Extensão de Conteúdo da Ajuda

org.eclipse.help.contentExtension

Este ponto de extensão destina-se ao suporte de conteúdo dinâmico e reutilizável nas páginas do Sistema de Ajuda. Ele permite contribuir com conteúdo em uma página existente do Sistema de Ajuda. Toda página XHTML no sistema de ajuda pode "declarar" que aceita contribuições de conteúdo especificando explicitamente esses pontos de contribuição utilizando um elemento âncora. Snippets XHTML então podem ser inseridos dinamicamente nesses documentos no tempo de execução.

<!ELEMENT extension (contentExtension+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentExtension EMPTY>

<!ATTLIST contentExtension

file CDATA #REQUIRED>

Define extensão de conteúdo para uma ou mais páginas do sistema de ajuda. O local do arquivo de extensão de conteúdo é especificado pelo atributo file.



Segue um exemplo do uso do ponto de extensão contentExtension.

(no arquivo plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(no arquivo contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

A contribuição anterior insere o conteúdo do arquivo XHTML, topicA.xhtml, na página do sistema de ajuda de destino especificada pelo atributo path. Nesse caso, a extensão de conteúdo será inserida no local de uma âncora chamada topicAnchor, na página someHelpPage.xhtml, no plugin org.xxx.yyy.somePluginId.

A contribuição anterior insere o conteúdo do arquivo XHTML, topicA.xhtml, na página do sistema de ajuda de destino especificada pelo atributo path. Nesse caso, a extensão de conteúdo será inserida no local de uma âncora chamada topicAnchor, na página someHelpPage.xhtml, no plugin org.xxx.yyy.somePluginId.

Nenhum código é necessário para utilizar esse ponto de extensão. Tudo que é necessário é fornecer os arquivos de conteúdo apropriados mencionados no arquivo plugin.xml.

A implementação padrão do sistema de ajuda básico fornecido com a plataforma Eclipse suporta totalmente esse ponto de extensão contentExtension.