Difference between revisions of "apeEAD"

From Archives Portal Europe Wiki
Jump to: navigation, search
(apeEAD changes since October 2015: add sanctioned changes up to Q1 of 2019)
(Replaced content with "The content of this page has been integrated into the [https://www.archivesportaleurope.net/tools/for-content-providers/standards/apeead/ website of Archives Portal Europe...")
Line 1: Line 1:
= The use of EAD in the Archives Portal Europe =
+
The content of this page has been integrated into the [https://www.archivesportaleurope.net/tools/for-content-providers/standards/apeead/ website of Archives Portal Europe] now. You can also check out the more specific page on [https://www.archivesportaleurope.net/tools/for-content-providers/standards/ead2002-in-archives-portal-europe/ the use of EAD 2002 in Archives Portal Europe] for more detailed information.
 
+
The most important archival standard used by the Archives Portal Europe is Encoded Archival Description (EAD), an XML standard for encoding archival finding aids, maintained by the [https://www2.archivists.org/groups/technical-subcommittee-on-encoded-archival-standards-ts-eas Technical Subcommittee for Encoded Archival Standards (TS-EAS)] of the [https://www2.archivists.org/ Society of American Archivists (SAA)], in partnership with the Library of Congress.
+
 
+
<div><br/>__TOC__<br/></div>
+
== Describing holdings and collections ==
+
The development of the EAD standard began with a project initiated by the University of California, Berkeley Library in 1993, led by Daniel Pitti. The requirements for the encoding standard then included – and still include today – the following criteria:
+
 
+
* ability to present extensive and interrelated descriptive information found in archival finding aids,
+
* ability to preserve the hierarchical relationships existing between levels of description,
+
* ability to represent descriptive information that is inherited by one hierarchical level from another,
+
* ability to move within a hierarchical informational structure,
+
* support for element-specific indexing and retrieval.
+
 
+
EAD is by now used world wide for data exchange between archival institutions and for Internet presentations of archival descriptive information. It is especially applied for trans-institutional and trans-national projects like the [http://www.archivesportaleurope.net Archives Portal Europe].
+
 
+
The first version of EAD, v1.0, was published in 1998, the second version, EAD2002, was released in December 2002 and the work on the revision of EAD2002, which led to the current version, [[EAD3|EAD3]], was started in 2010 and finished in August 2015. Currently the TS-EAS of the SAA is working on a first update of EAD3, v1.1, which will probably be released in the summer of 2018.
+
 
+
* Go to the [http://www.loc.gov/ead/ official EAD homepage] on the website of the Library of Congress
+
* Go to the [http://www.loc.gov/ead/tglib/index.html official EAD2002 Tag Library] to learn more about EAD2002 elements and attributes available.
+
* Go to the [http://www.loc.gov/ead/EAD3taglib/index.html official EAD3 Tag Library] to learn more about EAD3 elements and attributes available
+
* Go to the SAA website for [https://www2.archivists.org/groups/encoded-archival-standards-section/frequently-asked-questions-about-ead-and-ead3#.V31DfP4UVaR Frequently Asked Questions] about EAD in general and EAD3 in particular
+
* See the [https://www.ica.org/en/isadg-general-international-standard-archival-description-second-edition General International Standard Archival Description (ISAD(G)] as correspondent describing standard as maintained by the International Council on Archives (ICA).
+
<br/>
+
 
+
== The use of EAD as backbone within the three-layers-concept of the Archives Portal Europe ==
+
Within the Archives Portal Europe EAD is used with a concept of three interrelated and interconnected layers of description. Each of them consists of individual documents structured internally with the levels of EAD.<br/><br/>
+
 
+
The first layer, the '''Archival Landscape''', consists of one EAD document and has the function of a sort of umbrella for the whole providing users of the Archives Portal Europe with a starting point for navigational research by:
+
 
+
* naming all participating archival institutions in a structured way (f.i. sorted by country) with links to their more detailed descriptive information on the next lower level and
+
* granting access to detailed information on the institutions themselves like contact details or opening hours given in [[EAG2012|EAG]] files linked to the Archival Landscape.
+
<br/>
+
The second layer, the '''Holdings Guides''', consists of a set of EAD documents containing each a structured list of fonds or record groups of every archival institution. It aims at:
+
 
+
* giving an overview over the fonds and collections of the single archival institutions, intended to include links to more detailed information on records creators in [[apeEAC-CPF|EAC-CPF]] files,
+
* providing short information on fonds and collections incl. f.i. conditions concerning their access and use and
+
* linking to their detailed description on the next lower level.
+
<br/>
+
The third layer, the '''Finding Aids''', consists of EAD documents containing detailed description for the single fonds or record groups structured according to series and arrangement groups. Finding Aids will:
+
 
+
* provide detailed information on the archival material from collection level down to units' level indicating the reference numbers necessary for ordering or communication with the archival repositories and
+
* grant access to digitisations of the archival material, if applicable
+
<br/>
+
 
+
== Defining and creating apeEAD ==
+
 
+
In preparation of a joint presentation of different EAD implementations of different institutions in one online access point such as Archives Portal Europe, the APEnet project came up with a specific APE EAD schema, which was called apeEAD. This schema was continually enhanced and improved along with further steps of the two Archives Portal Europe projects: [http://www.apenet.eu APEnet (2009-2012)] and [http://www.apex-project.eu APEx (20012-2015)].
+
 
+
The complete [https://www.archivesportaleurope.net/Portal/profiles/apeEAD.xsd apeEAD schema] is defined as a subset of the [http://www.loc.gov/ead/ead.xsd EAD2002 schema] fulfilling the requirements for the joint presentation in the union finding aid of the Archives Portal Europe. It is optimised for the use inside the union finding aid and contains only those parts of EAD needed for common display, for linking and identification purposes. It was drafted on the basis of a the comparison of EAD profiles and practices of the National Archives participating in the APEnet project. In cases of different possibilities it names those elements and attributes commonly used – and describes how they are used.
+
<br/><br/><br/>
+
 
+
= apeEAD documentation =
+
When you are interested in the question how to map and convert your own data into apeEAD, then you can make use of these documents produced by the APEnet project:<br/>
+
 
+
[[Media:apeEAD_finding_aid_table_201210.pdf|the apeEAD table]],
+
 
+
* a tabular overview on how apeEAD has been defined within the APEnet project be used with finding aids, naming and listing the different elements and attributes, each with a short note on its intended use;
+
 
+
 
+
[[Media:apenet_ead_finding_aid_holdings_guide.pdf|the apeEAD guide]],
+
 
+
* a full text description of each element and attribute along with some examples concerning possible contents as well as the encoding of these elements in EAD XML and some examples of complete finding aids encoded in apeEAD (this document is outdated and a new version is currently in preparation; please refer to the apeEAD schema below);
+
 
+
 
+
[https://www.archivesportaleurope.net/Portal/profiles/apeEAD.xsd the apeEAD schema],
+
 
+
* the technical implementation of the profile, which is used as the target:
+
** when transforming archival descriptions from the content providers to the commonly used apeEAD,
+
** for validating the results of transformation and conversion of local EAD documents,
+
** for indexing the data to be used in an overall search,
+
** for creating HTML presentations of archival material within the future Archives Portal Europe, and
+
** for data exchange with other gateways such as Europeana.
+
 
+
 
+
[[Media:apenet_mapping_normalisation_guide.pdf|the mapping and normalisation best practice]] for the APEnet project
+
 
+
* the mapping and normalisation guideline effective at the end of the APEnet project in 2012
+
 
+
 
+
These above mentioned documents have been slightly evolving along with the further developments of apeEAD within the APEx project. But the changes and adaptations have been minor, more aimed at increasing the number of elements and attributes rather than diminishing them and this has not touched the general structure and the elements as defined within the APEnet project. The result of the evolution of apeEAD during the course of the APEx project has been documented in the D2.6/D4.8 deliverable of the project:
+
 
+
 
+
[[Media:D2.6D4.8_mapping-guide_apeEAD.pdf|the apeEAD mapping guide]], which reflects the status of apeEAD as per March 2015
+
 
+
* So this is the definitive mapping and normalisation guideline effective at the end of the APEx project in 2015 and still reflects the current status of apeEAD in combination with the changes as described [[#apeEAD_changes_since_October_2015|below]].
+
<br/><br/>
+
 
+
= apeEAD changes since October 2015 =
+
 
+
Within the [http://www.archivesportaleuropefoundation.eu Archives Portal Europe Foundation (APEF)], the non-profit organisation that took over the responsibility for the Archives Portal Europe after the conclusion of the APEx project per October 2015, a Working Group on Standards is in charge of the maintenance and the further development of the Archives Portal Europe standards. It has sanctioned the following changes on the apeEAD schema:
+
 
+
{| class="wikitable"
+
|-
+
!Date
+
!Element changed
+
!Changes
+
!Notes
+
|-
+
|rowspan="2" valign="top"|2016-08-03
+
| valign="top"|<code>@repositorycode</code>
+
| valign="top"|Addition of value <code>IM</code> to list
+
|rowspan="2" valign="top"|Accommodation of [https://en.wikipedia.org/wiki/Isle_of_Man Isle of Man] in APE
+
|-
+
| valign="top"|<code>@countrycode</code>
+
| valign="top"|Addition of value <code>IM</code> to list
+
<!--
+
|-
+
|rowspan="5" valign="top"|2019-0?-??
+
| valign="top"|<code><bibliography></code>
+
| valign="top"|Addition of <code><bibliography></code> as subelement
+
| valign="top"|Correction of a situation where nesting <code><bibliography></code> elements was prohibited while nesting of <code><bioghist></code> and <code><processinfo></code> elements was allowed
+
|-
+
| valign="top"|<code><publicationstmt></code>
+
| valign="top"|Addition of <code><nowiki><p></nowiki></code> as subelement
+
| valign="top"|Faciliation of adding copyright information to the apeEAD file. Example:<br />
+
<nowiki>
+
<publicationstmt>
+
  <publisher>Nationaal Archief, Den Haag</publisher>
+
  <date normal="2013" era="ce" calendar="gregorian">(c) 2013</date>
+
  <p id="copyright"><extref linktype="simple" href="http://creativecommons.org/publicdomain/zero/1.0/" actuate="onrequest" show="new">cc0</extref></p>
+
</publicationstmt>
+
</nowiki>
+
|-
+
| valign="top"|<code><nowiki><p></nowiki></code>
+
| valign="top"|Addition of <code><note></code> as subelement
+
| valign="top"|Faciliation of the display of footnotes in the portal
+
|-
+
| valign="top"|<code><filedesc></code>
+
| valign="top"|Addition of <code><notestmt></code> and its subelements
+
| valign="top"|Faciliation of adding general information about the material from the providing archive, for example on its accessibility. Example:<br />
+
<nowiki>
+
<notestmt>
+
  <note>
+
      <p>[ATTENTION: Any maps and drawings are not available for consultation during the
+
        <extref linktype="simple" href=http://www.gahetna.nl/verbouwing actuate="onrequest" show="new">reconstruction of the reading room</extref>!
+
        Reconstruction is scheduled to be completed by the end of 2019.]</p>
+
  </note>
+
</notestmt>
+
</nowiki>
+
|-
+
| valign="top"|various elements
+
| valign="top"|addition of <code><nowiki><ref></nowiki></code>
+
| valign="top"|Faciliation of internal linking within an apeEAD file. Example:<br />
+
<nowiki>
+
//Add example code here
+
</nowiki>
+
-->
+
|}
+
 
+
 
+
 
+
[[Category:Standards]]
+

Revision as of 10:00, 28 October 2022

The content of this page has been integrated into the website of Archives Portal Europe now. You can also check out the more specific page on the use of EAD 2002 in Archives Portal Europe for more detailed information.