{"id":179,"date":"2019-02-19T10:49:42","date_gmt":"2019-02-19T17:49:42","guid":{"rendered":"http:\/\/briancroxall.net\/w19dh\/?page_id=179"},"modified":"2019-03-13T11:14:04","modified_gmt":"2019-03-13T17:14:04","slug":"tei-markup","status":"publish","type":"page","link":"https:\/\/briancroxall.net\/w19dh\/assignments\/tei-markup\/","title":{"rendered":"TEI Markup"},"content":{"rendered":"<h2>Rationale<\/h2>\n<p>Past courses of mine have already <a href=\"http:\/\/briancroxall.net\/f17dh\/assignments\/distant-reading-duffy\/\">created digital editions of Duffy&#8217;s poetry<\/a>. But if we are going to have confidence in our research, it&#8217;s critical that we make sure we have accurate versions of her poems. This assignment will give us the opportunity to spot-check this work since mark-up requires significantly more care than transcription.\u00a0<\/p>\n<p>In addition to providing a better environment for careful attention, a marked-up edition provides us the chance to enrich the text. These enrichments can take the form of adding themes to the metadata, tagging place or person names, or identifying rhyme schemes in the different poems, as infrequent though they may be. If we work\u00a0consistently across all five volumes of the poetry in this process, we will be able to query our markup to highlight similarities and differences between\u00a0<em>The World&#8217;s Wife<\/em> and the books that precede it.<\/p>\n<h2>Nitty Gritty<\/h2>\n<p>Each of us will markup 15 poems, three from each of her five volumes. More specifically, you will each markup the two poems that you select for your <a href=\"http:\/\/briancroxall.net\/w19dh\/daily-poetry-discussion\/\">daily poetry discussion<\/a>\u00a0plus one that I randomly select. I suppose that this could encourage you to pick shorter poems for your daily discussion, but I also trust you to not game the system too much.\u00a0<\/p>\n<p>Random poem assignments:<\/p>\n<ul>\n<li>Dallyn: &#8220;Dear Norman&#8221; from SFN; &#8220;Strange Place&#8221; from SM; &#8220;Anne Hathaway&#8221; from TWW; &#8220;Mrs Skinner, North Street&#8221; from TOC; &#8220;Prayer&#8221; from MT<\/li>\n<li>Maika: &#8220;Dreaming of Somewhere Else&#8221; from SFN; &#8220;Homesick&#8221; from SM; &#8220;Thetis&#8221; from TWW; &#8220;P\u00e8re Lachaise&#8221; from TOC; &#8220;First Love&#8221; from MT<\/li>\n<li>Timothy: &#8220;And Then What&#8221; from SFN; &#8220;Psychopath&#8221; from SM; &#8220;Queen Kong&#8221; from TWW; &#8220;Hometown&#8221; from TOC; &#8220;Steam&#8221; from MT<\/li>\n<li>BC: &#8220;Girl Talking,&#8221; &#8220;Words of Absolution,&#8221; Woman Seated in the Underground, 1941&#8243; from SFN; &#8220;Correspondents,&#8221; &#8220;Telephoning Home,&#8221; &#8220;Plainsong&#8221; from SM; &#8220;Frau Freud,&#8221; &#8220;Medusa,&#8221; &#8220;Pope Joan&#8221; from TWW; &#8220;Words, Wide Night,&#8221; &#8220;The Kissing Gate,&#8221; &#8220;The Way My Mother Speaks&#8221; from TOC; &#8220;Moments of Grace,&#8221; &#8220;The Captain of the&#8230;,&#8221; &#8220;Never Go Back&#8221; from MT<\/li>\n<\/ul>\n<p>Your marked-up poems will be due no later than\u00a0<strong>Monday, 18 March<\/strong> by the beginning of class.\u00a0Your reflection papers are due on <strong>Wednesday, 20 March<\/strong> by the beginning of class.<\/p>\n<h3>Get Oxygen<\/h3>\n<p><a href=\"https:\/\/www.oxygenxml.com\/xml_editor\/download_oxygenxml_editor.html\">Download Oxygen XML Editor<\/a>\u00a0and sign up for a free, 30-day trial. You will receive a license key via email and you will need to use it with your individual copy.<\/p>\n<h3>Get the poems<\/h3>\n<p>The text of each of Duffy&#8217;s volumes is available either on <a href=\"https:\/\/docs.google.com\/document\/d\/1ZU-2oxJQAaZ-bogT8PdkZmAz2CRqTenaOhU4BhyPfnU\/edit?usp=sharing\">this shared Google Doc<\/a>\u00a0or in our <a href=\"https:\/\/github.com\/briancroxall\/duffy2019\/tree\/master\/text-files\">Duffy repository on GitHub<\/a>. The poems are identical in either location, so choose the one that seems easiest for you to work with.<\/p>\n<h3>Create the poem file<\/h3>\n<p>In Oxygen, open the <a href=\"https:\/\/github.com\/briancroxall\/duffy2019\/blob\/master\/tei-markup\/PoemTemplate.xml\">poem template<\/a> from the repo and copy all of its text (Ctrl\/Cmd-A, then Ctrl\/Cmd-C). Then open a new document in Oxygen and paste the template (Ctrl\/Cmd-V) into it.\u00a0<strong>Do\u00a0<em>NOT<\/em> start editing the template itself.<\/strong><\/p>\n<p>Name the file as follows: [two-digit number of poem]-[title of poem, underscored if multiple words]-[abbreviation of book].xml, using all lowercase. For example, &#8220;Girl Talking&#8221; and &#8220;Comprehensive&#8221; which are the first and second poems in\u00a0<em>Standing Female Nude<\/em> would have the following filenames: <code>01-girl_talking-sfn.xml<\/code> and <code>02-comprehensive-sfn.xml<\/code>, respectively.<\/p>\n<p>Save the file in the appropriate folder in your local copy of the GitHub repo.<\/p>\n<h3>Check the poem<\/h3>\n<p>Before marking up the poem, check carefully to see whether the poem has been transcribed faithfully from the text. Please pay special attention to the following:<\/p>\n<ul>\n<li>Punctuation, especially at the end of lines<\/li>\n<li>Spelling, being aware that British and American English differ and that the former is likely correct\u00a0<\/li>\n<li>Italics, making sure you have used the following markup: <code>&lt;hi rend=\"italics\"&gt;<\/code><\/li>\n<\/ul>\n<h3>Markup the poem<\/h3>\n<p>Markup the poem as follows. Be sure to refer to our &#8220;<a href=\"https:\/\/docs.google.com\/document\/d\/1uDKTJeV6aa61bQCHUilMTLoYvXcQbFpI076FeYXPMJc\/edit?usp=sharing\">Duffy Encoding Editorial Decisions<\/a>&#8221; document.<\/p>\n<h4>teiHeader<\/h4>\n<ul>\n<li><code>&lt;filedesc&gt;<\/code>\n<ul>\n<li><code>&lt;titleStmt&gt;<\/code>\n<ul>\n<li><code>&lt;title&gt;<\/code>: the poem&#8217;s title<\/li>\n<li><code>&lt;respStmt&gt;<\/code>\n<ul>\n<li><code>&lt;persName&gt;<\/code>: your name<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li><code>&lt;publicationStmt&gt;<\/code>\n<ul>\n<li><code>&lt;date&gt;<\/code>: the date you are encoding the poem<\/li>\n<\/ul>\n<\/li>\n<li><code>&lt;sourceDesc&gt;<\/code>\n<ul>\n<li><code>&lt;bibl&gt;<\/code>: the original information about the poem you&#8217;re encoding<code><\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li><code>profileDesc<\/code>\n<ul>\n<li>We will place the metadata for theme, gender, place, children, and narration in the <code>textClass<\/code> &#8211;&gt; <code>keywords<\/code> &#8211;&gt; <code>term<\/code>.<\/li>\n<li>For each <code>term<\/code>, you will include a type:\n<ul>\n<li>Theme.\u00a0Using the list from our <a href=\"https:\/\/docs.google.com\/document\/d\/1uDKTJeV6aa61bQCHUilMTLoYvXcQbFpI076FeYXPMJc\/edit#\">Duffy Encoding Decisions document<\/a>, include as many themes as seem reasonable. Each theme gets\u00a0<em>its own<\/em>\u00a0<code>term<\/code> tag. Be open to themes that are not yet on the list and bring them to the class.<\/li>\n<li>Gender.\u00a0\u00a0Identify whether the poem contains characters who are male or female and then identify whether the characters are major or minor.\u00a0Write the character types as follows: &#8220;major female character,&#8221; &#8220;major male character,&#8221; &#8220;minor female character,&#8221; or &#8220;minor male character.&#8221; Each of these gets\u00a0<em>its own <code>term<\/code><\/em> tag.\u00a0If there are no characters with identifiable genders, simply write &#8220;unknown.&#8221;<\/li>\n<li>Place.\u00a0A poem should be marked qua place on one or more of three binaries: rural or urban;\u00a0public or private;\u00a0inside or outside.\u00a0A poem can be both of the binary&#8217;s options\u00a0at the same time (e.g., public and private). Finally, if you can determine which country or even continent a poem is set, include that (e.g., Britain, Africa). Each of these gets its own <code>term<\/code> tag.<\/li>\n<li>Children.\u00a0Depending on whether there are children in the poem or not, simply write &#8220;Yes&#8221; or &#8220;No,&#8221; respectively.<\/li>\n<li>Narration.\u00a0Record the point of view of the poem. The most common choices will be &#8220;first person&#8221; or &#8220;third person.&#8221; Occasionally, poems use the second person, like &#8220;I Remember Me&#8221; in SFN. There should only be one point of view for a poem. But you will create a second narration <code>term<\/code> to indicate whether or not there is a &#8220;you&#8221; addressed in the poem. Simply write &#8220;you&#8221; or &#8220;no you.&#8221;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li><code>&lt;revisionDesc&gt;<\/code>\n<ul>\n<li><code>&lt;change&gt;<\/code>: record the date as the value for &#8220;when&#8221; using YYYY-MM-DD format and add your name\/initials as the value for &#8220;who.&#8221; Then replace the &#8220;?&#8221; with a description of what you did. Most of the time, &#8220;initial markup&#8221; is a good description.\u00a0<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>Body<\/h4>\n<ul>\n<li>Structure\n<ul>\n<li>Wrap the entire poem in a <code>&lt;lg type=\"poem\" n=\"X\"&gt;<\/code>. Change the X to the number of the poem\u00a0in the volume that you&#8217;re working on. Yes, this will mean counting in the table of contents.\n<ul>\n<li>For the type of poem, you have four choices.\n<ul>\n<li>sonnet. Use this type if the poem has exactly 14 lines, even if it doesn&#8217;t use the standard sonnet rhyme scheme or if the stanzas are broken in unusual ways.<\/li>\n<li><a href=\"https:\/\/en.wikipedia.org\/wiki\/Dramatic_monologue\">dramaticMonologue<\/a>. Good examples include &#8220;Head of English&#8221; or &#8220;You, Jane.&#8221; Use this type if<em> all<\/em> of the following are true:\n<ul>\n<li>There is one speaker in\u00a0the poem who is not the poet<\/li>\n<li>The person addresses one or more people\u00a0and we know about what they say or do based only on the speaker&#8217;s words<\/li>\n<li>The speaker&#8217;s words reveal something\u00a0about the speaker<\/li>\n<\/ul>\n<\/li>\n<li>haiku. Use this type if the poem has 3 lines, with the lines having a 5-7-5 syllable count.\u00a0<\/li>\n<li>poem. Use this for all poems that do not fit the other three options.<\/li>\n<\/ul>\n<\/li>\n<li>If the poem has an overall rhyming pattern, like a traditional sonnet would, include the rhyme scheme in the\u00a0opening <code>&lt;lg&gt;<\/code>, e.g., <code>&lt;lg type=\"poem\" rhyme=\"ababcdcdefefgg\"&gt;<\/code>.<\/li>\n<\/ul>\n<\/li>\n<li><code>&lt;head&gt;<\/code>: the poem&#8217;s title<\/li>\n<li>Wrap each stanza in a <code>&lt;lg type=\"stanza\" n=\"X\"&gt;<\/code> tag. Change the X to the number of the stanza.<\/li>\n<li>Wrap each line in a <code>&lt;l&gt;<\/code> tag and number the lines, e.g., <code>&lt;l n=\"1\"&gt;<\/code><\/li>\n<li>If a poem has multiple parts, like &#8220;Poem in Oils&#8221; in\u00a0<em>SFN<\/em> or &#8220;The Devil&#8217;s Wife&#8221; in\u00a0<em>TWW<\/em>, encode it as a <a href=\"http:\/\/teibyexample.org\/modules\/TBED04v00.htm#composite\">composite poem.<\/a><\/li>\n<\/ul>\n<\/li>\n<li>Semantics\n<ul>\n<li>Tag all person names using <code>&lt;persName&gt;<\/code>. If the person is a real person, put in a <a href=\"https:\/\/viaf.org\/\">VIAF<\/a> reference using <code>ref=\"\"<\/code>, e.g., <code>&lt;persName ref=\"http:\/\/viaf.org\/viaf\/76321889\"&gt;Ronald Reagan&lt;\/persName&gt;<\/code><\/li>\n<li>Tag all named places using <code>&lt;placeName&gt;<\/code>. If the place corresponds to somewhere\u00a0in the real world, put in a <a href=\"http:\/\/www.geonames.org\/\">GeoNames<\/a> reference using <code>ref=\"\"<\/code>, e.g., <code>&lt;placeName ref=\"http:\/\/www.geonames.org\/maps\/google_40.714_-74.006.html\"&gt;<\/code><\/li>\n<li>Tag all body words using <code>&lt;seg type=\"bodyPart\"&gt;<\/code><\/li>\n<li>Tag rhymes, both end and internal with <code>&lt;rhyme&gt;<\/code>\u00a0and use the label attribute to indicate the rhyme scheme, e.g.\u00a0<code>&lt;rhyme label=\"a\"&gt;<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Push the poem<\/h3>\n<p>After you&#8217;ve finished your work on the poem, make sure you <code>push<\/code> the changes you have made to the repo using the GitHub Desktop client. You might want to create a different commit for each poem as you work.<\/p>\n<h3>Reflect on the poems<\/h3>\n<p>After you have completed your edition, you will write a two- to three-page, double-spaced reflection on the assignment in 12-point Times New Roman. Some questions to consider in your reflection are:<\/p>\n<ul>\n<li>What did I learn about digital humanities from this assignment?<\/li>\n<li>What did I learn about Duffy&#8217;s poetry from this assignment?<\/li>\n<li>What did I learn about research from this assignment?<\/li>\n<li>What would I change about this assignment to make it more relevant, informative, enjoyable, challenging, or interesting?<\/li>\n<\/ul>\n<h2>Grading<\/h2>\n<p>This assignment is worth 125 points. I will <a href=\"https:\/\/www.random.org\/\">randomly<\/a> select five of the poems that you marked up. Each poem will be worth up to 20 points distributed as follows:<\/p>\n<ul>\n<li><strong>5 points:\u00a0<\/strong>I will check the poem to see if it is well-formed (per XML standards) and if it validates (against the TEI schema).<\/li>\n<li><strong>5 points:\u00a0<\/strong>I will check the poem&#8217;s text against the original text to make sure it is all correct.<\/li>\n<li><strong>5 points:\u00a0<\/strong>I will check to see if your <code>&lt;TEI Header&gt;<\/code> contains all the required information, including the user-determined metadata, such as theme, poem form, &#8220;I &amp; you&#8221;- vs third-person narration, and anything else we determine as a class.<\/li>\n<li><strong>5 points:\u00a0<\/strong>I will check the <code>&lt;text&gt;<\/code> to see if you have correctly tagged person names, place names, body words, as well as anything else we determine as a class.<\/li>\n<\/ul>\n<p>The remaining 25 points for the assignment will be awarded for timeliness and in connection with the reflection paper.<\/p>\n<h2>Credits<\/h2>\n<p>I designed this assignment in 2018 after discussions with <a href=\"https:\/\/library.brown.edu\/create\/cds\/people\/elli-mylonas\/\">Elli Mylonas<\/a>, TEI aficionado and\u00a0colleague extraordinaire. I&#8217;ve updated the assignment considerably for our 2019 class. Elli created the basic poem template and will\u2014no doubt\u2014continue to answer a great many questions as we go along.<\/p>\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Rationale Past courses of mine have already created digital editions of Duffy&#8217;s poetry. But if we are going to have confidence in our research, it&#8217;s critical that we make sure we have accurate versions of her poems. This assignment will give us the opportunity to spot-check this work since mark-up requires significantly more care than [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":77,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_jetpack_hide_featured_image":false,"_jetpack_featured_image_duplicate_dismissed":0,"footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-179","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/PaATg6-2T","_links":{"self":[{"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/pages\/179","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/comments?post=179"}],"version-history":[{"count":52,"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/pages\/179\/revisions"}],"predecessor-version":[{"id":563,"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/pages\/179\/revisions\/563"}],"up":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/pages\/77"}],"wp:attachment":[{"href":"https:\/\/briancroxall.net\/w19dh\/wp-json\/wp\/v2\/media?parent=179"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}