Custom transtype for web help

[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.

[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!

[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.

[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?