{"id":136,"date":"2022-02-08T15:30:53","date_gmt":"2022-02-08T22:30:53","guid":{"rendered":"http:\/\/briancroxall.net\/w22dh\/?page_id=136"},"modified":"2022-02-15T14:54:32","modified_gmt":"2022-02-15T21:54:32","slug":"encoding-peanuts","status":"publish","type":"page","link":"https:\/\/briancroxall.net\/w22dh\/assignments\/encoding-peanuts\/","title":{"rendered":"Encoding Peanuts"},"content":{"rendered":"<h2>Rationale<\/h2>\n<p>As I&#8217;ve told you, this class got its start with Amy Schulz Johnson asking my colleagues in <a href=\"https:\/\/odh.byu.edu\">ODH<\/a> to help her do some analysis of her dad&#8217;s work. Those colleagues created a corpus of <em>Peanuts<\/em>\u00a0by harvesting data from <a href=\"https:\/\/gocomics.com\">GoComics.com<\/a>. The GoComics team has created transcripts of what happens in the comics, which are tremendously helpful. But&#8230;it turns out they&#8217;re not always exactly correct. Just take a look at Schulz&#8217;s comic for <a href=\"https:\/\/www.gocomics.com\/peanuts\/1952\/01\/23\">Schulz&#8217;s comic for 23 January 1952<\/a> and GoComics&#8217;s corresponding <code>data transcript<\/code>:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/assets.amuniversal.com\/c51df360f868013014ce001dd8b71c47\" alt=\"Image of 23 January 1952 Peanuts strip\" \/><\/p>\n<blockquote><p>\n  Schroeder sits at the piano playing. Charlie Brown comes up to him and says, &#8220;Say, that&#8217;s sensational, Schroeder&#8230;what is it?&#8221; He looks to the reader confused as Schroeder replies, &#8220;Grasse Sonata fur das Hommer-Klavier&#8221; As Schroeder resumes his playing, Charlie Brown walks away. The latter says, &#8220;Sometimes I feel like I don&#8217;t belong around here!&#8221;\n<\/p><\/blockquote>\n<p>So it&#8217;s close&#8230;but it&#8217;s maybe not close enough. There&#8217;s a lot of information that isn&#8217;t captured in this transcript: what music Schroeder is playing and all its attendant information; what happens in which panel; the question mark that Charlie Brown &#8220;speaks&#8221;; the McCloudian transitions (see chapter 3) across the gutters; and how Schulz signs his name. And that&#8217;s just the first five things I thought to type!<\/p>\n<p>We can do better than this! Creating marked-up editions of Peanuts strips will provide us the chance to more accurately represent the strip, as well as enriching it in the specific ways that we care about: themes, settings, tagging person or place names, recording weather and activities, the direction characters move across the page, and pretty much anything else you can imagine. Creating such editions is time-consuming and requires serious attention to detail. But the opportunities for research that we gain with this process makes it worth the investment. To <a href=\"http:\/\/www.digitalhumanities.org\/dhq\/vol\/6\/1\/000117\/000117.html\">paraphrase John A. Walsh<\/a>, encoding <em>Peanuts<\/em> will &#8220;facilitate both close and distant reading strategies&#8221; (par. 17).<\/p>\n<h2>Nitty Gritty<\/h2>\n<p>Each of us will markup one month of strips from each of the volumes we&#8217;re reading for class. That&#8217;s about 60 strips, when all is said and done. And then you&#8217;ll write a reflection on the project&#8230;because of course you will.<\/p>\n<p>This assignment has two due dates. The first month of encoded strips is due on <strong>12 March<\/strong>. The second month of encoded strips and your reflection is due on <strong>9 April<\/strong>.<\/p>\n<p>Before you read further, it&#8217;s worth saying that this assignment looks&#8230;<strong>overwhelming<\/strong>. We will be covering all of this in class and will have some time in class where we are working together to tag things to get you used to what you&#8217;re doing. It&#8217;s true that this is an assignment that will take you a significant amount of time (plan on at least 5 minutes per strip). But you <em>can<\/em> do it, as long as you don&#8217;t leave it to the last minute.<\/p>\n<h3>Assignments<\/h3>\n<ul>\n<li>Archibald: March 1952 (31), September 1971 (30)<\/li>\n<li>Athay: April 1952 (30), May 1971 (31)<\/li>\n<li>Emmett: May 1952 (31), November 1971 (30)<\/li>\n<li>Kaufman: June 1952 (30), July 1971 (31)<\/li>\n<li>Overy: September 1952 (30), August 1971 (31)<\/li>\n<li>Rawlings: November 1952 (30), October 1971 (31)<\/li>\n<li>Croxall: February 1952 (28), July 1952 (31), August 1952 (31), December 1971 (31)<\/li>\n<\/ul>\n<h3>Get Oxygen<\/h3>\n<p><a href=\"https:\/\/www.oxygenxml.com\/xml_editor\/download_oxygenxml_editor.html\">Download Oxygen XML Editor<\/a> and 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>Create the strip file<\/h3>\n<p>In Oxygen, open your <a href=\"https:\/\/github.com\/briancroxall\/peanuts\/blob\/master\/peanuts-template.xml\">personalized strip template<\/a> from our <a href=\"https:\/\/github.com\/briancroxall\/peanuts\">repo<\/a> and copy all of its text (<code>Ctrl\/Cmd-A<\/code>, then <code>Ctrl\/Cmd-C<\/code>). Then open a new document in Oxygen and paste the template (<code>Ctrl\/Cmd-V<\/code>) into it. Do <em><strong>NOT<\/strong><\/em> start editing the template itself.<\/p>\n<p>Name the file as follows: peanuts-[four-digit year]-[two-digit month]-[two-digit day].xml. For example, the first strip, which is from 2 October 1950 would have the following filename: <code>peanuts_1950_10_02.xml<\/code>.<\/p>\n<p>Save the file in the <code>encoded-strips<\/code> folder in your local copy of the GitHub repo.<\/p>\n<h3>Encode the strip<\/h3>\n<p>Encode the strip as follows. If you run into questions, be sure to refer to our &#8220;<a href=\"https:\/\/docs.google.com\/document\/d\/1-4u0SHY5PW16sfcEqL8mOYl-x2JB0piXowOOpLYGn7I\/edit?usp=sharing\">Peanuts Encoding Editorial Decisions<\/a>&#8221; document.<\/p>\n<p>Don&#8217;t be alarmed at the size of this list. For most of the strips we encounter, many of these possibilities simply won&#8217;t occur.<\/p>\n<h4>teiHeader<\/h4>\n<p>Since we will each have our own personalized template to work from, we won&#8217;t have to make too many changes to the header. However, you&#8217;ll need to update your template when we move from the 1950-1952 volume to the 1971-1972 volume (specifically &lt;title&gt; and &lt;date&gt; on line 40).<\/p>\n<p>For each strip, however, you will need to make the following changes in the header:<\/p>\n<ol>\n<li>&lt;title&gt; (line 11): Change the title to have the correct date in YYYY-MM-DD format<\/li>\n<li>&lt;idno&gt; (line 35): Set the date to the proper YYYY-MM-DD format. Please make sure you don\u2019t put a space between Peanuts and the year.<\/li>\n<li>&lt;title level=&#8217;a&#8217;&gt; (line 40): Change the date of the strip to the proper date in YYYY-MM-DD format.<\/li>\n<li>&lt;change&gt; (line 66): for the value of @who, use your r-name from the taxonomy. For the value of when, record the date you are doing the edits using YYYY-MM-DD format. You\u2019ll note that the description of the change is \u201cInitial encoding.\u201d If what you\u2019re doing does not match that description, replace that phrase with a short description of what you\u2019re doing. In most cases, you won\u2019t have to change it.<\/li>\n<li>&lt;graphic&gt; (line 72): update the value of <code>@url<\/code> to the proper date for your comic. Open the URL in a browser (hold Ctrl\/Cmd while clicking on it) to make sure it resolves properly.<\/li>\n<\/ol>\n<h4>Body<\/h4>\n<p>Most of the work that you will do for each strip is in the <code>&lt;body&gt;<\/code> portion of the document. I suggest working on one aspect of the strip at a time (e.g., speech balloons or transitions) rather than moving through each panel and capturing each thing.<\/p>\n<p>Do the following 15 (!?!) things for each strip:<\/p>\n<h5>Metadata<\/h5>\n<p>1&#46; &lt;head&gt; (line 78): update the value of <code>@when<\/code> to the proper YYYY-MM-DD format. Then change the date within the element to <code>(D)D [full month name] YYYY<\/code> format.<br \/>\n2&#46; &lt;div type=&#8221;panelGrp&#8221;&gt; (line 80): Change the value of <code>@xml:id<\/code> to match the <code>idno<\/code> from the &lt;publicationStmt&gt; from the <code>teiHeader<\/code>. (As a reminder, this is <code>PeanutsYYYY-MM-DD<\/code>, with the proper date and no spaces.)<\/p>\n<h5>Settings, Weather, Activities, and Bechdel Test<\/h5>\n<p>3&#46; &lt;div type=&#8221;panelGrp&#8221;&gt; (line 80): For each strip, we will tag weather, activities, settings, and visual aspects using the <code>@ana<\/code> element. We will also tag whether or not a strip passes the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Bechdel_test\">Bechdel test<\/a>. For a full list of the different options, see our <a href=\"https:\/\/docs.google.com\/document\/d\/1-4u0SHY5PW16sfcEqL8mOYl-x2JB0piXowOOpLYGn7I\/edit#heading=h.sgkh3p4tf5r7\">Editorial Decisions Document<\/a> or <a href=\"https:\/\/github.com\/briancroxall\/peanuts-taxonomy\/blob\/master\/peanuts-taxonomy.xml\">the taxonomy<\/a>.<\/p>\n<h5>Number of Panels<\/h5>\n<p>4&#46; The template has a default of 4 panels. If there are more or less panels, add or subtract &lt;cbml:panel&gt; elements.<\/p>\n<h5>Characters in Panels<\/h5>\n<p>5&#46; &lt;cbml:panel&gt; (lines 82, 89, 94, and 99): For each panel, set the value of <code>@characters<\/code> that appear in that panel to the shortcodes of character names from <a href=\"https:\/\/github.com\/briancroxall\/peanuts-taxonomy\/blob\/master\/peanuts-taxonomy.xml\">the taxonomy<\/a>. Separate multiple character names with a space, e.g. <code>\"#c-cb #c-lucy #c-violet\"<\/code>.<\/p>\n<h5>Description of the Panel&#8217;s Action<\/h5>\n<p>6&#46; &lt;note&gt; (lines 83, 90, 95, and 100): For each panel, set the value of <code>@resp<\/code> to your <code>r-name<\/code> from the <a href=\"https:\/\/github.com\/briancroxall\/peanuts-taxonomy\/blob\/master\/peanuts-taxonomy.xml\">taxonomy<\/a>. Within the element, write a <em>brief<\/em> description of what happens in the panel. See the <a href=\"https:\/\/github.com\/briancroxall\/peanuts\/blob\/master\/test\/peanuts_1950_10_02.xml\">1950<\/a> and <a href=\"https:\/\/github.com\/briancroxall\/peanuts\/blob\/master\/test\/peanuts_1982_02_13.xml\">1982<\/a> examples in the <code>xml-test<\/code> folder within the repo for ideas.<\/p>\n<h5>Speech and Sound<\/h5>\n<p>7&#46; &lt;cbml:balloon&gt;: Use this element to transcribe each speech. Change the value of the <code>@type<\/code> attribute to <a href=\"https:\/\/docs.google.com\/document\/d\/1-4u0SHY5PW16sfcEqL8mOYl-x2JB0piXowOOpLYGn7I\/edit#heading=h.z9fvl6dyavim\">another choice<\/a> if it&#8217;s not a normal speech bubble. Set the value of the <code>@who<\/code> attribute to the appropriate character name from the <a href=\"https:\/\/github.com\/briancroxall\/peanuts-taxonomy\/blob\/master\/peanuts-taxonomy.xml\">taxonomy<\/a>.<br \/>\n8&#46; By default, the template is set up for a single speech balloon per panel. If there are multiple word balloons in a panel, add additional &lt;cbml:balloon&gt; elements.<br \/>\n9&#46; If characters are referred by name or by nickname (e.g., &#8220;Chuck&#8221;) in a speech bubble, wrap the name in a &lt;persName&gt; element and use a <code>@ref<\/code> attribute with the value set to the taxonomy reference; for example, &lt;persName ref=&#8221;#c-cb&#8221;&gt;.<br \/>\n10&#46; If real people are referred to by name (e.g., Beethoven, Peggy Fleming), tag them using a &lt;persName&gt; element and use a <code>@ref<\/code> attribute with the value set to a URI from an authority file like <a href=\"https:\/\/viaf.org\/\">VIAF<\/a>. For example, &lt;persName ref=&#8221;https:\/\/viaf.org\/viaf\/32182557\/&#8221;&gt;Beethoven&lt;\/persName&gt;. You can often find such URIs at the bottom of a person&#8217;s <a href=\"https:\/\/en.wikipedia.org\/wiki\/Main_Page\">Wikipedia<\/a> entry.<br \/>\n11&#46; If real places are referred to by name (e.g., New York), tag them using a &lt;placeName&gt; element and use a <code>@ref<\/code> attribute with the value set to a URI from an authority file like <a href=\"https:\/\/www.geonames.org\/\">GeoNames<\/a>.<br \/>\n12&#46; &lt;sound&gt;: Use this element to encode sounds that are not contained in a speech bubble (see <a href=\"https:\/\/www.gocomics.com\/peanuts\/1952\/05\/04\">this example<\/a>). This element should go on a new line within the &lt;cbml:panel&gt; and <em><strong>not<\/strong><\/em> within the &lt;cbml:balloon&gt;.<\/p>\n<h5>Diegetic Text<\/h5>\n<p>13&#46; Text that would be visible to characters within the strip, such as <a href=\"https:\/\/www.gocomics.com\/peanuts\/1950\/10\/07\">words on signs<\/a> should be tagged in the panel with a &lt;floatingText&gt; element with a <code>type=\"diegetic\"<\/code> attribute and a <code>@subtype<\/code> attribute. The <code>@subtype<\/code> should use <a href=\"https:\/\/docs.google.com\/document\/d\/1-4u0SHY5PW16sfcEqL8mOYl-x2JB0piXowOOpLYGn7I\/edit#heading=h.yl9jpai2cm2n\">the values from our editorial decisions document<\/a>.<\/p>\n<h5>Transitions<\/h5>\n<p>14&#46; <code>&lt;cbml:panel&gt;<\/code> (lines 89, 94, and 99): For each panel except for the first, set the value of <code>@ana<\/code> to the tr-name from the <a href=\"https:\/\/github.com\/briancroxall\/peanuts-taxonomy\/blob\/master\/peanuts-taxonomy.xml\">taxonomy<\/a>. Do your best to work according to McCloud&#8217;s definitions. If you are uncertain about a transition, bring it to class and we will discuss it together.<\/p>\n<h5>Signature and Date<\/h5>\n<p>15&#46; Look for Schulz&#8217;s signature and date and move the &lt;docAuthor&gt; and &lt;docDate&gt; elements (in panel 4 of the template by default) to the proper panel. If Schulz writes his name differently, update it in &lt;docAuthor&gt;. If he renders it in a different font or style, encode this with &lt;hi rend=&#8221;[description]&#8221;&gt; using the guidlines from our <a href=\"https:\/\/docs.google.com\/document\/d\/1-4u0SHY5PW16sfcEqL8mOYl-x2JB0piXowOOpLYGn7I\/edit#heading=h.vdewavlfmqzg\">editorial decisions document<\/a>. For the date, write it <em>exactly as Schulz does<\/em> (e.g., <code>1-15<\/code>)<\/p>\n<h5>Anything Else<\/h5>\n<p>We will collectively decide if there&#8217;s anything else we would like to tag in the strips and how we will do this. We should not let ourselves be governed by the narrow-mindedness of the 2020 or 2021 classes and their boneheaded professor!<\/p>\n<h3>Commit and push the strip<\/h3>\n<p>After you&#8217;ve finished your work on one or more strips, commit and push the changes you have made to the repo using the <a href=\"https:\/\/desktop.github.com\/\">GitHub Desktop client<\/a>. You might want to create a different commit for each strip as you work. Before you can push your changes, you might need to <code>fetch origin<\/code> to get changes that others have made.<\/p>\n<h3>Reflect on the Assignment<\/h3>\n<p>After you have completed your two months of strips, you will write a three-page reflection on the assignment. Some questions to consider in your reflection are:<\/p>\n<ul>\n<li>John Walsh <a href=\"http:\/\/www.digitalhumanities.org\/dhq\/vol\/6\/1\/000117\/000117.html#p1\">describes<\/a> encoding as &#8220;a form of discovery, or prospecting&#8221; and calls it both &#8220;a form of reading and writing.&#8221; Do I agree with him?<\/li>\n<li>What did I learn about digital humanities from this assignment?<\/li>\n<li>What did I learn about <em>Peanuts<\/em> 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<p>The reflection must be submitted as <strong>PDFs on Learning Suite by 11:59pm on Wednesday, 13 April<\/strong>. Please name your file <code>\"lastname\"_encoding_reflection.pdf<\/code> (e.g., croxall_encoding_reflection.pdf).<\/p>\n<h2>Grading<\/h2>\n<p>This assignment is worth 225 points. Each month of encoded strips will be worth up to 100 points. For each month, I will <a href=\"https:\/\/random.org\">randomly<\/a> select five of the strips that you marked up. Each of these five strips will be worth up to 20 points distributed as follows:<\/p>\n<ul>\n<li>5 points: I will check the strip to see if it is well-formed (per XML standards) and if it validates (against the TEI schema). Basically, if it gets a green light in Oxygen, you will be good to go.<\/li>\n<li>3 points: I will check to see if your <code>TEI header<\/code> contains all the required information.<\/li>\n<li>2 points: Using your URL from the &lt;facsimile&gt;, I will check the encoded strip&#8217;s text against the original text to make sure it is all correct.<\/li>\n<li>10 points: I will check the &lt;text&gt; to see if you have correctly tagged everything listed above, as well as anything else we determine as a class as we are working.<\/li>\n<\/ul>\n<p>The remaining 25 points for the assignment will be for the reflection paper. You will (primarily) be graded on your discussion of what you&#8217;ve learned, as well as (secondarily) grammer, mechanics, and all that jazz. Please note that I&#8217;m <em>not<\/em> grading you based on what you&#8217;ve learned but instead on your discussion of it. This means that the point of this reflection paper isn&#8217;t for you to tell me how great the assignment is.<\/p>\n<h2>Credits<\/h2>\n<p>I designed the <a href=\"https:\/\/briancroxall.net\/w18dh\/assignments\/tei-edition\/\">first version of this assignment in 2018<\/a> after discussions with <a href=\"https:\/\/library.brown.edu\/create\/cds\/people\/elli-mylonas\/\">Elli Mylonas<\/a>, TEI aficionado and colleague extraordinaire, and I made some important revisions <a href=\"https:\/\/briancroxall.net\/w19dh\/assignments\/tei-markup\/\">in 2019<\/a>. It was updated considerably <a href=\"https:\/\/briancroxall.net\/w20dh\/assignments\/encoding-peanuts-with-tei-cbml\/\">in 2020<\/a> for <em>Peanuts<\/em>, drawing particularly on the work of <a href=\"https:\/\/info.sice.indiana.edu\/~jawalsh\/\">John A. Walsh<\/a> and his <a href=\"http:\/\/dcl.ils.indiana.edu\/cbml\/\">Comic Book Markup Language<\/a>. Working from <a href=\"http:\/\/www.digitalhumanities.org\/dhq\/vol\/6\/1\/000117\/000117.html\">Walsh&#8217;s article in <em>Digital Humanities Quarterly<\/em><\/a>, Elli created the basic strip template and taxonomy, and she has helped me refine it further. In 2021 and 2022, I made a number of updates based on how what we have learned, trying\u2014believe it or not\u2014to make this all easier to understand.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Rationale As I&#8217;ve told you, this class got its start with Amy Schulz Johnson asking my colleagues in ODH to help her do some analysis of her dad&#8217;s work. Those colleagues created a corpus of Peanuts\u00a0by harvesting data from GoComics.com. The GoComics team has created transcripts of what happens in the comics, which are tremendously [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":13,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_jetpack_hide_featured_image":false,"_jetpack_featured_image_duplicate_dismissed":0,"footnotes":""},"class_list":["post-136","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/pages\/136","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/comments?post=136"}],"version-history":[{"count":36,"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/pages\/136\/revisions"}],"predecessor-version":[{"id":285,"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/pages\/136\/revisions\/285"}],"up":[{"embeddable":true,"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/pages\/13"}],"wp:attachment":[{"href":"https:\/\/briancroxall.net\/w22dh\/wp-json\/wp\/v2\/media?parent=136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}