P5: Guidelines for Electronic Text Encoding and Interchange

<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>

<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>

<refsDecl>
 <refState ed="first" unit="page" length="2"
  delim="."/>
 <refState ed="first" unit="line" length="3"/>
</refsDecl>

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

<refsDecl>
 <cRefPattern matchPattern="([A-Za-z0-9]+) ([0-9]+):([0-9]+)"
  replacementPattern="#xpath(//body/div[@n='$1']/div[$2]/div3[$3])"/>
</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>
 <p>參照是將位於最高層級的<gi>div</gi>元素的屬性<att>n</att>值串聯起來，
   其後跟著空格和續接的下一層級<gi>div</gi>，接著冒點，
   然後是續接的下一(最低) 層級的<gi>div</gi>所組成。</p>
</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>

<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>

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

<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>

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

<refsDecl>
 <citeStructure unit="work" match="//div1"
  use="@n">
  <citeStructure unit="book" match="div2"
   use="@n" delim=" ">
   <citeStructure unit="poem" match="div3"
    use="@n" delim=".">
    <citeStructure unit="line" match="l"
     use="@n" delim="."/>
   </citeStructure>
  </citeStructure>
 </citeStructure>
</refsDecl>

<refsDecl>
 <citeStructure unit="work" match="//div1"
  use="@n">
  <citeData property="http://purl.org/dc/terms/title"
   use="head"/>
  <citeStructure unit="book" match="div2"
   use="@n" delim=" ">
   <citeData property="http://purl.org/dc/terms/title"
    use="head"/>
   <citeStructure unit="poem" match="div3"
    use="@n" delim=".">
    <citeData property="http://purl.org/dc/terms/title"
     use="head"/>
    <citeStructure unit="line" match="l"
     use="@n" delim="."/>
   </citeStructure>
  </citeStructure>
 </citeStructure>
</refsDecl>

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

<refsDecl>
 <refState ed="E1" unit="work" delim=" "/>
 <refState ed="E1" unit="book" delim="."/>
 <refState ed="E1" unit="poem" delim=":"/>
 <refState ed="E1" unit="line"/>
</refsDecl>

<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>

<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>

<refsDecl xml:id="biblical2">
 <citeStructure unit="book"
  match="//body/div" use="@n">
  <citeStructure unit="chapter" match="div"
   use="@n" delim=" ">
   <citeStructure unit="verse" match="div"
    use="@n" delim=":"/>
  </citeStructure>
 </citeStructure>
</refsDecl>