XML requirements for
CSP's FACETS journal

Instructions for using this documentation

• ■ Revision history

Article XML Requirements

• ■ Journal Metadata

ID Syntaxes

• ■ Table of ID Syntaxes

File-Naming Conventions

• ■ Filenames

Full-text Examples

• ■ Full-Text Examples

DTD

• ■ DTD for use with FACETS articles

Article object

Figures and graphics

Element or context:

<fig>,<graphic>, and <inline-graphic>

Requirements:

A. Figures

N.B. <fig> should be used only for graphics that have captions and titles, except for the unique case of graphical abstracts.

1. Give each <fig> a unique id of the form "f{some number}"
2. Follow the CSP file-naming convention for graphics contained in figures
3. Use a <label> element to contain the numeric figure label (see the example)
4. Put the caption within <p> inside <caption>
5. Set the attribute 'xlink:href' on <graphic> to the file name of the figure file
6. Do not use any attribute on <graphic> within <fig> (i.e., do not use @orientation, @position, @xlink-type, etc)
7. Do not set <fig>
8. Set @position on <fig> as follows:
   • If the figure image will exceed the width of the column of the PDF, then set the value of @position on <fig> to "margin"
   • If the figure caption will run beneath the figure in the composed PDF page, then set the value of @position on <fig> to "anchor"
   • If the figure caption will float to the side of the figure in the composed PDF page, then set @position on <fig> to "float"

B. Displayed or inline graphics that are not part of figures

1. Give each <graphic> or <inline-graphic> a unique id of the form "c{some number}"
2. Follow the CSP file-naming convention for displayed and inline graphic files that are not part of figures

           <!---In the following example, the figure image takes up 60% of the column width of the composed PDF page-->
           <fig id="f1" position="anchor" orientation="portrait">
             <label>Fig. 1.</label>
             <caption>
             <p>Geology of northern Stikinia with a focus on the Hazelton Group and related intrusions, and the location and context of major associated mineral deposits.</title><p> Inset shows location of this area in the Canadian Cordillera.</p>
             </caption>
             <graphic xlink:href="cjes-2014-0155f1.tif"/>
           </fig>
           <!---In the following example, the figure image takes up 45% of the column width of the composed PDF page-->
           <fig id="f2" position="float" orientation="portrait">
             <label>Scheme 1.</label>
             <caption>
             <p>Scheme of plastiquinone.</p>
             </caption>
             <graphic xlink:href="cjes-2014-0155f2.tif"/>
           </fig>