Wikipedia

Whitman Archive

Joined 25 January 2010

Where to Begin...

edit
  • Oxygen is the recommended and Brett-supported program for P5 encoding.(Oxygen is an xml-editing application, specifically dedicated to XML.)
  • Template: a skeleton document that had all of the parts that every document would need. Could be downloaded and filled in with the relevant information. In Oxygen, there is actually a feature for templates. Follow examples in the zip file, which will tell you where to put the template. Then, in Oxygen, you will have an option to click the TEIP5-wwa template. Double-click this template, and you will get a new empty document based on the template. There are a few comments in the file where Brett has put instructions for using the template. There are fewer in the P5 template than in the P4 template. As you fill in the necessary items, you can delete these comments.
  • Brett has updated a lot of information in the header.
  • The <revisionDesc> is different. It's simple if you look at the examples. There is now a who attribute, versus content in an element. At the very start you want to give it its canonical name and save it to whatever local file you keep your files--do not save it in the template file. In addition, look to the example in the Common Errors section.

Now to the Transcription

edit
  • Lots of other little things have changed in the encoding. One big one is <pb />. For each page you will have a <pb /> One small thing that changes is that IDs have to be xml:id. To give a link to the page is now simpler, but it is different. There is no doctype declaration/DTD extension prior to the header. Instead, you just give you a URL type link to the image. So now you also have ti include the .jpg; There is an example in the Common Errors section.
  • Schema: there are lots of different syntaxes for schemas. RNG ODD and DTD. DTD is the oldest syntax and is not XML and its really readable. Many of the other syntaxes are XML, so they have a value in that you don't have to learn a new language to read them, but there is not an agreement on which everyone should be using. W3C recommends XMLSchema. TEIs native schema is RNGs, so we are doing our schemas in RNG (RelaxNG). There is another Relax schema, RNC (Relax Compact, does not use XML). The way the project's rules for creating XML documents.
  • Authoring a schema involves a new TEI module, called ODD. So you author an ODD file (a TEI XML file, with a whole bunch of new elements). Then, you take this file and put it in a TEI processer, such as Roma online, or a desktop processor (for most purposes better, can get from Sourceforge) called Vesta. A simple, stripped-down program. Give it your ODD file and tell it schemas to give you. Can also generate documentation. Start with something TEI offers of the shelf and then modify it. This is where your customizations come.
  • Brett recommends getting rid of comments as you take care of them.
  • Validating files: Need to have a network connection and the server needs to be up. In Oxygen, the validate is the paper and checkmark option.
  • Some quick comments about the differences between P4 & P5:

divs are still numbered

lgs are no longer numbered

<seg> no longer in poetry

<app> changed to <subst>

Transition from P4 to P5

edit
  • Before you begin, create a P4P5 directory and a P4P5 Output directory on the c:\ drive. Also, be sure the Saxon folder is on the c:\ drive.
  • From Whitman Archive Server, copy and past manuscripts to c:\P4P5
  • Open documents in Note Tab Pro
  • Open !!P4P5 clip
  • Remove Doc Types by running Step 1
  • Save documents
  • Minimize Note Tab Pro
  • Open Command Line
  • Type in C:\Documents and Settings\Whitman Archive>cd../../Saxon
  • Press enter
  • Copy (highlight and press enter)and paste (right click) the following command:

java -jar saxon8.jar -o C:\P4P5Output\ C:\P4P5\ C:\composite2.xsl

  • Hit enter to run command
  • Minimize command line
  • Reopen Note Tab Pro. Close all documents after saving.
  • Open documents from c:\P4P5 Output
  • Run Step 2 of clip
  • Save all documents and exit (or minimize) out of Note Tab Pro
  • Open Oxygen XML Editor
  • Open documents from c:\P4P5 Output
  • Associate schema (which should be put in the P4P5 Output directory)
  • Associate schema by clicking documents-xml document-associate schema-Relax NG Schema-XML-navigate to schema (c:\P4P5 Output-whitman-v1.rng)
  • Validate all documents & navigate through errors. See Common Errors for correction.

Common Errors

edit

The first lines of your document should look similar to below if transitioning from P4 to P5:

edit

<?xml version="1.0" encoding="ASCII"?>

<?xml-stylesheet type="application/xml" href="../xsl/reviews.xsl"?>

<?oxygen RNGSchema="whitman-v1.rng" type="xml"?>

<TEI xmlns="http://www.whitmanarchive.org/namespace" xml:id="xxx.00000">

Certainty Attributes

edit

Replace percentages with high, low, or medium depending on value.

  • Low=60%
  • Medium=60%-80%
  • High=80%-99%
  • Absolute=100%

Work Entity

edit

Change entity to ref. See below: <work entity="xxx.00526" cert="high"/> to <work ref="xxx.00526" cert="high"/>

When Attribute

edit

When attributes change to notBefore/notAfter tages. See below: <date when="1855-1859"> to <notBefore="1855" notAfter="1859">

Remove "xmlns" in Date Line

edit

<date xmlns>2008</date> to <date>2008</date>

RespStmt

edit

Reformat the statement to one line as below:

Before After
<change>

<date>2006-07-06</date>

<respStmt>

<name>Sarah Synovec</name>

</respStmt>

<item>Removed hi tags in Work notes; corrected miscellaneous errors</item>

</change>

<change when="2009-10-03" who="#ss">updated TEI header</change>

  • ALWAYS ATTEND TO THE REVISION DESC!!!

Date Ranges

edit

Date ranges are encoded as the "when" attribute above. <date value="1855/1857"> to <date notBefore="1855" notAfter="1857">

Replace "00" to "01"

edit

If you have values that are "00" replace them with "01" in order for validation.

<app>

edit

Change all <app> tags to <subst> tags

Anchored Tags

edit

In anchored tags, change "yes" or "no" to "true" or "false"

Hand Tags

edit

Change <hand> to <handNote>

Attribute "To"

edit
Before After
<delSpan to="">

<delSpan spanTo="">

<addSpan to=""> <addSpan spanTo="">

"pb" Tags

edit
Before After
<pb corresp="amh.00009.001" id="leaf001r" type="recto"/> <pb facs="../figures/amh.00006.001.jpg" xml:id="leaf001r" type="recto"/>

<rdg> Tag

edit

You can usually transfer the information into the "del" or "add" tags that it contains and then delete the <rdg> tag.


Before After
<app>

<rdg varSeq="1">

<del type="overstrike">now</del>

</rdg>

<rdg varSeq="2">\

<add place="supralinear" rend="insertion">then</add>

</rdg>

</app>

<subst>

<del rend="overstrike" seq="1">now</del>

<add place="supralinear" rend="insertion" seq="2>then</add>

</subst>

Element "l"

edit

Rearrange <l> and </l> to contain <add></add> or <del></del> instead of vice versa.

Attribute "corr"

edit

See the example below as to how to format this:

<choice>

<sic>the incorrect way it's written</sic>

<corr>the correct way to write it</corr>

</choice>

List

edit
Before After
<list><seg>text</seg></list> <list><item>text</item></list>

<app> Tags

edit

Format as below:


Before After
<app>

<rdg varSeq="1">text</rdg>

<rdg varSeq="2">

<add type="insertion" place="supralinear">another text</add>

</rdg>

</app>

<subst>

<orig seq="1">text</orig>

<add rend="insertion" place="supralinear" seq="2">another text</add>

</subst>

Attribute "id"

edit

Attribute ‘id’ changes to attribute ‘xml:id’

Type="Extract"

edit
Before After 
<q who="Walt Whitman">

<text type="extract">

<body>

<lg1 type="poem"> 

<q who="Walt Whitman" type="extract">

<floatingText>

<body>

<lg type="poem">

Bibliography

edit

In the reviews, the bibliographical transcription separated into structured and unstructured. For the reviews, the unstructured markings are used and thus, elements <analytic>, <imprint>, and <monogr> should be removed.

DELETE:<analytic> <imprint> <monogr>

Choice Tags with Orig

edit
Before After

<seg>As if it were not <orig reg="indispensable">indis‑</orig></seg>

<choice>

<orig>indis‑</orig>

<reg>indispensable</reg>

</choice>

<poem notes>

edit

<poem notes> is changed to: <poemNotes>

Profile Description

edit
After
<profileDesc>

<handNotes>

<handNote>

Figure Entity

edit

Document Figures as below:

<figure><graphic url="anc.00152.002.jpg"/>

<head type="main-authorial">Whitman's alternative plan for structuring the 1855 edition of <hi rend="italic">Leaves of Grass</hi>. Harry Ransom Humanities Research Center, University of Texas at Austin.</head>

<figDesc>Manuscript containing Whitman's alternative plan for structuring the 1855 edition of <bibl><title rend="italic">Leaves of Grass</title></bibl>.</figDesc>

</figure>

<xref>

edit

The element <xref> is not allowed in P5 encoding standards. Instead, this element should be only <ref> and the attribute should be changed to "target" instead of "doc" or "url".


Before After

For a list of these corrections, click <xref doc="anc.00161"> here </xref >.

For a list of these corrections, click <ref target="anc.00161"> here </ref >.

Permission Statements

edit
Before After

<div1 type="permission statement">

<div1 type="permissions">

Retrieved from "https://en.wiki.x.io/w/index.php?title=User:Whitman_Archive&oldid=1260591525"