|
|
|
|
|
Project Customizations
To modify HTML Help, users may make changes inside the HTML Help project file (.hhp) or through customization of the process used by ePublisher. Detailing how to make changes inside the .hhp file is beyond the scope of this document. See the help files inside HTML Help for details on the types of modifications, and the processes to implement them. This section focuses on modifications made through the ePublisher system.
When generating output, the ePublisher engine has three places to look for the files it requires to complete the transform. The user may modify two of these locations in order to create unique content.
By default, the ePublisher engine will look first for a Formats directory inside the project folder for the files it requires. Next, the engine looks for a Targets directory inside the project folder for the files it needs. Finally, the engine will look inside the installation directory for the required files.
By recreating the file path inside the Targets directory and storing a modified file in the correct location, the user can make changes to a specific target. This is useful when there are multiple targets and the user wishes to customize only one of them.
By recreating the file path inside the Formats directory and storing a modified file in the correct location, the user can make changes to an entire project. This is useful when there is only one target, or all targets should be modified the same way.
Both the Targets and Formats directories, as well as the folder hierarchy necessary to override a given file, must be created by the user. Modifying files in the installation directories is not recommended. Files should be modified on the target or project level or in user-created formats only.
|
|
If the user has created both a Targets and a Formats directory, please note that overrides placed in the Targets directory will override those placed in the Formats directory for that particular target. |
Figure 2 illustrates the same file hierarchy in the Targets and Formats directories.
Figure 2: Identical File Hierarchies in Formats and Targets Directories
