    | DocBook: The Definitive Guide 2.0.17 (Alpha) |
| | DocBook: The Definitive Guide 2.0.17 (Alpha) |
$Revision: 1666 $
$Date: 2002-06-12 07:19:37 -0400 (Wed, 12 Jun 2002) $
textobject — A wrapper for a text description of an object and its associated meta-information
textobject ::= (objectinfo?, (phrase|textdata| (%textobject.mix;)+))
The following parameter entities contain textobject:
| Parameter Entities | ||
%informal.tbl.table.mdl; | %mediaobject.mix; | %tbl.table.mdl; |
A TextObject is a wrapper containing a textual description
of a media object, and its associated meta-information.
TextObjects are only allowed in MediaObjects as
a fall-back option, they cannot be the primary content.
There are two different forms of TextObject, and it is
not unreasonable for a media object to contain both of them.
In the first form, the content of a TextObject is
simply a Phrase. This form is a mechanism for
providing a simple “alt text” for a media object. The
phrase might be used, for example, as the value of the
ALT attribute on an HTML IMG,
with the primary content of the image coming from one of the other
objects in the media object.
In the second form, the content of TextObject is a longer,
prose description. This form could be used when rendering to devices
that are incapable of displaying any of the other alternatives.
May be formatted inline or as a displayed block, depending on context. It might not be rendered at all, depending on its placement
within a MediaObject or InlineMediaObject and
the constraints on the publishing system. For a more detailed description
of the semantics involved, see MediaObject.
These elements contain textobject:
classsynopsisinfo, funcsynopsisinfo, informaltable, inlinemediaobject, literallayout, mediaobject, mediaobjectco, programlisting, screen, synopsis, table.
The following elements occur in textobject:
bibliolist, blockquote, calloutlist, caution, formalpara, glosslist, important, itemizedlist, literallayout, note, objectinfo, orderedlist, para, phrase, programlisting, programlistingco, screen, screenco, screenshot, segmentedlist, simpara, simplelist, textdata, tip, variablelist, warning.
alt, audioobject, caption, graphic, imageobject, inlinegraphic, inlinemediaobject, mediaobject, videoobject.
| | | |
| textdata | | tfoot |