<email> (
Electronic Mail)
Description
Description
This element holds both an electronic email address, and display text that could become a hypertext link that activates an email system and pre-populates the "to:" field.
The prefix "mailto:" must not be added to the attribute value, as it is added automatically later.
If the element is empty, this is a sign that the content of the attribute should also serve as the display text.
<para>Please emails bugs to: <email url="[email protected]"/>.</para>
Please email bugs to: [email protected].
If the element is not empty, the content of the element is presented instead (but the attribute is still used to supply the email system with its address:
<para>Please emails bugs to:
<email url="[email protected]">Bill Gates</email>.</para>
Please email bugs to: Bill Gates.
Parent Elements
The elements listed below may directly contain this element.
They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(choice of TEXT with elements repeated)
|
|--+(choice) [Objects in Text]
| |
| |-- inlinematheqn -- (elements)
| |
| |-- inlinechemeqn -- (elements)
| |
| |-- inlinegraphic
|
|--+(choice) [Formatting in Text]
| |
| |-- sub -- (TEXT and elements)
| |
| |-- sup -- (TEXT and elements)
| |
| |-- b -- (TEXT and elements)
| |
| |-- i -- (TEXT and elements)
| |
| |-- smallcaps -- (TEXT and elements)
| |
| |-- u -- (TEXT and elements)
| |
| |-- box -- (TEXT and elements)
| |
| |-- roman -- (TEXT and elements)
| |
| |-- script -- (TEXT and elements)
| |
| |-- tt -- (TEXT and elements)
| |
| |-- strikethrough -- (TEXT and elements)
| |
| |-- overline -- (TEXT and elements)
| |
| |-- newpage
| |
| |-- query -- TEXT
|
|--+(choice) [Names in Text]
| |
| |-- famousname -- TEXT
| |
| |-- companyname -- (TEXT and elements)
| |
| |-- institutionname -- (TEXT and elements)
| |
| |-- citation -- TEXT
DTD Definition
The DTD contains the following element and attribute definitions
(note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT email (#PCDATA | %ObjectsInText; | %FormattingInText; | %NamesInText;)*>
<!ATTLIST email
url CDATA #REQUIRED
%a-group-CommonIDAttrs;>
.
Defined in DTD section
Inline-level Content : Formatting and Identifying
General Attributes (shared with other elements)
Local Attributes (defined for this element alone)
Attribute:
url (
Uniform Resource Locator)
Description
This required attribute holds the email address. The prefix "mailto:" must not be added to the value (it is added automatically later).
If the element is empty, then this value should also be rendered as the default content of the element (as in the first example of the element in use).
Specification
This attribute is required. It has text content.
DTD Definition
url CDATA #REQUIRED
.