csp logo

Instructions for using this documentation

Article XML Requirements

Article Objects

ID Syntaxes

File-Naming Conventions

Full-text Examples

DTD

Article object

Links, internal

Set the attributes 'ref-type' and 'rid' on <xref> to the appropriate value, as described in the following table:

For links between

<xref> should contain

Set @ref‑type attribute to

Set @rid attribute to

Example

Authors and affiliations

Superscripted letter

aff

The affiliation id (e.g., affa)

<xref ref-type="aff" rid="affa"><sup>a</sup></xref>

Authors and footnotes in the metadata(including present address)

Superscripted symbol (in the following order: *, †, ‡, §, ∥, ¶ **, ††, ‡‡, §§, ∥∥, etc.)

author-fn

The footnote id (eg. "afn1")

<xref ref-type="author-fn" rid="afn1"><sup>&dagger;</sup></xref>

Callouts and boxes (boxed-text)

Baseline text (e.g., “Box. 1.”)

box

The id for the box (e.g., “box1”)

<xref ref-type="box" rid="box1">Box. 1</xref>

Callouts and figures

Baseline text (e.g., “Fig. 1.”)

fig

The id for the figure (e.g., “f1”)

<xref ref-type="fig" rid="fig1">Fig. 1</xref>

Callouts and footnotes in the text (not footnotes on authors or table footnotes; see separate requirements for these in this table)

Superscript number

fn

The id for the footnote (e.g., "fn1")

<xref ref-type="fn" rid="fn1"><sup>1</sup></xref>

Callouts and displayed equations

Baseline text (e.g., “Eq. 1”)

disp-formula

The id for the <disp-formula> element containing the math (e.g., “eq1”)

<xref ref-type="disp-formula" rid="eq1">Eq. 1</xref>

Callouts and tables

Baseline text (e.g., “Table 1”)

table

The id of the <table-wrap> element containing the table (e.g., “tab1”)

<xref ref-type="table" rid="tab1">Table 1</xref>

Callouts and table footnotes

Superscripted, italic lowercase letters or superscripted symbols (copy editor’s choice)

table-fn

The id of the table footnote (e.g., “tab1fn1”)

<xref ref-type="table-fn" rid="tab1fn2"><sup>&dagger;</sup></xref>

OR

<xref ref-type="table-fn" rid="tab1fn2"><sup><italic>a</italic></sup></xref>

Citations in the body of the paper and a bibliographic reference in a reference list

The author(s) and date of citation

bib-ref

The id of the <mixed-citation> element containing the whole reference (e.g., "refg1")

<xref ref-type="bib-ref" rid="ref1">Smith et al. 2006</xref>

 

Supplementary material mentions in the text and the supplementary material section

Link the text mention

supp-material

The id of the <supplementary-material> element in <sec sec-type="supplementary-material"> (e.g., "sm1")

<xref ref-type="supp-material" rid="sm1">See Table S1</xref>