Page 1 of 1

Accessing custom WebHelp responsive templates from custom framework

Posted: Fri Sep 29, 2017 11:12 pm
by jlowther
I am using oXygen 18.1.

I have a custom DITA framework:
Oxygen/frameworks/xyz_dita

The framework contains its own DITA-OT engine:
Oxygen/frameworks/xyz_dita/DITAOT

I use the following plugin:
Oxygen/frameworks/xyz_dita/DITAOT/plugins/com.xyz.webhelp-responsive

I would like to specify custom WebHelp responsive templates for the plugin, so, using the instructions in https://www.oxygenxml.com/doc/versions/ ... ation.html, I added the following folder:
Oxygen/frameworks/xyz_dita/DITAOT/plugins/com.oxygenxml.webhelp/templates/dita/myTemplate/

However, I cannot access the custom templates. It seems that oXygen does not see them in the DITA-OT engine for my framework. I have tried searching for them when I create a scenario in the Transformation tab of the document type association.

How can I access these templates from my custom framework and separate DITA-OT engine?

Re: Accessing custom WebHelp responsive templates from custom framework

Posted: Tue Oct 03, 2017 4:26 pm
by alin
Hello,

The templates presented in the WebHelp Responsive Scenario dialog are loaded from the following loacation:
{DITA_OT_DIR}/plugins/com.oxygenxml.webhelp/templates/dita

Please make sure that the DITA Open Toolkit option (from the Options > Preferences > DITA preferences page) points to your custom DITA-OT distribution (i.e.: Oxygen/frameworks/xyz_dita/DITAOT).

jlowther wrote:I use the following plugin:
Oxygen/frameworks/xyz_dita/DITAOT/plugins/com.xyz.webhelp-responsive

Furthermore, please make sure that you do not change the name of the WebHelp plugin's directory (it should be com.oxygenxml.webhelp).

Also, the directories structure and the resources names under the template directory are very important and should look like this:
{template-name}/variants/{variant-name}/{skin-name}/skin.css

For example: myTemplate/variants/myVariant/mySkin/skin.css
In this case you should see a "mySkin" entry in the Templates Tab of the WebHelp Responsive Scenario dialog. To easily identify your skin in the scenario dialog you can add a "skin.png" preview image in the skin's directory.

See also: https://www.oxygenxml.com/doc/versions/ ... uyh_x33_kv

Regards,
Alin