<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title type="main">TEI by Example</title>
        <title type="sub">Module 4: Poetry</title>
        <author xml:id="EV">Edward Vanhoutte</author>
        <editor xml:id="RvdB">Ron Van den Branden</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-16" who="#RvdB">technical revision</change>
      <change when="2010-07-09" who="#RvdB">release</change>
      <change when="2010-07-08" who="#EV">revision and added 2.3. grouping structures and 6.2. dedications</change>
      <change when="2007-10-22" who="#EV">added 6.2 Acrostics</change>
      <change when="2007-10-22" who="#EV">
                <list>
                    <item>-added new prose with internal rhyme under 3.1</item>
                    <item>inserted enjambements under 4.4 and rewrote that section</item>
                    <item>edited summary of 4</item>
                    <item>added summary to 5</item>
                    <item>removed <q>suggestions</q> div</item>
                </list>
            </change>
      <change when="2007-10-11" who="#EV">correction of text</change>
      <change when="2007-10-11" who="#EV">revision</change>
      <change when="2007-09-25" who="#EV">revision</change>
      <change when="2007-05-22" who="#RvdB">revision</change>
    </revisionDesc>
  </teiHeader>
  <text xml:id="TBED04v00" type="tutorials">
    <body>
            <div xml:id="metre">
        <head>Metrical Structure</head>
        <p>There is a difference between the conventional metrical structure of a poem and the actual realisation of that conventional metrical structure. Both can be documented with the use of attributes.</p>
        <div xml:id="metreconventional">
          <head>Conventional Metrical Structure</head>
          <p>The conventional metrical structure in which a poet is working can be documented with the <att>met</att> attribute, whose value specifies the metrical form of a single verse line. This attribute can be added to any text-division element in use in the encoding of poetry: <gi>div</gi>, <gi>lg</gi>, and <gi>l</gi>. The metre documented inside the <att>met</att> attribute is inherited by any metrical unit contained within the element for which the <att>met</att> attribute has been supplied. This means that the <att>met</att> value of a <gi>div</gi> or an <gi>lg</gi>, for instance, is inherited by nesting <gi>div</gi>s or <gi>lg</gi>s. The metrical structure of that <gi>lg</gi> is understood to contain as many repetitions of the pattern as there are lines in the line group. The same attribute value, when inherited in turn by the <gi>l</gi> element, must be understood not to repeat. Consider the third stanza of our shopping list poem, which exists of three lines of alternating long and short syllables:
            <figure xml:id="example20">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <lg type="stanza" met="-u|-u|-u|-/">
                  <l>Paper towels/garbage bags</l>
                  <l>Pasta sauce and Parmesan</l>
                  <l>Pumpkin seed and olive oil</l>
                </lg>
              </egXML>
              <head type="legend">Encoding the metrical structure of a stanza.</head>
            </figure>
          </p>
        </div>
        <div xml:id="metreprivate">
          <head>Private Metrical Notation Scheme</head>
          <p>The encoder is free to design their own metrical notation scheme. In the example above use has been made of the classical scansion system which marks quantitative metre originally by a macron (here a dash <code>-</code>) for long syllables and a breve (here a <code>u</code>) for short syllables. A bar <code>|</code> is used to mark the foot boundary and a slash <code>/</code> marks the line boundary. Other systems like the ictus (<code>/</code>) and <code>x (x)</code> system could be used to denote metrically stressed and unstressed syllables. The use of this latter system results in the following <att>met</att> attribute value for the stanza above: <val>/+/+/+/</val>.</p>
          <p>The metrical notation scheme used may be documented in the <gi>metDecl</gi> element within the <gi>encodingDecl</gi> element inside the TEI header. For the above example this could be documented as follows:
            <figure xml:id="example21">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <metDecl>
                  <metSym value="-">long syllable</metSym>
                  <metSym value="u">short syllable</metSym>
                  <metSym value="|">foot boundary</metSym>
                  <metSym value="/">metrical line boundary</metSym>
                </metDecl>
              </egXML>
              <head type="legend">Formal documentation of the metrical notation scheme with <gi>metSym</gi> elements inside <gi>metDecl</gi>.</head>
            </figure>
          </p>
          <p>This may also be expressed less formally, for instance:
            <figure xml:id="example22">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <metDecl>
                  <p>use has been made of the classical scansion system which marks quantitative metre originally by a macron (here a dash '-') for long syllables and a breve (here a 'u') for short syllables. A bar '|' is used to mark the foot boundary and a slash '/' marks the line boundary.</p>
                </metDecl>
              </egXML>
              <head type="legend">Informal documentation of the metrical notation scheme as a loose description inside <gi>metDecl</gi>.</head>
            </figure>
          </p>
          <note type="reference">See section <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/VE.html#HDMN">6.5 Metrical Notation Declaration</ref> of the TEI Guidelines for more examples and complex cases.</note>
        </div>
        <div xml:id="metrerealization">
          <head>Realisation of Metrical Structure</head>
          <p>When we consider the third and the fourth stanzas of the shopping list poem, we see that some lines of the fourth stanza divert from the metrical scheme documented in the <att>met</att> attribute. This deviation, or otherwise put, the <soCalled>realisation</soCalled>, may be documented inside a <att>real</att> attribute:
            <figure xml:id="example23">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <lg type="stanza" met="-u|-u|-u|-/">
                  <l>Paper towels/garbage bags</l>
                  <l>Pasta sauce and Parmesan</l>
                  <l>Pumpkin seed and olive oil</l>
                </lg>
                <lg type="stanza" met="-u|-u|-u|-/">
                  <l>Cheesy crisps and favourite mags</l>
                  <l real="-u|-‘|-u|-">Kidney beans (1 large can)</l>
                  <l real="- -|u-|u-">Cling film and kitchen foil</l>
                </lg>
              </egXML>
              <head type="legend">Encoding the actual realisation of a metrical scheme with a <att>real</att> attribute.</head>
            </figure>
          </p>
        </div>
        <div xml:id="metrecaesura">
          <head>Caesura and Enjambements</head>
          <p>Whereas a caesura expresses a metrical pause inside one line of verse, an enjambement marks the breaking of a syntactic unit between two lines of verse.</p>
          <p>The third line of the last stanza of the shopping list poem consists of two equal metrical parts (<code>-u-</code>) with a rest in between. This rest is called a caesura, and is here represented with an apostrophe. We can encode this information also in the verse line, with the <gi>caesura</gi> element which marks the point at which a metrical line may be divided:
            <figure xml:id="example24">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <l>Kidney beans <caesura/> (1 large can)</l>
              </egXML>
              <head type="legend">Encoding caesura with <gi>caesura</gi>.</head>
            </figure>
          </p>
          <p>The presence, absence, or degrees of discrepancy between lines of verse and syntactic units running over them can be documented as values of an optional <att>enjamb</att> attribute on the <gi>l</gi> element. When used, this attribute can, for instance, have the value <val>yes</val> or <val>no</val> to signal its occurrence, or <val>weak</val> or <val>strong</val> to express some sort of evaluation. In the following stanza of Edgar Allen Poe’s <title level="a">The Raven</title> the presence or absence of enjambement is encoded:
            <figure xml:id="example25">
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <lg>
                  <l enjamb="yes">But the Raven, sitting lonely on the placid bust, spoke only</l>
                  <l enjamb="no">That one word, as if his soul in that one word he did outpour.</l>
                  <l enjamb="no">Nothing further then he uttered, not a feather then he fluttered,</l>
                  <l enjamb="no">Till I scarcely more than muttered,—"Other friends have flown before;</l>
                  <l enjamb="no">On the morrow he will leave me, as my Hopes have flown before."</l>
                  <l enjamb="no">Then the bird said, "Nevermore."</l>
                </lg>
              </egXML>
              <head type="legend">Encoding enjambments with <att>enjamb</att>.</head>
            </figure>
          </p>
          <note type="summary">The expressions of conventional metrical structures in <att>met</att> attributes are inherited by the children of the attributed elements, except where deviations are expressed in a <att>real</att> attribute. Each encoder is free to design their own encoding scheme and document it inside <gi>metDecl</gi>. It is also possible to encode the occurrence and location of a caesura (with <gi>caesura</gi>) or an enjambement (with <att>enjamb</att>).</note>
        </div>
      </div>
        </body>
  </text>
    <!-- 
        $Date: 2020-07-08 02:33:20 +0200 (Wed, 08 Jul 2020) $
        $Id: TBED04v00.xml 425 2020-07-08 00:33:20Z ron.vandenbranden $  -->
</TEI>