Atomik Roundtrip 2.1: Reference > Chapter 12 Function Reference << >>

12.9 Roundtrip (Unicode) Mappings

NOTE: This palette and associated functionality is available when using Version of QuarkXpress prior to 7. Version 7 on directly supports Unicode characters removing the need for this functionality in Roundtrip.

The Unicode Mapping palette allows users to map certain unicode characters to appropriate characters and symbols in the fonts which are installed on their machine. This is necessary because the unicode character set contains many more symbols than are present in standard Macintosh and Windows fonts; however, these symbols are often available in other special fonts (like math fonts, expert fonts and symbol fonts).

The unicode characters which are represented by entities in the XML will be mapped to the appropriate fonts as specified in this dialog. As these settings are specific to the machine on which Roundtrip is being operated, rather than to the XML which is being worked with, they are settings which apply globally to all QuarkXPress documents and to all XML documents imported using Roundtrip, and only need to be set up once. Even though you may have many different XML files which use different entities, they will all refer to the same unicode character set.

To set a Unicode Mapping, first select the unicode character which you wish to edit from the list. The unicode values are listed in the same way that they would appear in an XML or DTD entity reference - so it is easy to identify which unicode character you wish to work with. The Entities palette also lists unicode numbers in an identical format.

Once you have selected the unicode value, you must enter either the character code for the character within the font to which the unicode character corresponds (in the ‘Code’ field of this dialog), or alternatively entering the character in the ‘Character’ field. You can see the character which you have entered in the ‘Display’ area on the right hand side of this dialog box.

If you specify a font from the font menu in this dialog, then Roundtrip will always use that font when it resolves an entity which refers to the unicode character. This is appropriate for symbol fonts, as the characters would look wrong in any other fonts. However, for characters such as accents, it would be more appropriate for these characters to appear in the same font as the text which surrounds them. In order to do this, you should select ‘Base’ from the font list (this is the first entry in the list). If you choose to use the ‘Base’ font, you should ensure that the character to which you are referring is present in all of the fonts which are likely to be used on your machine, otherwise an incorrect character will be displayed.

You should note that you can not put more than one Unicode Mapping to the same character in the same font, as it would make it impossible to ‘roundtrip’ content using these character entities. This is because if you have a many-to-one mapping of multiple unicode values to the same font and character, whilst Roundtrip would be able to correctly map the unicode values in the XML to this character as the XML was imported into QuarkXPress, it would not be able to correctly map the character in the QuarkXPress page back to the appropriate unicode character, as there would be more than one possibility. The Unicode Mapping palette will consequently not allow you to map more than one unicode character to the same font and character within the Atomik Roundtrip Unicode Mapping palette.

Once you have made a change, you must click ‘Save’ for your changes to be applied. If you click on another character in the list without clicking save, your changes will not be applied. If you wish to remove a Unicode Mapping, simply select the list entry for that mapping and click the ‘Delete’ button.

If you wish to add a brand new unicode reference, then you must type the unicode number (in the standard &#x0000; format, as you would in a DTD or XML entity declaration), and then enter either the character code in the ‘code’ box, or type the character directly on the keyboard into the ‘Character’ box; then click the Add button, and your new Unicode Mapping will be added to the list.

If you have already imported some XML which has entity declarations within it into your QuarkXPress document, you can automatically import all of the unicode characters used in that XML into the Unicode Mapping list by clicking the ‘Add Entities’ button in the Unicode Mapping palette.

The entries made in the Unicode Mapping palette are saved in the ‘UnicodeMap.prf’ file which is stored inside of your Roundtrip Preferences folder: (‘QuarkXPress\Preferences\Roundtrip\Your_Name\EntityMap.prf’). As this is an XML file, it can also be edited in another application, or transferred to another machine so that many users can have the same character mappings set up on their machines (so long as they all have the fonts which are referred to in those Unicode Mappings).

By default, the list will contain a number of standard mappings. If you wish to restore the default mappings at any time, simply delete the ‘EntityMap.prf’ file from your preferences folder inside the QuarkXPress folder. Before doing this you should note that this will also remove any custom mappings you have made.

The default mappings contain all of the standard Mac and Windows (depending on which platform you’re on) codepage characters. Additionally, the default mappings contain some QuarkXPress special characters, which you can reference in your XML as entities. There is a file ‘QXPSpecial.ent’ in the ‘Entities’ folder of your ‘Roundtrip’ installation which you can reference from your DTD to include these characters, or you can include some or all the entity references directly in your own entity file or DTD as follows:

<!ENTITY qxpPPN "&#xF126;" ><!-- Previous Page Number --> <!ENTITY qxpCPN "&#xF127;" ><!-- Current Page Number --> <!ENTITY qxpNPN "&#xF128;" ><!-- Next Page Number --> <!ENTITY qxpNL "&#x000A;" ><!-- Soft return --> <!ENTITY qxpT "&#x0009;" ><!-- Tab --> <!ENTITY qxpNC "&#xF131;" ><!-- New Column --> <!ENTITY qxpNB "&#xF132;" ><!-- New Box --> <!ENTITY qxpP "&#x000D;" ><!-- New Paragraph --> <!ENTITY qxpFS "&#xF134;" ><!-- Flexible Space --> <!ENTITY qxpPS "&#xF135;" ><!-- Punctuation Space --> <!ENTITY qxpDNL "&#xF136;" ><!-- Discretionary New Line --> <!ENTITY qxpIH "&#xF137;" ><!-- Indent Here Marker --> <!ENTITY qxpDH "&#xF138;" ><!-- Discretionary Hyphen -->

Of course, these entities can be named differently in order to be compatible with the equivalent character entities in your XML.