https://github.com/TEIC/TEI
Raw File
Tip revision: 347c64fac3fa1a64ade0d8d1842813d4b8f7acec authored by Hugh Cayless on 12 May 2017, 16:57:59 UTC
Updates.
Tip revision: 347c64f
ref-fileDesc.html

<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><!--THIS FILE IS GENERATED FROM AN XML MASTER. DO NOT EDIT (7)--><title>TEI element fileDesc (file description) </title><meta property="Language" content="en" /><meta property="DC.Title" content="TEI element fileDesc (file description) " /><meta property="DC.Language" content="SCHEME=iso639 en" /><meta property="DC.Creator.Address" content="tei@oucs.ox.ac.uk" /><meta charset="utf-8" /><link href="guidelines.css" rel="stylesheet" type="text/css" /><link href="odd.css" rel="stylesheet" type="text/css" /><link rel="stylesheet" media="print" type="text/css" href="guidelines-print.css" /><script type="text/javascript" src="jquery-1.2.6.min.js"></script><script type="text/javascript" src="columnlist.js"></script><script type="text/javascript" src="popupFootnotes.js"></script><script type="text/javascript">
        $(function() {
         $('ul.attrefs-class').columnizeList({cols:3,width:30,unit:'%'});
         $('ul.attrefs-element').columnizeList({cols:3,width:30,unit:'%'});
         $(".displayRelaxButton").click(function() {
           $(this).parent().find('.RNG_XML').toggle();
           $(this).parent().find('.RNG_Compact').toggle();
         });
         $(".tocTree .showhide").click(function() {
          $(this).find(".tocShow,.tocHide").toggle();
          $(this).parent().find("ul.continuedtoc").toggle();
	  });
        })
    </script><script type="text/javascript"><!--
var displayXML=0;
states=new Array()
states[0]="element-a"
states[1]="element-b"
states[2]="element-c"
states[3]="element-d"
states[4]="element-e"
states[5]="element-f"
states[6]="element-g"
states[7]="element-h"
states[8]="element-i"
states[9]="element-j"
states[10]="element-k"
states[11]="element-l"
states[12]="element-m"
states[13]="element-n"
states[14]="element-o"
states[15]="element-p"
states[16]="element-q"
states[17]="element-r"
states[18]="element-s"
states[19]="element-t"
states[20]="element-u"
states[21]="element-v"
states[22]="element-w"
states[23]="element-x"
states[24]="element-y"
states[25]="element-z"

function startUp() {

}

function hideallExcept(elm) {
for (var i = 0; i < states.length; i++) {
 var layer;
 if (layer = document.getElementById(states[i]) ) {
  if (states[i] != elm) {
    layer.style.display = "none";
  }
  else {
   layer.style.display = "block";
      }
  }
 }
 var mod;
 if ( mod = document.getElementById('byMod') ) {
     mod.style.display = "none";
 }
}

function showall() {
 for (var i = 0; i < states.length; i++) {
   var layer;
   if (layer = document.getElementById(states[i]) ) {
      layer.style.display = "block";
      }
  }
}

function showByMod() {
  hideallExcept('');
  var mod;
  if (mod = document.getElementById('byMod') ) {
     mod.style.display = "block";
     }
}

	--></script></head><body id="TOP"><div id="container"><div id="banner"><img src="Images/banner.jpg" alt="Text Encoding Initiative logo and banner" /></div></div><div class="mainhead"><h1>P5: 
    Guidelines for Electronic Text Encoding and Interchange</h1><p>Version 3.1.1a. Last updated on
	10th May 2017, revision bd8dda3</p></div><div class="main-content"><div class="miniTOC miniTOC_right"><ul class="subtoc"><li class="subtoc"></li><li class="subtoc"></li><li class="subtoc"><a class="navigation" href="index.html">Home</a></li><li class="subtoc"><a class="navigation" href="REF-ELEMENTS.html">C Elements</a></li></ul></div><div><h3 class="oddSpec" id="fileDesc">&lt;fileDesc&gt;</h3><table class="wovenodd"><tr><td colspan="2" class="wovenodd-col2"><span class="label">&lt;fileDesc&gt; </span>(file description) contains a full bibliographic description of an electronic file. [<a class="link_ptr" href="HD.html#HD2" title="The File Description"><span class="headingNumber">2.2 </span>The File Description</a> <a class="link_ptr" href="HD.html#HD11" title="The TEI Header and Its Components"><span class="headingNumber">2.1.1 </span>The TEI Header and Its Components</a>]</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Module</span></td><td class="wovenodd-col2">header — The TEI Header</td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Attributes</span></td><td class="wovenodd-col2"><a class="link_odd" title="provides attributes common to all elements in the TEI encoding scheme." href="ref-att.global.html">att.global</a> (<span class="attribute">@xml:id</span>, <span class="attribute">@n</span>, <span class="attribute">@xml:lang</span>, <span class="attribute">@xml:base</span>, <span class="attribute">@xml:space</span>)  (<a class="link_odd" title="provides rendering attributes common to all elements in the TEI encoding scheme." href="ref-att.global.rendition.html">att.global.rendition</a> (<span class="attribute">@rend</span>, <span class="attribute">@style</span>, <span class="attribute">@rendition</span>))  (<a class="link_odd" title="provides a set of attributes for hypertextual linking." href="ref-att.global.linking.html">att.global.linking</a> (<span class="attribute">@corresp</span>, <span class="attribute">@synch</span>, <span class="attribute">@sameAs</span>, <span class="attribute">@copyOf</span>, <span class="attribute">@next</span>, <span class="attribute">@prev</span>, <span class="attribute">@exclude</span>, <span class="attribute">@select</span>))  (<a class="link_odd" title="provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text." href="ref-att.global.analytic.html">att.global.analytic</a> (<span class="attribute">@ana</span>))  (<a class="link_odd" title="provides an attribute used to express correspondence between an element containing transcribed text and all or part of an image representing that text." href="ref-att.global.facs.html">att.global.facs</a> (<span class="attribute">@facs</span>))  (<a class="link_odd" title="supplies the @change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated." href="ref-att.global.change.html">att.global.change</a> (<span class="attribute">@change</span>))  (<a class="link_odd" title="provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it." href="ref-att.global.responsibility.html">att.global.responsibility</a> (<span class="attribute">@cert</span>, <span class="attribute">@resp</span>))  (<a class="link_odd" title="provides an attribute used by elements to point to an external source." href="ref-att.global.source.html">att.global.source</a> (<span class="attribute">@source</span>)) </td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Contained by</span></td><td class="wovenodd-col2"><div class="parent"><div class="specChildren"><div class="specChild"><span class="specChildModule">header: </span><span class="specChildElements"><a class="link_odd_elementSpec" title="(fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present." href="ref-biblFull.html">biblFull</a> <a class="link_odd_elementSpec" title="(TEI header) supplies descriptive and declarative metadata associated with a digital resource or set of resources." href="ref-teiHeader.html">teiHeader</a></span></div></div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">May contain</span></td><td class="wovenodd-col2"><div class="specChildren"><div class="specChild"><span class="specChildModule">header: </span><span class="specChildElements"><a class="link_odd_elementSpec" title="(edition statement) groups information relating to one edition of a text." href="ref-editionStmt.html">editionStmt</a> <a class="link_odd_elementSpec" title="describes the approximate size of a text stored on some carrier medium or of some other object, digital or non-digital, specified in any convenient units." href="ref-extent.html">extent</a> <a class="link_odd_elementSpec" title="(notes statement) collects together any notes providing information about a text additional to that recorded in other parts of the bibliographic description." href="ref-notesStmt.html">notesStmt</a> <a class="link_odd_elementSpec" title="(publication statement) groups information concerning the publication or distribution of an electronic or other text." href="ref-publicationStmt.html">publicationStmt</a> <a class="link_odd_elementSpec" title="(series statement) groups information about the series, if any, to which a publication belongs." href="ref-seriesStmt.html">seriesStmt</a> <a class="link_odd_elementSpec" title="(source description) describes the source from which an electronic text was derived or generated, typically a bibliographic description in the case of a digitized text, or a phrase such as &#34;born digital&#34; for a text which has no previous existence." href="ref-sourceDesc.html">sourceDesc</a> <a class="link_odd_elementSpec" title="(title statement) groups information about the title of a work and those responsible for its content." href="ref-titleStmt.html">titleStmt</a></span></div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Note</span></td><td class="wovenodd-col2"><!-- --><p>The major source of information for those seeking to create a catalogue entry or bibliographic citation for an electronic file. As such, it provides a title and statements of responsibility together with details of the publication or distribution of the file, of any series to which it belongs, and detailed bibliographic notes for matters not addressed elsewhere in the header. It also contains a full bibliographic description for the source or sources from which the electronic text was derived.</p></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Example</span></td><td class="wovenodd-col2"><div id="index-egXML-d52e19334" class="pre egXML_valid"><span class="element">&lt;fileDesc&gt;</span><br /> <span class="element">&lt;titleStmt&gt;</span><br />  <span class="element">&lt;title&gt;</span>The shortest possible TEI document<span class="element">&lt;/title&gt;</span><br /> <span class="element">&lt;/titleStmt&gt;</span><br /> <span class="element">&lt;publicationStmt&gt;</span><br />  <span class="element">&lt;p&gt;</span>Distributed as part of TEI P5<span class="element">&lt;/p&gt;</span><br /> <span class="element">&lt;/publicationStmt&gt;</span><br /> <span class="element">&lt;sourceDesc&gt;</span><br />  <span class="element">&lt;p&gt;</span>No print source exists: this is an original digital text<span class="element">&lt;/p&gt;</span><br /> <span class="element">&lt;/sourceDesc&gt;</span><br /><span class="element">&lt;/fileDesc&gt;</span><div style="float: right;"><a href="examples-fileDesc.html">Show all</a> </div></div></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Content model</span></td><td class="wovenodd-col2"><pre class="eg"><span class="element">&lt;content&gt;</span><br /> <span class="element">&lt;sequence&gt;</span><br />  <span class="element">&lt;sequence&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-titleStmt.html">titleStmt</a>"/&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-editionStmt.html">editionStmt</a>"<br />    <span class="attribute">minOccurs</span>="<span class="attributevalue">0</span>"/&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-extent.html">extent</a>" <span class="attribute">minOccurs</span>="<span class="attributevalue">0</span>"/&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-publicationStmt.html">publicationStmt</a>"/&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-seriesStmt.html">seriesStmt</a>"<br />    <span class="attribute">minOccurs</span>="<span class="attributevalue">0</span>"/&gt;</span><br />   <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-notesStmt.html">notesStmt</a>"<br />    <span class="attribute">minOccurs</span>="<span class="attributevalue">0</span>"/&gt;</span><br />  <span class="element">&lt;/sequence&gt;</span><br />  <span class="element">&lt;elementRef <span class="attribute">key</span>="<a class="link_odd" href="ref-sourceDesc.html">sourceDesc</a>"<br />   <span class="attribute">minOccurs</span>="<span class="attributevalue">1</span>" <span class="attribute">maxOccurs</span>="<span class="attributevalue">unbounded</span>"/&gt;</span><br /> <span class="element">&lt;/sequence&gt;</span><br /><span class="element">&lt;/content&gt;</span></pre></td></tr><tr><td class="wovenodd-col1"><span class="label" lang="en">Schema Declaration</span></td><td class="wovenodd-col2"><div class="displayRelax"><button class="displayRelaxButton"><span class="RNG_Compact">XML syntax</span><span class="RNG_XML">Compact syntax</span></button><pre class="RNG_XML"><span class="element">&lt;rng:element <span class="attribute">name</span>="<span class="attributevalue">fileDesc</span>"&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.rendition.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.linking.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.analytic.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.facs.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.change.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.responsibility.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">att.global.source.attributes</span>"/&gt;</span><br /> <span class="element">&lt;rng:group&gt;</span><br />  <span class="element">&lt;rng:group&gt;</span><br />   <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">titleStmt</span>"/&gt;</span><br />   <span class="element">&lt;rng:optional&gt;</span><br />    <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">editionStmt</span>"/&gt;</span><br />   <span class="element">&lt;/rng:optional&gt;</span><br />   <span class="element">&lt;rng:optional&gt;</span><br />    <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">extent</span>"/&gt;</span><br />   <span class="element">&lt;/rng:optional&gt;</span><br />   <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">publicationStmt</span>"/&gt;</span><br />   <span class="element">&lt;rng:optional&gt;</span><br />    <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">seriesStmt</span>"/&gt;</span><br />   <span class="element">&lt;/rng:optional&gt;</span><br />   <span class="element">&lt;rng:optional&gt;</span><br />    <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">notesStmt</span>"/&gt;</span><br />   <span class="element">&lt;/rng:optional&gt;</span><br />  <span class="element">&lt;/rng:group&gt;</span><br />  <span class="element">&lt;rng:oneOrMore&gt;</span><br />   <span class="element">&lt;rng:ref <span class="attribute">name</span>="<span class="attributevalue">sourceDesc</span>"/&gt;</span><br />  <span class="element">&lt;/rng:oneOrMore&gt;</span><br /> <span class="element">&lt;/rng:group&gt;</span><br /><span class="element">&lt;/rng:element&gt;</span></pre><pre class="RNG_Compact">
<span class="rnc_keyword">element</span> <span class="rnc_nc">fileDesc</span>
{
   <a class="link_odd" title="provides attributes common to all elements in the TEI encoding scheme." href="ref-att.global.html">att.global.attributes</a>,
   <a class="link_odd" title="provides rendering attributes common to all elements in the TEI encoding scheme." href="ref-att.global.rendition.html">att.global.rendition.attributes</a>,
   <a class="link_odd" title="provides a set of attributes for hypertextual linking." href="ref-att.global.linking.html">att.global.linking.attributes</a>,
   <a class="link_odd" title="provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text." href="ref-att.global.analytic.html">att.global.analytic.attributes</a>,
   <a class="link_odd" title="provides an attribute used to express correspondence between an element containing transcribed text and all or part of an image representing that text." href="ref-att.global.facs.html">att.global.facs.attributes</a>,
   <a class="link_odd" title="supplies the @change attribute, allowing its member elements to specify one or more states or revision campaigns with which they are associated." href="ref-att.global.change.html">att.global.change.attributes</a>,
   <a class="link_odd" title="provides attributes indicating the agent responsible for some aspect of the text, the markup or something asserted by the markup, and the degree of certainty associated with it." href="ref-att.global.responsibility.html">att.global.responsibility.attributes</a>,
   <a class="link_odd" title="provides an attribute used by elements to point to an external source." href="ref-att.global.source.html">att.global.source.attributes</a>,
   (
      (
         <a class="link_odd" title="(title statement) groups information about the title of a work and those responsible for its content." href="ref-titleStmt.html">titleStmt</a>,
         <a class="link_odd" title="(edition statement) groups information relating to one edition of a text." href="ref-editionStmt.html">editionStmt</a>?,
         <a class="link_odd" title="describes the approximate size of a text stored on some carrier medium or of some other object, digital or non-digital, specified in any convenient units." href="ref-extent.html">extent</a>?,
         <a class="link_odd" title="(publication statement) groups information concerning the publication or distribution of an electronic or other text." href="ref-publicationStmt.html">publicationStmt</a>,
         <a class="link_odd" title="(series statement) groups information about the series, if any, to which a publication belongs." href="ref-seriesStmt.html">seriesStmt</a>?,
         <a class="link_odd" title="(notes statement) collects together any notes providing information about a text additional to that recorded in other parts of the bibliographic description." href="ref-notesStmt.html">notesStmt</a>?
      ),
      <a class="link_odd" title="(source description) describes the source from which an electronic text was derived or generated, typically a bibliographic description in the case of a digitized text, or a phrase such as &#34;born digital&#34; for a text which has no previous existence." href="ref-sourceDesc.html">sourceDesc</a>+
   )
}</pre></div></td></tr></table></div></div><div class="stdfooter autogenerated"><p>
    [<a href="../../en/html/ref-fileDesc.html">English</a>]
    [<a href="../../de/html/ref-fileDesc.html">Deutsch</a>]
    [<a href="../../es/html/ref-fileDesc.html">Español</a>]
    [<a href="../../it/html/ref-fileDesc.html">Italiano</a>]
    [<a href="../../fr/html/ref-fileDesc.html">Français</a>]
    [<a href="../../ja/html/ref-fileDesc.html">日本語</a>]
    [<a href="../../ko/html/ref-fileDesc.html">한국어</a>]
    [<a href="../../zh-TW/html/ref-fileDesc.html">中文</a>]
    </p><hr /><div class="footer"><a class="plain" href="http://www.tei-c.org/About/">TEI Consortium</a> | <a class="plain" href="http://www.tei-c.org/About/contact.xml">Feedback</a></div><hr /><address><br />TEI Guidelines <a class="link_ref" href="AB.html#ABTEI4">Version</a> <a class="link_ref" href="../../readme-3.1.1.html">3.1.1a</a>. Last updated on <span class="date">10th May 2017</span>, revision <a class="link_ref" href="https://github.com/TEIC/TEI/commit/bd8dda3">bd8dda3</a>. This page generated on 2017-05-12T12:30:09Z.</address></div></body></html>
back to top