1.1 The tei module

1.2 The core module

The remainder of the elements in the core module are included in the IDS/XCES vocabulary; that remainder includes the elements listed below. (For the most part, these elements are also included in CES and XCES, but editor, gloss, lb, orig, and pb are not in XCES but are added back into the vocabulary by IDS/XCES.)

Some elements are included without change from TEI, at least in the sense that the same parameter entity or pattern names are used in the declarations. (The extension of some element classes in IDS/XCES does of course mean the effective content model is not actually the same. But we do not need to supply a different model in this ODD file.)

For other elements, IDS/XCES declares a content model which is a restriction of the content model in TEI P5. One simple way to move I5 closer to TEI P5 would be to drop these restrictions and use the TEI P5 declarations for these elements unchanged.

Finally, for some elements IDS/XCES declares a content model which extends or modifies the declarations in TEI P5. Sometimes the change consists merely in the addition of one or more attributes, or adding the element as a member of this or that class. In other cases the content model is rewritten.

• abbr (abbreviation): contains an abbreviation of any sort.
  Spec fragment add_abbr_to_token_class

  Change element abbr:

  Classes

  (add) model.token

  (add) model.basic

  Attributes

   

  expan

  (add this attribute)

  gives an expansion of the abbreviation.

  Example:

  <abbr expan = "Deutsche Volkspartei 
  (1918-1933)">DVP</abbr>

  Example:

  <abbr expan = "Unabhängige 
  Sozialdemokratische Partei">USPD</abbr>

  Example:

  <abbr expan = "Deutsche 
  Demokratische Partei (1918-1930)">DDP</abbr>

  Example:

  <abbr expan = 
  "Arbeiter-und-Bauern-Fakultät">ABF</abbr>

  Example:

  <abbr expan = "Deutsche 
  Akademie der Künste (Berlin/Ost)">DAK</abbr>

  Example:

  <abbr expan = "Deutsche
  Akademie der Wissenschaften
  (Berlin/Ost)">DAW</abbr>

  Example:

  <abbr expan = "Deutsches 
  Pädagogisches Zentralinstitut">DPZI</abbr>

  Example:

  <abbr expan = "Deutscher 
  Schriftstellerverband">DSV</abbr>

  This spec fragment is referred to by specgroup-core-redefinitions.

• address: contains a postal address, for example of a publisher, an organization, or an individual. (Not present in samples.)
• analytic (analytic level): contains bibliographic elements describing an item (e.g. an article or poem) published within a monograph or journal and not as an independent publication. IDS/XCES modifies the content model to fit the three-level structure of IDS corpora.
  Spec fragment redefine_analytic

  Change element analytic:

  Change contents to

  (h.title+, (h.author | editor)*, (biblScope | biblNote)*, (edition, respStmt?)*, imprint+, idno*, (biblNote | biblScope)*)

  This spec fragment is referred to by specgroup-core-redefinitions.

  CES restricts the TEI content model and renames some elements; IDS/XCES extends the CES definition. The model given here is the same as for monogr.
• author: in a bibliographic reference, contains the name(s) of the author(s), personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority.
• bibl (bibliographic citation): contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged.
• biblScope (scope of citation): defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work.
• biblStruct (structured bibliographic citation): contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order.
• corr (correction): contains the correct form of a passage apparently erroneous in the copy text. IDS-XCES adds the attribute @sic (which gives the original form) as e.g. occurring in hi1bb.xces.
  Spec fragment redefine_corr

  Change element corr:

  Attributes

   

  sic

  (add this attribute)

  from CES Dokumentation: "gives the original form"

  Example:

  ToDo

  This spec fragment is referred to by specgroup-core-redefinitions.

• date: contains a date in any format. CES declares this element as a member of the token class.
  Spec fragment add_date_to_token_class

  Change element date:

  Classes

  (add) model.token

  This spec fragment is referred to by specgroup-core-redefinitions.

• item: adding att.typed for wiki talk HLU 2020-01-24 : Note that in the current TEI, desc has already @type
  Spec fragment redefine_desc

  Change element desc:

  Classes

  (add) att.typed

  (add) model.descLike

  This spec fragment is referred to by specgroup-core-redefinitions.

• distinct: identifies any word or phrase which is regarded as linguistically distinct, for example as archaic, technical, dialectal, non-preferred, etc., or as forming part of a sublanguage.
• editor: secondary statement of responsibility for a bibliographic item, for example the name of an individual, institution or organization, (or of several such) acting as editor, compiler, translator, etc.
• item: adding att.typed for wiki talk HLU 2020-01-24
  Spec fragment redefine_emph

  Change element emph:

  Classes

  (add) att.typed

  This spec fragment is referred to by specgroup-core-redefinitions.

• foreign: identifies a word or phrase as belonging to some language other than that of the surrounding text. IDS-XCES allows it to contain q, e.g. in loz-div-pub.xces
  Spec fragment redefine_foreign

  Change element foreign:

  Change contents to

  (#PCDATA | %model.phrase; | %model.global; | q)*

  This spec fragment is referred to by specgroup-core-redefinitions.

• gap: indicates a point where material has been omitted in a transcription, whether for editorial reasons described in the TEI header, as part of sampling practice, or because the material is illegible, invisible, or inaudible. (In TEI P5, the description of the gap has moved from a desc attribute to a desc child; we revert this change for compatibility with existing data.)
  Spec fragment redefine_gap

  Change element gap:

  Change contents to

  Empty.

  Attributes

   

  desc

  (add this attribute)

  gives a description of the omitted material.

  Example:

  <p>
    <s type="manual">die anspruchsvolle Alternative 
      für Leichtraucher.</s>
    <s type="manual">Astor mild im Rauch 
      nikotinarm<gap desc="Zigarettenschachtel" 
      reason="omitted"/>.</s>
    <s type="manual">zum Anbieten und Verschenken 
      Astor mild-Kassette 48 Cigaretten DM 6,- 
      20 Astor mild DM 2,50.</s>
      <!--* ... *-->
  </p>

  Example:

  <s>Weit treffender haben aber jene 
  (die Griechen) die unteilbare Subsistenz 
  einer vernünftigen Natur mit dem Wort 
  'o'<gap desc="GREEKSMALLLETTERSTIGMA" 
          reason="omitted"/>benannt« 
  (Boethius, zitiert nach 
  Brasser 1999: 52).</s>

  This spec fragment is referred to by specgroup-core-redefinitions.

• gloss: identifies a phrase or word used to provide a gloss or definition for some other word or phrase.
  Spec fragment redefine_gloss

  Change element gloss:

  Attributes

   

  target

  (change this attribute)

  the target of the pointer

  Type

  an XSD IDREF value

  The original TEI target attribute of the class att.pointing comes out as of type CDATA from the ODD2DTD. (According to the TEI guidelines the type is 'datapointer' which stands for a single URI, which btw. correctly caused it to come out as xs:anyURI in the generated i5.xsd). But in the ids-xces.dtd it was IDREF for target at gloss. Hence I include it here with an explicit specification of the IDREF type.

  This spec fragment is referred to by specgroup-core-redefinitions.

• head (heading): contains any type of heading, for example the title of a section, or the heading of a list, glossary, manuscript description, etc. Changed 2020-01-21 such that it can contain sigend, for wiki talk.
  Spec fragment redefine_head

  Change element head:

  Change contents to

  (#PCDATA | %model.gLike; | %model.phrase; | %model.inter; | %model.global; | lg | %model.lLike; | %model.floatP.cmc;)*

  This spec fragment is referred to by specgroup-core-redefinitions.

• hi (highlighted): marks a word or phrase as graphically distinct from the surrounding text, for reasons concerning which no claim is made.
  Spec fragment add_hi_to_basic_class

  Change element hi:

  Classes

  (add) model.basic

  Change contents to

  (#PCDATA | %model.gLike; | %model.phrase; | %model.inter; | %model.global; | lg | %model.lLike; | %model.floatP.cmc;)*

  This spec fragment is referred to by specgroup-core-redefinitions.

• imprint: groups information relating to the publication or distribution of a bibliographic item. CES redefines this to use the pubDate element instead of date.
  Spec fragment redefine_imprint

  Change element imprint:

  Change contents to

  (pubPlace | publisher | pubDate)*

  This spec fragment is referred to by specgroup-core-redefinitions.

• item: contains one component of a list. . Redefined to contain signed as well for wiki talk HLU 2020-01-02.
  Spec fragment redefine_item

  Change element item:

  Change contents to

  (#PCDATA | %model.gLike; | %model.phrase; | %model.inter; | %model.divPart; | %model.global; | %model.floatP.cmc;)*

  This spec fragment is referred to by specgroup-core-redefinitions.

• l (verse line): contains a single, possibly incomplete, line of verse. CES redefined the meaning and values of the part attribute.
  Spec fragment redefine_l_part_attribute

  Change element l:

  Attributes

   

  part

  (redefine this attribute)

  indicates whether the verse line is metrically complete.

  Values

  y

  the line is metrically complete.

  n

  the line is metrically incomplete.

  u

  metricality is not known or inapplicable.

  Given the attribute name part, the value y might seem intuitively to mean “Yes, this is a partial line, not a full line,” but the CES documentation glosses y and n as shown.

  The attribute appears not to be actively used in any IDS samples, in any case; all values given are the default u.

  This spec fragment is referred to by specgroup-core-redefinitions.

• label: contains the label associated with an item in a list; in glossaries, marks the term being defined.
• lb (line break): marks the start of a new (typographic) line in some edition or version of a text. IDS-XCES adds @TEIform to the attribute list as used in fsp.xces and gr1.xces.
  Spec fragment add_lb_to_ids.milestones

  Change element lb:

  Classes

  (add) model.ids.milestones

  Attributes

   

  TEIform

  (add this attribute)

  TEIform

  Default value

  pb

  This spec fragment is referred to by specgroup-core-redefinitions.

• lg (line group): contains a group of verse lines functioning as a formal unit, e.g. a stanza, refrain, verse paragraph, etc.
  Spec fragment redefine_lg_part_attribute

  Change element lg:

  Attributes

   

  part

  (redefine this attribute)

  indicates whether the verse line group is metrically complete.

  Values

  y

  the line is metrically complete.

  n

  the line is metrically incomplete.

  u

  metricality is not known or inapplicable.

  The attribute appears not to be actively used in any IDS samples; all values given are the default u.

  This spec fragment is referred to by specgroup-core-redefinitions.

• list: contains any sequence of items organized as a list. IDS/XCES allows milestones and xptr elements among the children.
  Spec fragment redefine_list

  Change element list:

  Change contents to

  (head?, (item | (label, %model.ids.milestones;*, item) | %model.ids.milestones;)*)

  This spec fragment is referred to by specgroup-core-redefinitions.

• measure: contains a word or phrase referring to some quantity of an object or commodity, usually comprising a number, a unit, and a commodity name.
• mentioned: marks words or phrases mentioned, not used. (Not present in samples.)
• monogr (monographic level): contains bibliographic elements describing an item (e.g. a book or journal) published as an independent item (i.e. as a separate physical object). CES restricts the TEI content model and renames some elements; IDS/XCES extends the CES definition. The model given here is the same as for analytic.
  Spec fragment redefine_monogr

  Change element monogr:

  Change contents to

  (h.title+, (h.author | editor)*, (biblScope | biblNote)*, (edition, respStmt?)*, imprint+, idno*, (biblNote | biblScope)*)

  This spec fragment is referred to by specgroup-core-redefinitions.

• name (name, proper noun): contains a proper noun or noun phrase.
  Spec fragment add_name_to_token_class

  Change element name:

  Classes

  (add) model.token

  This spec fragment is referred to by specgroup-core-redefinitions.

• note: contains a note or annotation.
• num (number): contains a number, written in any form.
  Spec fragment add_num_to_token_class

  Change element num:

  Classes

  (add) model.token

  (add) model.basic

  This spec fragment is referred to by specgroup-core-redefinitions.

• orig (original form): contains a reading which is marked as following the original, rather than being normalized or corrected. The reg attribute was dropped in TEI P5 and must be restored. CES also adds a regalt attribute which must be defined.
  Spec fragment add_attributes_to_orig

  Change element orig:

  Attributes

   

  reg

  (add this attribute)

  gives a regularized (normalized) form of the text.

  regalt

  (add this attribute)

  gives an alternate form of the regularized (normalized) text.

  Example:

  <s type="manual">der warnt - 
  wider die eiserne Regel des 
  <orig reg="Wahlkampfes" 
        regalt="Wahlkrampfes">Wahlk(r)ampfes</orig>, 
  einen Gegner durch Nichtnennung zu strafen - 
  davor, PDS zu wählen.</s>

  This spec fragment is referred to by specgroup-core-redefinitions.

• p (paragraph): marks paragraphs in prose.
  Spec fragment redefine_p

  Change element p:

   

  (paragraph) marks paragraphs in prose. In the case of CMC documents, notably Wiki talk pages, it is necessary that signed may also appear inside paragraphs. In a Wiki talk page, users insert their signature as part of the paragraph. The only change to the original content model of p is that signed is additionally allowed inside p.

  Change contents to

  (#PCDATA | %model.gLike; | %model.phrase; | %model.inter; | %model.global; | lg | %model.lLike; | %model.floatP.cmc;)*

  Example:

  Usenet news message

  <<egXML>>

  <<p>>Wer die ruhrtour Mailingliste noch nicht kennt, der schaut bitte weiter unten nach!<</p>>

  <</egXML>>

  This spec fragment is referred to by specgroup-core-redefinitions.

• pb (page break): marks the boundary between one page of a text and the next in a standard reference system.
  Spec fragment add_TEIform_to_pb

  Change element pb:

  Classes

  (add) model.ids.milestones

  Attributes

   

  TEIform

  (add this attribute)

  Default value

  pb

  This spec fragment is referred to by specgroup-core-redefinitions.

• ptr (pointer): defines a pointer to another location. IDS/XCES adds this element to the ids.milestones class.
  Spec fragment ptr_as_milestone

  Change element ptr:

  Classes

  (add) att.text

  (drop) att.global

  (add) model.ids.milestones

  Attributes

   

  target

  (change this attribute)

  the target of the pointer

  Type

  an XSD IDREFS value

  The original TEI target attribute of the class att.pointing comes out as of type CDATA from the ODD2DTD. (According to the TEI guidelines the type is 'datapointer' which stands for a single URI, which btw. correctly caused it to come out as xs:anyURI in the generated i5.xsd). But in the ids-xces.dtd it was IDREFS. Hence I include it here with an explicit specification of the IDREFS type.

  This spec fragment is referred to by specgroup-core-redefinitions.

• pubPlace (publication place): contains the name of the place where a bibliographic item was published.
• publisher: provides the name of the organization responsible for the publication or distribution of a bibliographic item.
• q (separated from the surrounding text with quotation marks): contains material which is marked as (ostensibly) being somehow different than the surrounding text, for any one of a variety of reasons including, but not limited to: direct speech or thought, technical terms or jargon, authorial distance, quotations from elsewhere, and passages that are mentioned but not used. CES adds several attributes.
  Spec fragment add_attributes_to_q

  Change element q:

  Attributes

   

  next

  (change this attribute)

  points to the next element of a virtual aggregate of which the current element is part. Specifically, for q elements, gives the ID of a subsequent q element which contains a continuation of the same quotation.

  Type

  an XSD IDREF value

  In TEI P5, this attribute is URI-valued; in P3 (and IDS/XCES), it is IDREF-valued.

  prev

  (change this attribute)

  points to the previous element of a virtual aggregate of which the current element is part. Specifically, for q elements, gives the ID of a preceding q element which contains the immediately preceding portion of the same quotation.

  Type

  an XSD IDREF value

  In TEI P5, this attribute is URI-valued; in P3 (and IDS/XCES), it is IDREF-valued.

  direct

  may be used to indicate whether the quoted matter is regarded as direct or indirect speech.

  Values

  y

  speech or thought is represented directly.

  n

  speech or thought is represented indirectly, e.g. by use of a marked verbal aspect.

  unspecified

  no claim is made.

  broken

  indicates whether this quotation or piece of dialog is broken between two or more q elements (linked using the next and prev attributes).

  Values

  y

  quotation is broken across two or more elements.

  n

  quotation is not broken across multiple elements.

  unspecified

  no claim is made.

  This spec fragment is referred to by specgroup-core-redefinitions.

• quote (quotation): contains a phrase or passage attributed by the narrator or author to some agency external to the text.
• ref (reference): defines a reference to another location, possibly modified by additional text or comment. IDS-XCES adds @orig.
• reg (regularization): contains a reading which has been regularized or normalized in some sense.
  Spec fragment redefine_reg

  Change element reg:

  Attributes

   

  orig

  (add this attribute)

  for the original

  Example:

  ToDo

  This spec fragment is referred to by specgroup-core-redefinitions.

• sp (speech): An individual speech in a performance text, or a passage presented as such in a prose or verse text. CES restricts this content model severely; IDS/XCES brings it back closer to the TEI form, and adds the class of IDS milestones to the legal content.
  Spec fragment redefine_sp

  Change element sp:

  Change contents to

  (speaker | p | quote | poem | stage | %model.ids.milestones;)*

  Attributes

   

  role

  (add this attribute)

  Role in plenary debate such as presidency or ordinary mp

  Type

  #PCDATA

  name

  (add this attribute)

  Name of speaker

  Type

  #PCDATA

  parliamentary_group

  (add this attribute)

  Parliamentary group (German "Fraktion") of speaker

  Type

  #PCDATA

  party

  (add this attribute)

  Partyof speaker

  Type

  #PCDATA

  Example:

  <sp who="Korzcak">
    <speaker/>
    <p>
      <s>Sie irren sich,
        <stage>erwiderte Korczak,</stage>
        nicht jeder ist ein Schuft<stage>, 
        und er schlug die Waggontür 
        hinter sich zu</stage>.</s>
    </p>
  </sp>

  This spec fragment is referred to by specgroup-core-redefinitions.

• speaker: A specialized form of heading or label, giving the name of one or more speakers in a dramatic text or fragment.
• stage (stage direction): contains any kind of stage direction within a dramatic text or fragment.
• term: contains a single-word, multi-word, or symbolic designation which is regarded as a technical term.
  Spec fragment add_term_to_token_class

  Change element term:

  Classes

  (add) model.token

  This spec fragment is referred to by specgroup-core-redefinitions.

• time: contains a phrase defining a time of day in any format.
  Spec fragment add_time_to_token_class

  Change element time:

  Classes

  (add) model.token

  This spec fragment is referred to by specgroup-core-redefinitions.

• title: contains a title for any kind of work.

1.3 The header module

1.4 The textstructure module

2.1 The analysis module

2.2 The corpus module

2.3 The figures module

2.4 The namesdates module

As a conservative extension, the I5 vocabulary now includes 11 elements from the namesdates module. The rest of the module might as well be included, but are suppressed because they do not seem to be needed for now.

2.5 The linking module

In DeReKo, the elements ref, ptr, and xptr are used for linking. ref is already included in I5 through the core module. The elements xref and xptr were declared in the linking module in TEI P3 and P4, but they are no longer part of TEI P5. From the TEI P5 linking module, only the elements timeline and seg are taken. They are needed for the encoding of CMC documents

The following specification fragment includes the linking module and makes and delete all elemente except seg, timeline, and when.

2.6 TEI modules not included

4.1 Elements taken over without change from CES and XCES

CES moves the rend attribute from the list of global attributes to the text class; for now, we follow TEI here.

4.2 Elements defined by (X)CES and modified by IDS/XCES

• caption: (1) a heading, title etc. attached to a picture or diagram (2) a "pull quote" or other text about or extracted from a text and superimposed upon it to draw attention to it. This element was added by CES; it conflicts (possibly unintentionally) with a different element also named caption defined by TEI P3 for text displayed in a film (or text in a screenplay intended for such display). IDS/XCES modifies the CES version by allowing IDS milestones in the content.
  Spec fragment ids-doc-caption

  <caption> element (new)

   

  (1) a heading, title etc. attached to a picture or diagram; (2) a ‘pull quote’ or other text about or extracted from a text and superimposed upon it to draw attention to it. IDS-XCES adds ptr to the content model.

  Classes

  att.text

  Contains

  (head*, (p | %model.inter; | %model.ids.milestones;)+)

  Attributes

   

  type

  categorizes the caption

  Default value

  unspec

  Values

  byline

  caption containing authorship of an article

  display

  extra-textual caption (displayed box, etc.)

  attached

  caption describing a figure, photograph, etc.

  unspec

  not specified or unknown

  Example:

  <caption id="zi3.62406-0-c1" type="display">
    <quote>
      <s>"die Käufer werden dem Champagner
         treu bleiben, auch wenn er wieder 
         teurer wird"</s>
      <s>
        <title>Claude Taittinger
         Generaldirektor von Champagne 
         Taittinger</title>
      </s>
    </quote>
  </caption>

  This spec fragment is referred to by specgroup-XCES-changed.

• poem (in file ids.xesdoc.dtd): contains a poem, or an extract from a poem, appearing within or between paragraphs; an inter-level element. IDS changes CES's definition to allow milestone elements among the children.
  Spec fragment ids-doc-poem

  <poem> element (new)

   

  contains a poem appearing within or between paragraphs; an inter-level element.

  Classes

  att.text

  model.inter

  Contains

  (head?, (lg | l | %model.ids.milestones;)+)

  Example:

  <p>
    ...
    <s>Denn auch für diesen hilflosen, 
    aber unbestechlichen Chronisten der 
    dunkelsten deutschen Jahre erweisen 
    die Verse Brechts ihre Gültigkeit:</s>
  </p>
  <poem>
    <lg part="u">
      <l part="u">
        <s>[...]</s>
      </l>
    </lg>
    <lg part="u">
      <l part="u">
        <s>Ihr, die ihr auftauchen werdet 
           aus der Flut</s>
      </l>
      <l part="u">
        <s>In der wir untergegangen sind</s>
      </l>
      ...
    </lg>
    ...
  </poem>

  This spec fragment is referred to by specgroup-XCES-changed.

4.3 Renamings of TEI elements

Several IDS/XCES elements are esssentially renamings (or context-dependent renamings) of TEI elements.

• idsCorpus (in file ids.xesdoc.dtd): renaming of teiCorpus, with slight difference in content model
• idsHeader (in file ids.xheader.elt): renaming of teiHeader
• idsDoc (in file ids.xesdoc.dtd): intermediate level between idsText and idsCorpus; conceptually similar to the TEI element, and structurally similar to teiCorpus but (just for that reason) cannot be declared as a renaming of either. HLU: For the time being, idsDoc is not put in the namespace http://www.ids-mannheim.de/i5 so that in an i5 document, it will work like idsCorpus, idsText and idsHeader. The latter are technical renamings of original TEI elements (using altIdent) and therefore cannot be put in a namespace other than the TEI namespace)
  Spec fragment ids-doc-idsDoc

  <idsDoc> element (new)

   

  contains a single document within an IDS corpus; may contain one or several texts.

  Classes

  att.global

  Contains

  (idsHeader, idsText+)

  Attributes

   

  type

  Type

  an XSD string value

  Default value

  text

  version

  Type

  #PCDATA

  TEIform

  Type

  an XSD NMTOKEN value

  Default value

  TEI.2

  This spec fragment is referred to by specgroup-renamings.

• idsText (in file ids.xesdoc.dtd): renaming of TEI element

4.4 TEI P3 elements no longer in P5

Some elements and attributes used by IDS/XCES were taken over from TEI P3, but are no longer present in TEI P5: xptr, xref, dateRange, and timeRange.

<xptr targType = "pb" targOrder = "u" doc = "korpref.bio" from =
                    "TK1.00018-5-PB5" to = "DITTO" TEIform = "xptr"/>

4.5 Elements and attributes added by IDS

4.6 Module, classes and elements from the TEI CMC SIG proposals " Beißwenger/Ermakova/Geyken/Lemnitzer/Storrer (2013): An XML Schema for the Representation of CMC Genres in TEI"

4.7 Elements from the TEI Correspondence SIG proposal

Copied from the github site of the TEI Correspondence SIG, specifically from the file proposal.xml as of 2015-01-08