Content Pipeline Guide > Customizing Publishing > Configuring Character Entity Substitution Files for HTML Publishing > Entity Substitution File Format
  
Entity Substitution File Format
This section defines the format for the entity substitution files. These files are free-form XML with the following simple element structure.
<character-mapping> — Top-level element; required. No attributes.
<unicode/> — The only allowed child element. It has the following attributes:
char — Required. Represents the Unicode character to be substituted.
entity — Optional. Represents the entity to substitute. The entity may be a regular named entity like “mdash” or a numeric character reference like “#8212”. The value of this attribute would be the markup with the leading ampersand and trailing semicolon removed.
string — Optional. Represents a string value to substitute, used for HTML Help Navigation and text because these outputs are not represented by markup. However, you can use this attribute with the other output formats. If both entity and string are present, entity is used.