사전 빌드된 문서 색인

사용자가 제품의 도움말 목차를 검색할 때 검색은 문서 색인에서 수행됩니다.  기본적으로 이 색인은 도움말 검색을 처음 호출할 때 만들어지지만, 사전에 빌드되어 각각의 플러그인과 함께 사용자에게 제공될 수 있습니다. 3.1 이후로는 제품에 대한 완전한 색인으로 제공될 수 있습니다.  이렇게 하면 사용자 시스템에서 색인을 빌드하지 않아도 되고 사용자가 처음 검색 결과를 더 빨리 얻을 수 있습니다.

플러그인에 대한 문서 색인 빌드

색인을 빌드하려면 다음 단계를 수행하십시오.

제품의 색인 빌드

제품 단위 색인은 제품에 있는 모든 문서에 대한 하나의 집계 색인입니다. 이 색인은 문서 플러그인 세트가 변경되지 않는 시나리오에서 사용해야 합니다. 예를 들어, Information Center 설치는 제품 단위 색인을 사용할 경우 이익입니다.

색인을 빌드하려면 다음 단계를 수행하십시오.

예를 들면, 다음 명령을 실행하면

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

doc_index.zip 파일이 d:/build/com.my.plugin 아래의 nl/en 디렉토리에 저장됩니다. 이 파일에는 사용자가 en 로케일에서 제품을 실행할 때 사용 가능한 문서 내용의 색인이 들어 있습니다.

제품의 사전 빌드된 색인 패키징 및 설치

사전 빌드된 색인이 들어 있는 doc_index.zip 파일은 플러그인으로 패키징되어야 합니다.   기본 기능과 연관된 플러그인을 사용하거나 각 언어의 색인을 독립적인 단편으로 패키징하는 방법을 선택할 수 있습니다.

예를 들어 제품 문서가 영어, 독어 및 중국어와 같이 세 가지 언어로 사용할 경우 com.my.plugin 플러그인 구조는 다음과 같습니다.
com.my.plugin/
plugin.xml
nl/
de/
doc_index.zip
en/
doc_index.zip
zh/
CN/
doc_index.zip
other files of this plugin

플러그인 ID는 org.eclipse.help.base 플러그인에서 productIndex 환경 설정으로 지정해야 합니다.  위의 예제에 있는 플러그인의 경우 다음과 같이 plugin_customization.ini 파일에 해당 항목이 들어 있어야 합니다.
org.eclipse.help.base/productIndex=com.my.plugin