How to teach oXygen "HTML Help Workshop" path?

[Frank Ralf]

Hi,

According to Compiled HTML Help (CHM) Output Format, "Oxygen XML Author automatically detects HTML Help Workshop and uses it." HTML Help Workshop is installed on my system but oXygen doesn't find it. Is there a way to teach oXygen the correct location, for example by setting an environment variable or a transformation parameter?

Kind regards,
Frank

[Radu]

Hi Frank,

Sorry for the delay, we missed this one.
If you look in the build file which starts the HTML Help Workshop:

OXYGEN_INSTALL_DIR/frameworks/dita/DITA-OT/plugins/org.dita.htmlhelp/build_dita2htmlhelp.xml

it has two targets which try to detect where the Workshop is located:

Code: Select all

  <target name="use-init.envhhcdir" if="env.HHCDIR">

    <available file="${env.HHCDIR}${file.separator}hhc.exe" property="HTMLHelpCompiler"

               value="${env.HHCDIR}${file.separator}hhc.exe"/>

  </target>

  

  <target name="use-init.hhcdir" unless="env.HHCDIR">

    <condition property="hhc.dir" value="C:\Program Files (x86)\HTML Help Workshop" else="C:\Program Files\HTML Help Workshop">

      <available file="C:\Program Files (x86)\HTML Help Workshop" type="dir"/>

    </condition>

    <available file="${hhc.dir}${file.separator}hhc.exe" property="HTMLHelpCompiler"

               value="${hhc.dir}${file.separator}hhc.exe" />

  </target>

So either the HHCDIR environmental variable is set in the system where Oxygen is started or otherwise the workshop is searched for in the Program Files folder in a certain places.

Regards,
Radu

[Frank Ralf]

Hi Radu,

Thanks for this thorough explanation. At first sight it looks as if oXygen is looking in the right places. I will investigate further and report back.

Kind regards,
Frank