Taylor & Francis Journal Article DTD User Guide

DTD User Guide (1.10.1) for DTD "Taylor & Francis Journal Article DTD" version 1.10

Main Menu Change History Introduction Topics Attributes Attributes (shared) Elements Elements (grouped) DTD

<figure> Description .email comment.

Description

This element contains information about a figure in the article, including its title, caption, reference to a graphic file or embedded structure, and finally any endnotes:

<figure DOI="10.1081/CNV-120005919" articleid="120005919" filename="F0001.gif"
        id="F0001">
  <caption>Figure 1. ECOG 1594: Overall survival of stage IIIB NSCLC.</caption>
  <graphic entityref="F0001" width="380" height="252"/>
</figure>

Another example:

<figure id="F0001" filename="F0001.gif" orient="port" pgwide="yes" 
articleid="120027636" productid="CSS" doi="10.1081/CSS-120027636-F0001">
  <caption><b>Figure 1.</b> Lead fractions extracted from growing media.
  Values followed by the same letter within the same group do not differ
  significantly at the 5&percnt; level according to the least significant difference test.</caption>
  <graphic fileref=".\Fig\F0001" entityref="F0001" fileformat="gif" height="235" width="362"/>
</figure>

Parent Elements

The elements listed below may directly contain this element. They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.

Parent elements: <abstract> <para> <listitem> <definition> <entry>

- (via "Section Mixture" group: <intro> <section1> <section2> <section3> <section4> <section5> <summary> <ackno> <notesaddedinproof> )

Model Diagram

The DTD model for this element:

--+(sequence)
  |  
 title (optional) -- (TEXT and elements)
  |  
 caption (optional) -- (TEXT and elements)
  |  
  |--+(repeatable choice)
  |  |  
  |  |-- graphic  
  |  |  
  |  |-- chemeqn  -- (elements)
  |  |  
  |  |-- matheqn  -- (elements)
  |  |  
  |  |-- formula  -- (TEXT and elements)
  |  |  
  |  |-- compound  -- (elements)
  |  |  
  |  |-- structure  
  |  
 endnotes (optional) -- (TEXT and elements)

DTD Definition

The DTD contains the following element and attribute definitions (note that embedded links are to definitions within the DTD page of this guide):

<!ELEMENT figure                         (title?, caption?, 
                                              (graphic | chemeqn | matheqn | formula | compound | structure)+, endnotes?)>
<!ATTLIST figure
                orient                   (port | land)  #IMPLIED 
                pgwide                   (yes | no)  #IMPLIED 
                issuenum                 CDATA  #IMPLIED 
                articleid                CDATA  #REQUIRED 
                productid                CDATA  #REQUIRED 
                doi                      CDATA  #IMPLIED 
                colorgraphics            (yes | no)  "no" 
                primaryaudience          (Researcher | Professional | Librarian | Educator | 
                                          Non-specialist | Undergraduate | Consumer)  #IMPLIED 
                secondaryaudience        (Researcher | Professional | Librarian | Educator | 
                                          Non-specialist | Undergraduate | Consumer)  #IMPLIED 
                fulltextlink             CDATA  #IMPLIED 
               %a-group-YearOfPubAttrs;
               %a-group-InteractiveAttrs;
               %a-group-CommonIDAttrs;>

Defined in DTD section Block-level Content : Figures

General Attributes (shared with other elements)

Year of Publication Attributes (a-group-YearOfPubAttrs)

Interactive Attributes (a-group-InteractiveAttrs)

Common Optional ID Attributes (a-group-CommonIDAttrs)

Local Attributes (defined for this element alone)

Attribute: orient (Orientation)

Description

This attribute, if used, specifies that the figure should be displayed in "port"rait or "land"scape. When set to the landscape option, this is a good indication that the figure is wide, and may need to be treated in a special way even in non-page media. Although "port" is not an explicit default value, it should be treated as the assumed default value when this attribute is not present.

Specification

This attribute is not required. The allowed values are "port" and "land".

DTD Definition

                orient                   (port | land)  #IMPLIED

Attribute: pgwide (Page Wide)

Description

This attribute indicates that the figure must occupy the full width of the page when set to "yes". Although there is no explicit default value, the alternative setting of "no" should be assumed to be the default option that applies when the attribute is not present.

If the orient attribute is also present, the width is determined by the orientation, so the width of the page can be interpreted as the portrait width or the landscape width as appropriate.

Specification

This attribute is not required. The allowed values are "yes" and "no".

DTD Definition

                pgwide                   (yes | no)  #IMPLIED

Attribute: issuenum (Issue Number)

Description

This attribute holds the number of the issue of the journal that contained the article this figure appears in. It should only be needed if the figure is physically extracted from the rest of the article (when it can be copied from the issuenum on the <meta> element) and then allows this information to be carried with the figure. See also the articleid attribute.

Specification

This attribute is not required. It has text content.

DTD Definition

                issuenum                 CDATA  #IMPLIED

Attribute: articleid (Article Identifier)

Description

This attribute holds the identifier of the article this figure appears in (see articleid). It should only be needed if the figure is physically extracted from the rest of the article and then allows this information to be carried with the figure. See also the issuenum attribute.

<article articleid="120027636" ...>
  ...
  <figure id="F0001" ... articleid="120027636">...</figure>
  ...
</article>

Specification

This attribute is required. It has text content.

DTD Definition

                articleid                CDATA  #REQUIRED

Attribute: productid (Product Identifier)

Description

This attribute holds a copy of the value from the same attribute in the <meta> element, and is only needed if a figure is extracted from the rest of the article.

Specification

This attribute is required. It has text content.

DTD Definition

                productid                CDATA  #REQUIRED

Attribute: doi (Digital Object Identifier)

Description

This attribute holds a Digital Object Identifier for the figure, which will be the same as the DOI for the article, but with a suffix that conists of the figure identifier, as in "10.1081/CAR-120026597-F0001".

Specification

This attribute is not required. It has text content.

DTD Definition

                doi                      CDATA  #IMPLIED

Attribute: colorgraphics

Description

This attribute can be used to raise the fact that it consists of a colour image. It need only be used when the setting needs to be "yes" (there are colour images), because the default value is "no".

Specification

This attribute is required but has a default value of "no". The allowed values are "yes" and "no".

DTD Definition

                colorgraphics            (yes | no)  "no"

Attribute: primaryaudience

Description

This attribute identifies the primary audience for the figure, such as "Librarian" or "Undergraduate". If there is another likely audience, the secondaryaudience attribute can be used too (but must not contain the same value).

Specification

This attribute is not required. The allowed values are "Researcher", "Professional", "Librarian", "Educator", "Non-specialist", "Undergraduate" and "Consumer".

DTD Definition

                primaryaudience          (Researcher | Professional | Librarian | Educator | 
                                          Non-specialist | Undergraduate | Consumer)  #IMPLIED

Attribute: secondaryaudience

Description

This attribute identifies the seocndary audience for the figure, such as "Librarian" or "Undergraduate". It must only be used when a primary audience (see primaryaudience attribute) has also been used (and must not contain the same value).

Specification

This attribute is not required. The allowed values are "Researcher", "Professional", "Librarian", "Educator", "Non-specialist", "Undergraduate" and "Consumer".

DTD Definition

                secondaryaudience        (Researcher | Professional | Librarian | Educator | 
                                          Non-specialist | Undergraduate | Consumer)  #IMPLIED

Attribute: fulltextlink

Description

This attribute holds a URL (Uniform Resource Locator) that identifies the location and filename of a PDF file that contains the figure.

Specification

This attribute is not required. It has text content.

DTD Definition

                fulltextlink             CDATA  #IMPLIED