Upgrading Advanced Customizations of WebWorks Reverb 2.0
Most of the time, you will only need to customize the
_*.scss files to achieve all of your styling requirements for your WebWorks Reverb 2.0 output. However, the Reverb 2.0 format is highly customizable and if necessary you can make advanced customizations to this format. If you are upgrading from a prior release, then you will want to understand what files are most likely to be customized and how this is affected if you change the Skin Target Setting.If you have or plan to make advanced customizations to the WebWorks Reverb 2.0 layout or look-and-feel, then most likely you will have to modify one or more of the following files.
Filename | The display area or items affected by this file |
|---|---|
webworks.scss | Content panel styling only. Includes the styling of the MiniTOC, RelatedTopics, Social Buttons. |
skin.scss | Styling of TOC, Index, Toolbar, and Breadcrumbs. All icons used in the skin.png sprite file are managed here. Styling of content that appears above the Toolbar, such as the company information. |
search.scss | Styling of the search results page. |
skin.png (derived from skin.Fireworks.png) | PNG file with alpha channel that stores all of the Reverb icons. |
connect.asp | Used to manage the button placement in the toolbar. Also manages the TOC/Index/Search panel title for the Corporate skin. |
connect.scss | Manages basic structure of the entry-point file generated from the connect.asp template file. |
When working with alternate skins, you need to be aware of which files are most likely affected as a result of changing the skin type. If you have Advanced Customizations in any of these files, then you need to re-examine the diffs of these files after you switch the skin type. Most likely you will have minimal differences. Here are some basic steps you can follow to make sure you translate those changes to the new skin properly.
Basic steps for setting an alternate skin type when Advanced customizations are present
1. Check your Advanced Customizations for files listed in Advanced Reverb 2.0 Files that are typically customized.
2. Make sure any of these commonly customized files are implemented as Target Overrides as opposed to Format Overrides. Setting an alternate skin type will create an implicit target override that will have priority over any format overrides of the same name.
3. Before changing the skin type you will need to record any existing file differences. On the Advanced menu click Manage Target Customizations. Now use the procedure discussed in Format and Target Overrides to record these file differences. These file differences will be used later after the skin type has been changed.
4. On the Target menu, click Target Settings.
5. In the WebWorks Reverb category, select the right column of the Skin entry to display the file picker button.
6. Click the file picker button to bring up an Open file dialog which will display a list of skin plugin files. Each skin plugin file is identifiable by a
.weplugin extension. 7. Browse to the plugin file that you wish to use and double-click it to set the skin to that value.
8. At this point, you need to consider either removing your existing customizations and then re-implementing them using the information from your previously recorded file differences. Or managing the differences directly by comparing the differences using the procedure discussed in Format and Target Overrides. Either method will work.
Last modified date: 02/27/2024