53
53
<term>Entity</term>
55
<para>An entity is a "shortcut" for a constant. Entities are usually defined and stored in a list file. If you use an entity definition file it must be included using an inclusion statement in the header of the doucment. Character entities are defined as part of the docbook standard and do not need to be listed in the entity file(s). An example of a character entity is the "less than" symbol. Typing the symbol directly will break the DocBook code, since the symbol denotes the beginning of a tag. Using <keycap>&lt;</keycap> prevents this issue. </para>
55
<para>An entity is a "shortcut" for a constant. Entities are usually defined and stored in a "list" or "definitions" file. If you use an entity definition file it must be included using an inclusion statement in the header of the doucment. Character entities are defined as part of the docbook standard and do not need to be listed in the entity file(s). An example of a character entity is the "less than" symbol. Typing the symbol directly will break the DocBook code, since the symbol denotes the beginning of a tag. Using <keycap>&lt;</keycap> prevents this issue. </para>
61
<para> Sections are used for organizational purposes and are used by yelp to automatically generate a table of contents within a book, chapter, or article.</para>
65
<term>Nested tags</term>
67
<para> Tags residing inside of other tags are nested. Technically all of the tags inside of a document are nested between the opening and closing tag, but in common usage the term applies to tags nested within other tags within a paragrah or section element.</para>