CliffordAnderson/ead.md

## ead.md

      
    Raw
  

              ead.md
            
          
    ##Introduction to Encoded Archival Description
July 10 & 11, 2014
Vanderbilt University
Encoded Archival Description (EAD) is the recommended standard for creating digital editions of finding aids for Special Collections materials. The Vanderbilt University Library will hold two half-day training sessions in EAD from 9:00 a.m. to 12:00 p.m. on Thursday, July 10 and Friday, July 11 in Classroom 418A, Central Library. Please join us to learn the relevant archival standards, the basics of XML encoding, and the fundamentals of EAD. The workshop will not presuppose any prior knowledge of markup languages or archival practices.
###July 10
9:00 am     Introduction to XML – Cliff Anderson
9:30 am     A tour of the oXygen XML Editor – Cliff Anderson
9:50 am     Break
10:00 am    Standards in Archival Practice – Sara Sterkenburg
10:30 am    What is EAD? – Sara Sterkenburg
11:00 am    Encoding Practice – Cliff Anderson, Jacob Schaub, and Sara Sterkenburg
###July 11
9:00 am     Review of XML and EAD – Jacob Schaub
9:30 am     What are DTDs, Schemas, etc.? – Cliff Anderson
9:50 am     Break
10:00 am    Encoding Practice – Cliff Anderson, Jacob Schaub, and Sara Sterkenburg
11:00 am    Encoding Review – Sara Sterkenburg
11:30 am    Final Questions and Wrap Up – Cliff Anderson

  
## links.md

      
    Raw
  

              links.md
            
          
    ##Workshop Links
###Archival Description
The General International Standard Archival Description provides guidelines for national standards. The national standard in the United States is called Describing Archives: A Content Standard.
###Encoded Archival Description (EAD)
The Society of American Archivists and the Library of Congress jointly maintain the EAD standard. The Tag Library provides an easy wait to lookup the meaning of elements. The EAD schema may be found here. We'll be using the XML Schema version during our workshop, but there is also a RELAX NG version that we'll discuss briefly.
###Sample Finding Aid
We will be marking up the Samuel Edward Axson Sermons collection at the Library of Congress. You may access a PDF copy here. Here is the XML version. Try to markup up the PDF without peeking at the XML version!

  
## postcard.md

      
    Raw
  

              postcard.md
            
          
    ##Introduction to XML
###XML Basics
There are several good tutorials for learning the basics of XML. There are six types of XML nodes: attributes, comments, documents, elements, processing-instructions, and text.
###Markup Exercise
How would you markup up this postcard in XML? Feel free to invent your own XML elements, but make sure that your final document validates.


## postcard.rnc
datatypes xsd = "http://www.w3.org/2001/XMLSchema-datatypes"

element postcard {
    element date {
        attribute iso { xsd:date }?,
        text
    },
    element location { text },
    element body {
        element salutation {
            attribute authorizedForm { text }?,
            text
        },
        element paragraph { text }*,
        element closing { text },
        element signature { text }
    }+
}

## postcard.xml
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="postcard.rnc" type="application/relax-ng-compact-syntax"?>
<postcard>
    <date iso="1931-10-13">October 13</date>
    <location>Küsnacht</location>
    <body>
        <salutation authorizedForm="Jelliffe, Smith Ely, 1866-1945">My dear Jelliffe,</salutation>
        <paragraph>It is nice to hear of you again after many years.</paragraph>
        <paragraph>I just want to tell you that I see no point in sending my papers to your journal.
            You surely know that I am a mystic according to American standards. So I think it will
            be theological journals that might refer to my papers. I have noticed that my medical
            colleagues find it particular hard to understand my ideas. I therefore should prefer not
            to disturb the peace of their mind. The things I have written in the last years are only
            psychological stuff, which I supposed is Chinese to the readers of your journal. You
            will excuse therefore if I prefer not to enter upon your proposition.</paragraph>
        <closing>
            Sincerely Yours
        </closing>
        <signature>
            Carl Jung
        </signature>
    </body>
</postcard>

## template.xml
<?xml version="1.0" encoding="UTF-8"?>
<ead xmlns="urn:isbn:1-931666-22-9" xmlns:xlink="http://www.w3.org/1999/xlink"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="urn:isbn:1-931666-22-9 http://www.loc.gov/ead/ead.xsd"
     id="sample">
   <eadheader>
      <eadid></eadid>
      <filedesc>
         <titlestmt>
            <titleproper></titleproper>
         </titlestmt>
      </filedesc>
   </eadheader>
   <archdesc level="collection">
      <did>
         <abstract></abstract>
      </did>
   </archdesc>
</ead>
	datatypes xsd = "http://www.w3.org/2001/XMLSchema-datatypes"

	element postcard {
	element date {
	attribute iso { xsd:date }?,
	text
	},
	element location { text },
	element body {
	element salutation {
	attribute authorizedForm { text }?,
	text
	},
	element paragraph { text }*,
	element closing { text },
	element signature { text }
	}+
	}
	<?xml version="1.0" encoding="UTF-8"?>
	<?xml-model href="postcard.rnc" type="application/relax-ng-compact-syntax"?>
	<postcard>
	<date iso="1931-10-13">October 13</date>
	<location>Küsnacht</location>
	<body>
	<salutation authorizedForm="Jelliffe, Smith Ely, 1866-1945">My dear Jelliffe,</salutation>
	<paragraph>It is nice to hear of you again after many years.</paragraph>
	<paragraph>I just want to tell you that I see no point in sending my papers to your journal.
	You surely know that I am a mystic according to American standards. So I think it will
	be theological journals that might refer to my papers. I have noticed that my medical
	colleagues find it particular hard to understand my ideas. I therefore should prefer not
	to disturb the peace of their mind. The things I have written in the last years are only
	psychological stuff, which I supposed is Chinese to the readers of your journal. You
	will excuse therefore if I prefer not to enter upon your proposition.</paragraph>
	<closing>
	Sincerely Yours
	</closing>
	<signature>
	Carl Jung
	</signature>
	</body>
	</postcard>
	<?xml version="1.0" encoding="UTF-8"?>
	<ead xmlns="urn:isbn:1-931666-22-9" xmlns:xlink="http://www.w3.org/1999/xlink"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="urn:isbn:1-931666-22-9 http://www.loc.gov/ead/ead.xsd"
	id="sample">
	<eadheader>
	<eadid></eadid>
	<filedesc>
	<titlestmt>
	<titleproper></titleproper>
	</titlestmt>
	</filedesc>
	</eadheader>
	<archdesc level="collection">
	<did>
	<abstract></abstract>
	</did>
	</archdesc>
	</ead>