Concluindo o Plug-in Manifest

Começamos esse exemplo criando nosso plug-in e arquivos de documento. Em seguida, criamos arquivos toc para descrever a organização de nosso conteúdo. A parte que sobrou do trabalho é reunir tudo em um toc master e atualizar nosso plugin.xml para realmente contribuir com o toc master. 

Iniciamos criando um toc.xml para contribuir com os três tocs criados inicialmente.  Em vez de fornecer um href para cada tópico, utilizaremos o atributo link para fazer referência aos arquivos toc existentes.

<toc label="Exemplo de Ajuda Online">
	<topic label="Conceitos">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Tarefas">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Referência">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

Em seguida, atualizamos o plugin.xml para que contribua com o toc master:

   <extension point="org.eclipse.help.toc">
      <toc file="toc.xml" primary="true" />
   </extension>

Observe o uso do atributo primary.  Defini-lo como true indica que o toc deve sempre aparecer na navegação, mesmo quando não referido por outro toc.  Dessa maneira, nosso toc "master" sempre será exibido na lista de tópicos.  Ele aparecerá na lista de nível superior de manuais, desde que nenhum toc faça referência a ele.  

Finalmente, contribuímos com nossos arquivos toc individuais.

   <extension point="org.eclipse.help.toc">
       <toc file="toc_Concepts.xml" />
       <toc file="toc_Tasks.xml" />
       <toc file="toc_Reference.xml" />
   </extension>

Esses arquivos toc não aparecerão na lista de nível superior de manuais porque não definimos o atributo primary.  Os arquivos toc que não são designados como principais aparecerão na documentação da Web se forem referidos por algum toc que seja principal ou que esteja com link estabelecido por um toc principal.

É isso. Se você copiar seu diretório de plug-in para o diretório plugins da plataforma, inicie a plataforma e escolha Ajuda->Conteúdo da Ajuda; seu exemplo deverá aparecer na lista infoview de manuais:

Lista de manuais com entrada de exemplo

 

Se você clicar no "Exemplo de Ajuda Online", verá a estrutura do toc.

Navegador da ajuda online com exemplo de estrutura de manuais

Copyright IBM Corp. e outros 2000,2002.