DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

area (db.area.inareaset)

area — A region defined for a callout in a graphic or code example.

Synopsis

area (db.area.inareaset) ::=

Attributes

Common attributes.

Additional attributes:

  • coords
  • label
  • Exactly one of:
    • units (enumeration)
      • “calspair”
      • “linecolumn”
      • “linecolumnpair”
      • “linerange”
    • Each of:
      • units (enumeration)
        • “other”
      • otherunits (NMTOKEN)

Required attributes are shown in bold.

Description

An area in an areaset has an optional xml:id. In every other respect, it is the same as an area in an areaspec.

Attributes

Common attributes.

coords

Provides the coordinates of the area. The coordinates must be interpreted using the units specified.

label

Specifies an identifying number or string that may be used in presentation. The area label might be drawn on top of the figure, for example, at the position indicated by the coords attribute.

otherunits

Identifies the units used in the coords attribute when the units attribute is “other” . This attribute is forbidden otherwise.

units

Identifies the units used in the coords attribute. The default units vary according to the type of callout specified: calspair for graphics and linecolumn for line-oriented elements.

Enumerated values:
“calspair”

Coordinates expressed as a pair of CALS graphic coordinates.

“linecolumn”

Coordinates expressed as a line and column.

“linecolumnpair”

Coordinates expressed as a pair of lines and columns.

“linerange”

Coordinates expressed as a line range.

Parents

These elements contain area: areaset.

Children

The following elements occur in area: alt.

See Also

area (db.area)