<TEI xmlns="http://www.tei-c.org/ns/1.0">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title type="main">TEI by Example</title>
        <title type="sub">Module 8: Customising TEI, ODD, Roma</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>
        <editor>Edward Vanhoutte</editor>
        <editor>Ron Van den Branden</editor>
        <editor>Melissa Terras</editor>
      </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 practise 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-28" who="#RvdB">integrated examples in a single file</change>
    </revisionDesc>
  </teiHeader>
  <text xml:id="TBED08v00" type="examples">
    <body>
            <div xml:id="numbereddivs" type="example">
        <head>Abolishing Numbered Text Divisions</head>
        <p>Following ODD file defines a minimal TEI schema (containing the <ident type="module">core</ident>, <ident type="module">tei</ident>, <ident type="module">header</ident>, and <ident type="module">textstructure</ident> modules). Besides that, it does away with numbered text divisions (<gi>div1</gi>, ..., <gi>div7</gi>) by specifying the value <val>delete</val> for the <att>mode</att> attribute on their respective <gi>elementSpec</gi> declarations.</p>
        <p>Notice that strictly speaking, only deletion of <gi>div1</gi> is necessary, as all further numbered subdivisions should nest according to the TEI scheme. By definition, if the topmost level is deleted, all further subdivisions are practically excluded from the document model. Although they are still declared, they can’t be used in documents according to this schema. Additionally, notice how this list of separate <gi>elementSpec</gi> instructions could be expressed more concisely as:
          <egXML xmlns="http://www.tei-c.org/ns/Examples">
            <moduleRef key="textstructure" except="div1 div2 div3 div4 div5 div6 div7"/>
          </egXML>
        </p>
        
        <figure xml:id="numbereddivs-example">
          <egXML xmlns="http://www.tei-c.org/ns/Examples">
            <TEI xmlns="http://www.tei-c.org/ns/1.0_TBEeg_" xml:lang="en">
              <teiHeader>
                <fileDesc>
                  <titleStmt>
                    <title>numbered divisions</title>
                    <author>The TBE crew</author>
                  </titleStmt>
                  <publicationStmt>
                    <p>for use by whoever wants it</p>
                  </publicationStmt>
                  <sourceDesc>
                    <p>no source, born digital</p>
                  </sourceDesc>
                </fileDesc>
              </teiHeader>
              <text>
                <front>
                  <divGen type="toc"/>
                </front>
                <body>
                  <p>This customisation only selects the minimal TEI modules, and deletes all numbered subdivisions.</p>
                  <schemaSpec ident="numDiv" xml:lang="en">
                    <moduleRef key="core"/>
                    <moduleRef key="tei"/>
                    <moduleRef key="header"/>
                    <moduleRef key="textstructure"/>
                    <elementSpec module="textstructure" ident="div1" mode="delete"/>
                    <elementSpec module="textstructure" ident="div2" mode="delete"/>
                    <elementSpec module="textstructure" ident="div3" mode="delete"/>
                    <elementSpec module="textstructure" ident="div4" mode="delete"/>
                    <elementSpec module="textstructure" ident="div5" mode="delete"/>
                    <elementSpec module="textstructure" ident="div6" mode="delete"/>
                    <elementSpec module="textstructure" ident="div7" mode="delete"/>
                  </schemaSpec>
                </body>
              </text>
            </TEI>
          </egXML>
          <head type="legend">TBE-crafted example encoding, no material source.</head>
        </figure>
      </div>
        </body>
    <back>
      <div type="bibliography">
        <listBibl>
          <bibl xml:id="jtei2014">
                        <author>Van den Branden, Ron</author> and <author>Martin Holmes</author>. <date>2014</date>. <title level="u">Journal of the Text-Encoding Initiative Article Schema. Schema and guidelines for encoding an article for the journal.</title> <ptr target="https://tei-c.org/guidelines/customization/jtei/"/>.</bibl>
        </listBibl>
      </div>
    </back>
  </text>
  <!-- 
      $Date: 2020-07-08 02:33:20 +0200 (Wed, 08 Jul 2020) $
      $Id: TBED08v00.xml 425 2020-07-08 00:33:20Z ron.vandenbranden $  -->
</TEI>