<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/css" href="./slides-tei.css"?>
<!DOCTYPE TEI.2 SYSTEM "../../../Lite/DTD/teixlite.dtd" [
  <!ATTLIST figure
    width CDATA #IMPLIED
    height CDATA #IMPLIED
    url CDATA #IMPLIED >
  <!ATTLIST xref url CDATA #IMPLIED>
  <!-- Many browsers do not read an external DTD, so these entities are -->
  <!-- declared here (even though they are also declared in -->
  <!-- teixlite.dtd) so that those browsers won't throw an error-->
  <!ENTITY hellip	"&#x2026;"> <!-- HORIZONTAL ELLIPSIS -->
  <!ENTITY mdash	"&#x2014;"> <!-- EM DASH -->
  <!ENTITY ndash	"&#x2013;"> <!-- EN DASH -->
  <!ENTITY logo SYSTEM "./TEI-400.jpg" NDATA jpeg>
]>
<TEI.2>
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title>Advanced TEI Tagging</title>
	<author>Syd Bauman</author>
        <author>Julia Flanders</author>
      </titleStmt>
      <publicationStmt>
        <date value="2005-02-25"/>
        <distributor>TEI-Consortium (via website)</distributor>
        <address>
          <addrLine>info@tei-c.org</addrLine>
        </address>
        <availability>
          <p>Copyleft 2005 by Syd Bauman, Julia Flanders, and the
            Brown University Women Writers Project.</p>
        </availability>
	<pubPlace>Given at the winter 2005 TEI Workshop 2005-02-26/27 at
	    the University of Illinois at Urbana-Champaign</pubPlace>
      </publicationStmt>
      <sourceDesc>
	<p>None, this TEI Lite P4 XML file is the source.</p>
	<p>Except for the part on figures, which was imported from the
	  slides for Syd's talk <title>Advanced Topics in TEI</title>
	  Workshop 2004-11-04/05 at University of California,
	  Berkeley, the figures part of which was never actually
	  delivered</p>
	</sourceDesc>
     </fileDesc>
    <revisionDesc>
<change><date value="2005-02-28">Mon, 28 Feb 05</date>
	<respStmt><name>Syd Bauman</name>
	<resp>workshop co-presenter</resp></respStmt>
	<item>Updates for use on TEI website</item>
	</change>
    </revisionDesc>
   </teiHeader>
   <text>
     <body>

	<div rend="slide">
	<head>Identifying and Pointing</head>
	<list>
	  <item>XML provides ID attribute type</item>
	  <item>In TEI it is <emph>always</emph> called <ident
	      type="attrName">id</ident></item>
	  <item>Must be unique within the documnt</item><item>An IDREF
	    attribute <soCalled>points</soCalled> to the ID attribute
	    with the same value</item><item><ident
	      type="attrName">target</ident>, <ident
	      type="attrName">lang</ident></item>
	</list>
      </div>
      
      <div rend="slide"><head>Standardizing names</head>
	<list>
	  <item><ident type="attrName">reg</ident> provides a
	    regularized form of the name</item>
	  <item><ident type="attrName">key</ident> provides a key into
	    a database of names</item><item>Permitted on all naming
	    elements</item>
	</list>
      </div>
     	
      <div rend="slide">
	<head>Notes and annotation</head>
	<p>Basically just a hypertextual link</p>
	<p>You can encode notes inline (where they appear):</p>
	<eg><![CDATA[<p>We passed Albany <note>Capital of New
York</note> at 4:00 today.</p>]]></eg>
      </div>
     	
      <div rend="slide">
	<head>Some disadvantages&hellip;</head>
	<list>
	  <item>False proximity</item>
	  <item>Confusing to read</item>
	  <item>Only lets you annotate points, not ranges</item>
	</list>
      </div>
     	
      <div rend="slide">
	<head>A more adequate encoding</head>
	<list>
	  <item>Identify what you’re annotating and give it an <ident type="attrName">id</ident></item>
	  <item>Point from the <gi>note</gi> to the anchor point using <ident type="attrName">target</ident></item>
	  <item>Optional: point back from anchor to note:
	    <list>
	      <item>identify the <gi>note</gi> and give it an <ident type="attrName">id</ident></item>
	      <item>Point from the anchor point to the <gi>note</gi></item>
	    </list>
	  </item>
	  <item>Put the <gi>note</gi> wherever you like&hellip;</item></list>
      </div>
      
      <div rend="slide"><head>Sample <gi>note</gi></head>
	<eg><![CDATA[<p>The novelist <name id="A01">Francis Burney</name>,
in each of her notebooks ... 
<!-- ... -->
<note target="A01">Author of <title>Cecilia</title>.</note>]]></eg>
      </div>

      <div rend="slide">
	<head>Sample <gi>note</gi></head>
	<eg><![CDATA[<p>The novelist <name id="A01" corresp="N01">Francis
Burney</name>, in each of her notebooks ... 
<!-- ... -->
<note target="A01" id="N01">Author of <title>Cecilia</title>.</note>]]></eg>
      </div>

      <div rend="slide">
	<head>References and cross-references</head>
	<p><gi>ref</gi> and <gi>ptr</gi>: references within this text
	  <list>
	    <item>Uses ID/IDREF</item>
	    <item><gi>ref</gi> has content</item>
	  <item><gi>ptr</gi> does not</item>
	  </list>
<eg><![CDATA[Please see <ref target="C12">Chapter 12, <title>Birds</title>.</ref>]]></eg>
<eg><![CDATA[Please see <ptr target="C12"/>.]]></eg></p>
	<p><gi>xref</gi> and <gi>xptr</gi>: references outside the text
	  <list>
	    <item>Uses extended pointer syntax
	      <list>
		<item>it is a
		  <emph>very</emph> common extension to use a URL on <ident
		    type="attrName">url</ident> instead</item>
	      </list></item>
	    <item><gi>xref</gi> has content</item>
	    <item><gi>xptr</gi> does not</item>
	  </list></p>
      </div>

      <div rend="slide">
	<head>Alternative readings</head>
	<p><code>&lt;sic corr="bird"></code>brid<code>&lt;/sic></code></p>
	<p><code>&lt;corr sic="brid"></code>bird<code>&lt;/corr></code></p>
	<p><code>&lt;orig reg="Jesus"></code>Iesvs<code>&lt;/orig></code></p>
	<p><code>&lt;reg orig="Iesvs"></code>Jesus<code>&lt;/reg></code></p>
	<p><code>&lt;abbr expan="Obedient"></code>Ob’t<code>&lt;/abbr></code></p>
	<p><code>&lt;expan abbr="Ob’t"></code>Obedient<code>&lt;/expan></code></p>
      </div>

      <div rend="slide">
	<head>Foreign languages</head>
	<p>Use the <ident type="attrName">lang</ident> attribute on
	  the element containing the language</p>
	<p>If no element, use <gi>foreign</gi></p>
	<p>Place a <gi>language</gi> element in the header with an
	  <ident type="attrName">id</ident> value from RFC 3066 (or
	  its successor) that identifies that language</p>
      </div>

      <div rend="slide">
	<head>Encoding the physical document</head>
	<p><soCalled>Break</soCalled> elements: <gi>lb</gi>, <gi>cb</gi>, and <gi>pb</gi></p>
	<p><gi>milestone</gi> (for signatures, other similar structures)</p>
	<p>Forme work: <code>&lt;fw type="..."></code></p>
	<list type="unordered">
	  <item>Page numbers</item>
	  <item>Signatures</item>
	  <item>Running heads</item>
	  <item>Press figures</item>
	  <item>Catchwords </item>
	</list>
      </div>

      <div rend="slide">
	<head>A typical page break&hellip;</head>
	<eg><![CDATA[<p> ...
<lb/>and there it stopped.
<fw type="catch">The</fw>
<pb n="5"/>
<milestone unit="sig" n="A3r"/>
<fw type="pageNum">5</fw>
The next thing he knew ... </p>]]></eg>
      </div>

      <div rend="slide">
	<head>Illegibility</head>
	<p><gi>unclear</gi>: where you can see it but not clearly</p>
	<p><gi>supplied</gi>: where you can’t see it but you know what it says</p>
	<p><gi>gap</gi>: where you can’t see it and you don’t know what it says</p>
	<p><gi>damage</gi>: where the document is damaged</p>
      </div>

      <div rend="slide">
	<head>Linking <gi>figure</gi> to an image: classic code</head>
	<eg><![CDATA[<!DOCTYPE TEI.2 PUBLIC "-//TEI P4//DTD Main DTD Driver File//EN"
       	               "/path/to/tei2.dtd" [
  <!ENTITY % TEI.XML      'INCLUDE' >
  <!ENTITY % TEI.prose    'INCLUDE' >
  <!ENTITY % TEI.linking  'INCLUDE' >
  <!ENTITY % TEI.figures  'INCLUDE' >
  <!NOTATION jpeg PUBLIC "ISO DIS 10918//NOTATION JPEG Graphics Format//EN" >
  <!ENTITY logo SYSTEM "./TEI-400.jpg" NDATA jpeg >
  ]>
<TEI.2>
  <teiHeader>
    <!-- ... -->
  </teiHeader>
  <text>
    <body>
      <div rend="slide">
        <head>Linking <gi>figure</gi> to an image: classic image</head>
        <p>
          <figure entity="logo">
            <head>The TEI Logo</head>
            <figDesc>Stylized yellow angle brackets with the letters
              <mentioned>TEI</mentioned> in between and <mentioned>text
                encoding initiative</mentioned> underneath.</figDesc>
          </figure>
        </p>
      </div>
    </body>
  </text>
</TEI.2>]]></eg>
      </div>
      <div rend="slide">
	<head>Linking <gi>figure</gi> to an image: classic image</head>
	<p>
	  <figure entity="logo">
	    <head>The TEI Logo</head>
	    <figDesc>Stylized yellow angle brackets with the letters <mentioned>TEI</mentioned> in
	      between and <mentioned>text encoding initiative</mentioned> underneath.</figDesc>
	  </figure>
	</p>
      </div>

      <div rend="slide">
	<head>Linking <gi>figure</gi> to an image: hack code</head>
	<eg><![CDATA[<?xml version="1.0" ...?>
<!DOCTYPE ... [
  <!-- ... -->
  <!ATTLIST xref url CDATA #IMPLIED >
  <!ATTLIST xptr url CDATA #IMPLIED >
  <!ATTLIST figure width CDATA #IMPLIED
                   height CDATA #IMPLIED
                   scale CDATA #IMPLIED
                   url CDATA #IMPLIED >
  ]>
  <!-- ... -->
  <div rend="slide">
    <head>Linking <gi>figure</gi> to an image: hack image</head>
    <p>
      <figure url="./TEI-400.jpg">
        <head>The TEI Logo</head>
        <figDesc>Stylized yellow angle brackets with the letters
          <mentioned>TEI</mentioned> in between and <mentioned>text
            encoding initiative</mentioned> underneath.</figDesc>
      </figure>
    </p>
  </div>]]></eg>
      </div>
      <div rend="slide">
	<head>Linking <gi>figure</gi> to an image: hack image</head>
	<p>
	  <figure url="./TEI-400.jpg" width="200">
	    <head>The TEI Logo</head>
	    <figDesc>Stylized yellow angle brackets with the letters <mentioned>TEI</mentioned> in
	      between and <mentioned>text encoding initiative</mentioned> underneath.</figDesc>
	  </figure>
	</p>
      </div>
      <div rend="slide">
	<head>Linking <gi>figure</gi> to an image: P5 code</head>
	<eg><![CDATA[<figure>
  <graphic target="./TEI-400.jpg"/>
    <figDesc>Stylized yellow angle brackets with the letters
      <mentioned>TEI</mentioned> in between and <mentioned>text
      encoding initiative</mentioned> underneath.</figDesc>
</figure>]]></eg>
      </div>
     	
      <div rend="slide">
	<head>Title Pages</head>
	<p>A few basic parts:</p>
	<list type="unordered">
	  <item><gi>titlePage</gi></item>
	  <item><gi>docTitle</gi> with nested <gi>titlePart</gi></item>
	  <item><gi>byline</gi> with nested <gi>docAuthor</gi></item>
	  <item><gi>argument</gi>, <gi>epigraph</gi>, <gi>imprimatur</gi></item>
	  <item><gi>docEdition</gi></item>
	  <item><gi>docImprint</gi> with <gi>pubPlace</gi>, <gi>publisher</gi>,
	    <gi>docDate</gi></item>
	</list>
      </div>

      <div rend="slide">
	<head>Fragmentation and overlap: the problem</head>
	<eg><![CDATA[<l>On a tree by a river a little tomtit</l>
<l>Sang <q>Willow, titwillow, titwillow!</q></l>
<l>And I said to him, <q>Dicky-bird,
  why do you sit</l>
<l>Singing <q>Willow, titwillow, titwillow!</q></l></q>]]></eg>
      </div>
      <div rend="slide">
	<head>Fragmentation and overlap: a solution</head>
	<eg><![CDATA[<l>On a tree by a river a little tomtit</l>
<l>Sang <q>Willow, titwillow, titwillow!</q></l>
<l part="I">And I said to him,</l> <q><l part="F">Dicky-bird,
  why do you sit</l>
<l>Singing <q>Willow, titwillow, titwillow!</q></l></q>]]></eg>
      </div>
     	
     </body>
   </text>
</TEI.2>
