Preparing existing projects for ePublisher Upgrade

Welcome to ePublisher » Planning and Installing ePublisher » Upgrading from Previous Versions » Preparing existing projects for ePublisher Upgrade

To ensure smooth migration of existing projects and stationeries perform the following steps:

Save your Stationery, Stationery design projects, and any projects you currently use to generate output to a secure location. Stationery defines the appearance and functionality of all the output formats you need. Stationery design projects are the ePublisher Designer projects used to create Stationery. For more information about Stationery and Stationery design projects, see Understanding Stationery and Creating a Stationery Design Project. For more information about Stationery and Stationery design projects, see Understanding Stationery and Creating a Stationery Design Project.

If you implemented overrides when designing Stationery, then you will need to make sure and migrate each overridden file so that it is compatible with the latest format files of the new release, or decide to keep the base format version of the file unchanged. Examples of overrides include the following items:

Modifications to the Page.asp file

Custom .css files

Custom .scss files

Modifications to image files

Any advanced overrides such as modifications to .xsl or .fti files or files in the Formats or Targets folder.

When the Stationery designer creates and saves Stationery, ePublisher creates the following folders:

StationeryName\Formats\OutputFormat

StationeryName\Formats\OutputFormat.base

where StationeryName is the name the Stationery designer specified for the Stationery, and OutputFormat is the type of output format the Stationery Designer specified for a target in the Stationery.

The StationeryName\Formats\OutputFormat folder contains any customizations or overrides the Stationery designer specified when designing the Stationery. ePublisher Express synchronizes with the files in the OutputFormat folder and uses the information about customizations and overrides contained in files in the OutputFormat folder to generate output.

Note: The Stationery may have one or more OutputFormat folders, based on the settings the Stationery designer specified.

The StationeryName\Formats\OutputFormat.base folder contains copies of all the files located in the \Program Files\WebWorks\ePublisher\release_number\Formats\OutputFormat folder. These files define the default output format and transforms and are installed by default when you install ePublisher.

Stationery designers can do a compare, or diff, between the files located in these folders to quickly see any customizations or overrides specified for the Stationery. Stationery designers can use this information to help them reapply customizations and overrides as needed when designing a newer version of the Stationery in ePublisher Designer.

For more information about overrides, see Stationery, Projects, and Overrides.

Was this helpful?

Last modified date: 02/27/2024