-
Notifications
You must be signed in to change notification settings - Fork 0
/
conversion.html
537 lines (537 loc) · 34.3 KB
/
conversion.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- saved from url=(0070)http://www.iath.virginia.edu/ead/resources/ead2002conv/conversion.html -->
<HTML><HEAD><TITLE>Conversion of EAD 1</TITLE>
<META content="MSHTML 6.00.2800.1400" name=GENERATOR>
<META http-equiv=Content-Type content="text/html; charset=windows-1252">
<STYLE type=text/css>BODY {
MARGIN: 0.5in
}
P.MsoNormal {
FONT-SIZE: 10pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
LI.MsoNormal {
FONT-SIZE: 10pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
DIV.MsoNormal {
FONT-SIZE: 10pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
P.MsoBodyText {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
LI.MsoBodyText {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
DIV.MsoBodyText {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; punctuation-wrap: simple
}
</STYLE>
</HEAD>
<BODY>
<DIV class=Section1>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 14pt; FONT-FAMILY: Arial">Conversion of EAD 1.0 to EAD
2002</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">Table of
Contents</SPAN></B></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 12pt">
Introduction</SPAN></B></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 12pt">
What do I need to do?</SPAN></B></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 12pt">
Notes on the execution command</SPAN></B></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 12pt">
Conversion Assumptions</SPAN></B></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 14pt; FONT-FAMILY: Arial"></SPAN></B> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">Section A:
Introduction</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This document describes a
process for converting EAD instances written according to Version 1.0 of the EAD
DTD into ones that conform to Version 2002. This is achieved through the
use of an XSLT stylesheet and utilizes a series of files and applications
compressed as ead2002conv.exe. The following description consolidates and
amplifies information that is found in the readme.txt file included in the zip
file and as comments in the accompanying stylesheets. The zip file
includes a copy of the XSLT processor Saxon, associated stylesheets, a copy of
the EAD2002 DTD, and a script written in the Perl programming
language. When it is uncompressed, a series of folders are
created into which the various files are placed.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Transformation is performed
using an XSLT processor called Instant Saxon, which is supplied in the
conversion package. As used here, Saxon is a command line processor.
It may be executed either from a DOS prompt or from the Windows Run command
which is accessed via the Start button on the desktop's toolbar.
Institutions working in other operating systems will have to use the full
version of Saxon, compiled for their OS. Saxon also requires the
presence of a Java Virtual Machine. More recent versions of Windows
(though not XP) and Internet Explorer contain the necessary software.
Otherwise, Sun's JDK may be employed.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">One can perform the
transformation from version 1.0 to version 2002 either directly in Saxon as
described below or by using a Perl script which serves as a "wrapper" program
for Saxon and which is also contained in the conversion package. Using
Saxon directly will be the more straightforward option for those not familiar
with Perl though the latter has the advantage that it can convert the contents
of an entire directory in a single operation. Saxon converts only one file
at a time and, while more time-consuming, this approach actually may be an
advantage if one wishes to verify the results of each conversion as it
occurs. No directions for the use of Perl are included here beyond
those that are common to both processes. Some additional information
on Perl is included in the readme.txt file. The transformation
process can also be set to produce a report file that describes exactly what
actions were taken in the conversion of each EAD file. This report is
structured as an HTML document for viewing in a browser.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: 'Times New Roman'"><BR
style="PAGE-BREAK-BEFORE: always" clear=all></SPAN>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">Section B: What do I
need to do?</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">1. Download and
unzip the file ead2002conv.exe. The conversions assume that the software
is installed in the directory c:\ead2002conv. If you install
the software in another directory, be sure to alter the path statements in the
execution command described in step 3 below. You will also need to
change the path statement for the destination of the conversion report
file.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">2. The software
assumes that the directory v1 will be the location of version 1.0 source files
and that v2002 will be the location of version 2002 result files.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">3. Review the
assumptions about the conversion process that are described in the following
section to ensure that the changes that are occurring as part of the conversion
conform to institutional expectations.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">4. Verify the
character set encoding that you have used in your source document and the
encoding you wish in the resulting file. The stylesheet uses
ISO 8859-1 as the default output.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">5. Transform the
EAD files.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Type a variation of the
following command, substituting the proper path statements and file name, on the
command line in DOS or within the Run box in Windows. There are five
parts to the command.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in; TEXT-INDENT: -0.25in"><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: Symbol"> </SPAN>
<SPAN style="FONT-SIZE: 12pt">The directory location of conversion
software</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in; TEXT-INDENT: -0.25in"><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: Symbol"> </SPAN>
<SPAN style="FONT-SIZE: 12pt">The location and name of the output
file</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in; TEXT-INDENT: -0.25in"><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: Symbol"> </SPAN>
<SPAN style="FONT-SIZE: 12pt">The location and name of the input file</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in; TEXT-INDENT: -0.25in"><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: Symbol"> </SPAN>
<SPAN style="FONT-SIZE: 12pt">The location and name of the stylesheet</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in; TEXT-INDENT: -0.25in"><SPAN
style="FONT-SIZE: 12pt; FONT-FAMILY: Symbol"> </SPAN>
<SPAN style="FONT-SIZE: 12pt">Any variable parameters you wish to specify.
Options are listed under Notes below.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Generalized, the command
follows this syntax:</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">LocationOfTheConversionSoftware </SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN style="FONT-SIZE: 12pt">-o
PathToTheOutputFile\OutfileFileName.xml</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">PathToTheSourceFile\SourceFileName.xml </SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">PathToTheStylesheet\StylesheetName.xsl</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">parameterName=parameter value</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">A typical command in Run might
read:</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">c:\ead2002conv\bin\saxon
-o h:\ead\2468.xml h:ead2002\2468.xml</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">isoconvdate=2003-11-19 convdate
November 11, 2003 mainagencycode=Mnhi</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">reportpath=h\:conversion.html</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The same command from the DOS
prompt would read:</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">c:\ead2002conv>bin\saxon
-o h:\ead\2468.xml h:ead2002\2468.xml</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">isoconvdate=2003-11-19 convdate
November 11, 2003 mainagencycode=Mnhi</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">reportpath=h\:conversion.html</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">6. After executing
this command, review the conversion report for any anomalies or actions that do
not conform to your desired output</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">7. Edit the resulting EAD
file as necessary in your favorite XML editor. In particular, you
will probably have to edit the <eadid> element for reasons that are
described in the next section.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">8. Parse the
resulting EAD instance against the EAD2002 DTD to ensure that the resulting file
is valid.</SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt"></SPAN></B> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">Section C: Notes on
the Execution Command: </SPAN></B></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt"></SPAN></B> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">1. The example of
an execution command in step 3 uses the Saxon application in the directory
c:\ead2002conv\bin to convert the file 2468.xml in the folder h:\ead into a new
file with the same name, 2468.xml, and places it in the directory
h:\ead2002. In the resulting file, the maintenance agency code in
<eadid> is set to Mnhi for the Minnesota Historical Society and the date
of the conversion is reported as text in the YYYY element and as an ISO code in
its normal attribute. The expression "-o" is a Saxon parameter statement
that indicates that the following value is the location and/or name of the
output file. Follow the syntax of the example above. There is
an extra \ in the examples in the readme.txt file.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoBodyText>2. The unpacking of the file ead2002.exe
automatically creates default directories for version 1.0 source files and
version 2002 result files. The default folders are named "v1" and
"v2002". Other source and result locations may be employed
provided the appropriate path statements are spelled out in the execution
command. During the transformation process, Saxon will attempt to locate the
copy of the EAD version 1.0 DTD at the address given in the system id portion
(that which falls within the last set of quotation marks) of the DOCTYPE
declaration of your version 1.0 files. If it fails to find the DTD,
the transformation will fail immediately. If you are placing
your version 1.0 files in the folder "v1", you may need to adjust the system id
statement in your EAD files accordingly or include a copy of ead.dtd (and
eadbase.ent) there, whether the path to ead.dtd is relative or absolute.</P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">3. The XSLT stylesheet
specifies that the location of the conversion report is
c:\ead2002conv\doc. The zip file automatically creates this
directory. If you wish to direct the report elsewhere, you will
either have to change the path in the XSLT stylesheet (hint: it is on line 86)
or specify the location in a parameter as described in the section on parameters
below. Of course, you can also use a parameter to disable the
generation of the report completely. </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"> </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">4. Certain
parameter statements in the stylesheet determine various aspects of the
transformation process. These are documented in the stylesheet
itself and are summarized below. One can override the default values
either by editing the stylesheet or including overriding statements at the end
of the execution command, as shown in the examples under step 3
above. The parameters are:</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">countrycode</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The stylesheet default added to
<eadid> as @countrycode is "us". Use ISO 3166-1
values.</SPAN></P>
<P class=MsoNormal><B><SPAN
style="FONT-SIZE: 12pt">mainagencycode</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The stylesheet default added to
<eadid> as @mainagencycode is "ctY". (Guess where Stephen Yearl
works.) Use ISO 15511 values when replacing this value which
you will want to do unless you too work at Yale.</SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt"></SPAN></B> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">convdate</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The stylesheet default value
for the date of the transformation, as added to <revisondesc>
<change><date>, is "July 17, 2003"</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">isoconvdate</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The stylesheet default value
for date, expressed as an ISO code, as added to @normal in <revisondesc>
<change><date>, is "2003-07-16".</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">docname</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This is the file name for the
conversion report. The stylesheet default value is
"conversion". The path to this file is set in the stylesheet as
directoryname:\ead2002conv\doc. Either the file name may be
overridden from the command line here. The rest of the path
statement may be overridden from reportpath.</SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt"></SPAN></B> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">dtdpath</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This parameter sets the value
that is included in the system identifier within the DOCTYPE declaration of new
EAD 2002 file as the location for the file ead.dtd. The
stylesheet default is /dtds/ead.dtd which assumes that the ead.dtd file is
located in a directory called "dtds" that resides beneath the directory where
the EAD files is kept. If this does not match your file structure, you
will need to change the statement. </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">report</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This parameter determines
whether or not a report of the conversion process is produced. The
default value in the stylesheet is "y".</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">reportpath</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This parameter defines the
location of the conversion report. The stylesheet default has several
parts: the name of the drive where this software was installed, a path statement
"\ead2002conv\doc\", the value of the docname parameter, with the extension
".report.html".</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">If the software was installed
in the directory H: and the default value for docname is retained, the default
reportpath would be</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
h:\ead2002conv\doc\conversion.report.html</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
</SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">bundle</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The wrapper elements
<admininfo> and <add> have been deprecated in EAD2002. To use
them, one needs to adjust the DTD file itself. This parameter
determines what will be done with these elements during conversion. There
are two possibilities: replace <admininfo> and <add> with the
generic wrapper <descgroup> or remove the wrapper elements
completely. This parameter indicates whether to bundle them into
<descgrp> or not. The stylesheet default value is
"n". </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">You must understand, however,
that even if this parameter value is set to "n", these elements may be bundled
as described in the discussion of <add> and <admininfo> in the
Conversion Assumptions section below.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">langlang</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This parameter determines what
happens as a result of the presence of the langmaterial attribute in
<archdesc> in version 1.0 documents. The conversion stylesheet
creates a new element in the EAD 20002 document, thusly.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
<langmaterial></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
<language langcode="value">value</language></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
</langmaterial></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The coded value of
@langmaterial is written out in the <language> element according to a
conversion table in the file iso639-2.xml and the value of @langmaterial is
copied into its langcode attribute.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The stylesheet default value is
"eng" which produces the following output.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><langmaterial></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
<language langcode="eng">English</language></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt"></langmaterial></SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt"></SPAN></B> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">converter</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">This parameter defines the name
of the conversion stylesheet. The default value is "v1to02.xsl"<BR
style="PAGE-BREAK-BEFORE: always" clear=all></SPAN></P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">Section D:</SPAN></B><SPAN
style="FONT-SIZE: 12pt"> <B>Conversion Assumptions</B></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The Stylesheet makes various
assumptions during the conversion process based on changes made in the 2002
version of EAD. These are spelled out below.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">OBSOLETE:</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Elements and attributes NOT
available in EAD 2002.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><I><SPAN style="FONT-SIZE: 12pt">elements</SPAN></I></P>
<P class=MsoNormal><I><SPAN style="FONT-SIZE: 12pt"></SPAN></I> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><spanspec></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
v1to02.xsl eliminates this element from both <tspec> and
<tgroup></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><tfoot></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
v1to02.xsl writes text in a <tfoot> to <row
altrender="tfoot"></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><I><SPAN style="FONT-SIZE: 12pt">attributes</SPAN></I></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">behavior, content-role,
content-title, extent, inline, orient, pubstatus, rotate, shortentry, spanname,
tabstyle, tgroupstyle, tocentry, xlink:form</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
</SPAN></P>
<P class=MsoNormal style="TEXT-INDENT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">v1to02.xsl eliminates these attribute values</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">numbered</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
converts to altrender="numbered" or altrender="unumbered"</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">othersource</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
converts to source="value_of_othersource"</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">systemid</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
converts to <eadid>System
ID=value_of_systemid</eadid> </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">targettype (not actually in EAD
v1.0)</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><B><SPAN style="FONT-SIZE: 12pt">DEPRECATED:</SPAN></B></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Elements and attributes
strongly recommended not to be used, and are not permitted by default.
Such elements may only be made allowable by modifying the EAD 2002
DTD.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><I><SPAN style="FONT-SIZE: 12pt">elements</SPAN></I></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><add></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><admininfo></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">If the "bundle" parameter is
set to "y", as described above, the two elements are not removed or
changed.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">If the "bundle" parameter is
set to "n", which is the default value as described above, any of several
actions may occur depending on the structure of the element as described
below. The conversion process for both <add> and
<admininfo> follows the same pattern in the scenarios described
below. </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">A review of the content model
of these elements follows as it is necessary to understand the relationship
between their data structure and the conversion process.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Both Administrative Information
<admininfo> and Adjunct Descriptive Data <add> have been deprecated
in EAD 2002. While the DTD may be modified to revalidate them, the
EAD Working Group discourages this and makes no promise that they will be
available in future versions of the DTD. Now is the time to make the
transition. Where it is absolutely necessary to bundle groups of elements
together, the DTD now provides a generic wrapper element, Description Group
<descgrp>. Before adopting this element wholesale, a
repository should seriously consider the practical value of adding this
additional element.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">In EAD version 1.0, both
<add> and <admininfo> may contain three types of child elements,
i.e. those nested within it. In addition to the parent element (add
or admininfo), there may be a head, the generic block elements (address,
blockquote, chronlist, list, note, paragraph, and table), and certain
descriptive elements. </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">For <add>, the
descriptive elements are add, bibliography, fileplan, index, otherfindaid,
relatedmaterial, and separated material. </SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">For <admininfo), the
descriptive elements are accessrestrict, accruals, acqinfo, admininfo,
altformavailable, appraisal, custodhist, prefercite, processinfo, and
userestrict.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">The conversion algorithm may
produce any of several outputs depending on the structure of the parent
element.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 1: If the parent
element contains block elements but no descriptive elements, the parent element
is converted to <odd> and the name of the parent element is added as an
attribute, e.g. <odd type="add">.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 2: If the parent
element contains a single descriptive element and no block elements, the parent
element and its head element are removed. Any head element associated with
the descriptive element remains.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 3: If the parent
element contains a head element and more than one descriptive element, the
parent element is converted to <descgrp> and the name of the parent
element is added as an attribute, e.g. <descgrp type="add">.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 4: If the parent
element lacks a head element and contains more than one descriptive element, the
parent element is removed.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 5: If the
parent element is used recursively as a descriptive element and the parent has a
head, the parent element is removed and descriptive element is converted to
<odd> and the name of the descriptive element is added as an attribute,
e.g. <odd type="add">. NOTE: The stylesheet does not
distinguish between the situation where <add> or <adminifo> is used
as a parent element and when it appears recursively as its own
child. This is generally not a problem except for the next and
somewhat obscure scenario.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">Output 6: If the
parent element is used recursively as a descriptive element but lacks a head,
the stylesheet removes the parent element completely resulting in an invalid
document.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><dentry></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
content written straight to the <did> or other component child
element</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><drow></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
eliminated.</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><organization></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
converted to <arrangement></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"><tspec></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
eliminated</SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><I><SPAN style="FONT-SIZE: 12pt">attributes</SPAN></I></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">langmaterial</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">converts to <langmaterial><language
langcode="ISO639-2b_code">language_name (in French or
English)</language></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">legalstatus</SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 12pt">
converts to, e.g. <legalstatus
type="public">Public</legalstatus></SPAN></P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal><SPAN style="FONT-SIZE: 12pt">otherlegalstatus</SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt">convers to <legalstatus
type="my_other_legalstatus">my other
legalstatus</legalstatus></SPAN></P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt"></SPAN> </P>
<P class=MsoNormal style="MARGIN-LEFT: 0.5in"><SPAN
style="FONT-SIZE: 12pt"></SPAN> </P></DIV></BODY></HTML>