DocBook: The Definitive Guide

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
PrevNext

Name

GraphicCO -- A graphic that contains callout areas

Synopsis

Content Model

GraphicCO ::= (AreaSpec,Graphic,CalloutList*)

Attributes

Common attributes

Tag Minimization

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

Parameter Entities

%admon.mix;%bookcomponent.content;%component.mix;
%divcomponent.mix;%example.mix;%figure.mix;
%footnote.mix;%glossdef.mix;%indexdivcomponent.mix;
%informal.class;%para.mix;%qandaset.mix;
%refcomponent.mix;%sidebar.mix;

Description

Callouts, such as numbered bullets, are an annotation mechanism. In an online system, these bullets are frequently "hot," and clicking on them sends you to the corresponding annotation.

A GraphicCO is a wrapper around an AreaSpec and a Graphic. An AreaSpec identifies the locations (coordinates) on the Graphic in which the callouts occur. The GraphicCO may also contain the list of annotations in a CalloutList, although the CalloutList may also occur outside of the wrapper, elsewhere in the document.

Processing expectations

Formatted as a displayed block.

The mandatory processing expectations of a GraphicCO are minimal: a system is expected to render the graphic, if possible, and the callout list, if present.

In online environments, the processing system may be able to instantiate the linking relationships between the callout marks on the graphic and the annotations. For example, an HTML presentation system might use the coordinate information to construct a client-side image map. Some processing systems may even be able to go a step further and generate the callout marks automatically from the coordinate information. But this level of sophistication is not mandatory.

(5.0) Future Changes

In DocBook V5.0, GraphicCO will be discarded. In its place, use MediaObjectCO.

Parents

These elements contain GraphicCO: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caution, Chapter, Example, Figure, Footnote, Glossary, GlossDef, GlossDiv, Important, Index, IndexDiv, InformalExample, InformalFigure, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, ScreenShot, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step, Tip, Warning.

Children

The following elements occur in GraphicCO: AreaSpec, CalloutList, Graphic.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

See Also

AreaSpec, CalloutList, CO, ImageObjectCO, MediaObjectCO, ProgramListingCO, ScreenCO

Examples

<!DOCTYPE graphicco PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <graphicco> <areaspec units="calspair">   <areaset  coords="">     <area  coords="300 400">     <area  coords="325 340">   </areaset>   <area  coords="425 590"> </areaspec> <graphic fileref="http://somemap.site.com/EARTH?USA?MA?AMHERST"></graphic> </graphicco>


PrevHomeNext
GraphicUpGroup

Back to: DocBook: The Definitive Guide


O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.



DocBook. The Definitive Guide
DocBook 5: The Definitive Guide
ISBN: 0596805020
EAN: 2147483647
Year: 1999
Pages: 412
Authors: Walsh Norman, Richard L. Hamilton
BUY ON AMAZON

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net