<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title type="main">TEI by Example</title>
        <title type="sub">Module 6: Primary Sources</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-15" who="#RvdB">technical revision</change>
      <change when="2010-07-09" who="#RvdB">release</change>
      <change when="2009-11-30" who="#RvdB">corrected typos</change>
      <change when="2009-06-11" who="#RvdB">editing</change>
      <change when="2009-04-27" who="#RvdB">authoring</change>
    </revisionDesc>
  </teiHeader>
  <text xml:id="TBED06v00" type="tutorials">
    <body>
            <head>Module 6: Primary Sources</head>
            <div xml:id="intro">
        <head>Introduction</head>
        <p>Texts exist in many genres and forms, each with their particular structural and semantic features. Besides structural characteristics, texts can be roughly distinguished for their <soCalled>editorial status</soCalled>. Typically, the majority of conserved documents have a <soCalled>public</soCalled> status: after scrupulous authoring and editing by an author and/or editorial instance, they have been published and multiplied, either as manuscript, in print or nowadays in electronic form. Still, the textual universe is wider than these published documents. Lots of texts were never intended to be published, because they have a private nature (letters, ego documents), were not considered <soCalled>final</soCalled> documents (but may have survived their published successors), were conceived as exclusive pieces of art,... Often, such texts are of great value, either because no other representations exist (anymore), because they reflect stages in the conception of a published literary work, because they are evidence of historical language use, or for many other reasons to many other types of research.</p>
        <p>Because non-published texts typically are less editorially polished, they can contain many traces of the authoring or editing phase. Frequent phenomena in primary source materials are additions, deletions, restorations, errors, corrections,... Moreover, the condition of the material that carries the text may influence the transcription: damage may render a fragment illegible or incomplete. The TEI Guidelines offer specific elements to cover such phenomena in transcriptions. Notice, however, that these phenomena are not confined to handwritten texts: analogous phenomena may occur in typewritten documents, born-digital texts that have been printed for revision, or digital texts that include some form of electronic revision control information. Although many of the TEI elements discussed in this tutorial module are available in all TEI texts, some specific ones require inclusion of the dedicated <ident type="module">transcr</ident> TEI module in your TEI schema, documented in chapter <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/PH.html">11. Representation of Primary Sources</ref> of the TEI Guidelines.<note>For directions on composing a TEI schema by selecting TEI modules and elements, see <ptr type="crossref" target="TBED08v00.htm"/>.</note>
                </p>
        <p>This tutorial focuses on transcription of <emph>phenomena in primary sources</emph> rather than <emph>manuscripts</emph>, because the latter term is often understood with a specific connotation: texts written by hand before the print age. Those have their own highly specialised textual phenomena and cataloguing needs, to which a specific chapter of the TEI Guidelines is devoted (<ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/MS.html">10: Manuscript Description</ref>). Instead, this module will focus on the transcription of a handwritten prose text. Notice, also, that this tutorial does not cover the advanced mechanisms for combining transcription with facsimiles, as discussed in section <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/PH.html#PH-transcr">11.2 Combining Transcription with Facsimile</ref> of the TEI Guidelines.</p>
      </div>
            <div xml:id="primarysources">
        <head>Primary Source Material</head>
        <p>The text we use as an example throughout this module is a fragment of <title level="u">There and Back Again</title>, a story by the promising young talent Hannah Renton, in response to a writing assignment at school. 
          <figure xml:id="figure1">
            <graphic url="../../../images/tutorials/TBED06v00/TBA001.jpg"/>
            <graphic url="../../../images/tutorials/TBED06v00/TBA001b.jpg"/>
            <graphic url="../../../images/tutorials/TBED06v00/TBA002.jpg"/>
            <graphic url="../../../images/tutorials/TBED06v00/TBA003.jpg"/>
            <head type="legend">Some pages from a sample manuscript.</head>
          </figure>
        </p>
        <p>A first look at the document facsimiles above reveals that it is a prose document, with as most prominent structural features: a date, title, a graphic, and paragraphs. It could be transcribed as follows (for more details of prose transcription, see <ptr type="crossref" target="TBED03v00.htm"/>):
          <figure xml:id="example1">
            <egXML xmlns="http://www.tei-c.org/ns/Examples">
              <body>
                <pb n="1"/>
                <dateline>
                  <date when="2008-08-26">26/8/08</date>
                </dateline>
                <head>There and Back Again</head>
                <p>I can't believe it. Carl has not written to me or sent me a postcard once since he's been away in Egypt. It would be easier if our phone was working. It's been broken for ages! Dad can't fix it at the moment, and we can't afford to buy a new one. I would write to him, but he didn't tell me the address of the villa he was staying in. If only I had a mobile, I could phone his mobile number. Eureka!!! I could use next door's phone, oh, actually, Mr and Mrs Crooel won't let me use it (they're my next door neighbours). I know. I'll use the phone box!!! (I think I've got some change).</p>
                <p>Goodness me, this phone box stinks. EEAW, I don't even want to know what that is. Anyway, I hope his phone is switched on. What's it again??? Oh, yeah, 1312632. Arrgh!! What's happening!!! Who's shaking the phone box!! Who turned out the lights!!!</p>
                <p>WOW!!! Where am I? Why is everything so smokey? Everything is silver except the air around me, it's black, and I'm standing in a silver pod, with something that looks like a phone. When you look up there are millions of metal poles, and some of them have what look like funny shaped cars whizzing along attached to the metal poles at the top.</p>
                <pb/>
                <figure>
                  <graphic url="phonebox_scan.jpg"/>
                  <figDesc>the phone box travelling through time</figDesc>
                </figure>
                <pb n="2"/>
                <p>There seems to be no-one around the phone box. Yuk! Someone has just walked past. All their skin is black and crusty and in the side of their neck are gitt like things. The whites of his or her eyes are grey and he, or she has no hair. I also notice that he, or she has a clear gas mask. It's from all the smoke.</p>
                <p>Goodness me! I just stepped outside the phone box and I couldn't breathe. It was like a king cobra was wrapped around my neck and if I was to get a little bit of air in it was horrible, like when you stop at red man beside the traffic lights and a bus is stopped beside you and you're getting breaths of carbon dioxide. But this was 100x worse. Now I know what all the black air is: all the pollution. But that doesn't help me figure out where I am.</p>
                <p>What's that? It's a big poster, saying: Monday 26th May 1312632. I've gone into the future!!! Wait, I recognise the date. It's Carl's number! When I typed it in on the key pad in the phone box, that must have taken me into the future: I must get back and warn everyone! I'll type in 2008. Nothing was happening. Then, <quote>Hello, dearie</quote>, an old woman answered. <quote>Who is it?</quote> I hung up. Uh, oh. How do I get back then?</p>
                <pb n="3"/>
                <p>I've been thinking for ages about what to do. There only seems to be one good option, fix and stop all the pollution. This sort of seems like a dream, but a fun dream. I'll just have to find out where the city's power source is.</p>
                <p>I got round the corner and there was a BIG sign saying CITY'S POWER SOURCE. It's very oily and extremely big. Ah, this will be the switch.</p>
                <p>Everything has gone dark and I can't see where I'm going. I keep on banging into long bars and wires and knobs. Yess!! The door!!!</p>
                <p>There is uproar outside. I sealed the door with stones on the ground so no one could get in to turn the switch back on.</p>
                <p>I've been thinking. If I'm going to suck out all the pollution I'm going to need help. Which is not going to be easy.</p>
                <p>Everyone keeps on staring at me. It's very annoying. I hope people will help!</p>
                <p>OK. I think this will work. I've put up posters everywhere. They say... <quote>MEETING BESIDE PHONE BOX BE THERE AT 2pm</quote>. I hope they read English. And English time.</p>
              </body>
            </egXML>
            <head type="legend">A <soCalled>normalised</soCalled> encoding of the sample manuscript.</head>
          </figure>
        </p>
        <p>...or <emph>could</emph> it? When you compare the facsimiles and above transcription, you’ll notice that a lot of phenomena of this particular hand written text have been filtered out or abstracted in the transcription. Mind you, it <emph>could</emph> be a plausible transcription that strives for a representation of the contents, rather than a faithful record of its actual realisation, provided these editorial choices are stated explicitly in the header’s <gi>editorialDecl</gi> element.</p>
        <floatingText type="challenge">
          <body>
                        <div xml:id="guestion1" type="challenge.question" corresp="#solution1">
              <p>Take a close look at the document facsimiles above, compare it to the transcription above, and make a list of things you observe that are specific to the non-published character of this document.</p>
            </div>
                        <div xml:id="solution1" type="challenge.solution">
              <list rend="bulleted">
                <item>Additions</item>
                <item>Deletions</item>
                <item>Different hands</item>
                <item>Colour of ink</item>
                <item>Notes</item>
                <item>Errors</item>
                <item>Corrections</item>
                <item>Damage</item>
                <item>Unclear text</item>
                <item>Lacking text</item>
              </list>
            </div>
                    </body>
                </floatingText>
      </div>
            <div xml:id="primaryPhenomena">
        <head>
                    <emph>Representing</emph> Primary Source Phenomena</head>
        <div xml:id="addDel">
          <head>Additions and Deletions</head>
          <p>In primary sources, prominent traces of the editing process are additions and deletions. Additions may be marked by differing positioning, shifts in hands, ink, or font, and can be explicitly indicated by all kinds of markers. Deletions are often visible as struck out text. Because they may shed light on the writing process of the text or hold alternative readings and interpretations, additions and deletions can be very valuable elements in an electronic transcription.</p>
          <div xml:id="simpleAddDel">
            <head>Simple Additions and Deletions</head>
            <p>Our sample text contains a clear addition at the top of the second page. The phrase <q>the phone box</q> has probably been added afterwards, as it didn’t fit in the space available. This can be transcribed as an addition with the <gi>add</gi> element (from <soCalled>addition</soCalled>).
              <figure xml:id="example2">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <p>There seems to be no-one around <add>the phone box</add>.</p>
                </egXML>
                <head type="legend">Encoding of an addition.</head>
              </figure>
            </p>
            <p>Similarly, deletions can be marked with a specific element: <gi>del</gi> (from <soCalled>deletion</soCalled>). If we look closely at the same sentence, we see how the author has corrected a writing mistake by striking through a letter. This can be transcribed as follows:
              <figure xml:id="example3">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <p>There seem<del>e</del>s to be no-one around <add>the phone box</add>.</p>
                </egXML>
                <head type="legend">Encoding of a deletion.</head>
              </figure>
            </p>
            <p>Notice how additions, just like deletions, can be transcribed at character level, so that they enclose exactly those letters or phrases that have been deleted or added. We can be more precise about how additions and deletions are realised. Actual rendition information can be specified in the global <att>rend</att> attribute. For example, we could use the <att>rend</att> attribute to state that the deleted text has been crossed out, and the addition has occurred above the line, possibly using some kind of formalised expression. For deletions, information like <val>strikethrough</val> or <val>overwritten</val> may be sufficient (you can craft your own typology). Additionally, the <gi>add</gi> element has a specific attribute to record the place where the text had been added: <att>place</att>. It can combine keywords like <val>below</val> or <val>above</val> for text added below or above the line; <val>bottom</val>, <val>margin</val>, or <val>top</val> for text added at the bottom, margin, or top of the page; <val>opposite</val> or <val>overleaf</val> for additions on the opposite page or at the other side of the page. Our example could be extended as follows:
              <figure xml:id="example4">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <p>There seem<del rend="crossout">e</del>s to be no-one around <add place="above">the phone box</add>.</p>
                </egXML>
                <head type="legend">Encoding rendition details about additions and deletions.</head>
              </figure>
            </p>
            <p>Often, additions and deletions can be traced by shifts in ink or writing material. As this information can convey useful insights in the writing process, it can be useful to include it in the transcription. Of course, the <att>rend</att> attribute could be used for this purpose, but <gi>add</gi> and <gi>del</gi> have a more sophisticated mechanism to record aspects of the hand in which they are written: the <att>hand</att> attribute. This attribute in itself doesn’t indicate any specific features directly, but rather holds a reference to a hand description elsewhere in the document. A hand can be defined in a <gi>handNote</gi> element in the <gi>profileDesc</gi> part of the TEI header, which groups different hand definitions inside a <gi>handNotes</gi> element. A <gi>handNote</gi> definition can contain a loose prose description of the hand inside paragraphs, as well as more formalised identifications of different aspects of the hand in specific attributes: <att>scribe</att> (an name for the scribe), <att>script</att> (the writing style or font of a hand), <att>medium</att> (the type of ink), and <att>scope</att> (the dominance of this hand in the document). In order to make references to such a hand definition elsewhere in the transcription, a unique <att>xml:id</att> value must be provided. Inside <soCalled>transcriptional</soCalled> elements such as <gi>add</gi> and <gi>del</gi>, reference to a hand definition can be made with the <att>hand</att> attribute. As with all references in TEI, this takes the form of an URI pointer, of which the local part is preceded with a <code>#</code> sign. For this example, more details about the hand could be given as follows:
            <figure xml:id="example5">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <TEI>
                  <teiHeader>
                    <!--...-->
                    <profileDesc>
                      <!--...-->
                      <handNotes>
                        <handNote xml:id="HR" scribe="HannaRenton" script="handwritten" medium="pencil" scope="major">
                          <p>the document's main hand, Hanna Renton</p>
                        </handNote>
                      </handNotes>
                    </profileDesc>
                  </teiHeader>
                  <text>
                    <body>
                      <!--...-->
                      <p>There seem<del rend="crossout" hand="#HR">e</del>s to be no-one around <add place="above" hand="#HR">the phone box</add>.</p>
                      <!--...-->
                    </body>
                  </text>
                </TEI>
              </egXML>
              <head type="legend">Providing information about document hands.</head>
            </figure>
            </p>
            <p>Notice how the <att>hand</att> attribute is the means to distinguish between additions or deletions in a text made by different persons, if they can be distinguished. Our sample text contains other interventions in a different ink, made by a different hand. For example, on page two, text has been added both in the margin and inline, near the original word <q>breath</q>. A detailed study of the genesis of this work could identify the person responsible for these additions as the author’s teacher. With proper identification of this hand in the header, this attribution can be recorded in the transcription:
              <figure xml:id="example6">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <TEI>
                    <teiHeader>
                      <!--...-->
                      <profileDesc>
                        <!--...-->
                        <handNotes>
                          <handNote xml:id="HR" scribe="HannaRenton" script="handwritten" medium="pencil" scope="major">
                            <p>the document's main hand, Hanna Renton</p>
                          </handNote>
                          <handNote xml:id="teacher" scribe="classTeacher" script="handwritten" medium="red_ballpen" scope="minor">
                            <p>the document author's teacher</p>
                          </handNote>
                        </handNotes>
                      </profileDesc>
                    </teiHeader>
                    <text>
                      <body>
                        <!--...-->
                        <p>Goodness me! I just stepped outside the phone box and I couldn't breath<add hand="#teacher">e</add>. <add hand="#teacher" place="margin">"breath" = noun <lb/>"to breathe" = verb</add>
                          <!--...-->
                        </p>
                        <!--...-->
                      </body>
                    </text>
                  </TEI>
                </egXML>
                <head type="legend">Identifying multple hands.</head>
              </figure>
            </p>
            <p>Notice how, although the content of both <gi>add</gi> elements was most probably added in the same addition, they are split in order to capture the different positioning on the page. Another thing of notice, is the slight abstraction that has been made of the actual occurrence of the marginal addition on the page: instead of interrupting the words <q>couldn’t breath</q>, the encoder has opted to transcribe the annotation at the end of the sentence. The inline addition, on the other hand, is transcribed where it appears in the original, and therefore not specified with a <att>place</att> attribute.</p>
            <p>Additions and deletions may come in isolation like in the examples above, but often occur in combination, when existing text is deleted and new text is added. Such a case of juxtaposed deletion and addition can be found on the second page of the example, in the word that should read <q>dioxide</q>. Apparently, a first version was started correctly, with <q>diox</q>, which the author has revised to <q>diacxside</q>, by overwriting the original <q>ox</q> and adding the <q>acx</q>, resulting in the final reading <q>diacxside</q>. This can be represented with a simple sequence of <gi>del</gi> and <gi>add</gi>:
            <figure xml:id="example7">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                di<del hand="#HR" rend="overwritten">ox</del>
                                    <add hand="#HR">acx</add>side
              </egXML>
              <head type="legend">A simple encoding of subsequent deletions and additions.</head>
            </figure>
            </p>
            <p>Such combinations of deletions and deletions can be grouped in a dedicated <gi>subst</gi> (substitution) element, in order to identify them as a single editorial intervention.
              <figure xml:id="example8">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  di<subst hand="#HR">
                                        <del rend="overwritten">ox</del>
                                        <add>acx</add>
                                    </subst>side
                </egXML>
                <head type="legend">Grouping subsequent deletions and additions in <gi>subst</gi>.</head>
              </figure>
            </p>
            <p>Notice, how the identification of the responsible hand in the <att>hand</att> attribute has been moved upward to the <gi>subst</gi> element. Because <gi>subst</gi> contains a deletion and addition by the same hand, the hand identification is inherited by the corresponding <gi>del</gi> and <gi>add</gi> elements in the transcription.</p>
            <p>It must be acknowledged, that this analysis of the word <q>dioxide</q> in the text involves a fair amount of interpretation. Responsibility for these kinds of interpretation can be taken by means of a dedicated <att>resp</att> (responsibility) attribute. It can occur on <gi>add</gi>, <gi>del</gi>, and <gi>subst</gi> elements, and points to an identified person in the TEI header of an electronic document. In this case, the TBE crew, who edited this electronic text, can be held responsible for this interpretation as follows:
            <figure xml:id="example9">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <TEI>
                  <teiHeader>
                    <fileDesc>
                      <titleStmt>
                        <title>There and Back Again: digital edition</title>
                        <author xml:id="HannaRenton">Hanna Renton</author>
                        <editor xml:id="TBE">The TBE crew</editor>
                        <!--...-->
                      </titleStmt>
                      <!--...-->
                    </fileDesc>
                    <!--...-->
                  </teiHeader>
                  <text>
                    <body>
                      <!--...-->
                      <p><!--...-->di<subst resp="#TBE" hand="#HR">
                                                        <del rend="overwritten">ox</del>
                                                        <add>acx</add>
                                                    </subst>side<!--...-->
                      </p>
                      <!--...-->
                    </body>
                  </text>
                </TEI>
              </egXML>
              <head type="legend">Stating responsibility for editorial interpretations in <att>resp</att>.</head>
            </figure>
            </p>
            <p>Similarly, for the addition and correction in the first sentence on the first page, the authority can be indicated with <att>hand</att>, and the responsibility for the identification of this addition  with <att>resp</att>:
              <figure xml:id="example10">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <p>
                                        <add place="margin" resp="#TBE" hand="#teacher">Well done! <lb/>8,5 / 10</add>I can't bel<subst resp="#TBE" hand="#teacher">
                                            <del rend="strikethrough">ei</del>
                                            <add>ie</add>
                                        </subst>ve it.
                    <!--...-->
                                    </p>
                </egXML>
                <head type="legend">Identifying hands and stating editorial responsibility for other additions.</head>
              </figure>
            </p>
            <note type="summary">Additions and deletions can be encoded with the <gi>add</gi> and <gi>del</gi> elements, respectively. While the <att>rend</att> attribute can be used to record general visual aspects of their realisation in the source, the <gi>add</gi> element has a specific <att>place</att> attribute. This can be used to indicate where the addition is located (e.g., <val>inline</val>, <val>above</val> or <val>below</val> the line; at the <val>bottom</val> or <val>top</val> of the page; in the <val>margin</val>, <val>overleaf</val>, on the <val>opposite</val> page). Specific characteristics of the hand can be encoded by referring to a hand definition in the header, using the <att>hand</att> attribute, while responsibility for the encoding of additions and deletions can be stated in the <att>resp</att> attribute, referring to an identified person in the TEI header. Sequences of deletions and additions originating from one single intervention can be wrapped in a <gi>subst</gi> element.</note>
          </div>
          <div xml:id="complexAddDel">
            <head>Complex Additions and Deletions</head>
            <p>Deletions and additions are not limited to a single <soCalled>layer</soCalled> of a document, as in the previous examples. They may as well nest, when, for example, an added fragment itself contains further deletions and/or additions. Take, for example, the fragment on page 2 of the example text, that originally read: <q>It’s a big poster, saying: <gap/>
                            </q>. The author later had added the phrase <q>at the wall</q> in the margin, but has later corrected this to <q>on the wall</q>. This can be encoded as a single addition (<q>at the wall</q>), containing a nesting substitution, consisting of a deletion (<q>at</q>) and an addition (<q>on</q>):
            <figure xml:id="example11">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <p>What's that? It's a big poster <add hand="#HR" place="margin" resp="#TBE">
                                            <subst>
                                                <del rend="crossout">at</del>
                                                <add place="above">on</add>
                                            </subst> the wall</add>, saying <!--...-->
                                    </p>
              </egXML>
              <head type="legend">Encoding complex additions and deletions.</head>
            </figure>
            </p>
            <p>Besides substitutions, often in hand written texts, an original reading can be restored after being rejected first. The TEI Guidelines provide a specific element for marking such restorations: <gi>restore</gi>. This element can be wrapped around prior deletions. Take, for example, the phrase that should read <q>Who turned out the lights!!!</q> on the first page in the example. This had first been substituted for <q>Who turned off the lights!!!</q> but has afterwards been restored to the original reading, indicated both by an <q>OK</q> marker, and the addition of the original word <q>out</q>:
            <figure xml:id="example12">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                Who turned <restore hand="#HR" resp="#TBE">
                  <subst>
                    <del rend="crossout">out</del>
                    <add place="margin">off</add>
                  </subst>
                </restore> the lights!!!
              </egXML>
              <head type="legend">Encoding a restoration of a previous intervention.</head>
            </figure>
            </p>
            <p>Apart from having internal structure themselves, additions and deletions may overlap with other logical structures of a text, for example when crossing a paragraph boundary, or a phrase that is transcribed as a name or title. Take a look, for example, at page 3 of the sample document, which features two entire sentences being crossed out. This deletion, however, runs over two paragraphs. This could impossibly be encoded with a simple deletion:
              <figure xml:id="example13">
                <egXML xmlns="http://www.tei-c.org/ns/Examples" valid="false">
                  <p>
                    <!--...-->
                    <seg rend="incorrect">&lt;del&gt;</seg>But I've got to go outside (again).
                  </p>
                  <p>
                    It was a lot easier to find than I thought it would be.<seg rend="incorrect">&lt;/del&gt;</seg>
                    <!--...-->
                  </p>
                </egXML>
                <head type="legend">Incorrect encoding of a deletion crossing paragraph boundaries.</head>
              </figure>
            </p>                            
            <p>That is, the markup itself (a paragraph boundary) is involved in the deletion, and can not just be enclosed in another container, which would produce overlapping hierarchies as in the previous incorrect example. Other cases that would result in invalid TEI occur when long deletions or additions that nest properly inside bigger structures encompass text structures that are illegal inside <gi>add</gi> or <gi>del</gi> (such as entire paragraphs or divisions: <gi>add</gi> and <gi>del</gi> can only contain phrase-level elements). In order to facilitate the encoding of such cases (that are to be expected, given the tension between the unedited nature of primary sources and the formalism of the TEI markup vocabulary), the TEI Guidelines provide two specific elements: <gi>delSpan</gi> and <gi>addSpan</gi>. These are empty elements marking the beginning of a longer deletion or addition, respectively. The scope of the addition or deletion is made explicit by means of a specific <att>spanTo</att> attribute, which points to an identified end point, which comes later in the transcription. This end point can be represented with an empty <gi>anchor</gi> element, which is an all-purpose empty element for identifying a certain point in a text, via its <att>xml:id</att> attribute. Although they can’t contain any text, <gi>addSpan</gi> and <gi>delSpan</gi> can have all attributes of their <gi>add</gi> and <gi>del</gi> counterparts. The deletion in the example document can thus be encoded as follows:
              <figure xml:id="example14">
                <egXML xmlns="http://www.tei-c.org/ns/Examples">
                  <p>
                    <!--...--> where the city's power source is. <delSpan hand="#HR" resp="#TBE" rend="crossout" spanTo="#delEnd"/>But I've got to go outside (again).</p>
                  <p>It was a lot easier to find than I thought it would be. <anchor xml:id="delEnd"/>I got round the corner and <!--...-->
                                    </p>
                </egXML>
                <head type="legend">Encoding of boundary-crossing deletions with <gi>delSpan</gi>.</head>
              </figure>
            </p>
            <note type="summary">Complex deletions and additions may be represented using nesting <gi>del</gi> and <gi>add</gi> elements. Deleted text that has been restored again can be encoded with a <gi>restore</gi> element. When deletions or additions contain logical structures that cannot be transcribed as valid content of the <gi>del</gi> or <gi>add</gi> elements, or cross structural boundaries that would lead to overlapping hierarchies, these can be represented with empty elements. The <gi>delSpan</gi> and <gi>addSpan</gi> elements can indicate the start of such deletions or additions, respectively, and point to their end point with a <att>spanTo</att> attribute. The value of this attribute must point towards a following <gi>anchor</gi> element, which is an empty element identifying a point in the document with its <att>xml:id</att> attribute.</note>
          </div>
        </div>
        <div xml:id="graphical">
          <head>Facsimiles</head>
          <p>The first page of our example text is followed by an unnumbered page containing a drawing. As seen in <ptr type="crossref" target="TBED03v00.htm#figures"/> of this tutorial series, this can be represented with an empty <gi>graphic</gi> element, whose <att>url</att> attribute points to a digital representation of the image. When the graphic is enclosed in a larger <gi>figure</gi> element, a description of the image can be provided in <gi>figDesc</gi>:
            <figure xml:id="example15">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <pb/>
                <figure>
                  <graphic url="phonebox_scan.jpg"/>
                  <figDesc>the phone box travelling through time</figDesc>
                </figure>
                <pb n="2"/>
              </egXML>
              <head type="legend">Encoding a page facsimile in <gi>graphic</gi>.</head>
            </figure>
          </p>
          <p>Alternatively, it could be interesting for primary source materials to provide access to digital facsimiles of the entire document, in order to complement the transcription with visual evidence. The TEI Guidelines provide a mechanism to link each element in a digital transcription with a (part of) a facsimile: the global <att>facs</att> attribute (for <soCalled>facsimile</soCalled>). This attribute can be attached to any TEI element (if the <ident type="module">transcr</ident> module is included in the TEI schema), and point to a digital scan by means of an URI. Typically, scans are made page by page (or folio by folio), which makes it most convenient to attach a <att>facs</att> attribute to the corresponding <gi>pb</gi> (page break) elements in the electronic transcription. If we have digital facsimiles for each page of our example text available under the folder <ident type="file">scans</ident>, whose file names consist of the letters <code>TBA</code> + 3 digits, these facsimiles could be referenced from the transcription as follows:
          <figure xml:id="example16">
            <egXML xmlns="http://www.tei-c.org/ns/Examples">
              <pb facs="scans/TBA001b.jpg"/>
              <pb n="2" facs="scans/TBA002.jpg"/>
            </egXML>
            <head type="legend">Linking the encoding to facsimiles with <att>facs</att>.</head>
          </figure>
          </p>
          <p>Notice how this link makes the encoding of the figure inside <gi>graphic</gi> redundant, so that it can be left out of the transcription. Besides this simple mechanism of pointing to entire images, the TEI provides a more refined system to define specific zones inside facsimiles, that can be associated with specific elements in the transcription. As this is a more advanced topic, you are referred to the detailed discussion in section <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/PH.html#PHFAX">11.1 Digital Facsimiles</ref> of the TEI Guidelines.</p>
          <note type="summary">Digital facsimiles can be referenced from any element with the global <att>facs</att> attribute. It can hold a URI pointer to a digital scan of a document fragment.</note>
        </div>
        <div xml:id="unclearDamage">
          <head>Damage</head>
          <p>Transcription of primary source texts is determined by the state of the source material. Depending on the quality of the source materials and handwriting, some passages may be unclear, which may hamper straightforward transcription. Transcription of such passages may involve higher degrees of interpretation, or even editorial intervention, which may be signalled with appropriate elements that will be discussed further in this module (see <ptr type="crossref" target="#editorialInterventions"/>). However, if such interpretative elements are caused by material damage to the source text, this damage can be signalled in the transcription with the <gi>damage</gi> element. Many aspects of the damage can be expressed in attributes, most important of which are: 
            <list rend="bulleted">
              <item>
                                <att>hand</att>: the hand that caused the damage (when it is caused by identifiable human intervention)</item>
              <item>
                                <att>agent</att>: the cause of the damage</item>
              <item>
                                <att>extent</att>: the amount of damaged text, expressed in prose descriptions like <val>2 words</val>, <val>3 letters</val>
                            </item>
              <item>
                                <att>quantity</att>: the length of the damage in a specific unit (specified with the <att>unit</att> attribute)</item>
              <item>
                                <att>unit</att>: the unit in which the length of the damage is expressed (with the <att>quantity</att> attribute), e.g., <val>cm</val> (centimetres), <val>chars</val> (text characters)</item>
              <item>
                                <att>type</att>: a characterisation of the type of the damage</item>
            </list>
          </p>
          <p>One important condition for the use of the <gi>damage</gi> element, is that it should contain text that is more or less legible, or can be reconstructed. When no further (interpretative) claims about this text are made, this text can be enclosed as such inside the <gi>damage</gi> element. For example, in our example text, the stapling of the sheets of the writing assignment has caused damage to the top left part of the document, rendering the date line partly illegible. This can be recorded in the transcription:
            <figure xml:id="example17">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <body>
                  <pb n="1"/>
                  <dateline>
                    <date when="2008-08-26">
                                            <damage agent="stapling" hand="#teacher" unit="chars" quantity="3">26/</damage>8/08</date>
                  </dateline>
                  <head>There and Back Again</head>
                  <!--...-->
                </body>
              </egXML>
              <head type="legend">Signalling damage in the source with <gi>damage</gi>.</head>
            </figure>
          </p>
          <p>Similar to the <gi>del</gi> and <gi>add</gi> elements, <gi>damage</gi> has an empty counterpart: <gi>damageSpan</gi>, that should be used when damage runs over different structural boundaries, or contains document structures too large to be valid inside <gi>damage</gi>. It has the same attributes as <gi>damage</gi>, as well as an extra attribute <att>spanTo</att>, whose value points to a following identified element in the transcription.</p>
          <note type="summary">As it may influence the transcription and (degree of) interpretation of the source text, damage can be transcribed as a primary source phenomenon in its own right with the <gi>damage</gi> element. It can specify several characteristics associated with the damage, such as the responsible hand (if any) in the <att>hand</att> attribute, the cause of the damage in the <att>agent</att> attribute, and a classification of the kind of damage in the <att>type</att> attribute. The extent of the damage can either be given implicitly in an <att>extent</att> attribute, or explicitly with a combination of the <att>quantity</att> and <att>unit</att> attributes, recording the number of measured units, respectively. Damage crossing logical structures or encompassing large text structures can be encoded using an empty <gi>damageSpan</gi> element, whose <att>spanTo</att> attribute can point to the end point of the damage identified further in the transcription.</note>
        </div>
      </div>
            <div xml:id="editorialInterventions">
        <head>Editorial Interventions</head>
        <div xml:id="supplied">
          <head>Unclear, Supplied, Omitted Text</head>
          <p>Depending on the quality of the source material or the handwriting, transcription of primary source texts may be more or less straightforward. As any further interpretation of an electronic transcription depends on this first interpretative act, it may be desirable for an encoder to indicate places of uncertainty, either for further inspection or to take intellectual responsibility. Text for which the reading is uncertain can be encoded in an <gi>unclear</gi> element. The reason for the unclear reading can be stated in a <att>reason</att> attribute, which takes either a single keyword, or a white space separated list of keywords. If the legibility is affected by damage, the cause of the damage can be described in the <att>agent</att> attribute. For example, as our previous transcription of the word <q>dioxide</q> as <q>diacxside</q> was quite uncertain, this could be indicated with the <gi>unclear</gi> element:
            <figure xml:id="example18">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <TEI>
                  <teiHeader>
                    <fileDesc>
                      <titleStmt>
                        <title>There and Back Again: digital edition</title>
                        <author xml:id="HannaRenton">Hanna Renton</author>
                        <editor xml:id="TBE">The TBE crew</editor>
                        <!--...-->
                      </titleStmt>
                      <!--...-->
                    </fileDesc>
                    <!--...-->
                  </teiHeader>
                  <text>
                    <body>
                      <!--...-->
                      <p>
                        <!--...--> di<unclear reason="illegible" resp="#TBE">
                                                    <subst hand="#HR">
                          <del rend="overwritten">ox</del>
                          <add>acx</add>
                        </subst>
                                                </unclear>side <!--...-->
                      </p>
                      <!--...-->
                    </body>
                  </text>
                </TEI>
              </egXML>
              <head type="legend">Signalling unclear text with <gi>unclear</gi>.</head>
            </figure>
          </p>
          <p>Similarly, if we decided that the damaged dateline at the start of the document could still be deciphered, the uncertain status of this part of the text could be indicated with an <gi>unclear</gi> element:
            <figure xml:id="example19">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <dateline>
                  <date when="2008-08-26">
                                        <damage agent="stapling" hand="#teacher" unit="chars" quantity="3">
                                            <unclear>26/</unclear>
                                        </damage>8/08</date>
                </dateline>
              </egXML>
              <head type="legend">Combining <gi>damage</gi> with <gi>unclear</gi>.</head>
            </figure>
            ...or without the <gi>damage</gi> element, if this is deemed less important to the transcription:
            <figure xml:id="example20">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <dateline>
                  <date when="2008-08-26">
                                        <unclear reason="damage" agent="stapling" unit="chars" quantity="3">26/</unclear>8/08</date>
                </dateline>
              </egXML>
              <head type="legend">Indicating damage in a <att>reason</att> attribute on <gi>unclear</gi>.</head>
            </figure>
          </p>
          <p>Notice, however, that the use of the <gi>unclear</gi> element implies that the text it encloses must still be present in the document source, and still be legible to some degree. If the encoder considers text too unclear to be transcribed in any way, he or she may opt to omit this part of the text, and indicate this editorial intervention with a <gi>gap</gi> element. This is an empty element, whose sole purpose is to indicate the omission, possibly with characterisation of the reason (<att>reason</att>), or the cause of the damage causing this omission, if any (<att>agent</att>). As with the <gi>damage</gi> element, the extent of the omission can be specified implicitly with the <att>extent</att> attribute, or more explicitly by combining the <att>unit</att> and <att>quantity</att> attributes.</p>
          <p>For example, on page 3 of our sample text, the phrase <q>Yess!! The door!!!</q> is followed by some words that can’t all be deciphered confidently, as they appear to have been erased by the author. When transcribing this passage, we could opt to encode an informed guess and mark it with the <gi>unclear</gi> element, while leaving out the truly illegible words. This omission can be marked with <gi>gap</gi>:
            <figure xml:id="example21">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                Yess!! The door!!! <unclear reason="erasure" resp="#TBE">
                                    <gap unit="cm" quantity="2.5"/> I got out.</unclear>
              </egXML>
              <head type="legend">Omitting illegible text with <gi>gap</gi>.</head>
            </figure>
          </p>
          <p>Similarly, the damage in the dateline could be deemed too destructive for a confident reading of the day, which may motivate the encoder to leave it out. In this case, too, a <gi>gap</gi> element can be used, either within or without a surrounding <gi>damage</gi> element:
            <figure xml:id="example22">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <dateline>
                  <date when="2008-08-26">
                                        <damage agent="stapling" unit="chars" quantity="3">
                                            <gap unit="chars" quantity="3"/>
                                        </damage>8/08</date>
                </dateline>
              </egXML>
              <head type="legend">Omitting illegible text in a damaged region.</head>
            </figure>
          </p>
          <p>In contrast, the editor may wish to make a stronger intervention, by supplying text that is lacking from or illegible in the document source. This can be done by wrapping the added text in a <gi>supplied</gi> element. In a <att>reason</att> attribute, the reason for this editorial addition can be given. For the dateline example, if the text is considered illegible, but the encoder feels able to reconstruct the date, this can result in following encoding:
            <figure xml:id="example23">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <dateline>
                  <date when="2008-08-26">
                                        <damage agent="stapling" unit="chars" quantity="3">
                                            <supplied resp="#TBE">26/</supplied>
                                        </damage>8/08</date>
                </dateline>
              </egXML>
              <head type="legend">Encoding editorial additions with <gi>supplied</gi>.</head>
            </figure>
          </p>
          <p>This allows us to encode other lacking text as well: at the end of page 2, a couple of final words on some lines are incomplete due to xeroxing. These can be reconstructed fairly straightforwardly for the transcription. However, these reconstructions are best signalled with the <gi>supplied</gi> element:<note>Notice, the crucial difference between the encoding of text added or deleted by the author or editor of the <emph>source document</emph> on the one hand, and by the encoder of the <emph>electronic</emph> transcription on the other hand. Additions or deletions present in the source may only be encoded respectively as <gi>add</gi> and <gi>del</gi>, while text that has been added or deleted by editorial emendation must be encoded as <gi>supplied</gi> or <gi>gap</gi>, respectively.</note>
            <figure xml:id="example24">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <p>
                  <!--...-->
                  Nothing was happeni<supplied reason="cutoff-while-xeroxing" resp="#TBE">ng.</supplied>  Then, <quote>Hello, dearie</quote>, an old woman answere<supplied reason="cutoff-while-xeroxing" resp="#TBE">d.</supplied> <quote>Who is it?</quote> I hung up. Uh, oh. How do I get back then?</p>
              </egXML>
              <head type="legend">Providing a reason for an editorial addition, with <att>reason</att> on <gi>supplied</gi>.</head>
            </figure>
          </p>
          <note type="summary">When text in the source document is still partly legible, but needs interpretation in order to be transcribed, this uncertainty can be expressed by enclosing the text in an <gi>unclear</gi> element. If text is deemed totally illegible, it can be omitted from the transcription, but signalled with a <gi>gap</gi> element (without any content). Both elements can indicate the reason for the editorial intervention (<att>reason</att>), and the nature of the damage (<att>agent</att>). An editor wishing to supply text in the electronic transcription for illegible or lacking text in the source text, can encode this supplied text with the <gi>supplied</gi> element. In a <att>reason</att> attribute, the reason for this intervention can be stated.</note>
        </div>
        <div xml:id="corrections">
          <head>Corrections</head>
          <p>If we look back at the comparison between the facsimiles (see <ptr type="crossref" target="#figure1"/>) and the initial transcription (see <ptr type="crossref" target="#example1"/>), we notice that a lot of words have been silently corrected by the transcriber. Although some errors had been corrected by the teacher (who can be considered an editor or corrector of the source document), many have slipped through. Depending on the aim of the transcription, such apparent errors may be transcribed unmediatedly, corrected silently, marked explicitly, or corrected explicitly. All of these practices are perfectly legitimate as long as they are applied consistently and motivated in the <gi>editorialDecl</gi> element of the electronic document’s header. An encoder adhering to a more explicit practice would like to at least signal apparent errors, editorial corrections, or both. The TEI provides specific elements for this purpose: <gi>sic</gi>, for indicating apparent errors, and <gi>corr</gi>, for indicating editorial corrections. For example, the sentence <q>Now I know what all the black air is: all the polution.</q> on page 2 could be transcribed as follows:
            <figure xml:id="example25">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                Now I know what all the black air is: all the <sic>polution</sic>.
              </egXML>
              <head type="legend">Encoding an apparent error with <gi>sic</gi>.</head>
            </figure>
            ...if the encoder would be interested in transcribing the source text as accurately as possible, or:
            <figure xml:id="example26">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                Now I know what all the black air is: all the <corr>pollution</corr>.
              </egXML>
              <head type="legend">Encoding the correction of an apparent error with <gi>corr</gi>.</head>              
            </figure>
            ...if the content matters most (perhaps to ease searching operations in a digital edition of the text). However, both <soCalled>views</soCalled> on the text can be combined in a <gi>choice</gi> element.<note>Again, a crucial distinction must be pointed out between encoding of corrections present in the <emph>source document</emph>, and editorial corrections in the <emph>electronic transcription</emph>. The latter must always be encoded using <gi>sic</gi> and <gi>corr</gi>, possibly wrapped in a <gi>choice</gi> element. Corrections present in the source document must be encoded using combinations of <gi>del</gi> and <gi>add</gi>, possibly grouped in a <gi>subst</gi> element, and preferably specified with attributes identifying the responsible document hand (<att>hand</att>), and the editor responsible for this identification (<att>resp</att>).</note> This enables an encoder to express alternative encodings of the same text. Both views could thus be combined as:
            <figure xml:id="example27">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                Now I know what all the black air is: all the <choice>
                                    <sic>polution</sic>
                                    <corr>pollution</corr>
                                </choice>.
              </egXML>
              <head type="legend">Combining errors and corrections in <gi>choice</gi>.</head>
            </figure>
          </p>
          <p>The <gi>sic</gi> element may contain all elements that are necessary to represent the original source text, like deletions, damage, and so on. The <q>diacxside</q> fragment on page two can thus be corrected as follows:
          <figure xml:id="example28">
            <egXML xmlns="http://www.tei-c.org/ns/Examples">
              <choice>
                                    <sic>di<subst resp="#TBE">
                <del hand="#HR" rend="overwritten">ox</del>
                <add hand="#HR">acx</add>
              </subst>side</sic>
                                    <corr>dioxide</corr>
                                </choice>
            </egXML>
            <head type="legend">Encoding authorial phenomena inside <gi>sic</gi>.</head>
          </figure>
          </p>
          <note type="summary">Apparent errors in the source text may be indicated explicitly in a <gi>sic</gi> element, or corrected with a <gi>corr</gi> element. Both the original and the correction can be included in the transcription, if they are wrapped in a <gi>choice</gi> element.</note>
        </div>
      </div>
            <div xml:id="summary">
        <head>Summary</head>
        <p>This tutorial module has focused on the encoding of specific phenomena of primary source texts in TEI. When all of the concepts discussed are applied to the example text, this is how its transcription could look:
          <figure xml:id="example29">
            <egXML xmlns="http://www.tei-c.org/ns/Examples">
              <TEI>
                <teiHeader>
                  <fileDesc>
                    <titleStmt>
                      <title>There and Back Again: digital edition</title>
                      <author xml:id="HannaRenton">Hanna Renton</author>
                      <editor xml:id="TBE">The TBE crew</editor>
                    </titleStmt>
                    <!--...-->
                  </fileDesc>
                  <!--...-->
                  <profileDesc>
                    <!--...-->
                    <handNotes>
                      <handNote xml:id="HR" scribe="HannaRenton" script="handwritten" medium="pencil" scope="major">
                        <p>the document's main hand, Hanna Renton</p>
                      </handNote>
                      <handNote xml:id="teacher" scribe="classTeacher" script="handwritten" medium="red_ballpen" scope="minor">
                        <p>the document author's teacher</p>
                      </handNote>
                    </handNotes>
                  </profileDesc>
                  <!--...-->
                </teiHeader>
                <text>
                  <body>
                    <pb n="1" facs="scans/TBA001.jpg"/>
                    <dateline>
                      <date when="2008-08-26">
                                                <damage agent="stapling" hand="#teacher" unit="chars" quantity="3">
                        <supplied resp="#TBE">26/</supplied>
                      </damage>8/08</date>
                    </dateline>
                    <head>There and Back Again</head>
                    <p>
                                            <add place="margin" resp="#TBE" hand="#teacher">Well done! <lb/>8,5 / 10</add>I can't bel<subst hand="#teacher" resp="#TBE">
                                                <del rend="strikethrough">ei</del>
                                                <add>ie</add>
                                            </subst>ve it. Carl has not written to me or sent me a postcard once since he's been away in Egypt. It would be easier if our phone was working. It's been broken for ages! Dad can't fix it at the moment, and we can't afford to buy a new one. I would write to him, but he didn't tell me the address of the villa he was staying in. If only I had a mobile, I could phone his mobile number. Eureka!!! I could use next <choice>
                                                <sic>doors</sic>
                                                <corr>door's</corr>
                                            </choice> phone, oh, actually, Mr and Mrs Crooel won't let me use it (they're my next door neighbours). I know! I'll use the phone box!!! (I think I've got some change).</p>
                    <p>Goodness me, this phone box stinks. EEAW, I don't even want to know what that is. Anyway, I hope his phone is switched on. What's it again??? Oh, yeah 1312632. Arrgh!! <choice>
                                                <sic>W<subst hand="#HR" resp="#TBE">
                                                        <del rend="overwritten">a</del>
                                                        <add>h</add>
                                                    </subst>ats</sic>
                                                <corr>What's</corr>
                                            </choice> happening!!! Who's shaking the phone box!! Who turned <restore hand="#HR" resp="#TBE">
                      <subst>
                        <del rend="crossout">out</del>
                        <add place="margin">off</add>
                      </subst>
                    </restore> the lights!!!!</p>
                    <p>WOW!!! Where am I? Why is everything so <choice>
                                                <sic>smokey</sic>
                                                <corr>smoky</corr>
                                            </choice>? Everything is silver except the air around me, it's black, and I'm standing in a silver pod, with something that <choice>
                                                <sic>lookes</sic>
                                                <corr>looks</corr>
                                            </choice> like a phone. When you look up there are millions of metal poles, and some of them have w<subst hand="#HR" resp="#TBE">
                                                <del rend="overwritten">a</del>
                                                <add>h</add>
                                            </subst>at look like funny shaped cars whizzing along attached to the metal poles at the top.</p>
                    <pb facs="scans/TBA001b.jpg"/>
                    <pb n="2" facs="scans/TBA002.jpg"/>
                    <p>There seem<del rend="crossout" hand="#HR">e</del>s to be no-one around <add place="above" hand="#HR">the phone box</add>. Yuk! <subst hand="#HR" resp="#TBE">
                                                <del rend="writeover">s</del>
                                                <add>S</add>
                                            </subst>omeone has just walked past. All their skin is black and crusty and in the side of their neck are <unclear reason="illegible" resp="#TBE">gitt</unclear> like things. The whites of his or her eyes are grey and he, or she has no hair. I also notice that he, or she has a clear gas mask. It's from all the smoke.</p>
                    <p>Goodness me! I just stepped outside the phone box and I couldn'<unclear reason="cutoff while xeroxing" resp="#TBE">t</unclear> breath<add hand="#teacher">e</add>. <add hand="#teacher" place="margin">"breath" = noun <lb/> "to breathe" = verb</add> It was like a <choice>
                                                <sic>kng</sic>
                                                <corr>king</corr>
                                            </choice> cobra was wrapped around my neck and if I was to get a little bit of air in it was horrible, like when you stop at red man beside the traffic lights and a bus is stopped beside you and you're getting breaths of <choice>
                                                <sic>carben di<subst resp="#TBE">
                      <del hand="#HR" rend="overwritten">ox</del>
                      <add hand="#HR">acx</add>
                    </subst>side</sic>
                                                <corr>carbon dioxide</corr>
                                            </choice>. But this was 100x worse. Now I know what all the black air is: all the <choice>
                                                <sic>polution</sic>
                                                <corr>pollution</corr>
                                            </choice>. But that doesn't help me figure out where I am.</p>
                    <p>What's that? It's a big poster <add hand="#HR" place="margin" resp="#TBE">
                                                <subst>
                      <del rend="crossout">at</del>
                      <add place="above">on</add>
                    </subst> the wall</add>, saying: Monday 26th May 1312632. I've gone into the future!!! Wait, I recognise the date. It's <choice>
                                                <sic>Carls</sic>
                                                <corr>Carl's</corr>
                                            </choice> number! When I typed it in on the key pad in the phone box, that must <choice>
                                                <sic>of</sic>
                                                <corr>have</corr>
                                            </choice> taken me into the future: I must get back and warn everyone! I'll type in 2008. Nothing was happeni<supplied reason="cutoff while xeroxing" resp="#TBE">ng.</supplied> Then, <quote>Hello, dearie</quote>, an old woman answere<supplied reason="cutoff while xeroxing" resp="#TBE">d.</supplied> <quote>Who is it?</quote> I hung up. Uh, oh. How do I get back then?</p>
                    <pb n="3" facs="scans/TBA003.jpg"/>
                    <p>I've been thinking for ages about what to do. There only seems to be one good option, fix and stop all the <choice>
                                                <sic>polution</sic>
                                                <corr>pollution</corr>
                                            </choice>. This sort of seems like a dream, but a fun dream. I'll just have to find out where the city's power source is. <delSpan hand="#HR" resp="#TBE" rend="crossout" spanTo="#delEnd"/> But I've got to go outside (again).</p>
                    <p>It was <choice>
                                                <sic>alot</sic>
                                                <corr>a lot</corr>
                                            </choice> easier to find than I thought it would be. <anchor xml:id="delEnd"/> I got round the corner and <choice>
                                                <sic>ther</sic>
                                                <corr>there</corr>
                                            </choice> was a BIG sign saying <choice>
                                                <sic>CITYS</sic>
                                                <corr>CITY'S</corr>
                                            </choice> POWER SOURCE. It's very oily and extremely big. Ah, this will be the switch.<gap reason="erasure" unit="cm" quantity="2" resp="#TBE"/>
                                        </p>
                    <p>Everything has gone dark and I can't see where I'm going. I keep on banging into long bars and wires and knobs. Yess!! The door!!! <unclear reason="erasure" resp="#TBE">
                                                <gap unit="cm" quantity="2.5"/>I got out.</unclear>
                                        </p>
                    <p>There is uproar outside. I sealed the door with stones on the ground so no one could get <subst hand="#HR" resp="#TBE">
                                                <del rend="overwritten">it</del>
                                                <add>in</add>
                                            </subst> to turn the switch back on.</p>
                    <p>I've been thinking. If I'm going to suck out all the <choice>
                                                <sic>polution</sic>
                                                <corr>pollution</corr>
                                            </choice> I'm going to need help. Which is not going to be easy. <unclear reason="erasure" resp="#TBE">
                                                <gap unit="cm" quantity="2"/> cafe</unclear>
                                        </p>
                    <p>Everyone keeps on staring at me. It's very annoying. I hope people will help!</p>
                    <p>OK. I think this will work. I've put up posters everywhere. They say... <quote>MEETING BESIDE PHONE BOX BE THERE AT 2pm</quote>. I hope they read <choice>
                                                <sic>english</sic>
                                                <corr>English</corr>
                                            </choice>. And <choice>
                                                <sic>english</sic>
                                                <corr>English</corr>
                                            </choice> time.</p>
                  </body>
                </text>
              </TEI>
            </egXML>
            <head type="legend">A fully encoded transcription of the example text.</head>
          </figure>
        </p>
      </div>
            <div xml:id="primsource.further">
        <head>What’s Next?</head>
        <p>You have reached the end of this tutorial module covering the markup of primary source materials with TEI. You can now either 
          <list rend="bulleted">
            <item>proceed with <ref target="../modules/">other TEI by Example modules</ref>
                        </item>
            <item>have a look at the <ref target="../examples/TBED06v00.htm">examples section</ref> for the primary sources module.</item>
            <item>take an interactive test. This comes in the form of a set of multiple choice questions, each providing a number of possible answers. Throughout the quiz, your score is recorded and feedback is offered about right <emph>and</emph> wrong choices. Can you score 100%? Test it <ref target="../tests/TBED06v00.htm">here</ref>!</item>
          </list>
        </p>
      </div>
        </body>
  </text>
  <!-- 
        $Date$
        $Id$  -->
</TEI>