How to add a custom skin to a DITA OT process

[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

[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

[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

[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

[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

[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