How to Copy Additional Resources to Output Directory
Edit online

You can copy additional resources (such as JavaScript, CSS or other resources) to the output directory of a WebHelp system by using the webhelp.custom.resources parameter.

Using Oxygen XML Editor/Author

To copy additional resources to the output directory using a transformation scenario from within Oxygen XML Editor/Author, follow this procedure:
  1. Place all your resources in the same directory.
  2. Edit the WebHelp transformation scenario, then open the Parameters tab.
  3. Edit the value for the webhelp.custom.resources parameter and set it to the absolute path of the directory in step 1.
  4. Click OK to save the changes to the transformation scenario.
  5. Run the transformation scenario.

    Result: All files from the new directory will be copied to the root of the WebHelp output directory.

Using a Script Outside of Oxygen XML Editor/Author

Important: Running WebHelp transformations from a script outside of Oxygen XML Editor/Author requires an additional license and some additional setup:
To copy additional resources to the output directory using a script outside of Oxygen XML Editor/Author, follow this procedure:
  1. Place all your resources in the same directory.
  2. Specify the absolute path to that directory using the webhelp.custom.resources parameter.
  3. Execute the transformation script.

    Result: All files from the new directory will be copied to the root of the WebHelp output directory.

For example:
  • Windows:

    dita.bat -i c:\mySample.ditamap -f webhelp-responsive -Dwebhelp.custom.resources=c:\resources

  • Mac OS X/ Linux:

    dita -i /mySample.ditamap -f webhelp-responsive -Dwebhelp.custom.resources=/resources