Mounting a Finding Aids Collection

From DLXS Documentation

Main Page > Mounting Collections: Class-specific Steps > Mounting a Finding Aids Collection

---

This topic describes how to mount a Findaid Class collection.

Workshop materials are located here.

Contents 1 Overview 1.1 Examples 1.2 Overview of Data Preparation and Indexing Steps 2 Working with the EAD 3 Findaid Class Behaviors Overview 4 Preparing Data and Directories 4.1 Character Issues 4.2 Encoding Issues 5 Validating and Normalizing Your Data 6 Building the Index 7 Working with Fabricated Regions 8 Modifying Findaid Class Files 9 Mounting the Collection Online 10 Troubleshooting 11 Linking from Finding Aids Using ID Resolver 12 Workshop materials 13 Working with the User Interface 13.1 Findaid Class Graphics Files 13.2 Findaid Class Processing Instructions

Overview

Examples

Overview of Data Preparation and Indexing Steps

Data Preparation

1. [#DataPrepStep1 validating the files individually] against the EAD 2002 DTD
   make validateeach
   
2. [#DataPrepStep2 concatenating the files into one larger XML file]
   make prepdocs
   
3. [#DataPrepStep3 validating the concatenated file] against the dlxsead2002 DTD:
   make validate
   
4. [#DataPrepStep4 "normalizing" the concatenated file.]
   make norm
   
5. [#DataPrepStep5 validating the normalized concatenated file against the dlxsead2002 DTD]
   make validate
   

The end result of these steps is a file containing the concatenated EADs wrapped in a <COLL> element which validates against the dlxsead2002 and is ready for indexing:

<COLL>
<ead><eadheader><eadid>1</eadid>...</eadheader>... content</ead>
<ead><eadheader><eadid>2</eadid>...</eadheader>... content</ead>
<ead><eadheader><eadid>3</eadid>...</eadheader>... content</ead>
</COLL>

WARNING! If are extra characters or some other problem with the part of the program that strips out the xml declaration and the docytype declearation the file will end up like:

<COLL>
baddata<ead><eadheader><eadid>1</eadid>...</eadheader>... content</ead>
baddata<ead><eadheader><eadid>2</eadid>...</eadheader>... content</ead>
baddata<ead><eadheader><eadid>3</eadid>...</eadheader>... content</ead>
</COLL>

In this case you will get "character data not allowed" or similar errors during the make validate step. You can troubleshoot by looking at the concatenated file and/or checking your original EADs.

Indexing

1. make singledd indexes words for texts that have been concatenated into on large file for a collection. This is the recommended process.
2. make xml indexes the XML structure by reading the DTD. Validates as it indexes.
3. make post builds and indexes fabricated regions based on the XPAT queries stored in the workshopfa.extra.srch file.

Working with the EAD

Findaid Class Behaviors Overview

Preparing Data and Directories

Character Issues

Encoding Issues

Validating and Normalizing Your Data

Building the Index

Working with Fabricated Regions

Modifying Findaid Class Files

Mounting the Collection Online

Troubleshooting

Linking from Finding Aids Using ID Resolver

Workshop materials

Working with the User Interface

Findaid Class Graphics Files

Findaid Class Processing Instructions

Top