About Arbortext Styler > Creating a Basic Stylesheet > Migrating Stylesheets from a Previous Release
  
Migrating Stylesheets from a Previous Release
It is good practice to check whether your existing stylesheet.style files need updating when you install a new release of Arbortext Styler. Stylesheets from previous releases might not be compatible with the current release of the product. When you open a stylesheet from a previous release in the current release of the product, Arbortext Styler might prompt you to update the stylesheet. In this case, follow the prompts and your stylesheet will be updated automatically. Note that you must save the stylesheet for the updates to be permanent.
Following are two ways to update existing stylesheets:
• To update a stylesheet in Arbortext Styler:
1. In Arbortext Styler, select File > Open.
The Open Stylesheet dialog box opens.
2. Select a stylesheet developed in a previous release in the Available Stylesheets list.
3. Select OK to close the dialog box and open the stylesheet in Arbortext Styler.
If the stylesheet needs updating, Arbortext Styler prompts you to perform the update. If you do not perform the update, the stylesheet will not be usable in the current product release.
This is an image of the Arbortext Styler warning advising you that your style file is out of date, and verifying that you wish to update it
4. Follow the prompts to update the stylesheet.
Make sure you save the stylesheet to make the updates permanent. Note that after you save the updated .style file, it cannot be used by previous releases of PTC Arbortext software. The automatic updating process does save a backup of the original stylesheet, however, that you can access if necessary.
5. Perform this operation for all stylesheets you are migrating to the upgraded release. Be sure to check all custom directories your site uses for stylesheet.style files.
• To update a stylesheet in Arbortext Editor:
1. In Arbortext Editor, select Format > Select Stylesheets.
The Select Stylesheets dialog box opens.
2. Highlight the current Editor/Default stylesheet and select the Modify button.
The Modify Editor/Default Stylesheet Selection dialog box opens.
3. Select a stylesheet developed in a previous release in the Available Stylesheets for Editor/Default list, or add a new one via the Add button.
4. Select the Select button to close the dialog box and set the stylesheet as the Editor/Default stylesheet.
If the stylesheet needs updating, Arbortext Editor prompts you to perform the update. If you do not perform the update, the stylesheet will not be usable in the current product release.
This is an image of the Arbortext Styler warning advising you that your style file is out of date, and verifying that you wish to update it
5. Follow the prompts to update the stylesheet.
6. Select the Close button to close the Select Stylesheets dialog box.
7. Make sure you save the stylesheet to make the updates permanent. After you save the updated .style file, it cannot be used by previous releases of PTC Arbortext software. The automatic updating process saves a backup of the original stylesheet, that you can access if necessary.
8. Perform this operation for all stylesheets you are migrating to the upgraded release. Be sure to check all custom directories your site uses for stylesheet.style files.
If your stylesheet contains edited source for elements that was created in an earlier release of Arbortext Styler, or you suspect that it may, it is useful to review the stylesheet with this in mind when you wish to update it. You may need to recreate existing source code edits to take into account any new features introduced in the release.
Refer to Editing Stylesheet Source Overview for details about editing the source of an element context.