Document Types > Creating Aliases > Creating an Alias Map from an Empty Template
Creating an Alias Map from an Empty Template
When creating an alias map from an empty template, you start with a minimal map structure but no document type-specific information. Use this method if you only want to create aliases for a small number of elements, attributes, or attribute values in the document type.
To create an alias map from an empty template:
1. Open Arbortext Architect.
2. Choose File > Open.
3. Locate the directory in which the document type is saved and click OK.
4. Choose Edit > Aliases to open the Alias Map Editor.
5. Choose File > New.
The New dialog box opens.
6. In the New dialog box, select Empty and click OK.
The dialog box closes and an empty alias map displays in the Alias Map Editor.
The Alias Map Editor defaults to the Document Map view. If you would like to work from an Edit view, choose View > Edit View to change to the Edit view.
7. Place your cursor to the right of the name tag, and type the name of an element, attribute, or attribute value defined in the document type.
8. Place your cursor to the right of the corresponding alias tag, and type an alias name.
There are several guidelines you must follow when creating an alias. To ensure that Arbortext Editor does not interpret an alias as an entity, notation, or marked section, aliases should not begin with ampersands, exclamation points, or percent signs. Also, aliases cannot contain character entities. If an alias contains a character entity, ArbortextEditor will ignore any aliases defined in the alias map after the one containing the character entity.
Further, aliases cannot include the following characters, as they may be misinterpreted by ACL. All other characters are allowed:
Single or double quotes
Dollar signs
Left and right angle brackets
Aliases are always case sensitive, no matter how the NAMECASE GENERAL is set in an SGML declaration.
9. To add another element, attribute, or attribute value to the alias map, place your cursor to the immediate left of an existing element, attribute, or value tag (in between the tag and its associated book icon), and choose Insert > Markup.
10. In the Insert Markup dialog box, select element, attribute, or value, and click Insert. You can now add an alias for the element, attribute, or attribute value you just created.
The Alias Map Editor will generate warnings and errors associated with invalid alias definitions during validation.
11. Perform the same steps to create and add global attribute and global attribute value aliases.
12. When you have finished creating aliases, validate the alias map. To do this, choose Tools > Validate Alias Map File. If there are any warnings or errors associated with the alias map, they will display in an Alias Map Editor Error Messages window.
13. Choose File > Save to save this alias map. Arbortext Architect will add an .alias extension to the file name. For easy retrieval, you may want to save the alias map to the directory where the document type is located.
You can add as many elements, attribute, and attribute value aliases as you would like. If you are going to provide aliases for most of the element, attributes, and attribute values in your document type, you should start with a populated template.