Difference between revisions of "TEI Header"

From XML
Jump to: navigation, search
(Created page with "De <teiHeader> is een verplicht onderdeel van het transcriptiebestand en bevat meta-informatie over de digitale editie. Hij bestaat over het algemeen uit de volgende elementen...")
 
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
De <teiHeader> is een verplicht onderdeel van het transcriptiebestand en bevat meta-informatie over de digitale editie. Hij bestaat over het algemeen uit de volgende elementen:
+
The <teiHeader> is a required component of the transcription file and contains metadata about the digital edition. It generally consists of the following elements:
  
* De <fileDesc>: het enige verplichte onderdeel. Het bevat een bibliografische beschrijving van de digitale editie;
+
* The <fileDesc>: the only mandatory component. It contains a bibliographic description of the digital edition;
* De <encodingDesc> met daarin de relatie tussen de digitale editie en zijn (materiële) bron te beschrijven;
+
* The <encodingDesc>, which describes the relation between the digital edition and its (material) source;
* De <profileDesc> met classificerende en contextuele informatie over de tekst.  
+
* The <profileDesc> containing classifying and contextual information about the text.
+
* The <encodingDesc> which allows the encoder to provide a history of changes made during the development of the electronic text
De <fileDesc> bestaat ook weer uit drie verplichte onderdelen:
+
* Een <titleStmt> met informatie over de titel (<title>), auteur (<author>) en/of editeur <editor> van de tekst;
+
* Een <publicationStmt> met informatie over publicatiedetails;
+
* Een <sourceDesc> met bibliografische details over de materiële bron.
+
  
Omdat niet iedere tekstbron dezelfde soort informatie in de metadata behoeft, hangt het van het type bron af hoe de <teiHeader> per onderdeel wordt vormgegeven. Ook de verdere invulling van de <teiHeader> zal per bron verschillen. Het is daarom raadzaam om de pagina over de TEI Header van het relevante project te bekijken.
+
The <fileDesc> itself consists of three mandatory parts as well:
 +
* A <titleStmt> with information about the <title>, <author> and/or <editor> of the text;
 +
* A <publicationStmt> containing information about publication details;
 +
* A <sourceDesc> with bibliographical details about the material source.
 +
 
 +
The smallest possible valid TEI Header looks like this:
 +
<pre>
 +
<teiHeader>
 +
<fileDesc>
 +
  <titleStmt>
 +
  <title>
 +
<!-- title of the resource -->
 +
  </title>
 +
  </titleStmt>
 +
  <publicationStmt>
 +
  <p>
 +
<!-- Information about distribution of the resource -->
 +
  </p>
 +
  </publicationStmt>
 +
  <sourceDesc>
 +
  <p>
 +
<!-- Information about source from which the resource derives -->
 +
  </p>
 +
  </sourceDesc>
 +
</fileDesc>
 +
</teiHeader>
 +
</pre>
 +
 
 +
Each of our projects should at least use the <title> element to give the title of the edited document and the <editor> element to define the editors. E.g. (Mondrian example):
 +
<pre>
 +
<titleStmt>
 +
  <title>Briefkaart aan Harry Holtzman. Parijs, donderdag 14
 +
    maart 1935</title>
 +
  <editor xml:id="wc">Wietse Coppes</editor>
 +
  <editor xml:id="lj">Leo Jansen</editor>
 +
  <sponsor>Mondrian Edition Project</sponsor>
 +
</titleStmt>
 +
</pre>
 +
 
 +
The xml:id attributes make it possible to point to these elements, in order to assign responsibility.
 +
 
 +
It is advisable to maintain a log of changes to the document within the
 +
<revisionDesc>. The <change> element can be used to document these modifications:
 +
 
 +
<pre>
 +
<revisionDesc>
 +
    <change who="#lj" when="2014-10-08">Introduced facsimile element</change>
 +
    <change who="#wc" when="2014-10-09">checked transcription</change>
 +
</revisionDesc>
 +
</pre>
 +
 
 +
The who attribute refers to identifiers on the <editor> elements.
 +
 
 +
Not every source of text requires the same type of information within the metadata, so the way in which the <teiHeader> is shaped depends on the type of source. It is therefore advisable to take a look at the Wiki page about the TEI Header of the relevant project.  
 +
 
 +
==Zie ook==
 +
* [[TEI Header (MVN)]]
 +
* [[TEI Header (Mondrian)]]
 +
* [[XML Huygens]]
  
 
[[Category:XML Huygens]]
 
[[Category:XML Huygens]]

Latest revision as of 12:42, 26 April 2017

The <teiHeader> is a required component of the transcription file and contains metadata about the digital edition. It generally consists of the following elements:

  • The <fileDesc>: the only mandatory component. It contains a bibliographic description of the digital edition;
  • The <encodingDesc>, which describes the relation between the digital edition and its (material) source;
  • The <profileDesc> containing classifying and contextual information about the text.
  • The <encodingDesc> which allows the encoder to provide a history of changes made during the development of the electronic text

The <fileDesc> itself consists of three mandatory parts as well:

  • A <titleStmt> with information about the <title>, <author> and/or <editor> of the text;
  • A <publicationStmt> containing information about publication details;
  • A <sourceDesc> with bibliographical details about the material source.

The smallest possible valid TEI Header looks like this:

<teiHeader>
 <fileDesc>
  <titleStmt>
   <title>
<!-- title of the resource -->
   </title>
  </titleStmt>
  <publicationStmt>
   <p>
<!-- Information about distribution of the resource -->
   </p>
  </publicationStmt>
  <sourceDesc>
   <p>
<!-- Information about source from which the resource derives -->
   </p>
  </sourceDesc>
 </fileDesc>
</teiHeader>

Each of our projects should at least use the <title> element to give the title of the edited document and the <editor> element to define the editors. E.g. (Mondrian example):

<titleStmt>
  <title>Briefkaart aan Harry Holtzman. Parijs, donderdag 14
    maart 1935</title>
  <editor xml:id="wc">Wietse Coppes</editor>
  <editor xml:id="lj">Leo Jansen</editor>
  <sponsor>Mondrian Edition Project</sponsor>
</titleStmt>

The xml:id attributes make it possible to point to these elements, in order to assign responsibility.

It is advisable to maintain a log of changes to the document within the <revisionDesc>. The <change> element can be used to document these modifications:

<revisionDesc>
    <change who="#lj" when="2014-10-08">Introduced facsimile element</change>
    <change who="#wc" when="2014-10-09">checked transcription</change>
</revisionDesc>

The who attribute refers to identifiers on the <editor> elements.

Not every source of text requires the same type of information within the metadata, so the way in which the <teiHeader> is shaped depends on the type of source. It is therefore advisable to take a look at the Wiki page about the TEI Header of the relevant project.

Zie ook