Pro Projects with Custom XSL Procedure

Record existing Format Baselines

We recommend that before uninstalling your previous version of ePublisher that you take the following steps:

1. Create a copy of your Projects directory as a backup.
2. Make sure that all your production projects have been set up as Express Projects using standalone stationery.
3. If you haven't done so already, make sure that all Stationery is saved as Standalone Stationery.
4. If you have projects that included overrides to XSLT or other "Formats" files, then you should follow the procedures outlined in this HelpCenter article.

Migration of Pro Projects to 9.3

The following steps provide experienced ePublisher users with a clear upgrade path. Specifically, this applies to ePublisher Pro Master projects with custom overrides of version 9.x installation files (XSL, XML, Page.asp, etc.). The complexity of this procedure is related to the total number of project overrides, along with the nature and number of changes (if any) to the overridden files in ePublisher Pro 9.3. That is, if you didn't make many changes, and we didn't make any changes, then your job will be easier.

NOTE: These steps should be performed prior to upgrading to 9.3.

1. Collect all version specific files in one location.

   1. Locate and copy the installed Formats folder to a safe location with the current version number noted:

      copy "C:\Program Files\WebWorks\ePublisher Pro\Formats" to "C:\Documents and Settings\<user>\Desktop\ePublisher Pro 9.2.2\Formats"

   2. Duplicate all Master projects (.wep), and save copies in the same version folder:

      copy "Z:\My Documents\ePublisher Pro Projects" to "C:\Documents and Settings\<user>\Desktop\ePublisher Pro 9.2.2\My Projects"

2. Uninstall all ePublisher products.
3. Install new ePublisher products.

4. If you have project overrides, perform a three-way merge using your existing Master project override files, the original 9.2.2 Format files, and the new 9.3 Format files. The idea is to upgrade your overrides by applying similar changes (where appropriate) to the newest versions of those files, and to save the resultant merged file with your new Master project for use with 9.3.

   Possible tools for this operation are:

   • Araxis Merge Pro (http://www.araxis.com/merge/)
   • KDiff3 (http://kdiff3.sourceforge.net/)

5. Once your overrides have been replicated on copies of the version 9.3 Format files, test your output to ensure you are getting the expected results. If issues crop up, compare pre-existing 9.2.2 overrides (from the backup folder created in Step 1) to the new overrides you just created for 9.3.