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

<citationref> (Citation Reference) Description .email comment.

Description

This element contains a reference to a citation from within text. The target element should therefore be one of the following:


-	<ref-book>


-	<ref-conf>


-	<ref-govpub>


-	<ref-patent>


-	<ref-govpub>


-	<ref-periodic>


-	<ref-web>

Here is a typical example:

... from a trajectory analysis (15)

... from a trajectory analysis <citationref linkend="CIT0991">15</citationref>

Note the missing backets from the tagged example above. Such characters can be added automatically, if required, and their presence or absence will depend as much on the rules for a given journal as for general conventions adopted for a given electronic re-publishing system.

Sometimes, there is a reference to a citation that includes the author name and the date of the publication, as in the following example:

... from a trajectory analysis (Smith, 1991) ...

In this case, the tagging should be:

... from a trajectory analysis (Smith,
<citationref linkend="CIT0991">1991</citationref>) ...

Note the inclusion of both the name, and the brackets, around the reference element. This is the exception to the usual rule that such punctuation should be omitted.

Sometimes, however, there are several references to citations that involve the same author, as in the following examples.

First, there might be two or more dates given separately:

... from a trajectory analysis (Smith, 1991, 1993, 2000)

... from a trajectory analysis (Smith,
<citationref linkend="CIT1991">1991</citationref>
<citationref linkend="CIT1993">1993</citationref>
<citationref linkend="CIT2000">2000</citationref>) ...

Second, there might be a range of dates given (even though there will not be a citation for each of the dates in the range):

... from a trajectory analysis (Smith, 1991 - 2000)

... from a trajectory analysis (Smith,
<refrange text="1991-2000">
  <citationref linkend="CIT1991">1991</citationref>
  <citationref linkend="CIT1993">1993</citationref>
  <citationref linkend="CIT2000">2000</citationref>
</refrange>) ...

Third, there might be multiple citations in the same year, but the year number is not repeated in the text:

... from a trajectory analysis (Smith, 1991a, b)

... from a trajectory analysis (Smith,
<citationref linkend="CIT0001">1991a</citationref>
<citationref linkend="CIT0002">b</citationref>) ...

Finally, there might be a range and individual references to citations in the same year:

... from a trajectory analysis (Smith, 1991a-c, e)

... from a trajectory analysis (Smith,
<refrange text="1991a-c">
  <citationref linkend="CIT0001">1991a</citationref>
  <citationref linkend="CIT0002">1991b</citationref>
  <citationref linkend="CIT0003">1991c</citationref>
</refrange><citationref linkend="CIT0004">e</citationref>) ...

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:

- (via "Links from Text" group: <addinfo> <caption> <endnotes> <endnote> <refrange>

- - (via "Document Title Content" group: <supertitle> <title> <subtitle> <shorttitle> <abbrevtitle> <doititle> <shortsectionhead> )

- - (via "Title Content" group: <journaltitle> <journalsubtitle> <chaptitle> <pubname> <presentationtitle> <collectworktitle> <docpubtitle> <patenttitle> <articletitle> <listtitle> )

- - (via "Paragraph Content" group: <authornote> <para> <poemline> <computertext> <source> <entry> ) )

- (via "Name Mixture" group: <surname> <givenname> <inits> <middlename> <prefix> <suffix> <honorific> <degree> )

Model Diagram

The DTD model for this element:

--+(choice of TEXT with elements repeated) 
  |  
  |--+(repeatable choice) [Reference Content]
  |  |  
  |  |--+(choice) [Formatting in Text]
  |  |  |  
  |  |  |-- sub  -- (TEXT and elements)
  |  |  |  
  |  |  |-- sup  -- (TEXT and elements)
  |  |  |  
  |  |  |-- b  -- (TEXT and elements)
  |  |  |  
  |  |  |-- i  -- (TEXT and elements)
  |  |  |  
  |  |  |-- smallcaps  -- (TEXT and elements)
  |  |  |  
  |  |  |-- u  -- (TEXT and elements)
  |  |  |  
  |  |  |-- box  -- (TEXT and elements)
  |  |  |  
  |  |  |-- roman  -- (TEXT and elements)
  |  |  |  
  |  |  |-- script  -- (TEXT and elements)
  |  |  |  
  |  |  |-- tt  -- (TEXT and elements)
  |  |  |  
  |  |  |-- strikethrough  -- (TEXT and elements)
  |  |  |  
  |  |  |-- overline  -- (TEXT and elements)
  |  |  |  
  |  |  |-- newpage  
  |  |  |  
  |  |  |-- query  -- TEXT

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 citationref                    (#PCDATA | %ReferenceContent;)*>
<!ATTLIST citationref
                linkend                  IDREF  #REQUIRED 
               %a-group-CommonIDAttrs;>

Defined in DTD section Inline-level Content : Linking

General Attributes (shared with other elements)

Common Optional ID Attributes (a-group-CommonIDAttrs)

Local Attributes (defined for this element alone)

Attribute: linkend

Description

This attribute holds a copy of a unique value in an attribute of another element. This is used to form the link to that element.

Specification

This attribute is required. It holds a reference to a unique identifier code on another element.

DTD Definition

                linkend                  IDREF  #REQUIRED