DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

Graphic

Name

Graphic -- A displayed graphical object (not an inline)

Synopsis

Declared Content

Graphic ::=
CDATA

Attributes

Common attributes

Name	Type	Default
Width	NUTOKEN	None
SrcCredit	CDATA	None
Scale	NUMBER	None
Format	Enumerated notation: BMP CGM-BINARY CGM-CHAR CGM-CLEAR DITROFF DVI EPS EQN FAX GIF GIF87a GIF89a IGES JPEG JPG linespecific PCX PIC PS SGML TBL TEX TIFF WMF WPG	None
Align	Enumeration: Center Left Right	None
Scalefit	NUMBER	None
Depth	NUTOKEN	None
EntityRef	ENTITY	None
FileRef	CDATA	None

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities

%admon.mix;	%bookcomponent.content;	%component.mix;
%divcomponent.mix;	%equation.content;	%example.mix;
%figure.mix;	%footnote.mix;	%glossdef.mix;
%indexdivcomponent.mix;	%informal.class;	%inlineequation.content;
%para.mix;	%qandaset.mix;	%refcomponent.mix;
%sidebar.mix;	%tabentry.mix;	%tbl.entry.mdl;
%tbl.table-main.mdl;	%tbl.table.mdl;

Description

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.

Processing expectations

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.

 Future Changes

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.

 Future Changes

In DocBook V5.0, Graphic will be discarded. At that time, graphics will have to be incorporated using MediaObject or InlineMediaObject.

Parents

These elements contain Graphic: Answer, Appendix, ArtHeader, Article, BiblioDiv, Bibliography, BlockQuote, BookInfo, Callout, Caution, Chapter, DocInfo, entry, Equation, Example, Figure, Footnote, Glossary, GlossDef, GlossDiv, GraphicCO, Important, Index, IndexDiv, InformalEquation, InformalExample, InformalFigure, InformalTable, InlineEquation, ListItem, MsgExplan, MsgText, Note, ObjectInfo, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect1Info, RefSect2, RefSect2Info, RefSect3, RefSect3Info, RefSynopsisDiv, RefSynopsisDivInfo, ScreenShot, Sect1, Sect1Info, Sect2, Sect2Info, Sect3, Sect3Info, Sect4, Sect4Info, Sect5, Sect5Info, Section, SectionInfo, SetIndex, SetInfo, Sidebar, SimpleSect, Step, Synopsis, Table, Tip, Warning.

Attributes

Align

Align specifies the horizontal alignment of the graphic on the page or within the element that frames it.

Depth

Depth specifies the desired depth (vertical distance, at least in horizontal writing systems) of the image.

EntityRef

EntityRef identifies the general entity which contains (or points to) the content of the graphic.

FileRef

FileRef specifies the name of the file which contains the content of the graphic.

Format

Format identifies the format of the graphic content. The Format must be a defined notation.

Scale

Scale specifies integer representing a percentage scaling factor (retaining the relative dimensions of the original graphic). If unspecified, the value 100 (100%) is assumed.

Scalefit

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

SrcCredit contains details about the source of the Graphic.

Width

Width indicates the width of the graphic.

See Also

Alt, AudioObject, Caption, ImageObject, InlineGraphic, InlineMediaObject, MediaObject, TextObject, VideoObject

Examples

<!DOCTYPE figure PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<figure><title>Notre Dame Cathedral</title>
<graphic srccredit="Norman Walsh, 1998" fileref="figures/notredame">
</graphic>
</figure>

Figure 1. Notre Dame Cathedral

For additional examples, see also Equation, Figure, GraphicCO, InformalEquation, InlineEquation, ScreenShot.

---

Prev	Home	Next
GlossTerm	Up	GraphicCO

Back to: DocBook: The Definitive Guide