Example: <refsDecl> (references declaration)

These search results reproduce every example of the use of <refsDecl> in the Guidelines, including all localised and translated versions. In some cases, the examples have been drawn from discussion of other elements in the Guidelines and illustrating the use of <refsDecl> is not the main focus of the passage in question. In other cases, examples may be direct translations of each other, and hence identical from the perspective of their encoding.

2 The TEI Header


<teiHeader>

<teiHeader>
 <fileDesc>
  <titleStmt>
   <title>Shakespeare: the first folio (1623) in electronic form</title>
   <author>Shakespeare, William (1564–1616)</author>
   <respStmt>
    <resp>Originally prepared by</resp>
    <name>Trevor Howard-Hill</name>
   </respStmt>
   <respStmt>
    <resp>Revised and edited by</resp>
    <name>Christine Avern-Carr</name>
   </respStmt>
  </titleStmt>
  <publicationStmt>
   <distributor>Oxford Text Archive</distributor>
   <address>
    <addrLine>13 Banbury Road, Oxford OX2 6NN, UK</addrLine>
   </address>
   <idno type="OTA">119</idno>
   <availability>
    <p>Freely available on a non-commercial basis.</p>
   </availability>
   <date when="1968">1968</date>
  </publicationStmt>
  <sourceDesc>
   <bibl>The first folio of Shakespeare, prepared by Charlton Hinman (The Norton Facsimile,
         1968)</bibl>
  </sourceDesc>
 </fileDesc>
 <encodingDesc>
  <projectDesc>
   <p>Originally prepared for use in the production of a series of old-spelling
         concordances in 1968, this text was extensively checked and revised for use during the
         editing of the new Oxford Shakespeare (Wells and Taylor, 1989).</p>
  </projectDesc>
  <editorialDecl>
   <correction>
    <p>Turned letters are silently corrected.</p>
   </correction>
   <normalization>
    <p>Original spelling and typography is retained, except that long s and ligatured
           forms are not encoded.</p>
   </normalization>
  </editorialDecl>
  <refsDecl xml:id="ASLREF">
   <cRefPattern matchPattern="(\S+) ([^.]+)\.(.*)"
    replacementPattern="#xpath(//div1[@n='$1']/div2/[@n='$2']//lb[@n='$3'])">

    <p>A reference is created by assembling the following, in the reverse order as that
           listed here: <list>
      <item>the <att>n</att> value of the preceding <gi>lb</gi></item>
      <item>a period</item>
      <item>the <att>n</att> value of the ancestor <gi>div2</gi></item>
      <item>a space</item>
      <item>the <att>n</att> value of the parent <gi>div1</gi></item>
     </list></p>
   </cRefPattern>
  </refsDecl>
 </encodingDesc>
 <revisionDesc>
  <list>
   <item>
    <date when="1989-04-12">12 Apr 89</date> Last checked by CAC</item>
   <item>
    <date when="1989-03-01">1 Mar 89</date> LB made new file</item>
  </list>
 </revisionDesc>
</teiHeader>

2.3.6.1 Prose Method

<refsDecl>
 <p>The <att>n</att> attribute of each text in this corpus carries a
     unique identifying code for the whole text. The title of the text is
     held as the content of the first <gi>head</gi> element within each
     text. The <att>n</att> attribute on each <gi>div1</gi> and
  <gi>div2</gi> contains the canonical reference for each such
     division, in the form 'XX.yyy', where XX is the book number in Roman
     numerals, and yyy the section number in arabic. Line breaks are
     marked by empty <gi>lb</gi> elements, each of which includes the
     through line number in Casaubon's edition as the value of its
  <gi>n</gi> attribute.</p>
 <p>The through line number and the text identifier uniquely identify
     any line. A canonical reference may be made up by concatenating the
  <gi>n</gi> values from the <gi>text</gi>, <gi>div1</gi>, or
  <gi>div2</gi> and calculating the line number within each part.</p>
</refsDecl>

2.3.6.3 Milestone Method

<refsDecl>
 <refState ed="firstunit="pagelength="2"
  delim="."/>

 <refState ed="firstunit="linelength="3"/>
</refsDecl>

<refsDecl>

<refsDecl>
 <cRefPattern matchPattern="([A-Za-z0-9]+) ([0-9]+):([0-9]+)"
  replacementPattern="#xpath(//body/div[@n='$1']/div[$2]/div3[$3])"/>

</refsDecl>

<refsDecl>

<refsDecl xml:id="fr_ASLREF">
 <cRefPattern matchPattern="(\S+) ([^.]+)\.(.*)"
  replacementPattern="#fr_xpath(//div1[@n='$1']/div2/[@n='$2']//lb[@n='$3'])">

  <p>Une référence a été créée en assemblant les éléments suivants dans l'ordre inverse de
       la liste qui suit : <list>
    <item>la valeur <att>n</att> du précédent <gi>lb</gi></item>
    <item>une période</item>
    <item>la valeur <att>n</att> de l'ancêtre <gi>div2</gi></item>
    <item>un espace</item>
    <item>la valeur<att>n</att> du parent <gi>div1</gi></item>
   </list></p>
 </cRefPattern>
</refsDecl>

<refsDecl>

<refsDecl>
 <p>參照是將位於最高層級的<gi>div</gi>元素的屬性<att>n</att>值串聯起來,
     其後跟著空格和續接的下一層級<gi>div</gi>,接著冒點,
     然後是續接的下一(最低) 層級的<gi>div</gi>所組成。</p>
</refsDecl>

<refsDecl>

<refsDecl>
 <p>References are made up by concatenating the value for the
  <att>n</att> attribute on the highest level <gi>div</gi>
     element, followed by a space, followed by the sequential
     number of the next level <gi>div</gi> followed by a colon
     followed by the sequential number of the next (and lowest)
     level <gi>div</gi>.</p>
</refsDecl>

3 Elements Available in All TEI Documents


3.10.4 Declaring Reference Systems

<encodingDesc>
 <refsDecl>
  <cRefPattern matchPattern="([^ ]+) ([0-9]+)\.([0-9]+)\.([0-9]+)"
   replacementPattern="#xpath(//div1[@n='$1']/div2[@n='$2']/div3[@n='$3']/l[@n='$4']">

   <p>A canonical reference is assembled with
    <list>
     <item>the name of the <label>work</label>: the
      <att>n</att> of a <gi>div1</gi>,</item>
     <item>a space,</item>
     <item>the number of the <label>book</label>: the
      <att>n</att> of a child <gi>div2</gi>,</item>
     <item>a full stop</item>
     <item>the number of the <label>poem</label>: the
      <att>n</att> of a child <gi>div3</gi>,</item>
     <item>the line number: the <att>n</att> value of a
             child <gi>l</gi></item>
    </list></p>
  </cRefPattern>
  <cRefPattern matchPattern="([^ ]+) ([0-9]+)\.([0-9]+)"
   replacementPattern="#xpath(//div1[@n='$1']/div2[@n='$2']/div3[@n='$3']">

   <p>Same as above, but without the last component (full
         stop followed by the <gi>l</gi>'s <att>n</att>.</p>
  </cRefPattern>
  <cRefPattern matchPattern="([^ ]+) ([0-9]+)"
   replacementPattern="#xpath(//div1[@n='$1']/div2[@n='$2']">

   <p>Same as above, but without the poem component (full
         stop followed by the <gi>div3</gi>'s <att>n</att>.</p>
  </cRefPattern>
 </refsDecl>
</encodingDesc>

3.10.4 Declaring Reference Systems

<refsDecl>
 <cRefPattern matchPattern="([^ ]+ [0-9]+\.[0-9]+\.[0-9]+)"
  replacementPattern="#xpath(//l[@n='$1')"/>

</refsDecl>

3.10.4 Declaring Reference Systems

<refsDecl>
 <cRefPattern matchPattern="([^ ]+ [0-9]+\.[0-9]+\.[0-9]+)"
  replacementPattern="#xpath(//l[@n='$1')"/>

 <cRefPattern matchPattern="([^ ]+ [0-9]+\.[0-9]+)"
  replacementPattern="#xpath(//div2[@n='$1')"/>

</refsDecl>

3.10.4 Declaring Reference Systems

<refsDecl>
 <cRefPattern matchPattern="(.*)"
  replacementPattern="#$1"/>

</refsDecl>

3.10.4 Declaring Reference Systems

<refsDecl>
 <p>Standard references to work, book, poem, and line may be
     constructed from the milestone tags in the text.</p>
</refsDecl>

3.10.4 Declaring Reference Systems

<refsDecl>
 <refState ed="E1unit="workdelim=" "/>
 <refState ed="E1unit="bookdelim="."/>
 <refState ed="E1unit="poemdelim=":"/>
 <refState ed="E1unit="line"/>
</refsDecl>

16 Linking, Segmentation, and Alignment


16.2.5 Canonical References

<refsDecl xml:id="biblical">
 <cRefPattern matchPattern="(.+) (.+):(.+)"
  replacementPattern="#xpath(//div[@n='$1']/div[@n='$2']/div[@n='$3]')">

  <p>This pointer pattern extracts and references the <q>book,</q>
   <q>chapter,</q> and <q>verse</q> parts of a biblical reference.</p>
 </cRefPattern>
 <cRefPattern matchPattern="(.+) (.+)"
  replacementPattern="#xpath(//div[@n='$1']/div[$2])">

  <p>This pointer pattern extracts and references the <q>book</q> and
   <q>chapter</q> parts of a biblical reference.</p>
 </cRefPattern>
 <cRefPattern matchPattern="(.+)"
  replacementPattern="#xpath(//div[@n='$1'])">

  <p>This pointer pattern extracts and references just the <q>book</q>
       part of a biblical reference.</p>
 </cRefPattern>
</refsDecl>

16.2.5.2 Complete and Partial URI Examples

<refsDecl xml:id="USC">
 <cRefPattern matchPattern="([0-9][0-9])\s*U\.?S\.?C\.?\s*[Cc](h(\.|ap(ter|\.)?)?)?\s*([1-9][0-9]*)"
  replacementPattern="http://uscode.house.gov/download/pls/$1C$5.txt">

  <p>Matches most standard references to particular
       chapters of the United States Code, e.g.
   <val>11USCC7</val>, <val>17 U.S.C. Chapter 3</val>, or
   <val>14 USC Ch. 5</val>. Note that a leading zero is
       required for the title (must be two digits), but is not
       permitted for the chapter number.</p>
 </cRefPattern>
 <cRefPattern matchPattern="([0-9][0-9])\s*U\.?S\.?C\.?\s*[Pp](re(lim(inary)?)?)?\s*[Mm](at(erial)?)?"
  replacementPattern="http://uscode.house.gov/download/pls/$1T.txt">

  <p>Matches references to the preliminary material for a
       given title, e.g. <val>11USCP</val>, <val>17 U.S.C.
         Prelim Mat</val>, or <val>14 USC pm</val>.</p>
 </cRefPattern>
 <cRefPattern matchPattern="([0-9][0-9])\s*U\.?S\.?C\.?\s*[Aa](ppend(ix)?)?"
  replacementPattern="http://uscode.house.gov/download/pls/$1A.txt">

  <p>Matches references to the appendix of a given tile,
       e.g. <val>05USCA</val>, <val>11 U.S.C. Appendix</val>,
       or <val>18 USC Append</val>.</p>
 </cRefPattern>
</refsDecl>
<!-- ... -->
<p>The example in section 10 is taken
   from <ref cRef="17 USC Ch 1">Subject Matter and Scope of
     Copyright</ref>.</p>