<!-- ************************************************************** -->
<!--
NAME:     Music Encoding Initiative (MEI) DTD
          File      = meiShared.dtd 
          Vers Date = 2004/05/18

NOTICE:   Copyright (c) 2001-2004 Perry Roland. All rights
          reserved.

PURPOSE:  This file contains declarations for elements common to more
          than one of the other MEI DTD modules. These are declared
          here in order to eliminate dependencies between the modules.
          This file is invoked by the mei.dtd driver file.
                                                                    -->
<!-- ************************************************************** -->

<!-- ************************************************************** -->
<!-- Common (text) elements which are used in more than one module  -->
<!-- ************************************************************** -->
<!ENTITY % address 'INCLUDE'>
<![%address;[
<!ELEMENT %n.address;  (%n.addressline;)+>
<!ATTLIST %n.address;
          meiform            CDATA                 #FIXED 'address'
          %a.common;
          %a.text;>
]]>

<!-- Single line of an address -->
<!ENTITY % addressline 'INCLUDE'>
<![%addressline;[
<!ELEMENT %n.addressline;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.addressline;
          meiform            CDATA                 #FIXED 'addressline'
          %a.common;
          %a.text;>
]]>

<!-- Bibliographic reference. May function as a hypertext reference
to an external electronic resource. %m.textinline has been expanded in
order to disallow bibref, extref, and ref elements. A more structured
content model, similar to TEI's biblFull, requires new elements that
function like those in the meiHead DTD, but that do not duplicate their
names. -->
<!ENTITY % bibref 'INCLUDE'>
<![%bibref;[
<!ELEMENT %n.bibref;   (#PCDATA|%n.address;|%n.corpname;|%n.date;|
                       %n.extptr;|%n.geogname;|%n.identifier;|%n.lb;|
                       %n.num;|%n.pb;|%n.periodname;|%n.persname;|
                       %n.ptr;|%n.rend;|%n.stack;|%n.stylename;|
                       %n.title;)*>
<!ATTLIST %n.bibref;
          meiform            CDATA                 #FIXED 'bibref'
          %a.common;
          %a.text;
          %a.link.common;
          %a.link.external;>
]]>

<!-- Blockquote contains a phrase or passage attributed to a source
external to the text. The source for the quote may be included in the
optional bibref sub-element. -->
<!ENTITY % blockquote 'INCLUDE'>
<![%blockquote;[
<!ELEMENT %n.blockquote; ((%m.textcomponents;)+, (%n.bibref;)?)>
<!ATTLIST %n.blockquote;
           meiform           CDATA                 #FIXED 'blockquote'
           %a.common;
           %a.text;>
]]>

<!ENTITY % corpname 'INCLUDE'>
<![%corpname;[
<!ELEMENT %n.corpname; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.corpname;
          meiform            CDATA                 #FIXED 'corpname'
          %a.common;
          %a.text;>
]]>

<!-- Date contains a date in any format, with normalized value in the
normal attribute. %m.textinline is expanded here because date can't
contain date or other mid-level text structures, such as address,
bibref, etc. -->
<!ENTITY % date 'INCLUDE'>
<![%date;[
<!ELEMENT %n.date;  (#PCDATA|%n.extptr;|%n.extref;|%n.lb;|%n.num;|
                    %n.pb;|%n.ptr;|%n.ref;|%n.rend;|%n.stack;)*>
<!ATTLIST %n.date;
          meiform            CDATA                 #FIXED 'date'
          %a.common;
          %a.text;
          %a.bibl;
          certainty          CDATA                 #IMPLIED
          normal             %ISODATE;             #IMPLIED
          scheme             %URI;                 #IMPLIED>
]]>

<!-- An empty linking element that uses attributes to connect the MEI
document to an external electronic object. Don't confuse this element
with the ptr element, which is an internal link for movement from one
place in the MEI document to another in the same document. -->
<!ENTITY % extptr 'INCLUDE'>
<![%extptr;[
<!ELEMENT %n.extptr;  EMPTY>
<!ATTLIST %n.extptr;
          meiform            CDATA                 #FIXED 'extptr'
          %a.common;
          %a.link.common;
          %a.link.external;>
]]>

<!-- A linking element that can include text and subelements as part of
its reference to an electronic object that is external to the MEI
document. Don't confuse this element with the ref element, which is an
internal link for movement from one place in the MEI document to
another in the same document. %m.textinline is expanded here because a
ref may not contain bibref, extref, or ref elements. -->
<!ENTITY % extref 'INCLUDE'>
<![%extref;[
<!ELEMENT %n.extref;  (#PCDATA|%n.address;|%n.corpname;|%n.date;|
                      %n.extptr;|%n.geogname;|%n.identifier;|%n.lb;|
                      %n.num;|%n.pb;|%n.periodname;|%n.persname;|
                      %n.ptr;|%n.rend;|%n.stack;|%n.stylename;|
                      %n.title;)*>
<!ATTLIST %n.extref;
          meiform            CDATA                 #FIXED 'extref'
          %a.common;
          %a.text;
          %a.link.common;
          %a.link.external;>
]]>

<!-- An illustration. -->
<!ENTITY % fig 'INCLUDE'>
<![%fig;[
<!ELEMENT %n.fig;  ((%n.caption;)?, (%n.figdesc;)?)>
<!ATTLIST %n.fig;
          meiform            CDATA                 #FIXED 'fig'
          %a.common;
          entityref          ENTITY                #IMPLIED
          href               CDATA                 #IMPLIED>
]]>

<!-- A label which accompanies an illustration or a table. The
positioning of the caption, i.e. at the top, bottom, left, or
right of the table or figure, should be determined based on the
caption's type attribute. -->
<!ENTITY % caption 'INCLUDE'>
<![%caption;[
<!ELEMENT %n.caption;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.caption;
          meiform            CDATA                 #FIXED 'caption'
          %a.common;
          %a.text;>
]]>

<!-- Meta-data for an inline illustration. Best practice suggests
the use of controlled vocabulary. Don't confuse this element with a
caption. A caption is text primarily intended for display with an
illustration. It may or may not function as a description of the
illustration. Allowing %m.textcomponents (excluding fig) here would
make it possible to transcribe text included in the figure. Allowing
%m.primitiveswould accommodate figures 'drawn' at rendering time.
Perhaps <!ELEMENT %n.figdesc; (#PCDATA|%m.primitives;|%n.blockquote;|
%n.lg;|%n.list;|%n.p;|%n.table;|%n.textnote;)*> -->
<!ENTITY % figdesc 'INCLUDE'>
<![%figdesc;[
<!-- <!ELEMENT %n.figdesc;  (#PCDATA|%m.textinline;)*> -->
<!ELEMENT %n.figdesc; (#PCDATA|%m.primitives;|%n.blockquote;|
%n.lg;|%n.list;|%n.p;|%n.table;|%n.textnote;)*>
<!ATTLIST %n.figdesc;
          meiform            CDATA                 #FIXED 'figdesc'
          %a.common;
          %a.text;>
]]>

<!ENTITY % geogname 'INCLUDE'>
<![%geogname;[
<!ELEMENT %n.geogname; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.geogname;
          meiform            CDATA                 #FIXED 'geogname'
          %a.common;
          %a.text;>
]]>

<!-- Contains any heading, for example, the title of a text division,
or the heading of a list. A head is not allowed to contain a sub-head
in order to encourage the proper nesting of div elements. -->
<!ENTITY % head 'INCLUDE'>
<![%head;[
<!ELEMENT %n.head;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.head;
          meiform            CDATA                 #FIXED 'head'
          %a.common;
          %a.text;>
]]>

<!-- Bibliographic/personal identifier. -->
<!ENTITY % identifier 'INCLUDE'>
<![%identifier;[
<!ELEMENT %n.identifier;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.identifier;
          meiform            CDATA                 #FIXED 'identifier'
          %a.common;
          %a.bibl;>
]]>

<!-- Text line break. The source attribute is provided for linking
to the bibliographic description of the source(s) that contains the
line break. The n attribute should be used to record a label for the
line, i.e. most likely a line number. -->
<!ENTITY % lb 'INCLUDE'>
<![%lb;[
<!ELEMENT %n.lb;  EMPTY>
<!ATTLIST %n.lb;
          meiform            CDATA                 #FIXED 'lb'
          %a.common;
          source             IDREF                 #IMPLIED
          n                  CDATA                 #IMPLIED>
]]>

<!-- Line group usually contains verse although it may be used for
any section of text that is organized as a group of lines. -->
<!ENTITY % lg 'INCLUDE'>
<![%lg;[
<!ELEMENT %n.lg; ((%n.head;)?, (%n.l;)+)>
<!ATTLIST %n.lg;
          meiform            CDATA                 #FIXED 'lg'
          %a.common;
          %a.text;>
]]>

<!-- Line contains a single line of text. The n attribute should
be used to record a label for the line, i.e. most likely a line
number. -->
<!ENTITY % l 'INCLUDE'>
<![%l;[
<!ELEMENT %n.l; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.l;
          meiform            CDATA                 #FIXED 'l'
          %a.common;
          %a.text;
          n                  CDATA                 #IMPLIED>
]]>

<!-- List. N.B. A definition list should be encoded as a 2-column
table. -->
<!ENTITY % list 'INCLUDE'>
<![%list;[
<!ELEMENT %n.list;  ((%n.head;)?, (%n.item;)+)>
<!ATTLIST %n.list;
          meiform            CDATA                 #FIXED 'list'
          %a.common;
          %a.text;
          form               (simple|marked|ordered)
                                                   #IMPLIED>
]]>

<!-- Single item in a list -->
<!ENTITY % item 'INCLUDE'>
<![%item;[
<!ELEMENT %n.item;  (#PCDATA|%m.textcomponents;|%m.textinline;)*>
<!ATTLIST %n.item;
          meiform            CDATA                 #FIXED 'item'
          %a.common;
          %a.text;>
]]>

<!-- Number -->
<!ENTITY % num 'INCLUDE'>
<![%num;[
<!ELEMENT %n.num;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.num;
          meiform            CDATA                 #FIXED 'num'
          %a.common;
          %a.text;
          units              CDATA                 #IMPLIED>
]]>

<!-- Paragraph -->
<!ENTITY % p 'INCLUDE'>
<![%p;[
<!ELEMENT %n.p;  (#PCDATA|%m.paracontent;)*>
<!ATTLIST %n.p;
          meiform            CDATA                 #FIXED 'p'
          %a.common;
          %a.text;>
]]>

<!-- Page break. Meta-data about an accompanying page image may be
recorded in the pgdesc element. The source attribute is provided for
linking to the bibliographic description of the source(s) that
contains the page break. The n attribute contains the visual page
number. It need not be an integer, e.g. 'iv', or 'p17-3'. The logical
page number can be calculated by counting previous pb ancestor
elements. When used in a score context, a page break implies a
preceding system break. -->
<!ENTITY % pb 'INCLUDE'>
<![%pb;[
<!-- OLD MODELS:
<!ELEMENT %n.pb;  ((%n.fw;, (%n.fw;)?)?, (%n.pgdesc;)?)>
<!ELEMENT %n.pb;  ((%n.textnote;)*, (%n.pgdesc;)?)> -->
<!ELEMENT %n.pb;  (%n.pgdesc;)?>
<!ATTLIST %n.pb;
          meiform            CDATA                 #FIXED 'pb'
          %a.common;
          %a.link.external;
          source             IDREF                 #IMPLIED
          n                  CDATA                 #IMPLIED>
]]>

<!-- Meta-data which accompanies a page image. Best practice suggests
the use of controlled vocabulary. -->
<!ENTITY % pgdesc 'INCLUDE'>
<![%pgdesc;[
<!ELEMENT %n.pgdesc;  (#PCDATA)>
<!ATTLIST %n.pgdesc;
          meiform            CDATA                 #FIXED 'pgdesc'
          %a.common;
          %a.text;>
]]>

<!ENTITY % periodname 'INCLUDE'>
<![%periodname;[
<!ELEMENT %n.periodname; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.periodname;
          meiform            CDATA                 #FIXED 'periodname'
          %a.common;
          %a.text;>
]]>

<!ENTITY % persname 'INCLUDE'>
<![%persname;[
<!ELEMENT %n.persname; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.persname;
          meiform            CDATA                 #FIXED 'persname'
          %a.common;
          %a.text;>
]]>

<!-- An empty internal linking element that uses attributes to provide
for movement from one place in a MEI document to another place in the
same document. Unlike the ref element, the ptr element cannot contain
text or subelements to describe the referenced object. Don't confuse
this element with extptr which is used to connect the MEI document to
an external electronic object. -->
<!ENTITY % ptr 'INCLUDE'>
<![%ptr;[
<!ELEMENT %n.ptr;  EMPTY>
<!ATTLIST %n.ptr;
          meiform            CDATA                 #FIXED 'ptr'
          %a.common;
          %a.link.common;
          %a.link.internal;>
]]>

<!-- An internal linking element that provides for movement from one
place in a MEI document to another point in the same document. Unlike
the ptr element, ref may contain text and subelements to describe the
destination. Don't confuse this element with extref which provides for
linking to an electronic object that is external to the MEI document.
%m.textinline is expanded here because a ref may not contain bibref,
extref or ref elements. -->
<!ENTITY % ref 'INCLUDE'>
<![%ref;[
<!ELEMENT %n.ref;  (#PCDATA|%n.address;|%n.corpname;|%n.date;|
                   %n.extptr;|%n.geogname;|%n.identifier;|%n.lb;|
                   %n.num;|%n.pb;|%n.periodname;|%n.persname;|
                   %n.ptr;|%n.rend;|%n.stack;|%n.stylename;|
                   %n.title;)*>
<!ATTLIST %n.ref;
          meiform            CDATA                 #FIXED 'ref'
          %a.common;
          %a.text;
          %a.link.common;
          %a.link.internal;>
]]>

<!-- Special visual rendering of text. Add fam, name, and size
attributes or put these in a structured altrend attribute? -->
<!ENTITY % rend 'INCLUDE'>
<![%rend;[
<!ELEMENT %n.rend;  (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.rend;
          meiform            CDATA                 #FIXED 'rend'
          %a.common;
          %a.text;
          altrend            CDATA                 #IMPLIED
          rend               %TEXTRENDITION;       #REQUIRED>
]]>

<!-- Stacked text, e.g. an inline table with a single column. The
%m.textinline entity is expanded here in order to disallow a stack
within a stack and the pb element. -->
<!ENTITY % stack 'INCLUDE'>
<![%stack;[
<!ELEMENT %n.stack; (#PCDATA|%n.address;|%n.bibref;|%n.corpname;|
                    %n.date;|%n.extptr;|%n.extref;|%n.geogname;|
                    %n.identifier;|%n.lb;|%n.num;|%n.periodname;|
                    %n.persname;|%n.ptr;|%n.rend;|%n.stylename;|
                    %n.title;)*>
<!ATTLIST %n.stack;
          meiform            CDATA                 #FIXED 'stack'
          %a.common;
          %a.text;
          delim              CDATA                 #IMPLIED
          align              (left|right|center|
                             rightdigit)           #IMPLIED>
]]>

<!ENTITY % stylename 'INCLUDE'>
<![%stylename;[
<!ELEMENT %n.stylename; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.stylename;
          meiform            CDATA                 #FIXED 'stylename'
          %a.common;
          %a.text;>
]]>

<!-- Visual layout in tabular form -->
<!ENTITY % table 'INCLUDE'>
<![%table;[
<!ELEMENT %n.table;  ((%n.caption;)?, (%n.tr;)+)>
<!ATTLIST %n.table;
          meiform            CDATA                 #FIXED 'table'
          %a.common;
          %a.text;>
]]>

<!-- Table row -->
<!ENTITY % tr 'INCLUDE'>
<![%tr;[
<!ELEMENT %n.tr;  (%n.th;|%n.td;)+>
<!ATTLIST %n.tr;
          meiform            CDATA                 #FIXED 'tr'
          %a.common;
          %a.text;>
]]>

<!-- Table cell containing header information -->
<!ENTITY % th 'INCLUDE'>
<![%th;[
<!ELEMENT %n.th;  (#PCDATA|%m.textcomponents;|%m.textinline;)*>
<!ATTLIST %n.th;
          meiform            CDATA                 #FIXED 'th'
          %a.common;
          %a.text;
          colspan            %NUMBER;              #IMPLIED
          rowspan            %NUMBER;              #IMPLIED>
]]>

<!-- Table cell containing data -->
<!ENTITY % td 'INCLUDE'>
<![%td;[
<!ELEMENT %n.td;  (#PCDATA|%m.textcomponents;|%m.textinline;)*>
<!ATTLIST %n.td;
          meiform            CDATA                 #FIXED 'td'
          %a.common;
          %a.text;
          colspan            %NUMBER;              #IMPLIED
          rowspan            %NUMBER;              #IMPLIED>
]]>

<!-- Textnote contains a textual note or annotation. -->
<!ENTITY % textnote 'INCLUDE'>
<![%textnote;[
<!ELEMENT %n.textnote;  (#PCDATA|%m.textcomponents;|%m.textinline;)*>
<!ATTLIST %n.textnote;
          meiform            CDATA                 #FIXED 'textnote'
          %a.common;
          %a.text;>
]]>

<!-- Title of a bibliographic entity. The type attribute may be used
to classify the title according to some convenient typology. Sample
values include: 
   main         main title 
   subordinate  subtitle, title of part 
   parallel     alternate title, often in another language, by which
                the work is also known 
   abbreviated  abbreviated form of title

The type attribute is provided for convenience in analysing titles
and processing them according to their type; where such specialized
processing is not necessary, there is no need for such analysis, and
the entire title, including subtitles and any parallel titles, may be
enclosed within a single <title> element. The level attribute indicates
whether this is the title of an article, monograph, journal, series, or
unpublished material. -->
<!ENTITY % title 'INCLUDE'>
<![%title;[
<!ELEMENT %n.title; (#PCDATA|%m.textinline;)*>
<!ATTLIST %n.title;
          meiform            CDATA                 #FIXED 'title'
          %a.common;
          %a.text;
          level              (a|m|j|s|u)           #IMPLIED>
]]>

<!-- ************************************************************** -->
<!-- Graphic primitive element declarations                         -->
<!-- ************************************************************** -->
<!-- Line. The start and end attributes identify the two terminal
points of the line. They may be absolute page coordinates or positions
relative to another symbol. -->
<!ENTITY % line 'INCLUDE'>
<![%line;[
<!ELEMENT %n.line;  EMPTY>
<!ATTLIST %n.line;
          meiform            CDATA                 #FIXED 'line'
          %a.common;
          start              CDATA                 #REQUIRED
          end                CDATA                 #REQUIRED
          rend               %LINERENDITION;       #IMPLIED>
]]>

<!-- Curve. The start and end attributes identify the two terminal
points of the curve. They may be absolute page coordinates or
positions relative to another symbol. The bulge attribute may contain
multiple values of the %NUMBER type. -->
<!ENTITY % curve 'INCLUDE'>
<![%curve;[
<!ELEMENT %n.curve;  EMPTY>
<!ATTLIST %n.curve;
          meiform            CDATA                 #FIXED 'curve'
          %a.common;
          bulge              NMTOKENS              #REQUIRED
          start              CDATA                 #REQUIRED
          end                CDATA                 #REQUIRED
          rend               %CURVERENDITION;      #IMPLIED>
]]>

<!-- A reference to a previously defined symbol. The x and y
attributes identify the starting point, e.g. "hotspot" of the
symbol. These may contain absolute page coordinates or a position
relative to another symbol. The ref attribute should contain the
id of a symboldef element. -->
<!ENTITY % symbol 'INCLUDE'>
<![%symbol;[
<!ELEMENT %n.symbol;  (%n.param;)*>
<!ATTLIST %n.symbol;
          meiform            CDATA                 #FIXED 'symbol'
          %a.common;
          ref                IDREF                 #REQUIRED
          scale              %NUMBER;              #IMPLIED
          x                  CDATA                 #REQUIRED
          y                  CDATA                 #REQUIRED>
]]>

<!ENTITY % param 'INCLUDE'>
<![%param;[
<!ELEMENT %n.param;  EMPTY>
<!ATTLIST %n.param;
          meiform            CDATA                 #FIXED 'param'
          %a.common;
          name               CDATA                 #REQUIRED
          value              CDATA                 #REQUIRED>
]]>

<!-- Anchored text. The x and y attributes identify the starting point
of the text. They may contain absolute page coordinates or a position
relative to another symbol. -->
<!ENTITY % anchoredtext 'INCLUDE'>
<![%anchoredtext;[
<!ELEMENT %n.anchoredtext;  (#PCDATA|%m.anchoredtext;)*>
<!ATTLIST %n.anchoredtext;
          meiform            CDATA                 #FIXED 'anchoredtext'
          %a.common;
          %a.text;
          x                  CDATA                 #REQUIRED
          y                  CDATA                 #REQUIRED>
]]>