<?tei:SOF p2stco.odd ?>
<!-- $Id: p2stco.odd,v 1.6 1998/02/01 17:38:08 tei Exp $ -->
<!--*
    * $Log: p2stco.odd,v $
    * Revision 1.6  1998/02/01 17:38:08  tei
    * fix Log keyword,
    * normalize SGML
    * replace system identifiers with public identifiers.
    *
    * Revision 1.5  94/04/08  01:36:34  msmcq
    * Last-round changes before publication of P3
    * 
    * Revision 1.4  1994/04/01  16:36:47  msmcq
    * changes / fixes during validation of DTD
    * 
    * Revision 1.3  1994/03/24  22:20:40  msmcq
    * typos found by David Barnard et al. corrected
    * -->
<!-- P2.136 :  Combining TEI DTD fragments                    -->
<!-- Revisions:                                               -->
<!-- 94-04-07 : MSM : minor changes                           -->
<!-- 94-03-31 : MSM : define files teimix2, teigen2           -->
<!-- 94-03-22 : MSM : typos and wording changes from JLav     -->
<!-- 94-03-22 : MSM : retag some TERMs, Qs, as CODE, IDENT    -->
<!-- 94-03-21 : MSM : typos, suppress xref to CB              -->
<!-- 93-09-14 : MSM : dictionar-ies not dictionar-y           -->
<!-- 93-04-06 : MSM : one minor fix for clarity               -->
<!-- 3 apr 93 : LB revise for publication                     -->
<!--       changed title                                     -->
<!--      stylistic changes consequent on singularization    -->
<!--      simplified discussion/examples at end               -->
<!-- 93-03-30 : MSM : minor cosmetic changes for LB           -->
<!-- 93-03-06 : MSM : light revision, notes for more revision -->
<!-- 17 May 92 : CMSMcQ : began draft                         -->
 
<div2 id="STCO"><head>Combining TEI Base Tag Sets</head>
 
<p>The TEI DTD has been designed to simplify the task of choosing an
appropriate set of tags for the text in hand.  The core tag set includes
tags appropriate to the majority of simple tagging requirements for
prose, verse and drama, irrespective of the base tag set chosen.  For
more detailed tagging, the encoder may choose the prose base for prose
texts, the verse base for verse, and so on.</p>
 
<p>In discussing these base tag sets elsewhere in these Guidelines, it
is generally assumed for clarity of exposition that a text will fall
into one, not several, of these types.  It is not uncommon, however, for
a text to combine prose and verse, or other forms treated by the TEI as
different bases.  Examples include:
 
<list type="bullets">
<item>when the text is a collection of other texts, which do not all use
the same base:  e.g. an anthology of prose, verse, and drama</item>
<item>when the text contains other smaller, embedded texts:  e.g. a poem
or song included in a prose narrative</item>
<item>when some sections of the text are written in one form, and others
in a different form:  e.g. a novel where some chapters are in prose,
others take the form of dictionary entries and still others the form of
scenes in a play</item>
<item>when the text moves back and forth among forms not between
sections but within a single section:  e.g. mixed prose-and-verse forms
like many pastorals or like some portions of the Poetic Edda</item>
</list></p>
 
<p>The TEI DTD provides the following mechanisms to handle these cases:
 
<list type="bullets">
<item>a definition of a corpus or collection as a series of
<gi>tei.2</gi>
documents, sharing a common TEI header (see chapter <xref target="CC">)</item>
<item>a definition of composite texts which comprise front matter, a
group or several possibly nested groups of collected texts,
themselves possibly composite (see section <xref target="DSGRP">)</item>
<item>a notion of <term>embedded text</term>
which allows one text to be embedded within another (that is,
<gi>text</gi> is defined as a component-level element, as described
briefly at the conclusion of section <xref target="DSGRP">)</item>
 
</list></p>
 
<p>Whichever mechanism is adopted, if the whole of the resulting
document is to be parseable by the main TEI DTD it may need to combine
elements from different TEI base tag sets.  Two special-purpose base
tag sets are defined for this purpose:
 
<list>
<item>the <term>general</term> base, which allows different sections of a
text to use different bases, but ensures that each section uses
only one base</item>
<item>the <term>mixed</term> base, which allows chunk- and
inter-level elements from any base to mix within any text division</item>
</list></p>
 
<p>When either of these <soCalled>combined</soCalled> bases is used, the
user must specify all of the other bases to be included in the mix as
well as either the general or the mixed base.  This is the only
exception to the general rule that no more than one base tag set may be
enabled in a TEI document.
 
<!-- it's an error to specify both mixed and general, tho we can't -->
<!-- stop you -->
 
The following set of declarations for example allows for any mixture of
the low level structural tags defined in the prose, drama and dictionary
base tag sets:
 
<eg>
<![ CDATA [
 <!DOCTYPE TEI.2 PUBLIC "-//TEI P3//DTD Main Document Type//EN"
                        "tei2.dtd" [
   <!ENTITY % TEI.mixed 'INCLUDE' >
   <!ENTITY % TEI.prose 'INCLUDE' >
   <!ENTITY % TEI.drama 'INCLUDE' >
   <!ENTITY % TEI.dictionaries 'INCLUDE' >
   <!-- Structurally, Moby Dick is not your
    everyday common or garden variety novel ... -->
 ]>
]]>
</eg>
 
The following set of declarations has the same effect, but with the
additional restriction that each text division (i.e. each member of the
element class <ident type="class">divn</ident>) must be homogenous with
respect to the mixture of available bases.  Because in a
<soCalled>general</soCalled> base, each <gi>div</gi> of the text may use
a different base, the divisions of the text prefixed by this set of
declarations will each be composed of elements taken solely from one of
the prose, verse or dictionary base tag sets:
 
<eg>
<![ CDATA [
 <!DOCTYPE TEI.2 PUBLIC "-//TEI P3//DTD Main Document Type//EN"
                        "tei2.dtd" [
   <!ENTITY % TEI.general 'INCLUDE' >
   <!ENTITY % TEI.prose 'INCLUDE' >
   <!ENTITY % TEI.drama 'INCLUDE' >
   <!ENTITY % TEI.dictionaries 'INCLUDE' >
 ]>
]]>
</eg>
 
<!-- <p>For further discussion of mixing TEI bases, see       -->
<!-- chapter <xref target=CB>.                                --></p>
 
<p>The actual DTD fragments for the combined bases do nothing but
embed the default tag set for overall text structure.
The mixed-base tag set is in file <ident type="file">teimix2.dtd</ident>:
 
<dtdFrag id="DSTCBMX" n="Mixed-Base Tag Set" file="teimix2.dtd">
&dtdstart;
<entDecl entDoc="TEISTR">
<peRef n="TEI.structure.dtd">
</dtdFrag>
 
The general-base tag set is in file
<ident type="file">teigen2.dtd</ident>:
<dtdFrag id="DSTCBGN" n="General-Base Tag Set" file="teigen2.dtd">
&dtdstart;
<entDecl entDoc="TEISTR">
<peRef n="TEI.structure.dtd">
</dtdFrag>
</p></div2>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-default-dtd-file:"~/lib/psgml/p2odd.ced"
sgml-parent-document:(quote ("/home/tei/P3/Master/Odds/p2.odd" "tei.1" "text" "body" "div1" "div2"))
sgml-omittag:t
sgml-shorttag:t
End:
-->
<?tei:EOF p2stco.odd ?>
