Entities Rules

This section defines named entities that must be converted to their numeric equivalent in the MAML topic files.

Rule Processing

The .NET XML parser only recognizes the common ASCII named entities (&, <, >, ", and '). Once converted to MAML, the topics are processed as XML files and, as such, any other named entities in the topic will cause the build process to fail. This section defines all other named entities commonly found in HTML files and their replacement numeric equivalent. During conversion, any named entities from this section found in a topic are replaced with their numeric form (i.e. © would become ©).

The entries consist of Entity elements with a name attribute that defines the named entity and a value attribute that defines the numeric value to use as its replacement.

  Note

Unlike the other rules, entity name values are matched case-sensitively as the numeric values for uppercase and lowercase name values differ as shown in the example below.

Example Entities Entries
<Entities>
  <Entity name="Aacute" value="193" />
  <Entity name="aacute" value="225" />
  <Entity name="Acirc" value="194" />
  <Entity name="acirc" value="226" />
</Entities>

See Also