Style Map

Please, note that SWIFT is installed "locally" under your own user name. That is to say, anyone else logging on as a different user will not see any changes you make here.

One of the main purposes of SWIFT's Style Map is to show Word users which Word Styles are "mapped" to DBT Styles, and equally important, which styles are NOT mapped.

Any Word Style which is not mapped is simply brought into DBT as left aligned text, unless you select a DBT Style to map it to.

For example, the screen shot below is from an actual document where customized Word Styles have been used. Among the Paragraph Styes, two are mapped to DBT styles, but one is not. Following the screen shot is an explanation of the elements in this dialog.

Target DBT Template (drop-down list)

This list displays all available DBT templates. Your first task should be to select an appropriate template for the document you wish produced in braille.

If you have opened a new document in Word, the default Target DBT template initially displayed here will be whatever you have set as the default within DBT itself.

If you are opening a document which has previously been opened in SWIFT version 5 (this version) and you have previously changed the Target Template, that template will be shown. This allows you to work with multiple Word documents which use different DBT templates.

Please, note the comment in the screen shot above which reads: "You have not made any changes to the default style mappings for this template. These same mappings will be used if you open this document directly in to DBT (without using SWIFT)."

Save Map (button)

This button saves any changes of mappings you have made. (This changes the style map away from the default mapping contained in your chosen DBT template.) Note that this change will be saved in your user folder %appdata%\duxbury\swift\Templates. These settings will be used for all future work on your system when you select the corresponding template. To restore all settings to their defaults:

1. Hold down the Windows key and press R to bring up the Run dialog.
2. Type in the following command: %appdata%\duxbury\swift\Templates
3. Press Enter or click on the OK button
4. When the folder view opens, delete the .mws files.

Revert (button)

Reverts any changes you have just made back to the default settings.

Import (button)

Allows you to import a Style Map (*.mws) file from another user or system.

Export (button)

Allows you to export a Style Map (*.mws) file to another user or system.

Close (button)

Simply closes the Style Map dialog.

Show In-Use Styles Only (checkbox)

When checked, normally only the Styles used in the Word document itself are listed here.

Show Unmapped Styles First (checkbox)

When checked, any Word Style which is not mapped to a DBT Style is shown at the beginning of the list of Word Styles.

Show Only Recommended Styles (checkbox)

In some DBT templates, certain styles are no longer recommended; we have created better styles to replace them. In these cases, DBT itself generally does not show the older styles when you elect to apply a style. (The styles normally hidden are retained so that Word documents created to use these now "historical" styles continue to be imported properly.)

SWIFT can emulate this part of DBT behavior and show only styles that are recommended for use with new DBT documents. Such styles are generally the best targets for your Word styles.

Paragraph Styles (table)

This is a table of 5 columns: Name (of Word style), DBT Style (a selection list), IsAggregate (a checkbox), Level (a number) and Center (a checkbox).

Character Styles (table)

This is a table with only two columns: Word Style and DBT Style (a selection list).

Map Status (text box)

This read-only text box appears to advise whether or not you have made any changes.

Advanced (button)

This dialog reads, "Some Style Map entries read from the DBT Style Map file cannot be represented in the tabular format of the main Style Map task panel. These are shown here instead, and will be included in any Style Map exported or used by DBT to open your Word documents from SWIFT."

The example in the dialog below shows that "List Paragraph" and "Alt Text" are mapped to DBT styles in the selected template.