# DITA Best Practices : Using the webhelp transformation in Oxygen

Created by Todd Stupnik, last modified by Craig Westling on Aug 21, 2014

This article covers the following subjects pertaining to creating and running a webhelp transform in Oxygen:

- Installing the webhelp transformation
- Configuring the webhelp transformation in Oxygen

# Installing the webhelp transformation

The com.oxygenxml.webhelp.zip file contains almost all customizations to WKFS webhelp transformations.

Installation instructions:

1. Copy the com.oxygenxml.webhelp.zip file (currently located in TFS at $/FS.InfoDev/Dev/oxygen/webhelp transformation files) to the DITA-OT plugins folder in your oxygen installation; (ex. C:\Program Files\Oxygen XML Editor 15\frameworks\dita\DITA-OT\plugins)
2. Extract the zip file in to the current location (i.e. Extract Here)
3. If prompted to overwrite existing files, accept the process. This will overwrite all necessary files.

Successfully placing these files in the proper location will result in the correct formatting for the WKFS webhelp transformations, including fonts, colors, logos, bullet points, etc.

# Configuring the webhelp transformation in Oxygen

Upon installing the .zip file, perform the following:

1. Click the Configure Transformation Scenarios button (or select DITA Maps/Configure Transformation Scenarios) to display the corresponding dialog.
2. Click the checkbox next to DITA Map Webhelp - WKFS to select the webhelp transformation.
3. Click the Edit button.
4. Click the Output tab.
5. In the Output Folder field, enter the directory location to place the webhelp files. For example: C:/dev/out/FulfillmentManager/webhelp. NOTE: You must change the Output field when creating webhelp transforms for different products. For example, if creating a DocOne webhelp transform, change the Output field to: C:/dev/out/DocOne/webhelp.
6. Click OK.
7. Click Apply Associated.

## Attachments:

wiki_webhelp-configure-transform-scenario.png (image/png)