Creating Project 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 through the Quadralay Product Support department. If you are familiar with the XSL language, you may find this to be a powerful way to achieve very specific results in your generated output or output deployments. However, you need to understand that the override files that you create must be maintained by you and not the Quadralay Product Support department.
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
In Windows, open your project folder.
Create a new folder named Targets in your project folder.
In this new Targets folder, create a folder with the exact name of your target (targetname) in your project.
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.
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.
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.
- Category2009.1