Website Deliverables - Previous Next Index Print
Creating Project Target Overrides

Creating Project Target Overrides

Last Modified: October 9, 2006

ePublisher Pro

The purpose of this article is to explain how to create project target overrides for changes to an ePublisher Pro project that are not available through the GUI.

Some project modifications cannot be made through the GUI so we have created this article to provide steps for creating these project target overrides. Examples of modifications that cannot be made through the UI are changing the splash page to a WebWorks Help system, TOC font size adjustment to your project for localization purposes, and modifying style properties for breadcrumbs and mini-TOCs. When you create a project target override you are only overriding the specific file that you want to modify; you are also ensuring that these modifications are not lost when installing updates to ePublisher Pro.

This article offers general steps for performing target overrides. These steps may be taken with any of the files you need to modify inside the Formats directory. Please note however that changes to XSL and FTI files are not supported through our Product Support department. Modification of these files will only be supported through our Services department.

Instructions for creating project target overrides

To create a target override, we will first choose an existing format target in our project. Next, we will create a directory structure that mirrors the directory path to the file that we will be overriding.

Please follow these instructions to create target overrides:

For example, if you chose WebWorks Help 5.0 as the format when creating this project you will already have a target that, by default, is named WebWorks Help 5.0.

Figure 1 WebWorks Help 5.0 is the Active Format Target iseen below.

Next, we will create a new Targets directory in our ePublisher project directory.


Go to View > User Files.


Navigate up one level to the same directory where your .wep ePublisher Pro project file is located.


The directories ePublisher Pro looks for are case-sensitive. Be sure to type the folder names exactly the way they are typed in the installation directory structure.


Open the Targets directory you just created.


Create a new folder and assign it the name of the Active Format Target you have selected in your project. See Figure 1


Open a new window and navigate to the Formats folder located in the directory where you installed WebWorks ePublisher Pro. By default, it is located in C:\Program Files\WebWorks\ePublisher Pro\Formats.


Within the Formats directory, open the directory of the format on which you have based the format target, chosen in step 1.

For example, if the target you are creating overrides for is based on the WebWorks Help 5.0 format, you should open the WebWorks Help 5.0 directory in Formats.

For our example format target (which is based on the WebWorks Help 5.0 format), if you want to override the webworks.css file, you would open the Pages > css directory and copy the webworks.css file. The default installation path to webworks.css would be: C:\Program Files\WebWorks\ePublisher Pro\Formats\WebWorks Help 5.0\Pages\css


Within the Targets directory that you created in step 5, recreate the directory path that leads to the file you copied in step 11. Then paste the copied file here.

For this example, since you are overriding the webworks.css file for your new format target based on the WebWorks Help 5.0 format, you would create within your new Targets directory a new folder called Pages, and within that another directory called css.


If the file you need to override is located in the “Shared” directory, then you should recreate this folder inside the one named for your active target. For example, you might have a hierarchy in your project folder like this:
Targets\WebWorks Help 5.0\Shared\common\locale\locales.xml


It is not necessary to copy any files into the project Targets directory that you are not explicitly overriding.


After you have made the modifications you want to make to the file in your project directory, save the file and the next time you Generate All in your ePublisher Pro project, this file will replace the default file (thus overriding it), and the changes you made will be incorporated into the output.

This stationery can then be used to create future projects, while maintaining these modifications throughout your future projects.