--> Finding aids -->Preparing Finding Aids for EAD --> Preparing XML Files for Webtext |
 |
 |
|
Unless otherwise indicated,
all of the following sequences of commands begin at a DOS prompt.
NOTE: All macros used here
are found in the configuration file that is evoked using EDIXIT - not EDIX.
edixit [name].boxAfter file is"ripped", from DOS command line, type either:
alt-v rip [enter]xmlit [name] - if the finding aid is a standard box-and-folder listing,or:The completed file will be named [name].xmlxmlit [name] rec - if the box list contains significant line breaks.
Use this command if your finding aid is a miscellany or similar type of file that lists cataloging "fields" under folder titles (for example, see YCGLMISC.XML), OR, if your finding aid contains lists of names or titles as folder notes (for example, see Series V in STENZELR.XML). What "rec" does is add a line break at the end of every note line, forcing the XML file to be formatted exactly as input. Without that break, your lists and cataloging details will not be as comprehensible to the reader.
[Note: as of July 2002 all new miscellany items, with the exception of YCGL, are cataloged in the Miscellany Database.]
2.a. Run the XMLFRN marcro:
edixit [name].frn
alt-v xmlfrn [enter]The cursor will end up on the text string beinecke.XXXXXXXX.
If file has processed correctly, rename and save the file as [name].srn, using the Edix "alt-f" command:
alt-f [name].srn [enter]
alt-w
alt-x
NOTE: do not "alt-w" before "alt-f" in this step, or you will overwrite your text-only .frn file with the marked-up version. "Alt-f" saves the marked-up copy separately as [name].srn, and you still have your .frn file to use for the printed version and for permanent storage in URARC.2.b. Next, replace the eight Xs in the "beinecke.XXXXXXXX" string with the file name:
beinecke.[name]
(Note: the file name is also the EAD id for the EAD file)
Examples:
In WKENT.XML -- beinecke.wkent
In PRYCEJON.XML -- beinecke.prycejonThis is the string that will be searched in Orbis from the "View catalog record" link at the top of the finding aid file in Webtext. In order for the link to work, you must also insert the following string in the catalog record for the collection, in a NEW (see note) 035 field, subfield 9:
035 __ |9 (YUL)ead.beinecke.[ead id]
Examples:
035 __ |9 (YUL)ead.beinecke.wkent
035 __ |9 (YUL)ead.beinecke.prycejonIf there is no catalog record for the collection (as is the case with Osborn files and shelves, for instance), neither of these steps need be taken. Just leave the beinecke.XXXXXXXX string as is in the finding aid. The "view catalog record" link from the finding aid will simply produce a search in Orbis with 0 results.
In catalog records created before July 2002, you will see an existing 035 |9, which looks like this: "XXX9999YL" (for example: 035 __ |9 FJE3667YL ). This code is the seven-character bib id from the Notis system (Orbis1, or "old Orbis") which preceded the Endeavor Voyager LMS (Orbis2), plus "YL" which was added during migration to Voyager. DO NOT OVERWRITE OR DELETE THIS CODE; instead, add a separate 035 field for the ead id code, and enter as described above.
The Notis bib ids were migrated into Orbis2/Voyager because they were frequently used as identifiers for individual records, and it was important that they remain part of the record and be keyword-searchable. Previous to the Orbis2/Voyager implementation, this bib id, or "Orbis key," was the code inserted into the finding aid to provide the link to the catalog record. In finding aids for collections with catalog records created before July 2002, this code continued to be used as the link well beyond that date, and you will see XXX9999-type strings in most finding aids marked up before the autumn of 2003. At some point in the future, these may be converted to "beinecke.XXXXXXXX" links, for consistency.
2.c. Add paragraph tags to any additional paragraphs within <admininfo> sections:
The mark-up macro "xmlfrn" assumes one paragraph in each of the following sections: PROVENANCE, OWNERSHIP & LITERARY RIGHTS, CITE AS, RESTRICTIONS ON ACCESS, PROCESSING NOTES, LOCATION OF ASSOCIATED MATERIAL, and MICROFORM/DIGITAL VERSIONS. If your finding aid has more than one paragraph in any of these sections, you must add paragraph tags manually if you wish the paragraphs to display separately:
Type (or copy and paste) the following between the paragraphs: </p><p>
(Note: the macro will add multiple paragraph tags automatically in the bioghist and scopecontent sections.)
3. Link the two marked up files and run translation macros - adding appendix if needed.
3.a.: To link:edixit [name].xmlAt this point, you may have to mark up and add an appendix. See instructions below. You must mark up and add the appendix before running the translation macros in step 3.b., below.
Insert blank line at top of the file then move your cursor to the beginning of the file
alt-r [name].srn
alt-w3.b.: To run translation macros:
edixit [name].xml
alt-v transit [enter]
alt-wNote: take care not to run the translation macros more than once, since the unicode equivalents of some characters (&, #, and ©) contain & and #, and if you translate them twice, redundant unicode notation will appear in your finding aid. (For example, instead of "Ownership & Literary Rights," you will see "Ownership & Literary Rights.")
Check to see if there are cross references in the file by searching for See: or See also:
If these are not found in the file, you do not have to run the macro for cross-references.
If they are found, continue with these steps:To add cross-references:
alt-v refs [enter]This will end up creating a new file in F2 called: [name].chk. If this file contains data (other than formatting commands), save it and note that manual corrections need to be made. If [name].chk is empty, no more corrections need to be made.If a file only has references to Box numbers (not specific folders), you may use the macro "boxrefs" instead of "refs".
To add cross-references manually from [name].chk files, print out [name].chk, then within the XML file, search for occurences of data listed in [name].chk and make appropriate links to folder numbers - (usually Oversize or related material).
See below for an example of how to add a cross-reference link.
If you need to strip all folder ids and targets (leaving simple "ref" tags), you may use the macro "remids". (Note: simple "ref" tags without targets are dead links in the online version of the file. Please remove these before sending to XMLload.)
Notes about cross-references:
Do not run this macro if you don't have see or see also references in your file, or if the references do not contain box and folder numbers (in current practice all x-refs MUST contain a box and folder number, but some older files may contain references lacking them). The target is generated from the folder number, so if there isn't one in the cross reference, the result will be a dead link in the file.
If your finding aid is so large that it will be split into two or more files, you must go through and delete the "ref" tags for any x-refs to folders outside the current file, because these links will not work.
5.a. Add links to the appropriate Series headings and to related collections following the patterns on the Enhancement Instructions and Examples page.
THIS STEP MUST BE DONE WITH ALL FILES:
You must add the series ID to each series header as described on the Enhancement Instructions and Examples page. Even if it is not a numbered "Series" (e.g. Restricted Fragile or Oversize), you must add an ID at every <c01> level and to the header for each Appendix. Even short finding aids with no links from the Description to the box-and-folder list require a series ID. Without this ID, the links from the navigation window in Webtext will not work. Links to Appendices will simply not appear in the navigation window without the ID.5.b.: Add Links to Multiple Bioghist sections:
If there is more than one bioghist section, "althead" attributes must be changed for each occurrence. Each head within bioghist is output with a default value of althead="first". Each subsequent open head tag within bioghist (i.e. <bioghist><head althead="first"> - not to be confused with the closing tag: </head>) must have the althead attribute changed according to its order in the finding aid, using standard ordinals: first, second, third, etc. Existing style sheets can accommodate up to 10 bioghist statements. If you have more, consult the head of the MSS Unit.
Open EditPad
Open file
Remove solid block character at very end of file (an EDIX remnant), then SAVE fileNOTE: Style sheet notations for certain files should be changed at this step.
For most files, there is an instruction at the top of the files that reads: xml-stylesheet type="text/xsl" href="stylenative.xsl"
For Osborn files and drawers listings, change the instruction to read: xml-stylesheet type="text/xsl"href="stylenativeosborn.xsl"
For miscellanies, change the instruction to read: xml-stylesheet type="text/xsl" href="style.xsl".
(Note: miscellany files created from Edix finding aids, such as YCGL MSS MISC and the earlier files of GENM MSS MISC and YCAL MSS MISC, use "stylenativemisc.xsl". Those created from the DBText Miscellany Database use "style.xsl".)
Open file in IE using the "Open" function under the File menu.
Errors will be reported if the file cannot be opened. Open the XML file in an ASCII editor (EDIX or EDIT MASTER) to manually correct errors. Repeat this process, if necessary, and reload the file until it displays.Once the file is displayed, click the right mouse button for the mini-menu and select "Validate XML". This will check the XML file for encoding errors that do not effect display. Errors will be reported one at a time. Open the XML file in an ASCII editor (EDIX or EDIT MASTER) to manually correct errors. Repeat this process, if necessary, and reload the file and select "Validate XML" until the message "Validation successful" is reported.
NOTE: Often, when reloading an XML file in IE following a validation attempt, IE will close. You will have to restart IE.This stage of trouble-shooting may take some finesse. To proof these files, you must have your style sheet file (e.g. stylenative.xsl) in the same directory as your XML files.
The database administrator may have to assist with more complex errors.
NOTE: Also available on the IE mini menu (right button) is the option "View XSL output" which can be helpful in checking the HTML code that IE generates.
At this point, make sure that you've also copied your urfiles (*.box, *.frn, *.reg, *.app) to J:\MSSUNIT\URARC, especially if you've made any corrections.
Use the following pattern:
If the file name is "wkent" . . .
856:42: |3 Finding aid |u http://webtext.library.yale.edu/xml2html/beinecke.wkent.nav.html
Note: for new files you will also add an 035 |9 to the catalog record, using the following pattern:
035 __ |9 (YUL)ead.beinecke.wkent
(See instruction #2, above.)
10. For new files: Add entries to the Public Services file list (j:\mssunit\webtext\auxfiles\publist.htm), using existing entries as models.
Use a generic text editor (but not EDIX) to edit the file - HTML editors tend to add unnecessary coding. Copy the link just above where you will place your link, and paste it in the correct place.
e.g.:
<p><a href="http://webtext.library.yale.edu/xml2html/beinecke.jobaker.nav.html" class="fndLink">Henry
Hurford Janes-Josephine Baker Collection JWJ MSS 2</a></p>
replace cursor at first position
of window 4 change number in line 12 of macro
to equal one more than total number of files to be ripped
Completed files will be named
[name].sgm alt-v then edit out the extraneous data
- files size, etc. - leaving only a list of "[name.ext]"
which can be done by -
[space][space]@*[enter]
.[ext][enter] 1. For guides to microfilm, as
long as the guide is created according to style guidelines listed in the Processing
Manual, a macro can be used:
The cursor will end up on the
text string "XXX". Replace XXX with the id
assigned to the Appendix. Cut-and-paste the marked-up
appendix to the end of the XML file - just before the ARCHDESC tag.
Because there is a limited set of tags available for marking appendices and
because their formats The tags I have used are: <ADD>, <P>, <HEAD> and <BIBLIOGRAPHY>.
<add> <p>The following text was written by Georgia O'Keeffe
at the time she presented the Stieglitz Archive to Yale University Library.</p>
<p>"My Collection of Alfred Stieglitz Photographs</p>
<p>"When Stieglitz was in a bad humor he tore up
and threw away such piles of prints that I began to think from what went into
the waste basket I would make a collection for myself. I started with 4 by
5 prints. I found that by mounting a rather poor print with a margin a trace
more than 1/16 of an inch I could make it look better than it was and better
than it looked mounted on a large piece of paper as he mounted them. In time
when he saw what I was doing he laughed and made folders for my little prints.
I could keep my collection in the 4 or 5 boxes that the printing paper came
in so it took up little room. As time went on I had several little boxes.
Each print with its very narrow white mounting margin put in a little folder,
a trifle larger than its mount, folded in a piece of writing paper, boxed
in the little boxes the collection grew. He laughed about it and sometimes
gave me a good print. Sometimes sent me a print with a letter when I was away.
At times he would look at my prints and remark, "Did I throw that print away?"
and to my answer, "Yes you did" he would often remark, "It looks very well
the way you have mounted it." Finally I kept a few 8 by 10 prints from the
waste basket. Only one of my waste basket collection was mounted on a large
mat as he mounted. It was a Lake George Barn and is the only print of that
negative. He wanted it back with his other prints. I said, "No, waste basket
prints that I have saved from the waste basket are mine." He didn't care but
whenever he saw that print he looked at it with interest. </p>
<p>"There are a few prints of negatives that he
thought not very good and never printed again. I could see what he meant but
they were photographs of places or things that I liked so I kept them. </p>
<p>"When he died there were a few prints he had
not mounted always lying around on the table. According to his idea there
as something the matter with each one so he had not mounted it. I thought
them too good to throw away so I added them to my collection. Finally I had
so many little boxes I put them in the larger black boxes like he used to
keep them together. When he wasn't there any more and I had to do something
with everything that had been his I could think of nothing better to do with
my collection than to place it at Yale so that people interested in the Stieglitz
papers can see something of the photographs...even though they are not the
best prints and not mounted as he mounted them. </p>
<p>"I have taken them from their papers and folders
and boxes and mounted them in these frames. They can be easily handled and
looked at and shelved like a lot of books. It is my intention that they only
be looked at in the hand like a book and never be hung on the wall. I even
think that maybe all photographs are better looked at that way to really appreciate
them. </p>
<p>"As you look at them remember they are mostly
from the waste basket. Sometimes prints sent me with letters. Things he left
unmounted when he died and a few good prints he gave me." </p>
</add>
Once an appendix is marked, it is inserted at the end of the finding aid
after the closed </dsc> tag, but before the
closed </archdesc> tag - - before performing
any of the translation macros.
<note><p><ref target="f140"> <c03><container type="box"></container> 11. Alert the database administrator via email
about any new, renamed, or significantly changed finding aids.
Instructions
for database administrator.
Shortcuts:
"Rip"-ing multiple files:
edix
in window 4, enter list of names
of BOX files to be ripped
F2
alt-r j:\mssunit\ripm.mac [enter]
F4
alt-b 12 [enter]
F2
(e.g., 4 files = change
number to 5; 99 files = change number to 100; 1 file = change number to 2)
alt-v config [enter]
F1
alt-v ripm [enter]
alt-x (OK to lose changes) After
file is"ripped", from DOS command line, type either:
xmlit [name]
if the finding aid is a standard
box-and-folder listing, or:
xmlit [name] rec
if the finding aid is a miscellany
or a similar type that lists cataloging details as notes under folder titles.
Creating a list of multiple files:
This can be done easily
by:
MARKING
UP APPENDICES
dir *.[ext] [enter]
alt-t
Replace [ext] with the proper extension
- (box or xml)
If there is an appendix which goes
with a finding aid, it will have to be marked up one of two ways:
edixit [name].app
2. Other types of appendices must
be marked-up manually and attached to the end of the xml file.
alt-v appadd [enter]
e.g. Appendix A ="APPA"; Appendix
B = "APPB", etc..
NOTE: this must be done before
performing any of the translation macros
are not standardized, I have chosen to do the markup in a simple fashion.
Here is an appendix from the Stieglitz.O'Keeffe Papers YCAL MSS 85:
<head id="app4"> Appendix Four: Georgia O'Keeffe's
"Waste Basket Collection" of Photographs (Series IV. Box 146)</head>
EXAMPLES:
Cross-reference targets
The following example indicates how the finished coding for a cross-reference
should look
The text target="f140" has been added manually
to complete the link. The text id="f140" was
added previously by the "refs" macro. Note that the following example displays
a case in which the targeted folder number is different than the folder mentioned.
This happens when a folder that is being targeted falls within a range of
folders. You must determine the nearest folder number that you can use as
a target.
See: Series II, Correspondence,
GERTRUDE STEIN - OUTGOING,
William Garland Rogers, Box 10, folder 142
</ref></p></note>
<container type="folder" id="f140">140-145</container>
<unittitle>Rogers, William Garland</unittitle>
<unitdate>1934-46</unitdate>
Comments: Nicole Bouché,
nicole.bouche@yale.edu
Copyright 1997. Beinecke
Rare Book and Manuscript Library
All rights reserved.