Page 1 of 1

How to teach oXygen "HTML Help Workshop" path?

Posted: Wed Nov 05, 2014 5:48 pm
by 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

Re: How to teach oXygen "HTML Help Workshop" path?

Posted: Thu Nov 06, 2014 9:21 am
by 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

Re: How to teach oXygen "HTML Help Workshop" path?

Posted: Thu Nov 06, 2014 12:45 pm
by 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