The "figure" element groups an optional "preamble" element, an
"artwork" element, and an optional "postamble" element together. The
"figure" element also has an optional "anchor" attribute that is used
for cross-referencing with the "xref" element (Section 2.3.1.4).
There is also an optional "title" attribute that identifies the title
of the figure.
The "preamble" and "postamble" elements, if present, are simply text.
If a cross-reference is needed to a section, figure, or reference,
the "xref" element (Section 2.3.1.4) is used; similarly, if an
external-reference is needed, the "eref" element (Section 2.3.1.5) is
used. Indexing of text is provided by the the "iref" element (Section
2.3.1.6).
The "artwork" element, which must be present, contains "ASCII
artwork". Unlike text contained in the "t", "preamble", or
"postamble" elements, both horizontal and vertical whitespace is
significant in the "artwork" element.
RFC 2629 Writing I-Ds and RFCs using XML June 1999
So, putting it all together, we have, e.g.,
<figure anchor="figure_example">
So,
putting it all together, we have, e.g.,
ascii artwork goes here...
be sure to use "<" or "&" instead of "<" and "&",
respectively!
which is a very simple example.
which is a very simple example.
If you have artwork with a lot of "<" characters, then there's an XML
trick you can use:
If you have artwork with a lot of "<"
characters, then there's an XML trick you can
use:
<![CDATA[
ascii artwork goes here...
just don't use "]]" in your artwork!
]]>
The "<![CDATA[ ... ]]>" construct is called
a CDATA block -- everything between the innermost brackets
is left alone by the XML application.
The "<![CDATA[ ... ]]>" construct is called a CDATA block --
everything between the innermost brackets is left alone by the XML
application.
Because the "figure" element represents a logical grouping of text
and artwork, an XML application producing a text version of the
document should attempt to keep these elements on the same page.
Because RFC 2223 [2] allows no more than 69 characters by 49 lines of
content on each page, XML applications should be prepared to
prematurely introduce page breaks to allow for better visual
grouping.
RFC 2629 Writing I-Ds and RFCs using XML June 1999
Finally, the "artwork" element has two optional attributes: "name"
and "type". The former is used to suggest a filename to use when
storing the content of the "artwork" element, whilst the latter
contains a suggestive data-typing for the content.
2.3.1.4 The xref Element
The "xref" element is used to cross-reference sections, figures, and
references. The mandatory "target" attribute is used to link back to
the "anchor" attribute of the "section", "figure", and "reference"
=8= |