<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title type="main">TEI by Example</title>
        <title type="sub">Module 2: The TEI Header</title>
        <author xml:id="RvdB">Ron Van den Branden</author>
        <editor xml:id="EV">Edward Vanhoutte</editor>
        <editor xml:id="MT">Melissa Terras</editor>
        <sponsor>Association for Literary and Linguistic Computing (ALLC)</sponsor>
        <sponsor>Centre for Data, Culture and Society, University of Edinburgh, UK</sponsor> 
        <sponsor>Centre for Digital Humanities (CDH), University College London, UK</sponsor>
        <sponsor>Centre for Computing in the Humanities (CCH), King’s College London, UK</sponsor>
        <sponsor>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</sponsor>
        <funder>
          <address>
            <addrLine>Centre for Scholarly Editing and Document Studies (CTB)</addrLine>
            <addrLine>Royal Academy of Dutch Language and Literature</addrLine>
            <addrLine>Koningstraat 18</addrLine>
            <addrLine>9000 Gent</addrLine>
            <addrLine>Belgium</addrLine>
          </address>
          <email>ctb@kantl.be</email>
        </funder>
        <principal>Edward Vanhoutte</principal>
        <principal>Melissa Terras</principal>
      </titleStmt>
      <publicationStmt>
        <publisher>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</publisher>
        <distributor>Centre for Scholarly Editing and Document Studies (CTB) , Royal Academy of Dutch Language and Literature, Belgium</distributor>
        <pubPlace>Gent</pubPlace>
        <address>
          <addrLine>Centre for Scholarly Editing and Document Studies (CTB)</addrLine>
          <addrLine>Royal Academy of Dutch Language and Literature</addrLine>
          <addrLine>Koningstraat 18</addrLine>
          <addrLine>9000 Gent</addrLine>
          <addrLine>Belgium</addrLine>
        </address>
        <availability status="free">
          <p>Licensed under a <ref target="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution ShareAlike 3.0 License</ref>
                    </p>
        </availability>
        <date when="2010-07-09">9 July 2010</date>
      </publicationStmt>
      <seriesStmt>
        <title>TEI by Example.</title>
        <respStmt>
          <name>Edward Vanhoutte</name>
          <resp>editor</resp>
        </respStmt>
        <respStmt>
          <name>Ron Van den Branden</name>
          <resp>editor</resp>
        </respStmt>
        <respStmt>
          <name>Melissa Terras</name>
          <resp>editor</resp>
        </respStmt>
      </seriesStmt>
      <sourceDesc>
        <p>Digitally born</p>
      </sourceDesc>
    </fileDesc>
    <encodingDesc>
      <projectDesc>
        <p>TEI by Example offers a series of freely available online tutorials walking individuals through the different stages in marking up a document in TEI (Text Encoding Initiative). Besides a general introduction to text encoding, step-by-step tutorial modules provide example-based introductions to eight different aspects of electronic text markup for the humanities. Each tutorial module is accompanied with a dedicated examples section, illustrating actual TEI encoding practice with real-life examples. The theory of the tutorial modules can be tested in interactive tests and exercises.</p>
      </projectDesc>
    </encodingDesc>
    <profileDesc>
      <langUsage>
        <language ident="en-GB">en-GB</language>
      </langUsage>
    </profileDesc>
    <revisionDesc>
      <change when="2020-06-19" who="#RvdB">technical revision</change>
      <change when="2010-07-14" who="#RvdB">corrected significant typo (<gi>biblStruct</gi> for <gi>biblFull</gi>), removed <gi>ref</gi> around <gi>gi</gi>
            </change>
      <change when="2010-07-09" who="#RvdB">release</change>
      <change when="2009-09-28" who="#RvdB">corrected typos + examples</change>
      <change when="2009-08-18" who="#RvdB">creation</change>
    </revisionDesc>
  </teiHeader>
  <text xml:id="TBED02v00" type="tutorials">
    <body>
            <div xml:id="complexHeader">
        <head>The Header of a Complex Text</head>
        <p>Before we end, let’s go back to where we left you: the library, in front of the library catalogue or computer screen. Prepared for the possibility that this copy of the book may be in loan, you find another reference to <title level="m">The Wild Ass’s Skin</title> in the record of <title level="s">La Comédie Humaine</title> (look for <q>505 8 0 |gPhilosophic and analytic studies: v. 41. The|tmagic skin</q>; <title level="m">The Magic Skin</title> is an alternative title for the English translation):
          <figure xml:id="figure4">
            <graphic url="../../../images/tutorials/TBED02v00/comedie_cat.jpg"/>
            <head type="legend">A <ref target="https://catalogue.nla.gov.au/Record/3724946/Details">library catalogue record</ref> for a complex work.</head>
          </figure>
        </p>
        <p>Now <emph>that</emph>’s a record! If you thought the truckload of possibilities for the description of electronic texts in the TEI header set your head spinning already, imagine what an electronic edition of <title level="s">La Comédie Humaine</title> might look like! Code 300 tells us that it has no less than 53 volumes, with different titles per volume.</p>
        <p>One way of encoding this majestic work as a whole would be to treat <title level="s">La Comédie Humaine</title> as a kind of <soCalled>supertext</soCalled> containing all different works. This can be done in TEI by treating the whole as a <gi>teiCorpus</gi>, containing each separate work in its own <gi>TEI</gi> text. As each of these <gi>TEI</gi> texts needs its own TEI header, you can imagine the amount of meta-information, much of which will have to be repeated. This can be avoided by placing the common meta-information in the <gi>teiHeader</gi> element of the <gi>teiCorpus</gi> element, while retaining all work-specific meta-information in the TEI header section of the respective <gi>TEI</gi> text. This mechanism allows you to be maximally expressive in the description of all texts in a TEI corpus, <emph>and</emph> maximally efficient in the reduction of common information in the individual TEI headers.</p>
        <p>The following example gives an impression of what a TEI header for an electronic edition of <title level="s">La Comédie Humaine</title> might look like:
          <figure xml:id="example39">
            <egXML xmlns="http://www.tei-c.org/ns/Examples">
              <teiCorpus>
                <!-- general TEI header information or the entire corpus -->
                <teiHeader>
                  <fileDesc>
                    <titleStmt>
                      <title>La Comédie Humaine</title>
                      <author xml:id="HdB">Honoré de Balzac</author>
                      <editor role="editor" xml:id="TBEcrew">The TBE crew</editor>
                      <respStmt>
                        <name xml:id="RvdB">Ron Van den Branden</name>
                        <resp>transcription</resp>
                        <resp>annotation</resp>
                      </respStmt>
                      <sponsor>Association for Literary and Linguistic Computing (ALLC)</sponsor>
        <sponsor>Centre for Data, Culture and Society, University of Edinburgh, UK</sponsor> 
                      <sponsor>Centre for Computing in the Humanities (CCH) - King's College London</sponsor>
                      <sponsor>University College London (UCL)</sponsor>
                      <funder>
                        <address>
                          <addrLine>Centre for Scholarly Editing and Document Studies (CTB)</addrLine>
                          <addrLine>Royal Academy of Dutch Language and Literature</addrLine>
                          <addrLine>Koningstraat 18</addrLine>
                          <addrLine>9000 Gent</addrLine>
                          <addrLine>Belgium</addrLine>
                        </address>
                        <email>ctb@kantl.be</email>
                      </funder>
                      <principal xml:id="EV">Edward Vanhoutte</principal>
                      <principal xml:id="MT">Melissa Terras</principal>
                    </titleStmt>
                    <extent>0.5 Gb</extent>
                    <publicationStmt>
                      <publisher>Centre for Scholarly Editing and Document Studies (CTB)</publisher>
                      <distributor>Centre for Computing in the Humanities (CCH) - King's College London</distributor>
                      <pubPlace>Gent</pubPlace>
                      <address>
                        <name type="institution">Centre for Scholarly Editing and Document Studies (CTB)</name>
                        <name type="institution">Royal Academy of Dutch Language and Literature</name>
                        <street>Koningstraat 18</street>
                        <postCode>9000</postCode>
                        <name type="city">Gent</name>
                        <name type="country">Belgium</name>
                      </address>
                      <idno type="ISBN">0-00-000000-9</idno>
                      <availability status="free">
                        <licence>Published under a <ref target="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution ShareAlike 3.0 License</ref>.</licence>
                      </availability>
                      <date when="2110-01-01">1 January 2110</date>
                    </publicationStmt>
                    <seriesStmt>
                      <title>The TBE collection: sample texts encoded with TEI.</title>
                      <respStmt>
                        <name>Edward Vanhoutte</name>
                        <resp>compiler</resp>
                      </respStmt>
                      <idno type="ISSN">0000-0001</idno>
                    </seriesStmt>
                    <notesStmt>
                                            <note>OCR scanning done at KANTL, Ghent.</note>
                                        </notesStmt>
                    <sourceDesc>
                      <bibl>
                                                <title>La Comédie Humaine</title> by <author>Honoré de Balzac</author>. <pubPlace>London</pubPlace> : <publisher>Caxton</publisher>, <date from="1895" to="1900">1895-1900</date>. <extent>53 v.</extent>.</bibl>
                    </sourceDesc>
                  </fileDesc>
                  <encodingDesc>
                    <editorialDecl>
                      <correction method="markup">
                        <p>Apparent errors have been corrected using the <gi>sic</gi>&gt; <gi>corr</gi> elements, wrapped in a <gi>choice</gi> element.</p>
                      </correction>
                      <normalization method="markup" source="http://www.oed.com/">
                        <p>Spelling has been modernised using the <gi>orig</gi> / <gi>reg</gi> elements, wrapped in a <gi>choice</gi> element.</p>
                      </normalization>
                      <quotation marks="all">
                        <p>Diplomatic transcription, all original quotation marks have been retained and normalised to double quotation marks.</p>
                      </quotation>
                      <hyphenation eol="none">
                        <p>End-of-line hyphenation has been removed. All other hyphenation has been retained.</p>
                      </hyphenation>
                      <interpretation>
                        <p>Thematic analysis added, studying the main motifs.</p>
                        <p>Names and dates are marked.</p>
                      </interpretation>
                    </editorialDecl>
                    <projectDesc>
                      <p>Text encoded for <soCalled>The TBE collection: sample texts encoded with TEI</soCalled>, aiming at providing a collection of prime exemplar TEI encoded materials.</p>
                    </projectDesc>
                    <refsDecl>
                      <p>The paragraphs in the text are numbered with the <att>n</att> attribute. Each number consists of four digits; numbering is consecutive throughout the book. For example: <val>0203</val> numbers the 203th paragraph throughout the book.</p>
                      <p>Each chapter is identified with a formal identification code inside the <att>xml:id</att> attribute. Chapters are numbered using arabic numerals. The codes are composed by concatenating the identification codes for all ancestor text divisions down to the chapter level, with the dot as separation marker. For example: <val>I.2.3</val> identifies the third chapter of the second book of the first volume.</p>
                    </refsDecl>
                    <classDecl>
                      <taxonomy xml:id="DDC">
                        <bibl>
                          <title>Dewey Decimal Classification</title>
                          <edition>Abridged Edition 14</edition>
                          <ptr target="http://www.oclc.org/dewey/versions/abridgededition14/default.htm"/>
                        </bibl>
                      </taxonomy>
                      <taxonomy xml:id="lcsh">
                        <bibl>
                                                    <title>Library of Congress Subject Headings</title>
                                                </bibl>
                      </taxonomy>
                    </classDecl>
                    <metDecl>
                      <metSym value="-">long syllable</metSym>
                      <metSym value="u">short syllable</metSym>
                      <metSym value="|">foot boundary</metSym>
                      <metSym value="/">line boundary</metSym>
                    </metDecl>
                    <variantEncoding method="parallel-segmentation" location="internal"/>
                  </encodingDesc>
                  <profileDesc>
                    <langUsage>
                      <language ident="en" usage="98">English</language>
                      <language ident="fr" usage="1">French</language>
                      <language ident="ar" usage="1">Arabic</language>
                    </langUsage>
                  </profileDesc>
                  <revisionDesc>
                    <change when="2109-12-20" who="#RvdB">final proofing</change>
                    <change when="2009-03-08" who="#MT">addition of thematic analysis</change>
                    <change when="2009-03-08" who="#RvdB">addition of explanatory notes</change>
                    <change when="2008-10-25" who="#Rvdb">spell check</change>
                    <change when="2008-08-25" who="#Rvdb">addition of phrase level markup</change>
                    <change when="2008-08-20" who="#Rvdb">file creation</change>
                  </revisionDesc>
                </teiHeader>
                <!-- ... -->
                <TEI>
                  <!-- specific TEI header information for the distinct TEI documents -->
                  <teiHeader>
                    <fileDesc>
                      <titleStmt>
                        <title>The Wild Ass’s Skin: an electronic edition</title>
                        <editor role="translator" xml:id="EM">Ellen Marriage</editor>
                        <editor role="preface" xml:id="GS">George Saintsbury</editor>
                      </titleStmt>
                      <editionStmt>
                        <edition n="2.0">
                                                    <title>Version 2.0, enriched with thematic annotations.</title>
                                                    <date when="2010">2010</date>
                                                </edition>
                        <respStmt>
                          <name>Melissa Terras</name>
                          <resp>Added thematic annotations.</resp>
                        </respStmt>
                      </editionStmt>
                      <extent>572 Kb</extent>
                      <publicationStmt>
                        <idno type="ISBN">0-00-000000-0</idno>
                        <date when="2010-01-01">1 January 2010</date>                
                      </publicationStmt>
                      <sourceDesc>
                        <bibl>
                                                    <title>The Wild Ass’s Skin</title> by <author>Honoré de Balzac</author>. <pubPlace>London</pubPlace> : <publisher>Dent</publisher>, <date when="1906">1906</date>. <extent>xv</extent>, <extent>288 p.</extent>. Translated by <editor role="translator">Ellen Marriage</editor> ; preface by <editor role="preface">George Saintsbury</editor>.</bibl>
                      </sourceDesc>
                    </fileDesc>
                    <profileDesc>
                      <creation>Original written in <date when="1831">1831</date> in <name type="city">Paris</name>.</creation>
                      <langUsage>
                        <language ident="en" usage="98">English</language>
                        <language ident="fr" usage="1">French</language>
                        <language ident="ar" usage="1">Arabic</language>
                      </langUsage>
                      <textClass>
                        <keywords scheme="#lcsh">
                          <list>
                            <item>Literature</item>
                            <item>Fiction and juvenile belles lettres</item>
                            <item>Literature--Translations into English</item>
                          </list>
                        </keywords>
                        <classCode scheme="#DDC">843.7</classCode>
                        <catRef target="#BCS.phil" scheme="#BCS"/>
                      </textClass>
                      <handNotes>
                        <handNote xml:id="JH" scribe="JamesHarding" script="hand" medium="ink.blue">handwriting in blue ink by James Harding, previous owner of the book</handNote>
                        <handNote xml:id="ar" script="arabic">Arabic script</handNote>
                      </handNotes>
                    </profileDesc>
                    <revisionDesc>
                      <change when="2009-03-08" who="#MT">addition of thematic analysis</change>
                      <change when="2009-03-08" who="#RvdB">addition of explanatory notes</change>
                      <change when="2008-10-25" who="#RvdB">spell check</change>
                      <change when="2008-08-25" who="#RvdB">addition of phrase level markup</change>
                      <change when="2008-08-20" who="#RvdB">file creation</change>
                    </revisionDesc>
                  </teiHeader>
                  <text>
                    <!-- ... -->
                  </text>
                </TEI>
                <!-- ... -->
              </teiCorpus>                        
            </egXML>
            <head type="legend">Encoding common metadata of a composite work in the <gi>teiHeader</gi> of a <gi>teiCorpus</gi> element.</head>
          </figure>
        </p>
        <note>The TEI Guidelines provide refined ways of associating contextual information with specific (parts of) texts. See section <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAS">15.3 Associating Contextual Information with a Text</ref> for more information.</note>
        <note type="summary">A complex text encoded as a <gi>teiCorpus</gi> should have a <gi>teiHeader</gi> in its own right. This TEI header on the corpus level can contain the general descriptive information about all corpus texts embedded as <gi>TEI</gi> documents. Each corpus text then should have its own <gi>teiHeader</gi>, describing only those aspects that are specific to that text.</note>
      </div>
        </body>
  </text>
  <!-- 
        $Date: 2020-07-08 02:33:20 +0200 (Wed, 08 Jul 2020) $
        $Id: TBED02v00.xml 425 2020-07-08 00:33:20Z ron.vandenbranden $  -->
</TEI>