<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title type="main">TEI by Example</title>
        <title type="sub">Module 7: Critical Editing</title>
        <author xml:id="RvdB">Ron Van den Branden</author>
        <editor xml:id="EV">Edward Vanhoutte</editor>
        <editor xml:id="MT">Melissa Terras</editor>
        <sponsor>Association for Literary and Linguistic Computing (ALLC)</sponsor>
        <sponsor>Centre for Data, Culture and Society, University of Edinburgh, UK</sponsor> 
        <sponsor>Centre for Digital Humanities (CDH), University College London, UK</sponsor>
        <sponsor>Centre for Computing in the Humanities (CCH), King’s College London, UK</sponsor>
        <sponsor>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</sponsor>
        <funder>
          <address>
            <addrLine>Centre for Scholarly Editing and Document Studies (CTB)</addrLine>
            <addrLine>Royal Academy of Dutch Language and Literature</addrLine>
            <addrLine>Koningstraat 18</addrLine>
            <addrLine>9000 Gent</addrLine>
            <addrLine>Belgium</addrLine>
          </address>
          <email>ctb@kantl.be</email>
        </funder>
        <principal>Edward Vanhoutte</principal>
        <principal>Melissa Terras</principal>
      </titleStmt>
      <publicationStmt>
        <publisher>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</publisher>
        <distributor>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</distributor>
        <pubPlace>Gent</pubPlace>
        <address>
          <addrLine>Centre for Scholarly Editing and Document Studies (CTB)</addrLine>
          <addrLine>Royal Academy of Dutch Language and Literature</addrLine>
          <addrLine>Koningstraat 18</addrLine>
          <addrLine>9000 Gent</addrLine>
          <addrLine>Belgium</addrLine>
        </address>
        <availability status="free">
          <p>Licensed under a <ref target="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution ShareAlike 3.0 License</ref>
                    </p>
        </availability>
        <date when="2010-07-09">9 July 2010</date>
      </publicationStmt>
      <seriesStmt>
        <title>TEI By Example.</title>
        <respStmt>
          <name>Edward Vanhoutte</name>
          <resp>editor</resp>
        </respStmt>
        <respStmt>
          <name>Ron Van den Branden</name>
          <resp>editor</resp>
        </respStmt>
        <respStmt>
          <name>Melissa Terras</name>
          <resp>editor</resp>
        </respStmt>
      </seriesStmt>
      <sourceDesc>
        <p>Digitally born</p>
      </sourceDesc>
    </fileDesc>
    <encodingDesc>
      <projectDesc>
        <p>TEI By Example offers a series of freely available online tutorials walking individuals through the different stages in marking up a document in TEI (Text Encoding Initiative). Besides a general introduction to text encoding, step-by-step tutorial modules provide example-based introductions to eight different aspects of electronic text markup for the humanities. Each tutorial module is accompanied with a dedicated examples section, illustrating actual TEI encoding practise with real-life examples. The theory of the tutorial modules can be tested in interactive tests and exercises.</p>
      </projectDesc>
    </encodingDesc>
    <profileDesc>
      <langUsage>
        <language ident="en-GB">en-GB</language>
      </langUsage>
    </profileDesc>
    <revisionDesc>
      <change when="2020-06-28" who="#RvdB">integrated examples in a single file</change>
    </revisionDesc>
  </teiHeader>
  <text xml:id="TBED07v00" type="examples">
    <body>
            <div xml:id="dickinson" type="example">
        <head>Emily Dickinson: <title level="a">Faith is a Fine Invention</title>
                </head>
        <p>The following example is a critical edition of Emily Dickinson’s poem <title level="a">Faith is a Fine Invention</title>, encoded and made available by the University of Maryland University Libraries.</p>
        <p>In this example, 7 different versions of a 4-line poem are encoded using the parallel segmentation method. Each apparatus entry (<gi>app</gi>) contains different <gi>rdg</gi> elements documenting the variants occurring in the different text versions. Notice how the choice for equal <gi>rdg</gi> elements (instead of one <soCalled>preferred</soCalled> reading, encoded in a <gi>lem</gi> element), and the use of the parallel segmentation method abolish the notion of a base text.</p>
        <p>The different witnesses are listed in a <gi>listWit</gi> element inside the <gi>front</gi> section of the text. Each witness definition inside <gi>witness</gi> marks its corresponding sigil in an <att>xml:id</att> attribute. In the final line, a page break is recorded with <gi>pb</gi>. Its <att>ed</att> attribute is used to identify the specific edition where this page breaks occurs: the text witness identified as <ident>l1894</ident>. Notice, how this could have been expressed even more formally with the <att>edRef</att> attribute, which takes a pointer to an edition identified elsewhere: <tag type="empty">pb facs="#image1" edRef="#l1894"</tag>. For this page in that edition, a digital facsimile is provided by means of the global <att>facs</att> attribute.</p>
        <note type="reference">See <ptr type="crossref" target="../tutorials/TBED06v00.htm#graphical"/> for a discussion of the <att>facs</att> attribute.</note>
        <figure xml:id="dickinson-example">
          <egXML xmlns="http://www.tei-c.org/ns/Examples">
            <TEI xmlns="http://www.tei-c.org/ns/1.0_TBEeg_">
              <teiHeader>
                <fileDesc>
                  <titleStmt>
                    <title>"Faith is a fine invention"</title>
                    <author>Emily Dickinson</author>
                    <respStmt>
                      <name>Jarom McDonald</name>
                      <resp>Text encoding</resp>
                    </respStmt>
                    <respStmt>
                      <name>Lara Vetter</name>
                      <resp>Proofing</resp>
                    </respStmt>
                  </titleStmt>
                  <publicationStmt>
                    <publisher>The Versioning Machine project</publisher>
                    <availability>
                      <p>This poem is available only for demonstration purposes. It was created as
                        part of a research project to experiment with ways of displaying multiple
                        witnesses of a TEI-encoded poem using XML, XSLT and JavaScript.</p>
                    </availability>
                  </publicationStmt>
                  <notesStmt>
                    <note type="image" anchored="true">
                      <witDetail wit="#p1891" target="#p1891" place="apparatus">
                        <figure>
                          <graphic url="images/p1891.jpg"/>
                        </figure>
                      </witDetail>
                      <witDetail wit="#ll227" target="#ll227" place="apparatus">
                        <figure>
                          <graphic url="images/ll227.jpg"/>
                        </figure>
                      </witDetail>
                    </note>
                  </notesStmt>
                  <sourceDesc>
                    <p>See Witness List.</p>
                  </sourceDesc>
                </fileDesc>
                <encodingDesc>
                  <projectDesc>
                    <p>Test document for versioning machine project. Marked-up collation of three
                      manuscript witnesses: A 660, H 201, and H 72, and four early print witnesses:
                      Poems (1891)--XXX, Letters (1894)--p. 191, Complete Poems (1924)--LVI, and Life
                      and Letters (1926)--p. 227. </p>
                    <p>DTD constructed from TEI prose base with tagsets for linking, figures, analysis,
                      transcr, textcrit.</p>
                  </projectDesc>
                  <variantEncoding location="internal" method="parallel-segmentation"/>
                </encodingDesc>
              </teiHeader>
              
              <facsimile>
                <graphic xml:id="image1" url="images/cp32.jpg"/>
              </facsimile>
              
              <text>
                <front>
                  <div>
                    <listWit>
                      <witness xml:id="a660">A 660, verse embedded in letter to Samuel
                        Bowles.</witness>
                      <witness xml:id="h201">H 201, fascicle version of poem.</witness>
                      <witness xml:id="h72">H 72, fascicle version of poem.</witness>
                      <witness xml:id="p1891">Published as poem XXX in the second volume of Todd and
                        Higginson's <title rend="italic">Poems of Emily Dickinson</title>.</witness>
                      <witness xml:id="l1894">Letter to Samuel Bowles published in Todd's edition of
                        Dickinson's letters.</witness>
                      <witness xml:id="cp32">Published as poem LVI in Martha Dickinson Bianchi's
                        <title rend="italic">Complete Poems of Emily
                          Dickinson</title>.</witness>
                      <witness xml:id="ll227">Letter to Samuel Bowles published in Bianchi's <title rend="italic">The Life and Letters of Emily Dickinson</title>.</witness>
                    </listWit>
                  </div>
                </front>
                <body>
                  <div1>
                    <lg>
                      <l n="1">
                        <app>
                          <rdg wit="#a660 #h72">"Faith"</rdg>
                          <rdg wit="#h201 #l1894 #ll227">Faith</rdg>
                          <rdg wit="#p1891 #cp32">FAITH</rdg>
                        </app> is a fine invention</l>
                      <l n="2">
                        <app>
                          <rdg wit="#a660 #ll227">When </rdg>
                          <rdg wit="#h201 #h72 #p1891 #l1894 #cp32">For </rdg>
                        </app>
                        <app>
                          <rdg wit="#a660 #h201 #h72">Gentlemen </rdg>
                          <rdg wit="#p1891 #l1894 #cp32 #ll227">gentlemen </rdg>
                        </app>
                        <app>
                          <rdg wit="#a660 #ll227">can </rdg>
                          <rdg wit="#h201 #h72 #p1891 #l1894 #cp32">who </rdg>
                        </app>
                        <app>
                          <rdg wit="#a660 #h201 #h72">
                            <hi rend="underline">see</hi>
                          </rdg>
                          <rdg wit="#p1891 #l1894 #cp32 #ll227">see</rdg>
                        </app>
                        <app>
                          <rdg wit="#h72 #ll227">!</rdg>
                          <rdg wit="#a660 #h201"> -</rdg>
                          <rdg wit="#p1891 #cp32">;</rdg>
                          <rdg wit="#l1894">,</rdg>
                        </app>
                      </l>
                      <l n="3"> But <app>
                        <rdg wit="#h72">Microscopes</rdg>
                        <rdg wit="#a660 #h201">
                          <hi rend="underline">Microscopes</hi>
                        </rdg>
                        <rdg wit="#p1891 #l1894 #cp32 #ll227">microscopes</rdg>
                      </app> are prudent</l>
                      <l n="4"> In an <app>
                        <rdg wit="#a660 #h201 #h72">Emergency</rdg>
                        <rdg wit="#p1891 #l1894 #cp32 #ll227">emergency</rdg>
                      </app>
                        <app>
                          <rdg wit="#a660 #l1894">. <pb facs="#image1" ed="l1894"/>
                                                    </rdg>
                          <rdg wit="#h201 #h72 #p1891 #ll227 #cp32">!</rdg>
                        </app>
                      </l>
                    </lg>
                  </div1>
                </body>
              </text>
            </TEI>
          </egXML>
          <head type="legend">Encoding of several versions of Emily Dickinson’s poem <title level="a">Faith is a Fine Invention</title> for the Versioning Machine (<ref type="bibl" target="#dickinson1891">Dickinson 1891</ref>). TEI XML source available from <ptr target="http://v-machine.org/samples/faith.xml"/>.</head>
        </figure>
      </div>
        </body>
    <back>
      <div type="bibliography">
        <listBibl>
          <bibl xml:id="dickinson1891">
                        <author>Dickinson, Emily</author>. <date>1891</date>. <title level="a">Faith is a Fine Invention</title>. In <title level="m">Poems by Emily Dickinson, Volume 2.</title> Edited by <editor>Mabel Loomis Todd</editor> and <editor>Thomas W. S. Higginson</editor>. Encoded and made available by the University of Maryland University Libraries, as sample for the <ref target="http://www.v-machine.org/">Versioning Machine</ref>. Available online at <ptr target="http://v-machine.org/samples/faith.html"/>.</bibl>
          <bibl xml:id="marlowe1594">
                        <author>Marlowe, Christopher</author>. <title level="m">Edward II</title>. <date>1594</date>. Encoded and made available by the Perseus Digital Library. Available online at <ptr target="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.03.0007"/>.</bibl>
        </listBibl>
      </div>
    </back>
  </text>
  <!--
    $Date: 2020-07-08 02:33:20 +0200 (Wed, 08 Jul 2020) $
    $Id: TBED07v00.xml 425 2020-07-08 00:33:20Z ron.vandenbranden $  -->
</TEI>