Page 1 of 1

How to add a custom skin to a DITA OT process

Posted: Fri Oct 02, 2015 12:24 pm
by Glimmerino
Hello.

I have created a custom skin from the webhelp skin builder. I want to use this skin in my DITA OT build process. (I have purchased the webhelp plugins separately)
How do I install the new skin and how do I set the parameter -Dwebhelp.skin.css="url to the skin location"?

I don't want to go via Oxygen since I have my own build process.

Best regards

Re: How to add a custom skin to a DITA OT process

Posted: Fri Oct 02, 2015 9:39 pm
by adrian
Hi,

You have to save the CSS with the custom skin in the file system and indicate the path to it (a URL won't work) in the value of that parameter from the command line:
-Dwebhelp.skin.css=/path/to/my/custom.css

Regards,
Adrian

Re: How to add a custom skin to a DITA OT process

Posted: Fri Oct 02, 2015 11:20 pm
by Glimmerino
Hi.

Yes, but to which build file does that parameter go? Is it to the "build.xml" in the Dita source folder? Or is it to any other build file?

/Kristian

Re: How to add a custom skin to a DITA OT process

Posted: Mon Oct 05, 2015 10:30 am
by bogdan_cercelaru
Hi,

Depending on your operating system, you should open the "dita.bat" or "dita.sh" file from the "com.oxygenxml.webhelp" plugin directory and edit the line that starts with "-Dwebhelp.skin.css". If you cannot find it, please add this line at the and of your file:

Code: Select all

-Dwebhelp.skin.css=/path/to/my/custom.css
Please note that you need at least version 16.0 of the WebHelp plugin to use a custom skin file.

Regards,
Bogdan

Re: How to add a custom skin to a DITA OT process

Posted: Mon Oct 05, 2015 11:08 am
by Glimmerino
Hi.

This doesnt work since I dont think build.sh is part of my build process, nor should it be.

The build process goes as follows.

<my own ant build script> --> <dita.dir/build.xml (transtype=webhelp)> --> <dita.dir/plugins/com.oxygenxml.webhelp/build.dita.xml>

Where does the parameter "-Dwebhelp.skin.css" go if only using these scripts?

/Kristian

Re: How to add a custom skin to a DITA OT process

Posted: Wed Oct 07, 2015 10:51 am
by bogdan_cercelaru
Hi,

We've already discussed this in private, but in case anyone else needs to do this from an ANT build script, it should contain something like:

Code: Select all


<target name="build.webhelp">
<ant antfile="${dita.dir}/build.xml">
<property name="args.input" location="${basedir}/in/project.ditamap"/>
<property name="output.dir" location="${basedir}/out/webhelp"/>
<property name="transtype" value="webhelp"/>
...
<property name="webhelp.skin.css" value="${path.to.skin.css}"/>
...
</ant>
</target>
Regards,
Bogdan