Índice de Documentação Pré-construído

Quando o usuário pesquisa por conteúdo de ajuda de um produto, a pesquisa é executada no índice de uma documentação.  Por padrão, esse índice  é criado na primeira chamada da pesquisa de ajuda, mas pode ser pré-construído e entregue ao usuário com um produto.  Isso evita que a indexação ocorra na máquina do usuário e permite que o usuário obtenha os primeiros resultados da pesquisa mais rapidamente.

Construindo um Índice para um Produto

Para construir um índice, siga essas etapas:

Por exemplo, a execução de

eclipse -nosplash -application org.eclipse.help.indexTool -vmargs -DindexOutput=d:/build/com.my.plugin -DindexLocale=en

resultará na gravação do arquivo doc_index.zip no diretório nl/en que será criado em d:/build/com.my.plugin.  O arquivo zip conterá um índice do conteúdo dos documentos que estão disponíveis aos usuários quando eles executam o produto no locale en.

Empacotamento e Instalação do Índice Pré-construído

Os índices pré-construídos, os arquivos de doc_index.zip, precisam ser empacotados como um plug-in.   É possível escolher utilizar um plug-in associado ao recurso principal, ou escolher empacotar o índice para cada idioma em fragmentos separados.

Por exemplo, se a documentação do produto estiver disponível em dois idiomas, digamos inglês e alemão, um plug-in com.my.plugin pode ter a seguinte estrutura:
com.my.plugin/
plugin.xml
nl/
de/
doc_index.zip
en/
doc_index.zip
outros arquivos desse plug-in

O ID do plug-in precisa se especificado como uma preferência de productIndex para o plug-in org.eclipse.help.  Para o plug-in no exemplo acima, o arquivo plugin_customization.ini precisa conter a entrada
org.eclipse.help/productIndex=com.my.plugin


Copyright IBM Corporation e outros 2000, 2003.