<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="../../lib/atmo-odd.xsl"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:lang="en">
  <teiHeader>
    <fileDesc>
      <titleStmt>
        <title>Digital facsimiles for ATMO v1</title>
        <author xml:id="CMSMcQ">C. M. Sperberg-McQueen</author>
        <sponsor>Annotated Turki Manuscripts from the Jarring Collection Online</sponsor>
        <principal>Arienne M. Dwyer</principal>
        <principal>C. M. Sperberg-McQueen</principal>
        <funder>Henry Luce Foundation</funder>
      </titleStmt>
      <publicationStmt>
        <authority>Annotated Turki Manuscripts from the Jarring Collection Online</authority>
        <pubPlace>Lawrence, Kansas</pubPlace>
        <date>2015</date>
        <availability>
          <licence>
            <p><ref type="license" target="http://creativecommons.org/licenses/by-sa/4.0/"><graphic
                  rend="border-width:0" url="https://i.creativecommons.org/l/by-sa/4.0/88x31.png"
                /></ref></p>
            <p>This ODD specification of a TEI-based schema for digital facsimiles, by C. M.
              Sperberg-McQueen and the project Annotated Turki Manuscripts from the Jarring
              Collection Online, is licensed under a <ref type="license"
                target="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons
                Attribution-ShareAlike 4.0 International License</ref> Permissions beyond the scope
              of this license may be available at <ref
                target="http://uyghur.linguistics.indiana.edu/2015/atmo-licensing.xhtml"
                >http://uyghur.linguistics.indiana.edu/2015/atmo-licensing.xhtml</ref>.</p></licence>
        </availability>
      </publicationStmt>
      <notesStmt>
        <note type="ns">http://uyghur.linguistics.indiana.edu/ns/ATMOv1</note>
      </notesStmt>
      <sourceDesc>
        <p>Created in electronic form; no source to describe.</p>
      </sourceDesc>
    </fileDesc>
    <revisionDesc>
      <change who="#CMSMcQ" when="2015-12-09">Test, supply rudimentary text.</change>
      <change who="#CMSMcQ" when="2015-11-21">Revise, copy edit.</change>
      <change who="#CMSMcQ" when="2015-11-20">Made initial version of this ODD document, adapted
        from Roma.</change>
    </revisionDesc>
  </teiHeader>
  <text>
    <front>
      <titlePage>
        <docTitle>
          <titlePart>TEI customization for digital facsimiles</titlePart>
        </docTitle>

        <docAuthor>C. M. Sperberg-McQueen, Black Mesa Technologies LLC</docAuthor>
        <docDate>20 November 2015, rev. 9 December 2015</docDate>
        <titlePart><idno>ATMO Technical report 2015-02</idno></titlePart>

      </titlePage>

      <div xml:id="navbar" type="navbar">
        <head>Nearby documents</head>
        <list>
          <!--* <item><xref href="online.html">Online interface to Thutmose II</xref></item>
      <item><xref href="progdoc.xml">Programmers' documentation</xref></item>
    *-->
          <item xml:id="siteroot"><ref target="./../..">Home</ref></item>
        </list>
        <divGen type="toc"/>
      </div>

    </front>
    <body>
      <p>This document presents a schema for digital facsimiles, developed for the project
        "Annotated Turki Manuscripts from the Jarring Collection Online".  The reader is
        assumed to have either a working knowledge of TEI markup, a willingness to learn
        about TEI markup by consulting the TEI <title>Guidelines</title>, or an unusual
        tolerance for tedium.  For the use of the first two classes of reader, 
        references to TEI elements are throughout this document hyperlinked to their 
        reference documentation on the TEI's web site; the reference documentation in 
        turn is linked to the prose description of the element in context.  Readers who
        wish to see how the TEI defines any element are expected to follow the hyperlinks;
        no attempt will be made to document any TEI elements here.
      </p>

      <note place="block">
	<p>In its current state, this document is thought to be complete (that is,
	it isn't known to be missing any major parts or sections) but may have
	errors.  The schema specified here has not yet been thoroughly tested.</p>
      </note>

      <div xml:id="docstruc">
        <head>Basic structure of digital facsimiles</head>
        <p>A TEI <term>digital facsimile</term> is a TEI document containing a header and a sequence
          of page images; it is a very simple way to group the scans of a single manuscript together
          and link them to appropriate metadata. </p>
        <p>The general structure of a digital facsimile is a TEI header (containing a manuscript
        description) followed by a <gi>facsimile</gi> element, thus:
          <egXML xmlns="http://www.tei-c.org/ns/Examples"
><![CDATA[<tei:TEI xmlns:tei="http://www.tei-c.org/ns/1.0">
  <tei:teiHeader>
    <tei:fileDesc>
      <!--* bibliographic description of digital facsimile *-->
      <tei:titleStmt> ... </tei:titleStmt>
      <tei:editionStmt> ... </tei:editionStmt>
      <tei:extent> ... </tei:extent>
      <tei:publicationStmt> ... </tei:publicationStmt>
      <tei:sourceDesc>
        <!--* Description of source of this digital facsimile, 
            * i.e. of the source manuscript *-->
        <tei:msDesc>
          ...
        </tei:msDesc>
      </tei:sourceDesc>
    </tei:fileDesc>
  </tei:teiHeader>
  <tei:facsimile>
    <tei:graphic n="1" url="..."/>
    <tei:graphic n="2" url="..."/>
    ...
  </tei:facsimile>
</tei:TEI>            
          ]]></egXML>
        </p>
        <p>As can be seen, the body of the document is very simple, consisting only of the
        <gi>facsimile</gi> and <gi>graphic</gi> elements.  Almost all of the elements in the
        schema we need to build will be for the TEI header.  Since the header can contain
        prose descriptions of the manuscript and its digitization, however, many elements
        which one normally thinks of as belonging to the TEI body (for example <gi>p</gi> and
        its contents) are needed here.</p>
      </div>
      <div xml:id="schema-specifications">
        <head>Construction of the schema</head>
        <div xml:id="startingpoint">
          <head>The overall module structure</head>
          <p>The starting point is formed by the modules tei, core, textstructure, and header,
            to which we add the modules for names and dates, manuscript descriptions, and 
            primary sources.  The tei and manuscript description modules are included
            in full; the others are included selectively.
          </p>
          <schemaSpec ident="digifacs.v1" docLang="en" prefix="tei_" xml:lang="en">
            <moduleRef key="tei" except=""/>
            <moduleRef key="msdescription" except=""/>

            <specGrpRef target="#header-inclusion"/>
            <specGrpRef target="#core-inclusion"/>
            <specGrpRef target="#text-structure-inclusion"/>
            <specGrpRef target="#primary-sources-inclusion"/>
            <specGrpRef target="#names-dates-inclusion"/>
          </schemaSpec>
          <p>The manuscript description module includes the following elements.
            For the moment, we include all of them; experience will show whether
            any of them clutter up the menus.
            <list>
              <item><gi>accMat</gi>
                <gi>acquisition</gi>
                <gi>additional</gi>
                <gi>additions</gi>
                <gi>adminInfo</gi>
                <gi>altIdentifier</gi>
                <gi>binding</gi>
                <gi>bindingDesc</gi>
                <gi>catchwords</gi>
                <gi>collation</gi>
                <gi>collection</gi>
                <gi>colophon</gi>
                <gi>condition</gi>
                <gi>custEvent</gi>
                <gi>custodialHist</gi>
                <gi>decoDesc</gi>
                <gi>decoNote</gi>
                <gi>depth</gi>
                <gi>dim</gi>
                <gi>dimensions</gi>
                <gi>explicit</gi>
                <gi>filiation</gi>
                <gi>finalRubric</gi>
                <gi>foliation</gi>
                <gi>handDesc</gi>
                <gi>height</gi>
                <gi>heraldry</gi>
                <gi>history</gi>
                <gi>incipit</gi>
                <gi>institution</gi>
                <gi>layout</gi>
                <gi>layoutDesc</gi>
                <gi>locus</gi>
                <gi>locusGrp</gi>
                <gi>material</gi>
                <gi>msContents</gi>
                <gi>msDesc</gi>
                <gi>msIdentifier</gi>
                <gi>msItem</gi>
                <gi>msItemStruct</gi>
                <gi>msName</gi>
                <gi>msPart</gi>
                <gi>musicNotation</gi>
                <gi>objectDesc</gi>
                <gi>objectType</gi>
                <gi>origDate</gi>
                <gi>origPlace</gi>
                <gi>origin</gi>
                <gi>physDesc</gi>
                <gi>provenance</gi>
                <gi>recordHist</gi>
                <gi>repository</gi>
                <gi>rubric</gi>
                <gi>scriptDesc</gi>
                <gi>seal</gi>
                <gi>sealDesc</gi>
                <gi>secFol</gi>
                <gi>signatures</gi>
                <gi>source</gi>
                <gi>stamp</gi>
                <gi>summary</gi>
                <gi>support</gi>
                <gi>supportDesc</gi>
                <gi>surrogates</gi>
                <gi>typeDesc</gi>
                <gi>watermark</gi>
                <gi>width</gi></item>
            </list>
          </p>
        </div>
        <div xml:id="teiHeader">
          <head>The header module</head>
          <p>We include the header module: 
            <specGrp xml:id="header-inclusion">
              <moduleRef key="header"
                except="refsDecl cRefPattern refState
                correspAction correspContext correspDesc 
                listPrefixDef namespace prefixDef xenoData
                rendition styleDefDecl typeNote"
              />
            </specGrp>
          </p>
          <p>From the header module we exclude declarations for several elements we expect never to
            use: <list>
              <item>           
                <p>The <gi>refsDecl</gi>, <gi>cRefPattern</gi>, and
                  <gi>refState</gi> elements relate to machinery for
                  canonical references; we do not expect to need that
                  machinery.  We will provide canonical numberings for
                  sentences in annotated texts, but do not expect to do so
                  for digital facsimiles.</p>
              </item>
              <item>
                <p>The <gi>correspAction</gi>, <gi>correspContext</gi>, and <gi>correspDesc</gi>
                  elements all relate to collections of letters.</p>
              </item>
              <item>
                <p>The <gi>prefixDef</gi>, <gi>listPrefixDef</gi>, 
                  <gi>namespace</gi>, and <gi>xenoData</gi> elements all
                  relate to technical capabilities of TEI markup which our digital facsimiles will not use.
                </p>
              </item>
              <item>
                <p>
                  The <gi>rendition</gi>, <gi>styleDefDecl</gi>, and
                  <gi>typeNote</gi> elements describe information
                  relevant to the interpretation of the <att>rend</att>
                  attribute; they are irrelevant to facsimiles without
                  transcriptions, and <gi>typeNote</gi> is doubly
                  irrelevant to manuscript facsimiles because it
                  describes printed materials.
                </p>
              </item>
            </list>
          </p>
          
          <p>It may perhaps be more useful to identify the elements in the TEI header module which
            are included, rather than just those which are excluded. 
            These fall into several classes. Those we expect to need most frequently are
            the standard parts of a TEI header and elements we know we will need:
            <list>
              <item>The <gi>teiHeader</gi> encloses the header.</item>
              <item>The <gi>fileDesc</gi>,
                <gi>authority</gi>,
                <gi>availability</gi>,
                <gi>distributor</gi>,
                <gi>edition</gi>,
                <gi>editionStmt</gi>,
                <gi>extent</gi>,
                <gi>funder</gi>,
                <gi>idno</gi>,
                <gi>licence</gi>,
                <gi>notesStmt</gi>,
                <gi>principal</gi>,
                <gi>publicationStmt</gi>,
                <gi>seriesStmt</gi>,
                <gi>sponsor</gi>,
                and 
                <gi>titleStmt</gi>
                elements are all standard elements for the bibliographic
                description of the TEI document itself.</item>
              
              <item>The <gi>sourceDesc</gi> element will contain
                the description of the source manuscript in the
                form of an <gi>msDesc</gi> element.</item>
              
              <item><gi>handNote</gi> is used to describe the hands of
                a manuscript.</item>
              
              <item>The <gi>encodingDesc</gi>, <gi>projectDesc</gi>,
                and <gi>samplingDecl</gi> elements provide basic
                information about the preparation of the digital
                facsimile.
              </item>
              
              <item>The <gi>revisionDesc</gi>,
                <gi>change</gi>, and
                <gi>listChange</gi> elements are used to record the history of the
                TEI document.
              </item>
              
              <item><gi>appInfo</gi> and <gi>application</gi> allow the encoding description
                to include explicit records of automatic processing of the document by software; we
                will use these elements to record the translation of the manuscript descriptions from
                the Master DTD to TEI P5 and the preparation of the scanned images in JPEG form
                from the TIFFs supplied by LUB.</item>
              
              
            </list>
          </p>
          
          <p>Some elements we do not expect to need very often, but include in the schema
            in case we need them, on the theory that having unused elements in the schema
            will cause fewer headaches during the project than lacking an element we need.
            <list>
              <item>The <gi>biblFull</gi> element may be needed for bibliographic data
                within the annotations in the header.</item>
              
              <item>The <gi>profileDesc</gi>,
                <gi>calendar</gi>,
                <gi>calendarDesc</gi>,
                <gi>catRef</gi>,
                <gi>classCode</gi>,
                <gi>creation</gi>,
                <gi>keywords</gi>,
                <gi>langUsage</gi>,
                <gi>language</gi>, and
                <gi>textClass</gi>
                elements describe the text(s) contained in the manuscript, in general
                terms. We will not use them in the initial description of any manuscript,
                but if we enhance the metadata for any manuscript, these elements are likely to 
                be useful.</item>
              <item>In the <gi>encodingDesc</gi> element, the 
                <gi>catDesc</gi>,
                <gi>category</gi>,
                <gi>classDecl</gi>,
                <gi>geoDecl</gi>,
                <gi>tagUsage</gi>,
                <gi>tagsDecl</gi>, and
                <gi>taxonomy</gi>
                elements may be useful for enriched manuscript descriptions; they won't
                be part of the initial representation.
              </item>              
            </list>
          </p>
          
          <p>Some elements should perhaps be suppressed; further thought is needed.
            <list>              
              <item><gi>abstract</gi></item>
              <item><gi>scriptNote</gi></item>
              <item>The <gi>editorialDecl</gi>,
                <gi>correction</gi>,
                <gi>hyphenation</gi>,
                <gi>interpretation</gi>,
                <gi>normalization</gi>,
                <gi>punctuation</gi>,
                <gi>quotation</gi>,
                <gi>segmentation</gi>, and
                <gi>stdVals</gi> elemetns are all relevant for 
                transcriptions, not digital facsimiles.</item>
            </list>
          </p>
        </div>
        <div xml:id="core-module">
          <head>The core module</head>
         <specGrp xml:id="core-inclusion">           
           <moduleRef key="core" except="cb gb lb pb said sp speaker stage teiCorpus"/>
         </specGrp>
          <p>The core module includes:
            <list>
              <item><gi>abbr</gi>
                <gi>add</gi>
                <gi>addrLine</gi>
                <gi>address</gi>
                <gi>analytic</gi>
                <gi>author</gi>
                <gi>bibl</gi>
                <gi>biblScope</gi>
                <gi>biblStruct</gi>
                <gi>binaryObject</gi>
                <gi>choice</gi>
                <gi>cit</gi>
                <gi>citedRange</gi>
                <gi>corr</gi>
                <gi>date</gi>
                <gi>del</gi>
                <gi>desc</gi>
                <gi>distinct</gi>
                <gi>divGen</gi>
                <gi>editor</gi>
                <gi>email</gi>
                <gi>emph</gi>
                <gi>expan</gi>
                <gi>foreign</gi>
                <gi>gap</gi>
                <gi>gloss</gi>
                <gi>graphic</gi>
                <gi>head</gi>
                <gi>headItem</gi>
                <gi>headLabel</gi>
                <gi>hi</gi>
                <gi>imprint</gi>
                <gi>index</gi>
                <gi>item</gi>
                <gi>l</gi>
                <gi>label</gi>
                <gi>lg</gi>
                <gi>list</gi>
                <gi>listBibl</gi>
                <gi>measure</gi>
                <gi>measureGrp</gi>
                <gi>media</gi>
                <gi>meeting</gi>
                <gi>mentioned</gi>
                <gi>milestone</gi>
                <gi>monogr</gi>
                <gi>name</gi>
                <gi>note</gi>
                <gi>num</gi>
                <gi>orig</gi>
                <gi>p</gi>
                <gi>postBox</gi>
                <gi>postCode</gi>
                <gi>ptr</gi>
                <gi>pubPlace</gi>
                <gi>publisher</gi>
                <gi>q</gi>
                <gi>quote</gi>
                <gi>ref</gi>
                <gi>reg</gi>
                <gi>relatedItem</gi>
                <gi>resp</gi>
                <gi>respStmt</gi>
                <gi>rs</gi>
                <gi>series</gi>
                <gi>sic</gi>
                <gi>soCalled</gi>
                <gi>street</gi>
                <gi>term</gi>
                <gi>textLang</gi>
                <gi>time</gi>
                <gi>title</gi>
                <gi>unclear</gi>
              </item>
            </list>
          </p>
          <p>We exclude the following on the assumption that we will never need them in the
          headers of digital facsimiles:
            <gi>cb</gi>
            <gi>gb</gi>
            <gi>lb</gi>
            <gi>pb</gi>
            <gi>said</gi>
            <gi>sp</gi>
            <gi>speaker</gi>
            <gi>stage</gi>
            <gi>teiCorpus</gi>
          </p>
          </div>
        
        <div xml:id="text-structure-exclusions">
          <head>The text-structure module</head>
          <p>The basic text-structure module defines elements used in structuring the text, such as
            <gi>div</gi> and related elements; it also includes title pages and material that often
            appears there, as well as the essential <gi>TEI</gi> element.
            <specGrp xml:id="text-structure-inclusion">
              <moduleRef key="textstructure"
                except="argument back body byline closer dateline 
                div div1 div2 div3 div4 div5 div6 div7 
                epigraph floatingText front group imprimatur 
                opener postscript salute signed text titlePage titlePart trailer"
              />
            </specGrp></p>
          <p>The following elements of this module are included in our digital facsimile schema: <list>
              <item><gi>TEI</gi></item>
              <item><gi>docAuthor</gi></item>
              <item><gi>docDate</gi></item>
              <item><gi>docEdition</gi></item>
              <item><gi>docImprint</gi></item>
              <item><gi>docTitle</gi></item>
            </list>
          </p>
          <p>These elements are excluded: <gi>argument</gi>
            <gi>back</gi>
            <gi>body</gi>
            <gi>byline</gi>
            <gi>closer</gi>
            <gi>dateline</gi>
            <gi>div</gi>
            <gi>div1</gi>
            <gi>div2</gi>
            <gi>div3</gi>
            <gi>div4</gi>
            <gi>div5</gi>
            <gi>div6</gi>
            <gi>div7</gi>
            <gi>epigraph</gi>
            <gi>floatingText</gi>
            <gi>front</gi>
            <gi>group</gi>
            <gi>imprimatur</gi>
            <gi>opener</gi>
            <gi>postscript</gi>
            <gi>salute</gi>
            <gi>signed</gi>
            <gi>text</gi>
            <gi>titlePage</gi>
            <gi>titlePart</gi>
            <gi>trailer</gi>
          </p>
        </div>
        <div xml:id="primary-sources-exclusions">
          <head>The primary-sources module</head>
          <p>From the basic primary-sources module we exclude declarations for several elements we
            expect never to use: <specGrp xml:id="primary-sources-inclusion">
              <moduleRef key="transcr"
                except="addSpan am damage damageSpan delSpan ex fw 
                handNotes handShift line listTranspose metamark 
                mod redo restore retrace secl sourceDoc space 
                subst substJoin supplied surplus transpose undo zone"
              />
            </specGrp></p>
          <p>The digital facsimile schema includes the following elements of this module: <list>
              <item><gi>facsimile</gi></item>
              <item><gi>surface</gi></item>
              <item><gi>surfaceGrp</gi></item>
            </list>
            The <gi>surface</gi> and <gi>surfaceGrp</gi> elements are not expected
            to be used except in the case where there are multiple images of the same
            opening or writing surface.
          </p>
          <p>The following elements are excluded as relevant to transcriptions but not to
            digital facsimiles:
              <gi>addSpan</gi>
              <gi>am</gi>
              <gi>damage</gi>
              <gi>damageSpan</gi>
              <gi>delSpan</gi>
              <gi>ex</gi>
              <gi>facsimile</gi>
              <gi>fw</gi>
              <gi>handNotes</gi>
              <gi>handShift</gi>
              <gi>line</gi>
              <gi>listTranspose</gi>
              <gi>metamark</gi>
              <gi>mod</gi>
              <gi>redo</gi>
              <gi>restore</gi>
              <gi>retrace</gi>
              <gi>secl</gi>
              <gi>sourceDoc</gi>
              <gi>space</gi>
              <gi>subst</gi>
              <gi>substJoin</gi>
              <gi>supplied</gi>
              <gi>surface</gi>
              <gi>surfaceGrp</gi>
              <gi>surplus</gi>
              <gi>transpose</gi>
              <gi>undo</gi>
              <gi>zone</gi>
          </p>
        </div>
        <div xml:id="names-dates-exclusions">
          <head>The names and dates module</head>
          <p>We include the module for names and dates because it includes elements for country and
            city (<gi>settlement</gi>), which we need. We exclude most of the rest of it. <specGrp
              xml:id="names-dates-inclusion">
              <moduleRef key="namesdates"
                except="age birth climate death education event 
                faith floruit langKnowledge langKnown listEvent 
                offset population residence sex socecStatus state 
                terrain trait"
              />
            </specGrp>
          </p>
          <p>We include the following elements of this module, primarily for use in
            identifying individuals and organizations involved in the creation either of
            the manuscript or of the digitization:<list>
              <item><gi>addName</gi></item>
	      <item><gi>affiliation</gi></item>
	      <item><gi>bloc</gi></item>
	      <item><gi>country</gi></item>
	      <item><gi>district</gi></item>
	      <item><gi>forename</gi></item>
	      <item><gi>genName</gi></item>
	      <item><gi>geo</gi></item>
	      <item><gi>geogFeat</gi></item>
	      <item><gi>geogName</gi></item>
	      <item><gi>listNym</gi></item>
	      <item><gi>listOrg</gi></item>
	      <item><gi>listPerson</gi></item>
	      <item><gi>listPlace</gi></item>
	      <item><gi>listRelation</gi></item>
	      <item><gi>location</gi></item>
	      <item><gi>nameLink</gi></item>
	      <item><gi>nationality</gi></item>
	      <item><gi>nym</gi></item>
	      <item><gi>occupation</gi></item>
	      <item><gi>org</gi></item>
	      <item><gi>orgName</gi></item>
	      <item><gi>persName</gi></item>
	      <item><gi>person</gi></item>
	      <item><gi>personGrp</gi></item>
	      <item><gi>place</gi></item>
	      <item><gi>placeName</gi></item>
	      <item><gi>region</gi></item>
	      <item><gi>relation</gi></item>
	      <item><gi>roleName</gi></item>
	      <item><gi>settlement</gi></item>
	      <item><gi>surname</gi></item>
            </list>
          </p>
          <p>We exclude the following:
            <gi>age</gi>
            <gi>birth</gi>
            <gi>climate</gi>
            <gi>death</gi>
            <gi>education</gi>
            <gi>event</gi>
            <gi>faith</gi>
            <gi>floruit</gi>
            <gi>langKnowledge</gi>
            <gi>langKnown</gi>
            <gi>listEvent</gi>
            <gi>offset</gi>
            <gi>population</gi>
            <gi>residence</gi>
            <gi>sex</gi>
            <gi>socecStatus</gi>
            <gi>state</gi>
            <gi>terrain</gi>
            <gi>trait</gi>
          </p>
        </div>
      </div>
      <div xml:id="testing">
        <head>Preliminary testing of the schema</head>
        <p>The initial use of this schema is to represent the manuscript descriptions
          prepared by the University Library in Lund.  These were constructed to accord
          with the manuscript-description DTD prepared by the Master Project in the
          1990s; the essentials of the Master DTD were later incorporated into the TEI
          but some changes in naming and structure of elements were made at that time. 
        </p>
        <p>The stylesheet for the translation is located 
        <ref target="https://uyghur.linguistics.indiana.edu/lib/msDesc.master-to-p5.xsl"
        >on the project web site</ref>.  It reflects the following cross walk between
          the elements found in the LUB materials (not necessarily all of Master)
          and the definitions of TEI P5.  Note:
	  <list>
	    <item><p>Elements which have been renamed are
	    shown in blue.</p></item>
	    <item><p>Elements or groups in the Master / LUB vocabulary 
	    which have no direct correspondence in TEI P5 are shown in red; 
	    the notes show how these are dealt with.</p>
	    <p>TEI elements into which those elements map are shown in green,
	    if the connection is not otherwise obvious.</p></item>
	    <item><p>Elements or groups in TEI P5 
	    which appear not to correspond to any Master / LUB elements
	    and also not to contain any such are shown in gray.</p></item>
	    <item><p>The TEI content model is omitted (replaced by ...) in cases where the Master / LUB data
	    obviously form a subset of the TEI model and the details of the TEI content
	    model are unhelpful.</p></item>
	    <item><p>The macro <ident>specialPara</ident> allows either the content
	    of a single paragraph, or a sequence of paragraphs (<gi>p</gi> elements).</p></item>
	    <item><p>For ease in construction and completeness-checking, the rows are
	    in alphabetical order.  The element <gi scheme="master">msDescription</gi>
	    is the starting-point.</p></item>
	  </list>


          <table rend="border">
            <row role="label">
              <cell cols="2">Master / LUB</cell>
              <cell cols="2">TEI P5</cell>
              <cell>Notes</cell>
            </row>
            
            <row>
              <cell>acquisition</cell>
              <cell>(p)
              </cell>
              <cell>acquisition</cell>
              <cell><hi>specialPara</hi></cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>additional</cell>
              <cell>(adminInfo)
              </cell>
              <cell>additional</cell>
              <cell>( adminInfo?, 
	      <lb/><hi rend="gray">surrogates</hi>?, 
	      <lb/><hi rend="gray">listBibl</hi>? )
              </cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>adminInfo</cell>
              <cell>(recordHist)
              </cell>
              <cell>adminInfo</cell>
              <cell>( recordHist?, 
	      <lb/><hi rend="gray">availability</hi>?, 
	      <lb/><hi rend="gray">custodialHist</hi>?, 
	      <lb/><hi rend="gray">model.noteLike</hi>? )
              </cell>
              <cell>&#xA0;</cell>
            </row>

	    <row>
	      <cell>altName</cell>
	      <cell>#PCDATA</cell>
	      <cell>altIdentifier</cell>
	      <cell>( <hi rend="gray">model.placeNamePart _sequenceOptional</hi>,
	      <lb/><hi rend="gray">institution</hi>?,
	      <lb/><hi rend="gray">repository</hi>?,
	      <lb/><hi rend="gray">collection</hi>?,
	      <lb/><hi rend="green">idno</hi>,
	      <lb/><hi rend="gray">note</hi>? )
	      </cell>
	      <cell><list>
		<item>The two occurrences of <gi scheme="Master">altName</gi> in the LUB
		data have values of the form "scriptorium : jarring : 294911 : 1118928290"
		(only with no spaces)
		and carry <code>type="database-identifier"</code>.</item>
	      </list></cell>
	    </row>
            
	    <!--* author *-->

            <row>
              <cell>binding</cell>
              <cell>(p)</cell>
              <cell>&#xA0;</cell>
              <cell>( <hi rend="green">model.pLike</hi> 
	      <lb/>| <hi rend="gray">condition</hi> 
	      <lb/>| <hi rend="gray">decoNote</hi> )+
	      </cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>bindingDesc</cell>
              <cell>(binding)
              </cell>
              <cell>bindingDesc</cell>
              <cell>( <hi rend="gray">( model.pLike 
	      <lb/>| decoNote 
	      <lb/>| condition )+ 
	      <lb/>|</hi> binding+ )
              </cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>change</cell>
              <cell>(date,
                <lb/>respStmt,
                <lb/>item)
              </cell>
              <cell>change</cell>
              <cell><hi>specialPara</hi></cell>
              <cell><list>
                <item>Careful translation may be needed.</item>
              </list></cell>
            </row>

	    <row>
	      <cell>condition</cell>
	      <cell>(p)</cell>
	      <cell>condition</cell>
	      <cell><hi>specialPara</hi></cell>
	      <cell>&#xA0;</cell>
	    </row>

	    <row>
	      <cell>country</cell>
	      <cell>#PCDATA with <att>reg</att></cell>
	      <cell>country</cell>
	      <cell><hi>specialPara</hi></cell>
	      <cell><list>
		<item>P5 <gi>country</gi> lacks a <att>reg</att> attribute;
		use <att>key</att> (or <att>ref</att> if you can find a 
		canonical URI).  All occurrences in the data have
		<code>reg="SE"</code> and the value <code>Sweden</code>.</item>
	      </list>
	      </cell>
	    </row>

<!--* country *-->
            
            <row>
              <cell>date</cell>
              <cell>#PCDATA
              </cell>
              <cell>date</cell>
              <cell>...</cell>
              <cell><list>
                <item>All instances have the value "2015-06-16" and
		<att>rend</att> attributes with the values "creation" or "revision".
		Take this into account when translating the change histories.
		</item>
              </list></cell>
            </row>
            
            <row>
              <cell>decoNote</cell>
              <cell>(p)</cell>
              <cell>decoNote</cell>
              <cell><hi>macro.specialPara</hi></cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>decoration</cell>
              <cell>(decoNote)
              </cell>
              <cell>decoDesc</cell>
              <cell>( <hi rend="gray">model.pLike</hi>+ 
	      <lb/>| ( <hi rend="gray">summary</hi>?, 
	      <lb/>decoNote+ ) )
              </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
              </list></cell>
            </row>
	               
            <row>
              <cell>dimensions</cell>
              <cell>(height,
                <lb/>width)
              </cell>
              <cell>dimensions</cell>
              <cell>( ( <hi rend="gray">dim</hi> 
	      <lb/>| model.dimLike )* )
              </cell>
              <cell><list>
                <item>model.dimLike = (<hi rend="gray">depth</hi> | height | width)</item>
              </list></cell>
            </row>
            
            <row>
              <cell>extent</cell>
              <cell>(#PCDATA, 
                <lb/>dimensions,
                <lb/>#PCDATA)
              </cell>
              <cell>extent</cell>
              <cell><hi>character data and phrase-level elements, 
	      including <gi>dimensions</gi></hi>
              </cell>
              <cell><list>
                <item>A typical example of the <gi>extent</gi> element is
                  <code>&lt;extent>ff. 320&lt;dimensions>
                      &lt;height>225&lt;/height>
                      &lt;width>180&lt;/width>
                    &lt;/dimensions>mm.&lt;/extent></code>,
                but not all examples follow this pattern.</item>
              </list></cell>
            </row>

	    <row>
	      <cell>foliation</cell>
	      <cell>(p)</cell>
	      <cell>foliation</cell>
	      <cell><hi>macro.specialPara</hi></cell>
	      <cell>&#xA0;</cell>
	    </row>

	    <row>
	      <cell>height</cell>
	      <cell>#PCDATA</cell>
	      <cell>height</cell>
	      <cell>#PCDATA</cell>
	      <cell>&#xA0;</cell>
	    </row>
            
            <row>
              <cell>history</cell>
              <cell><lb/><lb/>(origin,
                <lb/>provenance,
                <lb/>acquisition)
              </cell>
              <cell>history</cell>
              <cell>( <hi rend="gray">model.pLike</hi>+ 
	      <lb/>| ( <hi rend="gray">summary</hi>?, 
	      <lb/>origin?, 
	      <lb/>provenance*, 
	      <lb/>acquisition? ) )
              </cell>
              <cell>&#xA0;</cell>
            </row>

	    <!--* idno *-->

	    <row>
	      <cell>idno</cell>
	      <cell>#PCDATA</cell>
	      <cell>idno</cell>
	      <cell>...</cell>
	      <cell>&#xA0;</cell>
	    </row>

            
            <row>
              <cell>item</cell>
              <cell>#PCDATA</cell>
              <cell>item</cell>
              <cell>...</cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell>msContents</cell>
              <cell>(<hi rend="gray">model.pLike</hi>+
                <lb/>| (<hi rend="green">summary</hi>?
                <lb/> textLang?
                <lb/> titlePage?,
                <lb/> (<hi rend="green">msItem</hi> | <hi rend="green">msItemStruct</hi>)*))
              </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
		<item><gi>msContents</gi> should be injected with 
		one <gi>msItemStruct</gi> which should contain the
		author, title, and notes from the LUB
		<gi scheme="Master">msHeading</gi>.</item>
              </list></cell>
            </row>

            <row>
              <cell><hi rend="blue">msDescription</hi></cell>
              <cell>(msIdentifier,
                <lb/>
                <lb/>
                <lb/><hi rend="red">msHeading</hi>,
                <lb/>physDesc,
                <lb/>history,
                <lb/>additional?)
              </cell>
              <cell><hi rend="blue">msDesc</hi></cell>
              <cell>(msIdentifier,
                <lb/><hi rend="gray">model.headLike</hi>*
                <lb/>(<hi rend="gray">model.pLike</hi>+ 
                <lb/> | ( <hi rend="green">msContents</hi>?,
                <lb/> physdesc?,
                <lb/> history>,
                <lb/> additional?,
                <lb/> <hi rend="gray">msPart</hi>*)))
              </cell>
              <cell><list>
                <item>model.headLike = head</item>
                <item>model.pLike = (ab | p)</item>
                <item><gi scheme="Master">msHeading</gi> mostly maps to <gi>msContents</gi></item>
                <item><gi scheme="Master">additional</gi> appears in three records of 569.</item>
              </list></cell>
            </row>
            
            <row>
              <cell><hi rend="red">msHeading</hi></cell>
              <cell>(author?,
                <lb/>title,
                <lb/>origPlace?,
                <lb/>origDate?,
                <lb/>textLang,
                <lb/>note)
              </cell>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell><list>
                <item>No direct P5 equivalent; some of the contents belong in 
		<gi>msContents</gi> / <gi>msItemStruct</gi>.</item>
		<item>The <gi>origPlace</gi> and <gi>origDate</gi>
		elements are moved into the <gi>history</gi> element.</item>
                <item><gi scheme="Master">author</gi> appears about 115 times; 
                  <gi scheme="Master">origPlace</gi>
                  and 
                  <gi scheme="Master">origDate</gi>
                  occur almost but not quite always (omitted about twenty times each).</item>
              </list></cell>
            </row>
            
            <row>
              <cell>msIdentifier</cell>
              <cell>(country,
                <lb/>settlement,
                <lb/>
                <lb/>repository,
                <lb/>
                <lb/>idno,
                <lb/><hi rend="red">altName</hi>?)
              </cell>
              <cell>msIdentifier</cell>
              <cell>(model.placeNamePart*,
                <lb/>
                <lb/><hi rend="gray">institution</hi>?,  
                <lb/>repository?,
                <lb/><hi rend="gray">collection</hi>*,
                <lb/>idno?,
                <lb/>(<hi rend="green">msName</hi>
                <lb/>| <hi rend="green">altIdentifier</hi>)*)
              </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
                <item>model.placeNamePart = bloc | country | district | geogName | placeName | region | settlement</item>
                <item>LUB puts institution information into <gi>repository</gi> and collection information into <gi>idno</gi>.</item>
                <item><gi scheme="Master">altName</gi> appears in two records of 569.</item>
                <item>In the LUB data, all children of <gi>msIdentifier</gi> contain character data only. (They are
                not listed separately in this cross-walk.)</item>
              </list></cell>
            </row>
            
            <row>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell>msItem</cell>
              <cell>( ( locus 
	      <lb/>| locusGrp )*,
	      <lb/>( model.pLike+
	      <lb/>| ( model.titlepagePart 
	      <lb/>| model.msItemPart 
	      <lb/>| model.global )+ ) )
              </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
		<item>model.msItemPart = 
		<list>
		  <item>model.biblLike = (<hi rend="green">bibl</hi> 
		  | biblFull | biblStruct | listBibl | msDesc)</item>
		  <item>model.msQuoteLike = (colophon | explicit | finalRubric | incipit | rubric | title)</item>
		  <item>model.quoteLike = (cit | quote)</item>
		  <item>model.respLike = (<hi rend="green">author</hi> | editor | funder 
		  | meeting | principal | respStmt | sponsor)</item>
		  <item>decoNote | filiation | idno | msItem | msItemStruct textLang</item>
		</list>
		</item>
		<item>model.titlepagePart = (argument | binaryObject 
		| byline | <hi rend="green">docAuthor</hi> | docDate 
		| docEdition | docImprint 
		| <hi rend="green">docTitle</hi> | epigraph | graphic 
		| mprimatur | titlePart)</item>
		<item>model.global = 
		<list>
		  <item>model.global.edit = (addSpan | app
		damageSpan | delSpan | gap | space) </item>
		  <item>model.global.meta = (alt
		altGrp | certainty | fLib | fs | fvLib | index | interp | interpGrp
		join | joinGrp | link | linkGrp | listTranspose | precision
		respons | span | spanGrp | substJoin | timeline)</item>
		  <item>model.global.spoken = (incident | kinesic | pause | shift
		vocal | writing) </item>
		  <item>model.milestoneLike = (anchor | cb | fw | gb | lb
		milestone | pb) </item>
		  <item>model.noteLike = (note | witDetail)</item>
		  <item>figure | metamark | notatedMusic</item>
		</list>
		</item>
              </list></cell>
            </row>
            
            <row>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell>msItemStruct</cell>
              <cell>( <hi rend="gray">( locus 
	      <lb/>| locusGrp )?,</hi>
	      <lb/>( <hi rend="gray">model.pLike+
	      <lb/>|</hi> ( <hi rend="green">author</hi>*,
	      <lb/><hi rend="gray">respStmt</hi>*,
	      <lb/><hi rend="green">title</hi>*,
	      <lb/><hi rend="gray">rubric</hi>?,
	      <lb/><hi rend="gray">incipit</hi>?,
	      <lb/><hi rend="gray">msItemStruct</hi>*,
	      <lb/><hi rend="gray">explicit</hi>?,
	      <lb/><hi rend="gray">finalRubric</hi>?,
	      <lb/><hi rend="gray">colophon</hi>*,
	      <lb/><hi rend="gray">decoNote</hi>*,
	      <lb/><hi rend="gray">listBibl</hi>*,
	      <lb/><hi rend="gray">( bibl | biblStruct )*,</hi>
	      <lb/><hi rend="green">model.noteLike</hi>*,
	      <lb/><hi rend="green">textLang</hi>? ) ) )
	      </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
		<item>model.noteLike = (note | witDetail)</item>
              </list></cell>
            </row>
            
            <row>
              <cell>name</cell>
              <cell>#PCDATA</cell>
              <cell>name</cell>
              <cell>...</cell>
              <cell><list>
                <item>All instances have as value either "sigge" or "gunilla".</item>
              </list></cell>
            </row>
            
            <row>
              <cell>note</cell>
              <cell>(p+)</cell>
              <cell>note</cell>
              <cell>...</cell>
              <cell><list>
                <item>Four instances of <gi scheme="Master">note</gi>
                contain character data directly, without
                <gi>p</gi>.</item>
              </list></cell>
            </row>

            <row>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell>objectDesc</cell>
              <cell>( <hi rend="gray">model.pLike</hi>+ 
	      <lb/>| ( supportDesc?, 
	      <lb/><hi rend="gray">layoutDesc</hi>? ) )
              </cell>
              <cell><list>
                <item>model.pLike = (ab | p)</item>
		<item><gi>objectDesc</gi> needs to be injected into 
		<gi>physDesc</gi> to contain the <gi>supportDesc</gi>
		element (and within it, <gi>support</gi>).</item>
              </list></cell>
            </row>

	    <row>
	      <cell>origDate</cell>
	      <cell>#PCDATA, with attributes
	      <att>notBefore</att> and <att>notAfter</att></cell>
	      <cell>origDate</cell>
	      <cell>...</cell>
	      <cell><list>
		<item>The <att>notBefore</att> and <att>notAfter</att> should be preserved.</item>
	      </list></cell>
	    </row>
	    <row>
	      <cell>origPlace</cell>
	      <cell>#PCDATA</cell>
	      <cell>origPlace</cell>
	      <cell>...</cell>
	      <cell><list>
		<item>P5 appears to expect <gi>origDate</gi> and <gi>origPlace</gi> to
		appear in running prose and not in crystals.  Supply text?</item>
	      </list></cell>
	    </row>
            
            <row>
              <cell>origin</cell>
              <cell>(p)
              </cell>
              <cell>origin</cell>
              <cell><hi>specialPara</hi></cell>
              <cell><list>
                <item>Actually, one LUB description has character data before an empty <gi>p</gi>.</item>
              </list></cell>
            </row>
            
            <row>
              <cell>p</cell>
              <cell>(#PCDATA)
              </cell>
              <cell>p</cell>
              <cell>...</cell>
              <cell>&#xA0;</cell>
            </row>
            
            <row>
              <cell>physDesc</cell>
              <cell>(<hi rend="red">support</hi>,
                <lb/><hi rend="red">extent</hi>,
                <lb/><hi rend="blue">decoration</hi>?,
                <lb/>bindingDesc,
                <lb/><hi rend="red">foliation</hi>?,
                <lb/><hi rend="red">condition</hi>)
              </cell>
              <cell>physDesc</cell>
              <cell>( model.pLike*, 
	      <lb/>( model.physDescPart _sequenceOptional ) )
	      <lb/><hi>i.e.</hi>
              <lb/>( <hi rend="gray">(p | ab)*,</hi>
	      <lb/>( <hi rend="gray">accMat</hi>
	      <lb/>&amp; <hi rend="gray">additions</hi> 
	      <lb/>&amp; bindingDesc 
	      <lb/>&amp; <hi rend="blue">decoDesc</hi> 
	      <lb/>&amp; <hi rend="gray">handDesc</hi> 
	      <lb/>&amp; <hi rend="gray">musicNotation</hi>                
	      <lb/>&amp; <hi rend="green">objectDesc</hi> 
	      <lb/>&amp; <hi rend="gray">scriptDesc</hi> 
	      <lb/>&amp; <hi rend="gray">sealDesc</hi> 
	      <lb/>&amp; <hi rend="gray">typeDesc</hi> ) )	     
              </cell>
              <cell><list>
                <item>model.physDescPart contains elements accMat
                additions bindingDesc decoDesc handDesc musicNotation
                objectDesc scriptDesc sealDesc typeDesc;
		the <code>sequenceOptional</code> suffix indicates
		that they can occur in any sequence, each at most
		once in the sequence.		
		</item>
                <item>In the LUB data, there is one record without 
		<gi scheme="Master">decoration</gi> and one
		without <gi scheme="Master">foliation</gi>.</item>
		<item>LUB <gi>support</gi>, <gi>extent</gi>, <gi>foliation</gi>,
		and <gi>condition</gi> are wrapped into P5
		<gi>objectDesc</gi> / <gi>supportDesc</gi>.</item>
		<item>LUB <gi>bindingDesc</gi> stays where it is.</item>
		<item>LUB <gi scheme="Master">decoration</gi> is renamed P5 <gi>decoDesc</gi>.</item>
              </list></cell>
            </row>
            
            <row>
              <cell>provenance</cell>
              <cell>(p)</cell>
              <cell>provenance</cell>
              <cell><hi>specialPara</hi></cell>
              <cell><list>
                <item>Actually, five LUB descriptions have character data before an empty <gi>p</gi>.</item>
              </list></cell>
            </row>
            
            <row>
              <cell>recordHist</cell>
              <cell>(<lb/>source,
                <lb/>change+)
              </cell>
              <cell>recordHist</cell>
              <cell>( <hi rend="gray">model.pLike</hi>+ 
	      <lb/>| ( source, 
	      <lb/>change* ) )
              </cell>
              <cell></cell>
            </row>
            
            <row>
              <cell>repository</cell>
              <cell>#PCDATA, with attribute
	      <att>lang</att> (and twice also <att>key</att>)</cell>
              <cell>repository</cell>
              <cell>...</cell>
              <cell><list>
                <item>Value of both <att>key</att> attributes is "jarring".
		Value of <att>lang</att> is "ENG" for all records.</item>
              </list></cell>
            </row>

            <row>
              <cell>respStmt</cell>
              <cell>(name)
              </cell>
              <cell>respStmt</cell>
              <cell>((resp+, name_)
                <lb/>| (name+, resp+)
              </cell>
              <cell><list>
                <item>P5 content model uses model.nameLike.agent instead of <gi>name</gi>, 
		so <gi>orgName</gi> and <gi>persName</gi> are also allowed.</item>
		<item>The LUB data will need to be restructured.</item>
              </list></cell>
            </row>
            
<!--* settlement *-->

            <row>
              <cell>source</cell>
              <cell><code>EMPTY</code>
              </cell>
              <cell>source</cell>
              <cell><hi>specialPara</hi></cell>
              <cell></cell>
            </row>
            
            <row>
              <cell>&#xA0;</cell>
              <cell>&#xA0;</cell>
              <cell>summary</cell>
              <cell><hi>macro.specialPara</hi>
	      </cell>

              <cell><list>
                <item>Among other things, <gi>summary</gi>
		may contain <gi>title</gi>, <gi>origPlace</gi>,
		<gi>origDate</gi>, and <gi>note</gi> (but not
		<gi>author</gi> or <gi>textLang</gi>).
		If it could handle author and text language as well,
		it would be a natural translation of LUB's
		<gi scheme="Master">msHeading</gi>.</item>
              </list></cell>
            </row>
            
            <row>
              <cell>support</cell>
              <cell>(p)</cell>
              <cell>support</cell>
              <cell><hi>macro.specialPara</hi></cell>
              <cell>&#xA0;</cell>
            </row>

	    <row>
	      <cell>&#xA0;</cell>
	      <cell>&#xA0;</cell>
	      <cell>supportDesc</cell>
	      <cell>( <hi rend="gray">model.pLike</hi>+ 
	      <lb/>| ( support?, 
	      <lb/>extent?, 
	      <lb/>foliation*, 
	      <lb/>collation?, 
	      <lb/><hi rend="gray">condition</hi>? ) )</cell>
	      <cell><list>
	      </list></cell>
	    </row>


	    <row>
	      <cell>textLang</cell>
	      <cell>#PCDATA, with <att>langKey</att> attribute</cell>
	      <cell>textLang</cell>
	      <cell>...</cell>
	      <cell><list>
		<item><gi>textLang</gi> has attributes <gi>mainLang</gi>
		and <att>otherLangs</att>.  For now, assume the first language
		given is the main language.</item>
		<item>LUB data uses uppercase two-letter codes.</item>
		<item>Why on earth didn't the manuscript description design
		reuse <gi>langUsage</gi>?</item>
	      </list></cell>
	    </row>

	    <!--*
	    <row>
	      <cell>title</cell>
	      <cell/>
	      <cell>title</cell>
	      <cell>&#xA0;</cell>
	      <cell>&#xA0;</cell>
	    </row>
	    *-->

	    <row>
	      <cell>width</cell>
	      <cell/>
	      <cell>width</cell>
	      <cell>...</cell>
	      <cell>&#xA0;</cell>
	    </row>

          </table>

        </p>
      </div>
    </body>
  </text>
</TEI>
