<graphic>

Graphic

Definition

An external file that holds a picture, illustration, etc., usually as some form of binary object

The “content” of the <graphic> element (if any) is not the object itself but merely information about the object. The external file that contains the object is named by the xlink:href attribute.

Remarks

Although, in theory, the position attribute of this element may be used to indicate whether this element must be anchored at its exact location within the text or whether it may float, it is usually good practice to anchor graphics. For graphics inside figures, tables, etc., the graphic should be anchored, although the outer structure (figure, boxed-text) may be allowed to float.

Display component elements, such as <alt-text>, should always be used at the highest possible level; in other words, if a <graphic> element is inside a <fig>, the <alt-text>, <long-desc>, <attrib>, etc., should be part of the <fig>, not part of the <graphic>. Use a <alt-text> (or similar display component elements) on a <graphic> only when the graphical object is not enclosed in any other structure or when a figure contains multiple graphical objects, each of which must have its own <alt-text>. For similar reasons, the position attribute should be set to “anchor” for a <graphic> element that is inside a larger display container such as a <fig>.

Attributes

alt-version Alternative Version of the Graphic
alternate-form-of Alternate Form of Graphic, Media Object, Etc.
id Identifier
mime-subtype Mime Subtype
mimetype Mime Type
position Position
xlink:actuate Actuating the Link
xlink:href Href (Linking Mechanism)
xlink:role Role of the Link
xlink:show Showing the Link
xlink:title Title of the Link
xlink:type Type of Link
xmlns:xlink XLink Namespace Declaration

Related Elements

This Suite contains several elements to describe non-XML material: <graphic>, <inline-graphic>, <media>, and <supplementary-material>. The elements <graphic> and <inline-graphic> are used for “still” images, i.e., photographs, diagrams, etc. The distinction between the two other elements is more subtle. The element <media> should be used for movies, audio clips, and media in other formats which are intrinsic to the document’s content, that is, the media object is discussed within the document. The element <supplementary-material> should be used for films, audio clips, or other material which enhances a document, but which is not discussed as part of the document.

Conversion Note: It is best practice to tag unlabeled graphical objects (no label such as “Figure 4.”) as <graphic>s, not as <fig>s. A common test to determine whether an object is a <fig> versus a <graphic> is to ask, “If there were a List of Figures for this article, should this object appear in that list?”

Model Information

Content Model

<!ELEMENT  graphic      %graphic-model;                              >

Description

The following, in order:

This element may be contained in:

<app> Appendix; <body> Body of the Article; <boxed-text> Boxed Text; <chem-struct> Chemical Structure (Display); <chem-struct-wrapper> Chemical Structure Wrapper; <disp-formula> Formula, Display; <fig> Figure; <named-content> Named Special (Subject) Content; <p> Paragraph; <sec> Section; <table-wrap> Table Wrapper; <td> Table Data Cell (XHTML table model); <th> Table Header Cell (XHTML table model)

Tagged Example


...
<sec sec-type="results">
<title>Results</title>
<p>We identified 703 abstracts, of which 687 were not 
relevant ... Details of randomisation procedures, 
treatment schedules, and numbers of patients followed 
up are given on the <italic>BMJ</italic> website.</p>
<fig id="F1">
<caption>
<p>Deaths among patients receiving day hospital care 
or alternative services. Odds ratios of death by end 
of follow up were calculated by fixed effects model. 
Heterogeneity between trials is presented as 
&#x03C7;<sup>2</sup></p>
</caption>
<alt-text>Deaths in hospitals or with alternative services</alt-text>
<graphic xmlns:xlink="http://www.w3.org/1999/xlink" 
xlink:href="fors2662.f1" alt-version="yes">
<object-id>456472</object-id>
</graphic>
</fig>
...
</sec>
...


Module

display.ent