{"id":179,"date":"2018-02-16T14:00:42","date_gmt":"2018-02-16T21:00:42","guid":{"rendered":"http:\/\/briancroxall.net\/w18dh\/?page_id=179"},"modified":"2018-03-20T14:53:00","modified_gmt":"2018-03-20T20:53:00","slug":"tei-edition","status":"publish","type":"page","link":"https:\/\/briancroxall.net\/w18dh\/assignments\/tei-edition\/","title":{"rendered":"TEI Edition"},"content":{"rendered":"<h2>Updates<\/h2>\n<p>To make it easier to see when I&#8217;ve made updates to the instructions, I will <span style=\"background-color: yellow;\">highlight the changes in yellow<\/span>.<\/p>\n<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 all of her poems.\u00a0 While we could simply compare a digital copy of the poem to the one on the page, maintaining the attention necessary to catch errors is difficult if you&#8217;re just glancing back and forth. We need to do something more to keep ourselves aware of the fine details of the text. To this end, we will each be preparing a digital edition of one of her books of poetry.<\/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 all place and\/or person names, or identifying rhyme schemes in the different poems, as infrequent as they may be. If we work\u00a0consistently across all five volumes of the poetry in this process, we will be 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 create a digital edition of one of Duffy&#8217;s first five volumes using XML and the TEI guidelines.<\/p>\n<table>\n<tbody>\n<tr>\n<td><em>Standing\u00a0Female Nude<\/em><\/td>\n<td>Brian Croxall<\/td>\n<\/tr>\n<tr>\n<td><em>Selling Manhattan<\/em><\/td>\n<td>McKinsey Koch<\/td>\n<\/tr>\n<tr>\n<td><em>The Other Country<\/em><\/td>\n<td>Chris Dichmann<\/td>\n<\/tr>\n<tr>\n<td><em>Mean Time<\/em><\/td>\n<td>Maddie Calder<\/td>\n<\/tr>\n<tr>\n<td><em>The World&#8217;s Wife<\/em><\/td>\n<td>Lorin Groesbeck<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Your edition of Duffy will be due no later than\u00a0<del><span style=\"color: red;\">Wednesday, 14 March 2018<\/span><\/del> <del><span style=\"color: red;\">Wednesday, 21 March<\/span><\/del><strong> Saturday, 24 March by 5pm.<\/strong> Your reflection papers are due on <strong>Monday, 26 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\/duffy\">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\u00a0 the poem file<\/h3>\n<p>Open the <a href=\"https:\/\/github.com\/briancroxall\/duffy\/blob\/master\/tei-editions\/PoemTemplate.xml\">poem template<\/a> from the repo in Oxygen 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 but not necessarily<\/li>\n<li>Italics, making sure you have used the following markup: <code>&lt;hi rend=\"italics\"&gt;<\/code><\/li>\n<\/ul>\n<h3>Mark-up the poem<\/h3>\n<p>Mark-up 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;persName&gt;<\/code> within <code>&lt;respStmt&gt;<\/code>: your name<\/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> within <code>&lt;sourceDesc&gt;<\/code>: the original information about the poem you&#8217;re encoding<\/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.<\/li>\n<\/ul>\n<\/li>\n<li><span style=\"background-color: yellow;\"><code>profileDesc<\/code><\/span>\n<ul>\n<li><span style=\"background-color: yellow;\">We will place the metadata<\/span> 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 characters 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<h4>Body<\/h4>\n<ul>\n<li>Structure\n<ul>\n<li><code>&lt;head&gt;<\/code>: the poem&#8217;s title<\/li>\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.\n<ul>\n<li><span style=\"background-color: yellow;\">For the type of poem, you have three choices.<\/span>\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.<\/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>poem. Use this for all poems that do not fit either &#8220;sonnet&#8221; or &#8220;dramatic monologue.&#8221;<\/li>\n<\/ul>\n<\/li>\n<li>If the poem has an overall rhyming pattern, like a 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>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><\/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><code><\/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 reflection on the assignment. 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 150 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 25 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. <strong>5 points<\/strong><\/li>\n<li><strong>10 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\/cds\/elli-mylonas\/\">Elli Mylonas<\/a>, digital humanities librarian, TEI aficionado, and\u00a0colleague extraordinaire. Elli created the poem template and will\u2014no doubt\u2014continue to answer a great many questions as we go along.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Updates To make it easier to see when I&#8217;ve made updates to the instructions, I will highlight the changes in yellow. 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 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":77,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":"","_links_to":"","_links_to_target":""},"class_list":["post-179","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/pages\/179","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/comments?post=179"}],"version-history":[{"count":35,"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/pages\/179\/revisions"}],"predecessor-version":[{"id":239,"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/pages\/179\/revisions\/239"}],"up":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/pages\/77"}],"wp:attachment":[{"href":"https:\/\/briancroxall.net\/w18dh\/wp-json\/wp\/v2\/media?parent=179"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}