Extensão do Índice da Ajuda

org.eclipse.help.contentExtension

Este ponto de extensão têm como função o suporte de conteúdos dinâmicos e reutilizáveis nas páginas Sistema de Ajuda. Permite a contribuição de conteúdos numa página Sistema de Ajuda existente. Uma página XHTML no sistema Ajuda pode "declarar" que pode aceitar contribuições de conteúdo ao especificar explicitamente estes pontos de contribuição através da utilização do elemento anchor. Os fragmentos do XHTML podem ser inseridos dinamicamente nestes documentos em 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 a extensão do conteúdo de uma ou mais página Sistema de Ajuda. A localização do ficheiro de extensão do conteúdo é especificada pelo atributo file.



De seguida é apresentado um exemplo de como utilizar o ponto de extensão contentExtension.

(no ficheiro plugin.xml)

 

<extension point=

"org.eclipse.help.contentExtension"

>

<contentExtension file=

"contentExtensionFile.xml"

/>

</extension>

(no ficheiro contentExtensionFile.xml)

<contentExtension>

<topicExtension content=

"xhtml/topicA.xhtml"

path=

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

/>

</contentExtension>

A contribuição apresentada acima insere o conteúdo do ficheiro XHTML, topicA.xhtml, na página Sistema de Ajuda de destino especificada pelo atributo path. Neste caso, a extensão do conteúdo será inserida na localização de uma âncora denominada topicAnchor na página someHelpPage.xhtml no plug-in org.xxx.yyy.somePluginId.

A contribuição apresentada acima insere o conteúdo do ficheiro XHTML, topicA.xhtml, na página Sistema de Ajuda de destino especificada pelo atributo path. Neste caso, a extensão do conteúdo será inserida na localização de uma âncora denominada topicAnchor na página someHelpPage.xhtml no plug-in org.xxx.yyy.somePluginId.

Não é necessário nenhum código para utilizar este ponto de extensão. É apenas necessário facultar os ficheiros de conteúdo adequados mencionado no ficheiro plugin.xml.

A implementação predefinida do sistema de ajuda de base facultada com a plataforma Eclipse suporta totalmente o ponto de extensão contentExtension.