[xml][dita]OTでJavaHelpをパブリッシュして開いてみる

DITA Open ToolkitのためにJavaHelpをインストールします。

OT公式ドキュメント"Installing and upgrading DITA Open Toolkit"
(installing_map.pdf)に、JavaHelpのインストール方法がありますが、
配布元の情報が古いので、以下のようにしてください。

前提ソフトウェア
---------------------
DITA Open Toolkit 1.5.2 M7

入手とインストール
---------------------

1. JavaHelpプロジェクトのサイトに行く。URL: https://javahelp.dev.java.net/
2. "Download the Latest JavaHelp System Build"のセクションまでスクロールする。
3. "To download the latest JavaHelp system build, click here."の"here"をクリックする。
4. 今日現在では以下のリンクになっている。
   http://download.java.net/javadesktop/javahelp/javahelp2_0_05.zip
5. zipを解凍して C:\javahelp\jh2.0 に保存する。

環境変数の設定
---------------------
環境変数JHHOMEに C:\javahelp\jh2.0 を設定する。
これは startcmd.bat に書いてもいいです。
build_dita2javahelp.xmlは環境変数JHHOMEを見て動きますから必ずやってください。

---
<target name="compile.Java.Help"
    if="env.JHHOME"
    description="Compile Java Help output">
  <!-- delete 'JavaHelpSearch' directory before compiling. -->
  <condition property="compile.dir" value="${dita.map.output.dir}">
    <isset property="old.transform"/>
  </condition>
  <condition property="compile.dir" value="${output.dir}">
    <isset property="inner.transform"/>
  </condition>
  <delete dir="${compile.dir}${file.separator}JavaHelpSearch" />
  <java jar="${env.JHHOME}${file.separator}javahelp${file.separator}bin${file.separator}jhindexer.jar"
      fork="true"
      dir="${compile.dir}">
    <arg value="." />
  </java>
</target>
---

サンプルからJavaHelpをパブリッシュ
----------------------------------
{DITA-OT}\startcmd.bat をダブルクリック。
コマンドを叩く。
> ant -f build_demo.xml samples.javahelp -v

vオプションを付けて冗長メッセージにしたので、ビルドの最後の方で
compile.Java.Helpタスクが動いたっぽい形跡がわかるはずです。
（ちなみに私の環境ではJ:ドライブです。）
---
compile.Java.Help:
   [delete] Deleting directory J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\DOCS
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\DOCS.TAB
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\OFFSETS
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\POSITIONS
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\SCHEMA
   [delete] Deleting J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch\TMAP
   [delete] Deleting directory J:\DITA-OT1.5.2\out\samples\javahelp\JavaHelpSearch
     [java] Executing 'C:\Program Files\Java\jre6\bin\java.exe' with arguments:
     [java] '-jar'
     [java] 'J:\javahelp\jh2.0\javahelp\bin\jhindexer.jar'
     [java] '.'
     [java]
     [java] The ' characters around the executable and arguments are
     [java] not part of the command.
---

JavaHelpビューワーで見てみる
----------------------------
J:ドライブにすべてインストールされているものとして説明します。

1. J:\javahelp\jh2.0\demos\bin\hsviewer.jar をダブルクリック。
2. HelpSet URLにチューザーから J:\DITA-OT1.5.2\out\samples\javahelp\hierarchy_helpset.hs を選ぶ。

3. [Display]ボタンをクリック。
4. おなじみのGarage SampleがJavaHelpとなって出現するはず。