본문 바로가기

개발환경/이클립스

RCP 도움말 초기 페이지 조작하기

RCP(Rich Client Platform)에서 도움말 초기 페이지를 변경해야 할 때가 있습니다.
기본 초기 페이지는 /org.eclipse.help.base/doc/help_home.html 이며 아래 내용과 같이 도움말 사용법을 설명하고 있습니다.

이클립스에 익숙한 우리와 달리 고객은 이 페이지 보다는 제품의 도움말로 바로 가기를 원할 것입니다. 

방법은 간단합니다. 아래와 같이 Extensions 탭에서 org.eclipse.core.runtime.products 를 확장한 곳에서 preferenceCustomization 를 지정한 후에 이곳에서 특정 속성을 재지정(오버라이드)하면 됩니다.

plugin.xml 파일
...
   <extension
         id="product"
         point="org.eclipse.core.runtime.products">
      <product
            application="kr.flowerteam.blooma.application"
            name="Flowerteam Blooma">
         ...
         <property
               name="preferenceCustomization"
               value="plugin_customization.ini">
         </property>
         ...
      </product>
   </extension>
...


plugin_customization.ini
...
# help system override.
#org.eclipse.help.base/help_home = /kr.flowerteam.blooma.help/html/toc.htm
# show the first help contents.
org.eclipse.help.base/help_home = /../nav/0

위에서 두가지 방식을 보여주고 있는데 첫번째는 특정 자원을 지정하는 방식 즉, html 파일을 직접 지정하는 방식이고 두번째는 #show the first help contents. 라고 주석을 달아 놓은 것처럼 help system에 의해 생성되는 컨텐츠 목록의 첫번째를 보여줍니다. 그닥 중요하지는 않지만 둘사이에는 미묘한 차이가 있으므로 확인해 보시기 바랍니다. 두번째 방식은 목차를 생성하는 도움말 기능을 이해하면 될 것 같습니다.

참고: