Table of Contents

Previous

Next


Creating Target Overrides

This section defines how to override default files for a specific target in a project without affecting other targets of the same output format type in that project. Do not modify the files in the installation folder hierarchy. These files are the default files and should remain as is. These files are also overwritten when you install new ePublisher releases. Instead, store and incorporate your customized files with your Stationery so your projects based on the Stationery get those customizations.

Note: Changes to .xsl and Format Trait Info .fti files are considered advanced customizations and are not supported by the Quadralay Product Support department. If you are familiar with XSL, you may find that customizations to .xsl and .fti files are a powerful way to achieve very specific results in your generated output or output deployment. However, you are responsible for maintaining any .xsl or .fti file overrides that you implement. The Quadralay Product Support department does not provide support for these advanced customizations.

Make sure the file and folder names you create exactly match the default file and folder names in the installation folder hierarchy. Do not copy any files into the project folder hierarchy that you are not overriding.

The following task assumes that ePublisher is installed in the default location and your ePublisher projects are stored in the My Documents folder. If you installed ePublisher to a non-default location, or if you store your projects in a folder other than the My Documents folder, adjust the paths in the following task.

To override a project target

  1. In your Stationery design project, on the View menu, click Project Directory.

  2. Create a new folder named Targets in your project folder.

  3. In this new Targets folder, create a folder with the exact name of your target (targetname) in your project.

  4. In this new Targets\targetname folder, duplicate the folder hierarchy within the appropriate format of the file you want to override. For example, if you want to override the Page.asp file, create the Pages folders in the Targets\targetname folder.

  5. Copy the file you want to override from the default installation folder location of the format associated with the target into the new location in your project folder hierarchy. For example, if you want to override the Page.asp file and your target produces HTML Help output, copy the Program Files\WebWorks\ePublisher Pro\Formats\Microsoft HTML Help 1.x\Pages\Page.asp file to the My Documents\component Projects\project\Targets\targetname\Pages folder, where component is the name of the ePublisher component you are using to create the project, such as ePublisher Pro or ePublisher Express, and project is the name of your project.

  6. Modify the copied file in the project folder hierarchy as needed, and save the file.

The next time you generate your project, the modified file automatically overrides the default file and the changes you made are incorporated into the output for that target. These customizations also override any override files you saved in the project folder hierarchy for the associated output format.

Note: When you save the ePublisher project as Stationery, the project target overrides you have created are saved with your Stationery. This Stationery can then be used to create future projects in ePublisher Express.

 

ePublisher/2009.3/Help/04.Reference_Information/1.27.How_It_Works (last edited 2009-11-16 17:43:28 by TonyMcDow)