XMLMind’s ditac test converter is a free, open source software to generate production quality deliverables out of the box. Using command line utility you can supply number of parameters supported by XSLT stylesheets. Here is a small demonstration on customising webhelp output by using various jquery themes.
Generate DITA webhelp output using ditac
Using following command-line you can generate web help output.
command-line option -format specifies output format, here we have need webhelp output format.
Make sure you specify desired output directory along with _.html to specify the file extension of generated files for webhelp output. For this example we will use taskbook.ditamap that is available as a sample ditamap.
The default output as a result of a ditac command-line mentioned above is shown on left.
Now, lets change the look of webhelp output by using different jquery theme. You can use command-line parameter wh-jquery-theme to specify which theme you want to see your generated output in?
Bydefault ‘smoothness’ jquery theme is used for webhelp output.Here, we have changed it to ‘redmond’. Take a look at the change in the output.
Similarly you can use any of jquery themes listed here
Here is result of swanky-purse jquery theme!
Now, you may need to create your own theme that matches with corporate identity of your company.
Create your own custom jquery theme
All you need to do is create your own custom jquery-css and specify the path of that jquery-css as a parameter while generating webhelp output using ditac command-line.
Remember, when wh-jquery-css parameter is used wh-jquery-theme parameter will be ignored. Moreover, place your custom jquery css into resources subdirectory of your output directory to make everything portable.
Finally, do not forget to copy all the images used in the source dita files into the output directory by using -images as follows
-images option will copy all the images from source file into the img subdirectory of output directory.