    | 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) $
graphic — A displayed graphical object (not an inline)
graphic ::= EMPTY
Name | Type | Default | ||||||||||||||||||||||||||||||
| width | CDATA | None | ||||||||||||||||||||||||||||||
| srccredit | CDATA | None | ||||||||||||||||||||||||||||||
| contentdepth | CDATA | None | ||||||||||||||||||||||||||||||
| entityref | ENTITY | None | ||||||||||||||||||||||||||||||
| scalefit | CDATA | None | ||||||||||||||||||||||||||||||
| contentwidth | CDATA | None | ||||||||||||||||||||||||||||||
| align |
| None | ||||||||||||||||||||||||||||||
| valign |
| None | ||||||||||||||||||||||||||||||
| depth | CDATA | None | ||||||||||||||||||||||||||||||
| fileref | CDATA | None | ||||||||||||||||||||||||||||||
| format |
| None | ||||||||||||||||||||||||||||||
| scale | CDATA | None |
This element contains graphical data, or a pointer to an
external entity containing graphical data. One of the
deficiencies of the DocBook Graphic element is that
there is no way to specify an alternate text description of the
graphic. This has been rectified by the introduction of
MediaObject.
Formatted as a displayed block.
There are several ways to provide content for a
Graphic. It is best to use only one of these
methods. However, if multiple graphic sources are provided, the
processing expectations are as follows: element content should be used
in favor of either EntityRef or FileRef and EntityRef
should be used in favor of FileRef.
In DocBook V4.0, Graphic will be declared EMPTY.
This change will require that any embedded graphic content be stored outside the
SGML source and pointed to with an
EntityRef or
FileRef attribute.
In DocBook V5.0, Graphic will be discarded. At that
time, graphics will have to be incorporated using
MediaObject or InlineMediaObject.
These elements contain graphic:
answer, appendix, appendixinfo, article, articleinfo, bibliodiv, bibliography, bibliographyinfo, blockinfo, blockquote, bookinfo, callout, caution, chapter, chapterinfo, constraintdef, entry, equation, example, figure, footnote, glossary, glossaryinfo, glossdef, glossdiv, graphicco, important, index, indexdiv, indexinfo, informalequation, informalexample, informalfigure, informaltable, inlineequation, itemizedlist, listitem, msgexplan, msgtext, note, objectinfo, orderedlist, para, partinfo, partintro, preface, prefaceinfo, procedure, qandadiv, qandaset, question, refentryinfo, referenceinfo, refsect1, refsect1info, refsect2, refsect2info, refsect3, refsect3info, refsection, refsectioninfo, refsynopsisdiv, refsynopsisdivinfo, revdescription, screenshot, sect1, sect1info, sect2, sect2info, sect3, sect3info, sect4, sect4info, sect5, sect5info, section, sectioninfo, setindex, setindexinfo, setinfo, sidebar, sidebarinfo, simplesect, step, synopsis, table, taskprerequisites, taskrelated, tasksummary, td, th, tip, variablelist, warning.
Align specifies the horizontal alignment
of the graphic on the page or within the element that frames it.
Depth specifies the desired depth (vertical
distance, at least in horizontal writing systems) of the
image.
EntityRef identifies the general entity
which contains (or points to) the content of the graphic.
FileRef specifies the name of the file
which contains the content of the graphic.
Format identifies the format of the graphic
content. The Format must be a defined
notation.
Scale specifies integer representing a
percentage scaling factor (retaining the relative dimensions of the
original graphic). If unspecified, the value 100 (100%) is assumed.
If ScaleFit has the value 1 (true), then
the graphic is to be scaled (uniformly) to the specified width or depth.
The default value of 0 (false) indicates that the image will not be
scaled to fit (although it may still be scaled by the
Scale attribute).
SrcCredit contains details about the source
of the Graphic.
Width indicates the width of the graphic.
alt, audioobject, caption, imageobject, inlinegraphic, inlinemediaobject, mediaobject, textobject, videoobject.
<!DOCTYPE figure PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<figure><title>Notre Dame Cathedral</title>
<graphic srccredit="Norman Walsh, 1998" fileref="figures/notredame.png"/>
</figure>For additional examples, see also
equation, figure, graphicco, informalequation, inlineequation, screenshot.
| | | |
| glossterm | | graphicco |
