Page 1 of 1

Custom transtype for web help

Posted: Mon Jul 17, 2017 10:37 pm
by jlowther
I am using Oxygen 18 on Windows.

I am trying to override the default output that I get from the webhelp-responsive transtype using the instructions provided here:
https://www.oxygenxml.com/doc/versions/ ... hing2.html

I created all of the files exactly as described. I also created a new transformation scenario with the transtype specified as "webhelp-responsive-custom", that is:
DITA-OT2.x/plugins/com.oxygenxml.webhelp.responsive.custom/build.xml
DITA-OT2.x/plugins/com.oxygenxml.webhelp.responsive.custom/integrator.xml
DITA-OT2.x/plugins/com.oxygenxml.webhelp.responsive.custom/plugin.xml
DITA-OT2.x/plugins/com.oxygenxml.webhelp.responsive.custom/xsl/createMainFilesCustom.xml
DITA-OT2.x/plugins/com.oxygenxml.webhelp.responsive.custom/xsl/dita2webhelpCustom.xml

However, when I run the transform, I get error messages. The last line is
build_dita.xml:338: stylesheet C:\Users\id\git\user_doc\en-us\${dita.plugin.com.oxygenxml.webhelp.responsive.custom.dir}\xsl\dita2webhelpCustom.xsl doesn't exist.

Based on this message, it appears that oXygen is looking in input directory (the source dita map that I am trying to transform) for the custom file. It should be looking in the DITA-OT directory.

Is this a bug or is my version of oXygen not compatible with this procedure? Thanks.

Re: Custom transtype for web help

Posted: Tue Jul 18, 2017 3:48 pm
by radu_pisoi
Hi,

I've followed the instructions from the procedure and I've obtained the same error like you.

The issue is inside the documentation procedure. The macro that points to the plugin's directory is wrong, it should be ${dita.plugin.com.oxygenxml.webhelp.responsive.customization.dir} instead of ${dita.plugin.com.oxygenxml.webhelp.responsive.custom.dir}.

Code: Select all


 <property
name="args.wh.xsl"
value="${dita.plugin.com.oxygenxml.webhelp.responsive.customization.dir}/xsl/dita2webhelpCustom.xsl"/>
I will register an issue to fix this problem in our documentation.

Thank you for reporting this problem!

Re: Custom transtype for web help

Posted: Wed Jul 19, 2017 9:56 pm
by jlowther
I have noted the error in the directory name and corrected my files.

I have followed the steps to create customized webhelp and webhelp-responsive output as described on this page:
https://www.oxygenxml.com/doc/versions/ ... omizatione

I am able to get the desired results from the customized "webhelp" (that is, Classic) type.

However, when I generate output for "webhelp-responsive", the build completes (although it takes a long time), and the output I get is not usable. The index.html file appears to be a copy of plugins/com.oxygenxml.webhelp/xsl/dita/responsive/createMainFiles.xsl. There is no TOC or any topic content.

Is there a bug registered for customizing webhelp-responsive? Does my version of oXygen (v18) not support it? Thanks.

Re: Custom transtype for web help

Posted: Thu Jul 20, 2017 12:05 pm
by radu_pisoi
Hi,

We are not aware of a such issue. Maybe the problem is inside your customization.
Could you send us your customization on support@oxygenxml.com and a short description for it?