Using internal entities for variables

Internal entities are an XML feature for creating typing shortcuts. They should be avoided in DITA authoring.

Internal entities function as typing shortcuts in XML documents. They allow a string or phrase to be defined in the head of the XML file, and then used in the body of the content using a shortcut notation. For example, the phrase "Supara Lumberer" may be defined as <!ENTITY lumberer "Supara Lumberer">, and that lumberer entity used within the document as &lumberer;. They can theoretically be used for creating variables.

Do not use internal entities. Their use inhibits interchange, and they are technically difficult for authors to work with. They are also changed during XSL transformations, resulting in inconsistent output results.