Character Mapping

To modify the ePublisher character map, you'll need to perform a simple overide of a file called 'mapentrysets.xml', which is located by default in the ePublisher Pro installation directory: [program files]\WebWorks\ePublsisher\[version]\Formats\Shared\html

For information on performing target overrides, please see our online documentation here: http://www.webworks.com/Documentation/Reverb/index.html#page/04.Reference%2520Information/How%2520It%2520Works.1.26.htm

Once you have copied the file to the appropriate location in your project folder, open it in a text editor such as NotePad, and add the appropriate map entries, modeling them after the existing exampels.

A common problem you might run into with FrameMaker source is caused by the use of "smart quotes." Browsers may render these characters incorrectly, so you'll want to replace them with regular straight quotes. Character mapping can help you to automate this process.

In mapentrysets.xml, you'll want to add the following entries, which will replace the left and right double quotation marks, respectively, with straight quotation marks:

<MapEntry match="&#8220;">"</MapEntry>
<MapEntry match="&#8221;">"</MapEntry>

Then, save mapentrysets.xml and regenerate your output to apply the changes. If you have trouble implementing this override, or if you have any other questions concerning this issue, please submit a new case.

Note: To find Unicode-supported characters for mapping or bullet replacement, try using the Windows Character Map, or check this website (unaffiliated with Quadralay) for a Unicode character search: http://www.fileformat.info/info/unicode/char/search.htm


Other examples for character replacements:

Pounds sterling symbol to less-than-or-equals

<MapEntry match="£">&amp;#x2264;</MapEntry>

Often, soft hyphens (those inserted by FrameMaker to break a word when the "Hyphenate" option is selected in the Style Designer) cause problems in HTML output. There are two options for dealing with this issue. a. To replace the soft hyphen with a normal hyphen:

<MapEntry match="­">-</MapEntry>

b. To remove all instances of the soft hyphen:

<MapEntry match="­"></MapEntry>


It is also possible to build in more complex mapping behavior by utilizing the MappingContext functionality built into the WebWorks XSL extensions, as described in this Wiki article:

http://wiki.webworks.com/DevCenter/Documentation/CharacterMaps

In pages.xsl (along with a few other content-processing documents), a mapping context is used to apply the "common" entries in mapentrysets.xml to all of content of each output HTML page. You can override that file and add mapentries there, or you can create additional mapping contexts, convert your own external XML mapentry lists, or call custom templates hat perform additional processing. To that end, there are plenty of options, but character map customizations to files other than mapentrysets.xml fall beyond the scope of technical support.


CategorySolutionsOverrides CategorySolutionsLocalization

Permalinks/Solutions/Overrides/CharacterMapping (last edited 2009-04-01 17:52:05 by LaurenLever)