Parliamentary proceedings corpora (PPCs) are a quintessential resource for a wide range of research questions from a number of SSH disciplines, such as history and sociolinguistics. Their most distinguishing characteristic is that they are (typically edited) transcriptions of spoken language produced in controlled and regulated circumstances. They are also rich in invaluable (sociodemographic) metadata as well as easily available under the Freedom of Information Acts set in place to enable informed participation by the public and to improve effective functioning of democratic systems, making the datasets even more valuable.
Given these reasons and the fact that parliamentary proceedings are often available on-line, many researchers have already compiled corpora of parliamentary proceedings. However, these corpora are encoded in a variety of different annotation schemes, limiting their interchange and re-use.
In order to overcome this problem, the presented recommendations, called Parla-CLARIN, propose a schema that can be used for encoding of parliamentary proceedings corpora, primarily for the purposes of scholarly investigations, and that could serve as a storage and interchange format for such corpora. These recommendations attempt to take into account the following aspects of PPC:
The recommendations are implemented as a parameterisation of the TEI Guidelines, which are XML-based recommendations for encoding texts for scholarly purposes. As opposed to most other such recommendations, the TEI Guidelines have the ambition to be applicable to texts in any natural language, of any date, in any literary genre or text type, without restriction on form or content. The TEI parameterisation proposed for Parla-CLARIN also allows a wide range of PPC to be encoded, while making explicit recommendations on the manner of encoding various phenomena. The recommendations are written as a TEI ODD document, on the basis of which it is possible to derive an XML schema expressed either as a RelaxNG schema, a DTD or a W3C schema.
When using these recommendations, the following points should be taken in consideration:
The rest of these recommendations are structured as follows:
These recommendations consist of guidelines, a formal TEI schema, and derived XML schemas in various schema languages. They are intended for the encoding of corpora of parliamentary proceedings, regardless of the language or country of origin, for the purposes of scholarly investigations, be they from the field of linguistics, political science, history or other humanities and social sciences disciplines. The recommendations are, in principle, not meant as the primary storage format of parliamentary proceedings, such as kept by governmental offices, for which Akoma Ntoso might be preferred.
In developing a schema for structuring data, two approaches can be adopted: a descriptive one, where as much as possible of the original data distinctions are kept in the target encoding; or a prescriptive one, where the target encoding is severely constrained, to enable seamless data interchange and esp. interoperability with software tools. The Parla-CLARIN recommendations adopt the descriptive approach, as the source data, time and effort devoted to converting it, the intended applications, as well as country-specific rules of parliamentary proceedings will differ considerably, and it is likely that any prescriptive schema would soon turn out to be too restrictive. Nevertheless, the recommendations do try to limit the plethora of encoding options otherwise available in TEI to those that could be sensibly applied to corpora of parliamentary proceedings, and where more than one option is available in TEI to encode a given phenomenon, the schema and especially the text guidelines attempt to recommend only one option.
It should be noted that for those preferring a prescriptive approach, the ParlaMint corpora and their schema should be consulted, which are interoperable and are accompanied by a number of scripts to validate and convert the corpora. But, while the ParlaMint corpora do contain rich (meta)data, they nevertheless support a more restricted view on encoding parliamentary proceedings than does Parla-CLARIN.
The Parla-CLARIN proposal is developed as a project of the CLARIN European Research Infrastructure for Language Resources and Technology. Before the beginning of this development, CLARIN had already organised a number of initiatives and events that deal with parliamentary corpora:
At these events, it became clear that existing parliamentary corpora are encoded in many different ways, presenting a barrier to their interchange. Therefore the CLARIN Interoperability Committee organised a focused ‘CLARIN ParlaFormat’ workshop (May 23-24, 2019, Amersfoort) with selected participants at which the idea of the Parla-CLARIN recommendations were introduced, the participants presented their own experiences with encoding parliamentary corpora and gave their comments to the draft proposal. The details are given in the slides of the workshop, with the introduction and response to comments being:
After the initial publication of Parla-CLARIN, the ParlaMint project developed corpora of 17 European parliaments, encoded to a specialisation of the Parla-CLARIN recommendations. As the ParlaMint corpora follow a much stricter encoding, they are also interoperable, and samples of the corpora, the schema used, and various scripts to process the corpora are available from the ParlaMint GitHub repository, while the complete corpora can be found on the CLARIN.SI repository. Certain decisions taken in the encoding of the ParlaMint corpora have also had an impact on the current Parla-CLARIN recommendations.
While there are a large number of recommendations and standards that could in principle be used to encode parliamentary proceedings, the Akoma Ntoso standard stands out in that it was explicitly developed as an XML format for encoding legislative and judiciary documents including parliamentary proceedings. Akoma Ntoso is an OASIS standard and has already been used to encode various legal documents in a number of countries. It defines an XML schema for modelling for legal documents (called AKN), uses FRBR concepts and has a built-in relation to ontologies.
It is thus a reasonable question why CLARIN did not simply adopt AKN, rather than developing a conceptually very different encoding schema. The main reasons for this are the following:
Nevertheless, AKN is an important schema for modelling parliamentary proceedings, and some solutions of AKN were used in developing the Parla-CLARIN proposal, in particular the typology of divisions of a document. Also developed was a (partial) conversion for AKN to Parla-CLARIN, which covers some example documents, further discussed in the Section on the Conversion from Akoma Ntoso.
The Resource Description Framework (RDF) is a W3C specification and a standard model for computer-processable data interchange on the Web. It is also the base format for modelling information in the context of Linked Open Data (LOD), an influential model for linking data on the Web. And while LOD data is typically not concerned with language data, there is also the ‘Linguistic Linked Open Data Cloud’ (LLOD) initiative which is explicitly targeted towards language resources. RDF/LOD has also been quite popular for modelling parliamentary debates (e.g. the already mentioned Talk of Europe LOD dataset), so, again, the question arises why not use RDF to encode such data, rather than developing a TEI-based solution.
In this case, the answer is, at least partially, to do with the community addressed by the Parla-CLARIN recommendations and the preferences of this community: while LOD is targeted to computer scientists and the concept of a machine-processable and linked Word-Wide Web, TEI much more addresses researchers from (digital) humanities and of internally complete resources. In practical terms, this is seen in the difference between RDF encoded data, which is machine processable but hardly human readable or editable and highly connected to external data sources, while TEI documents are relatively self-explanatory, esp. after some exposure to the TEI Guidelines, can be edited in any XML editor and mostly self-contained. And while there exists the LLOD initiative that addresses linguistic annotation, the initiative seems to have lost momentum, and also has other concerns to addressing detailed encoding of a particular type of language resources - in fact, the same can be said for most RDF attempts at encoding parliamentary data, which encode only rather shallow aspects of such data.
But while this specification does not see RDF data as the ideal framework to encode parliamentary proceedings corpora for storage and interchange, it does take RDF as a useful down-stream model for exploiting such corpora, i.e. developing a TEI to RDF conversion is a concern, which is taken further in the Section on the Conversion to RDF.
A Parla-CLARIN corpus should, in general, capture as much of the text and markup from the source as possible, while the presence of graphical items or other elements that could not or were not transcribed should be indicated by markup, in particular with the use of <gap> as further explained in the Section on Gaps.
The corpus should be encoded in Unicode, using the UTF-8 character encoding, at least for European languages. In cases where the original contains characters from the Unicode Private Use Area, these should, if possible, be given their closest Unicode equivalents, or substituted by the Unicode replacement character U+FFFD.1
End-of-line hyphens can be removed, and the split words joined in order to enhance searching the corpus and to simplify linguistic processing. It is recommended that this practice is documented in the TEI header of the corpus, in the <hyphenation> element as explained in the Section on Documenting the encoding process.
The following characters, esp. prevalent when the source documents were in Word or HTML, deserve special mention:
While not required, it is sensible to also normalise sequences of whitespace characters into a single space or end-of-line character. Again, this simplifies further (esp. linguistic) processing.
The language of an element's text content is in TEI, as in XML, signaled by the value of its xml:lang attribute. The Parla-CLARIN recommendations require that each element that contains text is either marked by this attribute, or one of its ancestors is; in particular, the root element of the corpus should always have an xml:lang attribute. For multilingual documents (excluding cases where only a minor part of the text is in another language), the language code of the root element should be ‘mul’ for ‘multiple languages’. Note that if going by the ancestor axis, the values of two xml:lang are in conflict, the one closer to the context node is relevant one.
The values of xml:lang should follow BCP 47, cf. also ‘xml:lang in XML document schemas’.
Apart from the above considerations, a related question is where to draw the line between the object and meta languages, i.e. the language of the corpus and the language of the markup. The TEI defines the names of the elements and attributes in English, and the language of the corpus will, of course, depend on the country of the parliament. It is less straightforward to decide in which language the attribute values (such as the values of the type attribute) should be. Parla-CLARIN recommends that these should also be in English.
In order to simply refer to elements of a TEI document (i.e. a Parla-CLARIN corpus), elements can be marked with an ID, i.e. given the xml:id attribute with a unique value, obeying certain format requirements as defined by W3C.
Parla-CLARIN requires an xml:id attribute on the root element of each corpus file, which should, furthermore, be identical to the filename (modulo the file extension). Parla-CLARIN also recommends that the divisions of the document (element <div>) should also be given identifiers. While any element can be given an xml:id, this is, in general, not a good idea; rather, only those elements that will or could be referenced should be marked with this attribute.
TEI offers a number of attributes that contain (URI) pointers. Where the reference is to an element inside the document, the value of the xml:id being referred to should be preceded by a hash (#), as mandated by the XML standard. If the ID pointed to is from another document, then the full URI needs to be used.
Parliamentary corpora can contain significant time-related information, e.g. the date and time of a sitting, the start and end of an MP's affiliation to a particular party, the dates of the beginning and end of a political party etc. In general, such information in TEI is stored in the attributes of the pertinent element, which take as their values a date and possibly time, according to the ISO 8601 Date and Time Formats, and specified in the XML Schema Part 2: Datatypes Second Edition. TEI offers a very rich set of attributes and ancillary elements to specify time-related information, which are discussed in the Section on Dates and Times of the TEI Guidelines.
Parla-CLARIN users are free to use any of the TEI temporal attributes and elements, however, for most purposes, the following five attributes will suffice:
While these recommendations make the assumption that a complete PPC is one TEI XML document, this does not mean that it also has to be stored in one file, as the file structure is distinct from the concept of XML documents. To enable one XML document to be composed of many files, the XInclude mechanism should be used. Typically, a corpus will then be composed of a file containing the root XML element and the corpus header, while individual text files will be included in the corpus using the <include> element from the XInclude namespace, as illustrated by the following example:
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Sk-11/SI-1990-05-07-01.xml"/>⚓
As mentioned, we recommend that the file has the same name as the value of the xml:id attribute of the root element of the file. This e.g. guarantees that each file of the corpus has a unique name.
A Parla-CLARIN corpus has the <teiCorpus> element as the root element of the corpus XML document. It contains the <teiHeader> of the corpus containing the metadata for the corpus as a whole, followed by a series of <TEI> elements that each contain one corpus component.
We do not specify what an individual component should contain, as the size and granularity of parliamentary proceedings corpora, not to mention the national rules of structuring the workings of the parliament, differ substantially. Typically, however, an individual <TEI> element contains one sitting or session or one day, in any case such data that has metadata (encoded in its <teiHeader>) that distinguishes it from the other components of the corpus.
As illustrated below, the <text> element can, apart from the obligatory <body>, also contain front matter in <front> and back matter in <back>. While the <body> will contain the transcription proper (i.e. the speeches), the former contains preamble text, and the latter various appendices or texts that are related to the speeches.
In the text <body>, as well as in the <front> and <back> matter, the element that further organises the content into sections is the division, <div>, and each of the three text-bearing elements (if present) should contain at least one division.
Parliamentary proceedings often exist in two versions, the original, ‘raw’ transcription, and the edited, ‘redacted’ transcription, which is then published. If both versions can be available, it is interesting for some research questions to also have both versions transcriptions available for study in the scope of a PPC.
trans-raw.xml and one from the file trans-red.xml it is in this case enough to specify the xml:id on both elements and use the corresp attribute to point to the aligned segment: corresp="trans-raw.xml#raw.3 trans-raw.xml#raw.4".TEI allows significant metadata to be added to a document. The metadata is contained in the <teiHeader> element, which in corpora can appear at two levels:
It is recommended that the metadata that is common to the whole corpus is stored in the corpus TEI header, whereas the text-specific metadata is in the corpus text TEI header.
It is outside the scope of this specification to give all the details of a <teiHeader> element, for this, the user is referred to the Section on the TEI header of the TEI Guidelines, and, of course, to the example corpora that are part of the Parla-CLARIN Git repository. Here we do, however, give some examples and concentrate on the metadata that is esp. relevant to parliamentary proceedings corpora.
Unlike some other proposals, in particular Akoma Ntoso, the Parla-CLARIN recommendations assume that speaker meta-data is also included in the corpus,2 as this allows the corpus to be stand-alone with all the relevant data necessary for analysis already included in it.
Information on speakers is given in the corpus TEI header, in particular in the <listPerson> element, itself a part of the participant description, i.e. the <particDesc> element.
As illustrated above, further person metadata can contain the sex of the person and their birth date and place. Other potentially useful elements are the persons <death> date and place, as well as (possibly time stamped) <education>, <occupation>, and <affiliation>.
The example above uses, via the ref attribute, stand-off annotation to refer to the names of the parties, which should then be defined in a <taxonomy> element in the <teiHeader>, as explained in the Section on Party metadata. The same can be done for the affiliation to the national assembly (i.e. that the person is an MP), where, additionally, a reference, via the ana attribute, is given to the legislative period in which the person was an MP.
Persons can have further attributes, and TEI offers various elements (typically typed) to express them; they are introduced in the Section on Personal Characteristics of the TEI Guidelines. The two more general ones are <state>, which contains the description of some status or quality attributed to a person (or organisation), often at some specific time or for a specific date range and <trait>, which differs from <state> that it is independent of the volition or action of the holder and usually not at some specific time or for a specific date range. The former could, for example, be used to encode the fact that a PM was jailed for a given period of time, while the latter would e.g. be used for the information that a PM is handicapped.
The transcriptions of the parliamentary debates are the central part of these recommendations and this section explains how to encode the transcriptions of speeches proper, and how to treat the commentary inserted by the transcribers, which often marks various verbal and non-verbal incidents, such as applause, interruption of speeches, voting (with results) etc. Most of these elements are explained in the Chapter on Transcription of Speech of the TEI Guidelines, and we illustrate the essential ones below.
The utterances can (but are not required to) be segmented using the generic TEI element for segments, <seg>, which encodes the paragraphs of the source transcription.4
Transcriber comments encode information such as interruptions, notes on what is happening in the chamber, results of voting, etc. Note that while section headings can also be taken as a kind of transcriber comments, these serve to structure a document, and are therefore treated in the Section on Text divisions.
In general, transcriber comments are encoded using <note>, although some comments can be encoded using more precise TEI elements, as explained below. Whether <note> or these more specific elements will be used, and, indeed, whether comments are preserved in the encoding at all, will depend on the needs and resources of each particular project.
The first note simply gives the speaker of the utterance that would follow it, the second one gives the time when the session started, while the third and fourth are notes on the voting results. Note that in all three cases, instead of, or in addition to retaining such notes, the information contained in them can also be further explicated in dedicated markup. So, the information given in the first note will typically be encoded in the who attribute, the second could be encoded in the u/@when attribute, while how to encode the last two is explained in the Section on Voting results. It is therefore a matter of editorial policy whether to faithfully reproduce the transcription, including comments, or whether to remove the comments when they have already been taken into account when processing the transcriptions.
It should be noted that <note> and the four ‘incident’ elements can be placed either on the same level as the <u> elements, or directly inside them (so, on the same level as <seg> elements) or even inside <seg> elements. It is recommended to place them as far up the hierarchy as possible, and especially avoid having them inside elements with otherwise contain text only (i.e. utterances or segments), as placing elements there leads to mixed content, which is difficult to process further, in particular if the text is to be linguistically annotated. However, if a transcriber comment is placed in the middle of the text, then it needs to be encoded inside the utterance, except if the utterance is split, as is further explained in the Section on Interrupted utterances.
Boris Johnson: I propose a no-deal Brexit. /Jeremy Corbyn: Traitor!/ Because England does not want any dealings with the European Union.⚓While the interruption might be simply encoded as a <note> or <vocal> element, as explained above, it is more precisely encoded as a separate utterance, which brings with it the problem that nested utterances are not allowed, so the main utterance then needs to be split into two (or more) pieces. The example below illustrates how this is encoded:
This section introduces basic types of linguistic annotation that can be added to PPCs; the examples should be sufficient for users to be able to add further types of linguistic annotation to PPC corpora.
It is recommended that linguistically annotated PPCs are stored in two versions, one with the linguistic annotations, and the other without them. The reason for this is that many users prefer to use the ‘plain-text’ version, e.g. because they want to perform their own linguistic annotation, or this kind of annotation is simply not relevant for their research questions.
The TEI Guidelines discuss basic linguistic annotation in their Chapter on Simple Analytic Mechanisms and we follow one particular option given there. In particular, it is recommended that (where possible) the annotation is in-line (as opposed to stand-off), i.e. that the linguistic annotation is given in the main document, and therefore mixed with the other annotations, rather than in a separate document with pointers into the base text.
The base form of a word is given in the lemma attribute,6 while the situation with the part-of-speech tags is somewhat more complicated. For analytic tagsets, where a "part-of-speech tag" is actually a set of attribute-values, as in the example above, the msd attribute should be used. For synthetic tagsets, such as the Penn Treebank tagset, which have atomic tags that cannot always be decomposed into attribute-value pairs (e.g. "TO" for the word "to"), a better alternative is to use of the pos attribute.
http://nl.ijs.si/ME/V6/msd/tables/msd-fslib2-sl.xml#Pd-nsg) which enables the feature-structure definitions to be stored externaly to the corpus. However, prefixing such PoS tags for each token by the complete URL would lead to very large files. This is why the TEI offers a mechanism to shorten references to URLs. This mechanism is explained in the Section Using Abbreviated Pointers of the TEI Guidelines, and we give below and example: mte: rather than #. This prefix should be then expanded by the processing software to whatever the <prefixDef> element, defined in the TEI header, specifies, as shown in the example below: In certain contexts a word (or, in general, a token) in the transcription needs to be normalised in a certain way. In the context of PPCs, this can happen with historical transcripts, which contain archaic wordforms and where we wish to annotate them with their modernised forms, or when the transcript is linguistically annotated, and the annotation framework distinguishes original words form syntactic words (i.e. has the concept of ‘multiwords’), as is the case in the Universal Dependencies framework.
For simple normalisation, where a one-word token is normalised into another word token, the norm attribute on word or punctuation tokens should be used, as explained at the end of the Section Lightweight Linguistic Annotation of the TEI Guidelines.
The contained links then give the references to the head and argument tokens of the relation, while the ana attribute specifies what kind of a relation this is. It should be noted that the value of the analysis attribute is a pointer, and, in the example, we use the TEI prefix mechanism, which is then expanded via the <prefixDef> element in the TEI header to resolve into a URI pointer (as explained in Section on Identifiers and referencing), most likely to pointing to <taxonomy> categories that give the definitions of the relations. A further point to notice is that the sentence serves as the Root element of the sentence, i.e. the fifth link of the UD analysis ties together the sentence with the top-most token of the sentence.
Parliamentary corpora can also have data from other modalities associated with the transcripts, in particular audio or video recordings, and the facsimile of the original transcripts, particularly relevant for older parliamentary proceedings. This section explains how to encode such data in the TEI encoded documents, where it is assumed that the actual speech, video and images are stored in separate files, and the TEI document makes reference to them.
The transcription can refer to and align with external audio and video data using the <timeline> element, explained in the Section on Placing Synchronous Events in Time of the TEI Guidelines, and further elaborated in ISO 24624:2016 Language resource management -- Transcription of spoken language. While the ISO standard is better elaborated, it also changes and adds element definitions, so we are using the standard TEI variant of speech encoding as far as the schema is concerned, while taking into account, as much as possible, specific encoding choices as proposed by the ISO standard.
The mapping of time intervals of the recording to IDs in the TEI document is encoded in the <timeline> element, in particular in the contained <when> elements. As explained below, these IDs are then used to link elements in the transcription to the timeline, therefore each <when> element must have the xml:id attribute. The <when> elements must also be in the same order as the time-points they encode.
s) and the time origin of the timeline, here referring to the first <when> element, at the very start of the recording, so specified with the absolute time. Further <when> elements give the interval between this origin point and their end: In cases where the facsimile of the original transcription is available (especially valuable for older parliamentary proceedings, where the exact appearance of the original proceedings is of interest), it is advantageous to enable viewing the original together with the encoded transcription. How to achieve this, in general, is explained in the Chapter on Representation of Primary Sources of the TEI Guidelines.
More complicated cases, such as delimiting portions of a page are also supported by the TEI Guidelines, and for these the reader is referred directly to the Section on Digital Facsimiles.
A TEI encoded document is, in general, not meant to be used directly by software programs, rather it serves as an interchange and storage format. Furthermore, most TEI documents are not "born TEI", but rather converted into TEI from some source format. In this section we discuss some up- and down-conversion scripts that have already been developed for transforming source formats into Parla-CLARIN and from Parla-CLARIN into formats immediately usable by software and are available in the Git repository of Parla-CLARIN.
As mentioned in the Section on Introducing Akoma Ntoso, this standard is used to encode parliamentary proceedings of several countries, and this section introduces the developed conversion of AKN documents to Parla-CLARIN. The example documents and conversion script can be found in the Examples/AkomaNtoso folder of the Parla-CLARIN Git repository. For a detailed treatment of the conversion, the XSLT script akn2tei.xsl should be consulted, while we here mention only some of the more aspects of the conversion.
sameAs) of the official FRBR definition of ‘work’, ‘expression’, and ‘manifestation’ (so, http://purl.org/vocab/frbr/) with the AKN recommended ontology of these terms, namely https://w3id.org/akn/ontology/allot/.questionAnswer. Such <listRelation> can be placed in an arbitrary portion of the document, as it contains links to IDs, but is, by convention, best placed inside the answer. We exemplify the Parla-CLARIN encoding of a question and answer below: As explained in the Section on Introducing RDF, this data model would be a useful ‘down-conversion’ of Parla-CLARIN corpora.
On the tei-l mailing list there have already been discussions on how to link TEI with RDF, summarised and with further links in Issue #1860 of the TEI GitHub project. The best way seems to be to either directly turn TEI markup into RDF triples, or, where this is not possible, to use the RDFa attribute on TEI elements.
An implementation might be best approached from the opposite direction, i.e. developing an ‘up-conversion’ to TEI of an existing RDF-encoded CPP.
The authors would like to thank all the participants of the CLARIN ParlaFormat workshop (May 23-24, 2019, Amersfoort) for their very useful comments and suggestions.
This proposal was inspired by a number of related projects, in particular: Best Practices for TEI in Libraries, the DARIAH and ELEXIS funded initiative TEI Lex0 to develop an interchange encoding for machine readable dictionaries, and the ELTeC corpus initiative by the COST Action CA16204 ‘Distant Reading for European Literary History’.
The work on these recommendations was funded by the CLARIN Research Infrastructure for Language Resources and Tools.
This section gives a complete example document that validates according to Parla-CLARIN and aims to illustrate the encoding of various aspects of parliamentary proceedings corpora.
| <TEI> (TEI document) contains a single TEI-conformant document, combining a single TEI header with one or more members of the model.resource class. Multiple <TEI> elements may be combined within a <TEI> (or <teiCorpus>) element. [4. Default Text Structure 15.1. Varieties of Composite Text] | |||||||||
| Module | textstructure — Formal specification | ||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
| ||||||||
| Member of | |||||||||
| Contained by | |||||||||
| May contain | |||||||||
| Note | This element is required. It is customary to specify the TEI namespace | ||||||||
| Example | <TEI version="3.3.0" xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader>
<fileDesc>
<titleStmt>
<title>The shortest TEI Document Imaginable</title>
</titleStmt>
<publicationStmt>
<p>First published as part of TEI P2, this is the P5
version using a name space.</p>
</publicationStmt>
<sourceDesc>
<p>No source: this is an original work.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<p>This is about the shortest TEI document imaginable.</p>
</body>
</text>
</TEI> | ||||||||
| Example | <TEI version="2.9.1" xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader>
<fileDesc>
<titleStmt>
<title>A TEI Document containing four page images </title>
</titleStmt>
<publicationStmt>
<p>Unpublished demonstration file.</p>
</publicationStmt>
<sourceDesc>
<p>No source: this is an original work.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<facsimile>
<graphic url="page1.png"/>
<graphic url="page2.png"/>
<graphic url="page3.png"/>
<graphic url="page4.png"/>
</facsimile>
</TEI> | ||||||||
| Schematron |
<sch:ns prefix="tei"
uri="http://www.tei-c.org/ns/1.0"/>
<sch:ns prefix="xs"
uri="http://www.w3.org/2001/XMLSchema"/> | ||||||||
| Schematron |
<sch:ns prefix="rng"
uri="http://relaxng.org/ns/structure/1.0"/> | ||||||||
| Content model |
<content>
<sequence>
<elementRef key="teiHeader"/>
<alternate>
<sequence>
<classRef key="model.resource"
minOccurs="1" maxOccurs="unbounded"/>
<elementRef key="TEI" minOccurs="0"
maxOccurs="unbounded"/>
</sequence>
<elementRef key="TEI" minOccurs="1"
maxOccurs="unbounded"/>
</alternate>
</sequence>
</content>
⚓ | ||||||||
| Schema Declaration |
element TEI
{
tei_att.global.attributes,
tei_att.typed.attributes,
attribute version { text }?,
( tei_teiHeader, ( ( tei_model.resource+, tei_TEI* ) | tei_TEI+ ) )
}⚓ | ||||||||
| <ab> (anonymous block) contains any arbitrary component-level unit of text, acting as an anonymous container for phrase or inter level elements analogous to, but without the semantic baggage of, a paragraph. [16.3. Blocks, Segments, and Anchors] | |
| Module | linking — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.declaring (@decls) att.fragmentable (@part) att.written (@hand) |
| Member of | |
| Contained by | corpus: particDesc setting settingDesc header: abstract application availability cRefPattern calendar change correction correspAction correspContext correspDesc editionStmt editorialDecl encodingDesc hyphenation interpretation langUsage licence normalization prefixDef projectDesc publicationStmt punctuation quotation refsDecl samplingDecl segmentation seriesStmt sourceDesc stdVals styleDefDecl namesdates: climate event langKnowledge listRelation nym object occupation org person personGrp persona place population state terrain trait transcr: metamark |
| May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | The <ab> element may be used at the encoder's discretion to mark any component-level elements in a text for which no other more specific appropriate markup is defined. |
| Example | <div type="book" n="Genesis">
<div type="chapter" n="1">
<ab>In the beginning God created the heaven and the earth.</ab>
<ab>And the earth was without form, and void; and
darkness was upon the face of the deep. And the
spirit of God moved upon the face of the waters.</ab>
<ab>And God said, Let there be light: and there was light.</ab>
<!-- ...-->
</div>
</div> |
| Schematron |
<sch:report test=" (ancestor::tei:p or ancestor::tei:ab) and not( ancestor::tei:floatingText
|parent::tei:exemplum |parent::tei:item |parent::tei:note |parent::tei:q
|parent::tei:quote |parent::tei:remarks |parent::tei:said |parent::tei:sp
|parent::tei:stage |parent::tei:cell |parent::tei:figure )"> Abstract model violation: ab may not occur inside paragraphs or other ab elements.
</sch:report> |
| Schematron |
<sch:report test=" (ancestor::tei:l or ancestor::tei:lg) and not( ancestor::tei:floatingText
|parent::tei:figure |parent::tei:note )"> Abstract model violation: Lines may not contain higher-level divisions such as p or ab, unless ab is a child of figure or note, or is a descendant of floatingText.
</sch:report> |
| Content model |
<content>
<macroRef key="macro.paraContent"/>
</content>
⚓ |
| Schema Declaration |
element ab
{
tei_att.global.attributes,
tei_att.typed.attributes,
tei_att.declaring.attributes,
tei_att.fragmentable.attributes,
tei_att.written.attributes,
tei_macro.paraContent
}⚓ |
| <abbr> (abbreviation) contains an abbreviation of any sort. [3.6.5. Abbreviations and Their Expansions] | |||||||||||||
| Module | core — Formal specification | ||||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (type, @subtype)
| ||||||||||||
| Member of | |||||||||||||
| Contained by | core: abbr add addrLine author bibl biblScope choice citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode creation distributor edition extent funder geoDecl language licence principal rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: docDate | ||||||||||||
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||||||||
| Note | If abbreviations are expanded silently, this practice should be documented in the <editorialDecl>, either with a <normalization> element or a <p>. | ||||||||||||
| Example | <choice>
<expan>North Atlantic Treaty Organization</expan>
<abbr cert="low">NorATO</abbr>
<abbr cert="high">NATO</abbr>
<abbr cert="high" xml:lang="fr">OTAN</abbr>
</choice> | ||||||||||||
| Example | <choice>
<abbr>SPQR</abbr>
<expan>senatus populusque romanorum</expan>
</choice> | ||||||||||||
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ | ||||||||||||
| Schema Declaration |
element abbr
{
tei_att.global.attributes,
tei_att.typed.attribute.subtype,
attribute type { text }?,
tei_macro.phraseSeq
}⚓ | ||||||||||||
| <abstract> contains a summary or formal abstract prefixed to an existing source document by the encoder. [2.4.4. Abstracts] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | header: profileDesc |
| May contain | figures: table linking: ab namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation |
| Note | This element is intended only for cases where no abstract is available in the original source. Any abstract already present in the source document should be encoded as a <div> within the <front>, as it should for a born-digital document. |
| Example | <profileDesc>
<abstract resp="#LB">
<p>Good database design involves the acquisition and deployment of
skills which have a wider relevance to the educational process. From
a set of more or less instinctive rules of thumb a formal discipline
or "methodology" of database design has evolved. Applying that
methodology can be of great benefit to a very wide range of academic
subjects: it requires fundamental skills of abstraction and
generalisation and it provides a simple mechanism whereby complex
ideas and information structures can be represented and manipulated,
even without the use of a computer. </p>
</abstract>
</profileDesc> |
| Content model |
<content>
<alternate minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.pLike"/>
<classRef key="model.listLike"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element abstract
{
tei_att.global.attributes,
( tei_model.pLike | tei_model.listLike )+
}⚓ |
| <activity> (activity) contains a brief informal description of what a participant in a language interaction is doing other than speaking, if anything. [15.2.3. The Setting Description] | |
| Module | corpus — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | corpus: setting |
| May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data |
| Note | For more fine-grained description of participant activities during a spoken text, the <event> element should be used. |
| Example | <activity>driving</activity> |
| Content model |
<content>
<macroRef key="macro.phraseSeq.limited"/>
</content>
⚓ |
| Schema Declaration |
element activity { tei_att.global.attributes, tei_macro.phraseSeq.limited }⚓ |
| <add> (addition) contains letters, words, or phrases inserted in the source text by an author, scribe, or a previous annotator or corrector. [3.5.3. Additions, Deletions, and Omissions] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.placement (@place) att.typed (@type, @subtype) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) |
| Member of | |
| Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure mentioned name note num orig p pubPlace publisher q quote rb ref reg rs rt said sic soCalled speaker stage street term textLang time title unclear unit figures: cell namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: docDate |
| May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | In a diplomatic edition attempting to represent an original source, the <add> element should not be used for additions to the current TEI electronic edition made by editors or encoders. In these cases, either the <corr> or <supplied> element are recommended. In a TEI edition of a historical text with previous editorial emendations in which such additions or reconstructions are considered part of the source text, the use of <add> may be appropriate, dependent on the editorial philosophy of the project. |
| Example | The story I am
going to relate is true as to its main facts, and as to the
consequences <add place="above">of these facts</add> from which
this tale takes its title. |
| Content model |
<content>
<macroRef key="macro.paraContent"/>
</content>
⚓ |
| Schema Declaration |
element add
{
tei_att.global.attributes,
tei_att.transcriptional.attributes,
tei_att.placement.attributes,
tei_att.typed.attributes,
tei_att.dimensions.attributes,
tei_macro.paraContent
}⚓ |
| <addSpan> (added span of text) marks the beginning of a longer sequence of text added by an author, scribe, annotator or corrector (see also <add>). [11.3.1.4. Additions and Deletions] | |
| Module | transcr — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.transcriptional (@status, @cause, @seq) (att.editLike (@evidence, @instant)) (att.written (@hand)) att.placement (@place) att.typed (@type, @subtype) att.spanning (@spanTo) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) |
| Member of | |
| Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
| May contain | Empty element |
| Note | Both the beginning and the end of the added material must be marked; the beginning by the <addSpan> element itself, the end by the spanTo attribute. |
| Example | <handNote xml:id="HEOL"
scribe="HelgiÓlafsson"/>
<!-- ... -->
<body>
<div>
<!-- text here -->
</div>
<addSpan n="added_gathering" hand="#HEOL"
spanTo="#P025"/>
<div>
<!-- text of first added poem here -->
</div>
<div>
<!-- text of second added poem here -->
</div>
<div>
<!-- text of third added poem here -->
</div>
<div>
<!-- text of fourth added poem here -->
</div>
<anchor xml:id="P025"/>
<div>
<!-- more text here -->
</div>
</body> |
| Schematron |
<sch:assert test="@spanTo">The @spanTo attribute of <sch:name/> is required.</sch:assert> |
| Schematron |
<sch:assert test="@spanTo">L'attribut spanTo est requis.</sch:assert> |
| Content model |
<content>
<empty/>
</content>
⚓ |
| Schema Declaration |
element addSpan
{
tei_att.global.attributes,
tei_att.transcriptional.attributes,
tei_att.placement.attributes,
tei_att.typed.attributes,
tei_att.spanning.attributes,
tei_att.dimensions.attributes,
empty
}⚓ |
| <addrLine> (address line) contains one line of a postal address. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | core: address |
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | Addresses may be encoded either as a sequence of lines, or using any sequence of component elements from the model.addrPart class. Other non-postal forms of address, such as telephone numbers or email, should not be included within an <address> element directly but may be wrapped within an <addrLine> if they form part of the printed address in some source text. |
| Example | <address>
<addrLine>Computing Center, MC 135</addrLine>
<addrLine>P.O. Box 6998</addrLine>
<addrLine>Chicago, IL</addrLine>
<addrLine>60680 USA</addrLine>
</address> |
| Example | <addrLine>
<ref target="tel:+1-201-555-0123">(201) 555 0123</ref>
</addrLine> |
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ |
| Schema Declaration |
element addrLine { tei_att.global.attributes, tei_macro.phraseSeq }⚓ |
| <address> (address) contains a postal address, for example of a publisher, an organization, or an individual. [3.6.2. Addresses 2.2.4. Publication, Distribution, Licensing, etc. 3.12.2.4. Imprint, Size of a Document, and Reprint Information] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl language licence principal publicationStmt rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectIdentifier objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: docDate |
| May contain | figures: figure notatedMusic header: idno namesdates: addName bloc climate country district forename genName geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin |
| Note | This element should be used for postal addresses only. Within it, the generic element <addrLine> may be used as an alternative to any of the more specialized elements available from the model.addrPart class, such as <street>, <postCode> etc. |
| Example | Using just the elements defined by the core module, an address could be represented as follows: <address>
<street>via Marsala 24</street>
<postCode>40126</postCode>
<name>Bologna</name>
<name>Italy</name>
</address> |
| Example | When a schema includes the names and dates module more specific elements such as country or settlement would be preferable over generic <name>: <address>
<street>via Marsala 24</street>
<postCode>40126</postCode>
<settlement>Bologna</settlement>
<country>Italy</country>
</address> |
| Example | <address>
<addrLine>Computing Center, MC 135</addrLine>
<addrLine>P.O. Box 6998</addrLine>
<addrLine>Chicago, IL 60680</addrLine>
<addrLine>USA</addrLine>
</address> |
| Example | <address>
<country key="FR"/>
<settlement type="city">Lyon</settlement>
<postCode>69002</postCode>
<district type="arrondissement">IIème</district>
<district type="quartier">Perrache</district>
<street>
<num>30</num>, Cours de Verdun</street>
</address> |
| Content model |
<content>
<sequence>
<classRef key="model.global"
minOccurs="0" maxOccurs="unbounded"/>
<sequence minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.addrPart"/>
<classRef key="model.global"
minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</sequence>
</content>
⚓ |
| Schema Declaration |
element address
{
tei_att.global.attributes,
( tei_model.global*, ( tei_model.addrPart, tei_model.global* )+ )
}⚓ |
| <affiliation> (affiliation) contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor. [15.2.2. The Participant Description] | |||||||||||
| Module | namesdates — Formal specification | ||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)
| ||||||||||
| Member of | |||||||||||
| Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode correspAction creation distributor edition extent funder geoDecl language licence principal rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname textstructure: docDate | ||||||||||
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||||||
| Note | If included, the name of an organization may be tagged using either the <name> element as above, or the more specific <orgName> element. | ||||||||||
| Example | <affiliation>Junior project officer for the US <name type="org">National Endowment for
the Humanities</name>
</affiliation> | ||||||||||
| Example | This example indicates that the person was affiliated with the Australian Journalists Association at some point between the dates listed. <affiliation notAfter="1960-01-01"
notBefore="1957-02-28">Paid up member of the
<orgName>Australian Journalists Association</orgName>
</affiliation> | ||||||||||
| Example | This example indicates that the person was affiliated with Mount Holyoke College throughout the entire span of the date range listed. <affiliation from="1902-01-01"
to="1906-01-01">Was an assistant professor at Mount Holyoke College.</affiliation> | ||||||||||
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ | ||||||||||
| Schema Declaration |
element affiliation
{
tei_att.global.attributes,
tei_att.editLike.attributes,
tei_att.datable.attributes,
tei_att.naming.attributes,
tei_att.typed.attribute.subtype,
attribute type { text }?,
tei_macro.phraseSeq
}⚓ | ||||||||||
| <age> (age) specifies the age of a person. [13.3.2.1. Personal Characteristics] | |||||||||||||||||||
| Module | namesdates — Formal specification | ||||||||||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.typed (type, @subtype)
| ||||||||||||||||||
| Member of | |||||||||||||||||||
| Contained by | |||||||||||||||||||
| May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data | ||||||||||||||||||
| Note | As with other culturally-constructed traits such as sex, the way in which this concept is described in different cultural contexts may vary. The normalizing attributes are provided as a means of simplifying that variety to Western European norms and should not be used where that is inappropriate. The content of the element may be used to describe the intended concept in more detail, using plain text. | ||||||||||||||||||
| Example | <age value="2" notAfter="1986">under 20 in the early eighties</age> | ||||||||||||||||||
| Content model |
<content>
<macroRef key="macro.phraseSeq.limited"/>
</content>
⚓ | ||||||||||||||||||
| Schema Declaration |
element age
{
tei_att.global.attributes,
tei_att.editLike.attributes,
tei_att.datable.attributes,
tei_att.typed.attribute.subtype,
tei_att.dimensions.attributes,
attribute type { text }?,
attribute value { text }?,
tei_macro.phraseSeq.limited
}⚓ | ||||||||||||||||||
| <alt> (alternation) identifies an alternation or a set of choices among elements or passages. [16.8. Alternation] | |||||||||||||||||||||||||
| Module | linking — Formal specification | ||||||||||||||||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.pointing (target, @targetLang, @evaluate)
| ||||||||||||||||||||||||
| Member of | |||||||||||||||||||||||||
| Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname | ||||||||||||||||||||||||
| May contain | Empty element | ||||||||||||||||||||||||
| Example | <alt mode="excl" target="#we.fun #we.sun"
weights="0.5 0.5"/> | ||||||||||||||||||||||||
| Content model |
<content>
<empty/>
</content>
⚓ | ||||||||||||||||||||||||
| Schema Declaration |
element alt
{
tei_att.global.attributes,
tei_att.pointing.attribute.targetLang,
tei_att.pointing.attribute.evaluate,
tei_att.typed.attributes,
attribute target { list { * } }?,
attribute mode { "excl" | "incl" }?,
attribute weights { list { * } }?,
empty
}⚓ | ||||||||||||||||||||||||
| <altGrp> (alternation group) groups a collection of <alt> elements and possibly pointers. [16.8. Alternation] | |||||||||
| Module | linking — Formal specification | ||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing.group (@domains, @targFunc) (att.pointing (@targetLang, @target, @evaluate)) (att.typed (@type, @subtype))
| ||||||||
| Member of | |||||||||
| Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname | ||||||||
| May contain | |||||||||
| Note | Any number of alternations, pointers or extended pointers. | ||||||||
| Example | <altGrp mode="excl">
<alt target="#dm #lt #bb"
weights="0.5 0.25 0.25"/>
<alt target="#rl #db" weights="0.5 0.5"/>
</altGrp> | ||||||||
| Example | <altGrp mode="incl">
<alt target="#dm #rl" weights="0.90 0.90"/>
<alt target="#lt #rl" weights="0.5 0.5"/>
<alt target="#bb #rl" weights="0.5 0.5"/>
<alt target="#dm #db" weights="0.10 0.10"/>
<alt target="#lt #db" weights="0.45 0.90"/>
<alt target="#bb #db" weights="0.45 0.90"/>
</altGrp> | ||||||||
| Content model |
<content>
<sequence>
<classRef key="model.descLike"
minOccurs="0" maxOccurs="unbounded"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<elementRef key="alt"/>
<elementRef key="ptr"/>
</alternate>
</sequence>
</content>
⚓ | ||||||||
| Schema Declaration |
element altGrp
{
tei_att.global.attributes,
tei_att.pointing.group.attributes,
attribute mode { "excl" | "incl" }?,
( tei_model.descLike*, ( tei_alt | tei_ptr )* )
}⚓ | ||||||||
| <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. [3.12.2.1. Analytic, Monographic, and Series Levels] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Contained by | core: biblStruct |
| May contain | |
| Note | May contain titles and statements of responsibility (author, editor, or other), in any order. The <analytic> element may only occur within a <biblStruct>, where its use is mandatory for the description of an analytic level bibliographic item. |
| Example | <biblStruct>
<analytic>
<author>Chesnutt, David</author>
<title>Historical Editions in the States</title>
</analytic>
<monogr>
<title level="j">Computers and the Humanities</title>
<imprint>
<date when="1991-12">(December, 1991):</date>
</imprint>
<biblScope>25.6</biblScope>
<biblScope>377–380</biblScope>
</monogr>
</biblStruct> |
| Content model |
<content>
<alternate minOccurs="0"
maxOccurs="unbounded">
<elementRef key="author"/>
<elementRef key="editor"/>
<elementRef key="respStmt"/>
<elementRef key="title"/>
<classRef key="model.ptrLike"/>
<elementRef key="date"/>
<elementRef key="textLang"/>
<elementRef key="idno"/>
<elementRef key="availability"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element analytic
{
tei_att.global.attributes,
(
tei_author
| tei_editor
| tei_respStmt
| tei_title
| tei_model.ptrLike
| tei_date
| tei_textLang
| tei_idno
| tei_availability
)*
}⚓ |
| <anchor> (anchor point) attaches an identifier to a point within a text, whether or not it corresponds with a textual element. [8.4.2. Synchronization and Overlap 16.5. Correspondence and Alignment] | |
| Module | linking — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) |
| Member of | |
| Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list listBibl measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
| May contain | Empty element |
| Note | On this element, the global xml:id attribute must be supplied to specify an identifier for the point at which this element occurs within a document. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence. |
| Example | <s>The anchor is he<anchor xml:id="A234"/>re somewhere.</s>
<s>Help me find it.<ptr target="#A234"/>
</s> |
| Content model |
<content>
<empty/>
</content>
⚓ |
| Schema Declaration |
element anchor { tei_att.global.attributes, tei_att.typed.attributes, empty }⚓ |
| <annotation> represents an annotation following the Web Annotation Data Model. [16.10. The standOff Container] | |||||||||||||||||||||||||||
| Module | linking — Formal specification | ||||||||||||||||||||||||||
| Attributes | att.global (xml:id, @n, @xml:lang, @xml:base, @xml:space) att.global.rendition (@rend, @style, @rendition) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.analytic (@ana) att.global.facs (@facs) att.global.change (@change) att.global.responsibility (@cert, @resp) att.global.source (@source) att.pointing (target, @targetLang, @evaluate)
| ||||||||||||||||||||||||||
| Member of | |||||||||||||||||||||||||||
| Contained by | linking: listAnnotation standOff | ||||||||||||||||||||||||||
| May contain | |||||||||||||||||||||||||||
| Example | <annotation xml:id="ann1"
motivation="linking" target="#Gallia">
<!-- See https://www.w3.org/TR/annotation-model/#lifecycle-information and
https://www.w3.org/TR/annotation-model/#agents -->
<respStmt xml:id="fred">
<resp>creator</resp>
<persName>Fred Editor</persName>
</respStmt>
<revisionDesc>
<change status="created"
when="2020-05-21T13:59:00Z" who="#fred"/>
<change status="modified"
when="2020-05-21T19:48:00Z" who="#fred"/>
</revisionDesc>
<!-- See https://www.w3.org/TR/annotation-model/#rights-information -->
<licence target="http://creativecommons.org/licenses/by/3.0/"/>
<!-- Multiple bodies -->
<!-- Pointers to sections of text in the same document -->
<ptr target="#string-range(c1p1s1,0,6)"/>
<ptr target="#string-range(c1p1s6,19,7)"/>
</annotation> | ||||||||||||||||||||||||||
| Example | <annotation xml:id="TheCorrectTitle"
motivation="commenting" target="#line1">
<note>The correct title of this specification, and the correct full name of XML, is
"Extensible Markup Language". "eXtensible Markup Language" is just a spelling error.
However, the abbreviation "XML" is not only correct but, appearing as it does in the title
of the specification, an official name of the Extensible Markup Language. </note>
</annotation> | ||||||||||||||||||||||||||
| Content model |
<content>
<sequence>
<elementRef key="respStmt" minOccurs="0"
maxOccurs="unbounded"/>
<elementRef key="revisionDesc"
minOccurs="0" maxOccurs="unbounded"/>
<elementRef key="licence" minOccurs="0"
maxOccurs="unbounded"/>
<classRef key="model.annotationPart.body"
minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</content>
⚓ | ||||||||||||||||||||||||||
| Schema Declaration |
element annotation
{
tei_att.global.attribute.n,
tei_att.global.attribute.xmllang,
tei_att.global.attribute.xmlbase,
tei_att.global.attribute.xmlspace,
tei_att.global.rendition.attribute.rend,
tei_att.global.rendition.attribute.style,
tei_att.global.rendition.attribute.rendition,
tei_att.global.linking.attribute.corresp,
tei_att.global.linking.attribute.synch,
tei_att.global.linking.attribute.sameAs,
tei_att.global.linking.attribute.copyOf,
tei_att.global.linking.attribute.next,
tei_att.global.linking.attribute.prev,
tei_att.global.linking.attribute.exclude,
tei_att.global.linking.attribute.select,
tei_att.global.analytic.attribute.ana,
tei_att.global.facs.attribute.facs,
tei_att.global.change.attribute.change,
tei_att.global.responsibility.attribute.cert,
tei_att.global.responsibility.attribute.resp,
tei_att.global.source.attribute.source,
tei_att.pointing.attribute.targetLang,
tei_att.pointing.attribute.evaluate,
attribute xml:id { text },
attribute target { list { + } },
attribute motivation
{
list
{
(
"assessing"
| "bookmarking"
| "classifying"
| "commenting"
| "describing"
| "editing"
| "highlighting"
| "identifying"
| "linking"
| "moderating"
| "questioning"
| "replying"
| "tagging"
)+
}
}?,
(
tei_respStmt*,
tei_revisionDesc*,
tei_licence*,
tei_model.annotationPart.body*
)
}⚓ | ||||||||||||||||||||||||||
| <annotationBlock> groups together various annotations, e.g. for parallel interpretations of a spoken segment. [8.4.6. Analytic Coding] | |
| Module | spoken — Formal specification |
| Attributes | att.ascribed (@who) att.timed (@start, @end) (att.duration (att.duration.w3c (@dur)) (att.duration.iso (@dur-iso)) ) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | |
| May contain | |
| Example | <annotationBlock who="#SPK1" start="#T2"
end="#T3" xml:id="ag20">
<u xml:id="u20">
<seg xml:id="seg37" type="utterance"
subtype="modeless">
<w xml:id="w46">Yeah</w>
</seg>
</u>
</annotationBlock>
<annotationBlock who="#SPK1" start="#T5"
end="#T6" xml:id="ag21">
<u xml:id="u21">
<seg xml:id="seg38" type="utterance"
subtype="modeless">
<w xml:id="w47">Mhm</w>
</seg>
</u>
</annotationBlock> |
| Content model |
<content>
<alternate minOccurs="0"
maxOccurs="unbounded">
<elementRef key="u"/>
<elementRef key="spanGrp"/>
<classRef key="model.global.spoken"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element annotationBlock
{
tei_att.ascribed.attributes,
tei_att.timed.attributes,
tei_att.global.attributes,
( tei_u | tei_spanGrp | tei_model.global.spoken )*
}⚓ |
| <appInfo> (application information) records information about an application which has edited the TEI file. [2.3.11. The Application Information Element] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | header: encodingDesc |
| May contain | header: application |
| Example | <appInfo>
<application version="1.24" ident="Xaira">
<label>XAIRA Indexer</label>
<ptr target="#P1"/>
</application>
</appInfo> |
| Content model |
<content>
<classRef key="model.applicationLike"
minOccurs="1" maxOccurs="unbounded"/>
</content>
⚓ |
| Schema Declaration |
element appInfo { tei_att.global.attributes, tei_model.applicationLike+ }⚓ |
| <application> provides information about an application which has acted upon the document. [2.3.11. The Application Information Element] | |||||||||||||
| Module | header — Formal specification | ||||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod))
| ||||||||||||
| Member of | |||||||||||||
| Contained by | header: appInfo | ||||||||||||
| May contain | |||||||||||||
| Example | <appInfo>
<application version="1.5"
ident="ImageMarkupTool1" notAfter="2006-06-01">
<label>Image Markup Tool</label>
<ptr target="#P1"/>
<ptr target="#P2"/>
</application>
</appInfo> This example shows an appInfo element documenting the fact that version 1.5 of the Image Markup Tool1 application has an interest in two parts of a document which was last saved on June 6 2006. The parts concerned are accessible at the URLs given as target for the two <ptr> elements. | ||||||||||||
| Content model |
<content>
<sequence>
<classRef key="model.labelLike"
minOccurs="1" maxOccurs="unbounded"/>
<alternate>
<classRef key="model.ptrLike"
minOccurs="0" maxOccurs="unbounded"/>
<classRef key="model.pLike"
minOccurs="0" maxOccurs="unbounded"/>
</alternate>
</sequence>
</content>
⚓ | ||||||||||||
| Schema Declaration |
element application
{
tei_att.global.attributes,
tei_att.typed.attributes,
tei_att.datable.attributes,
attribute ident { text },
attribute version { text },
( tei_model.labelLike+, ( tei_model.ptrLike* | tei_model.pLike* ) )
}⚓ | ||||||||||||
| <author> (author) in a bibliographic reference, contains the name(s) of an author, personal or corporate, of a work; for example in the same form as that provided by a recognized bibliographic name authority. [3.12.2.2. Titles, Authors, and Editors 2.2.1. The Title Statement] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) |
| Member of | |
| Contained by | header: editionStmt titleStmt |
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | Particularly where cataloguing is likely to be based on the content of the header, it is advisable to use a generally recognized name authority file to supply the content for this element. The attributes key or ref may also be used to reference canonical information about the author(s) intended from any appropriate authority, such as a library catalogue or online resource. In the case of a broadcast, use this element for the name of the company or network responsible for making the broadcast. Where an author is unknown or unspecified, this element may contain text such as Unknown or Anonymous. When the appropriate TEI modules are in use, it may also contain detailed tagging of the names used for people, organizations or places, in particular where multiple names are given. |
| Example | <author>British Broadcasting Corporation</author>
<author>La Fayette, Marie Madeleine Pioche de la Vergne, comtesse de (1634–1693)</author>
<author>Anonymous</author>
<author>Bill and Melinda Gates Foundation</author>
<author>
<persName>Beaumont, Francis</persName> and
<persName>John Fletcher</persName>
</author>
<author>
<orgName key="BBC">British Broadcasting
Corporation</orgName>: Radio 3 Network
</author> |
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ |
| Schema Declaration |
element author
{
tei_att.global.attributes,
tei_att.naming.attributes,
tei_att.datable.attributes,
tei_macro.phraseSeq
}⚓ |
| <authority> (release authority) supplies the name of a person or other agency responsible for making a work available, other than a publisher or distributor. [2.2.4. Publication, Distribution, Licensing, etc.] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) |
| Member of | |
| Contained by | core: monogr header: publicationStmt |
| May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data |
| Example | <authority>John Smith</authority> |
| Content model |
<content>
<macroRef key="macro.phraseSeq.limited"/>
</content>
⚓ |
| Schema Declaration |
element authority
{
tei_att.global.attributes,
tei_att.canonical.attributes,
tei_macro.phraseSeq.limited
}⚓ |
| <availability> (availability) supplies information about the availability of a text, for example any restrictions on its use or distribution, its copyright status, any licence applying to it, etc. [2.2.4. Publication, Distribution, Licensing, etc.] | |||||||||
| Module | header — Formal specification | ||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default)
| ||||||||
| Member of | |||||||||
| Contained by | header: publicationStmt | ||||||||
| May contain | |||||||||
| Note | A consistent format should be adopted | ||||||||
| Example | <availability status="restricted">
<p>Available for academic research purposes only.</p>
</availability>
<availability status="free">
<p>In the public domain</p>
</availability>
<availability status="restricted">
<p>Available under licence from the publishers.</p>
</availability> | ||||||||
| Example | <availability>
<licence target="http://opensource.org/licenses/MIT">
<p>The MIT License
applies to this document.</p>
<p>Copyright (C) 2011 by The University of Victoria</p>
<p>Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:</p>
<p>The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.</p>
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.</p>
</licence>
</availability> | ||||||||
| Content model |
<content>
<alternate minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.availabilityPart"/>
<classRef key="model.pLike"/>
</alternate>
</content>
⚓ | ||||||||
| Schema Declaration |
element availability
{
tei_att.global.attributes,
tei_att.declarable.attributes,
attribute status { "free" | "unknown" | "restricted" }?,
( tei_model.availabilityPart | tei_model.pLike )+
}⚓ | ||||||||
| <back> (back matter) contains any appendixes, etc. following the main part of a text. [4.7. Back Matter 4. Default Text Structure] | |
| Module | textstructure — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls) |
| Contained by | |
| May contain | figures: figure notatedMusic table namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin |
| Note | Because cultural conventions differ as to which elements are grouped as back matter and which as front matter, the content models for the <back> and <front> elements are identical. |
| Example | <back>
<div type="appendix">
<head>The Golden Dream or, the Ingenuous Confession</head>
<p>TO shew the Depravity of human Nature, and how apt the Mind is to be misled by Trinkets
and false Appearances, Mrs. Two-Shoes does acknowledge, that after she became rich, she
had like to have been, too fond of Money
<!-- .... -->
</p>
</div>
<!-- ... -->
<div type="epistle">
<head>A letter from the Printer, which he desires may be inserted</head>
<salute>Sir.</salute>
<p>I have done with your Copy, so you may return it to the Vatican, if you please;
<!-- ... -->
</p>
</div>
<div type="advert">
<head>The Books usually read by the Scholars of Mrs Two-Shoes are these and are sold at Mr
Newbery's at the Bible and Sun in St Paul's Church-yard.</head>
<list>
<item n="1">The Christmas Box, Price 1d.</item>
<item n="2">The History of Giles Gingerbread, 1d.</item>
<!-- ... -->
<item n="42">A Curious Collection of Travels, selected from the Writers of all Nations,
10 Vol, Pr. bound 1l.</item>
</list>
</div>
<div type="advert">
<head>By the KING's Royal Patent, Are sold by J. NEWBERY, at the Bible and Sun in St.
Paul's Church-Yard.</head>
<list>
<item n="1">Dr. James's Powders for Fevers, the Small-Pox, Measles, Colds, &c. 2s.
6d</item>
<item n="2">Dr. Hooper's Female Pills, 1s.</item>
<!-- ... -->
</list>
</div>
</back> |
| Content model |
<content>
<sequence>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.frontPart"/>
<classRef key="model.pLike.front"/>
<classRef key="model.pLike"/>
<classRef key="model.listLike"/>
<classRef key="model.global"/>
</alternate>
<alternate minOccurs="0">
<sequence>
<classRef key="model.div1Like"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.frontPart"/>
<classRef key="model.div1Like"/>
<classRef key="model.global"/>
</alternate>
</sequence>
<sequence>
<classRef key="model.divLike"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.frontPart"/>
<classRef key="model.divLike"/>
<classRef key="model.global"/>
</alternate>
</sequence>
</alternate>
<sequence minOccurs="0">
<classRef key="model.divBottomPart"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.divBottomPart"/>
<classRef key="model.global"/>
</alternate>
</sequence>
</sequence>
</content>
⚓ |
| Schema Declaration |
element back
{
tei_att.global.attributes,
tei_att.declaring.attributes,
(
(
tei_model.frontPart
| tei_model.pLike.front
| tei_model.pLike
| tei_model.listLike
| tei_model.global
)*,
(
(
tei_model.div1Like,
( tei_model.frontPart | tei_model.div1Like | tei_model.global )*
)
| (
tei_model.divLike,
( tei_model.frontPart | tei_model.divLike | tei_model.global )*
)
)?,
(
tei_model.divBottomPart,
( tei_model.divBottomPart | tei_model.global )*
)?
)
}⚓ |
| <bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. [3.12.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.typed (@type, @subtype) att.sortable (@sortKey) att.docStatus (@status) |
| Member of | |
| Contained by | |
| May contain | core: abbr add address author bibl biblScope cb choice citedRange corr date del distinct editor ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp meeting mentioned milestone name note noteGrp num orig pb ptr pubPlace publisher q ref reg relatedItem respStmt rs series sic soCalled term textLang time title unclear unit figures: figure notatedMusic gaiji: g namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listRelation location nameLink objectIdentifier objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | Contains phrase-level elements, together with any combination of elements from the model.biblPart class |
| Example | <bibl>Blain, Clements and Grundy: Feminist Companion to Literature in English (Yale,
1990)</bibl> |
| Example | <bibl>
<title level="a">The Interesting story of the Children in the Wood</title>. In
<author>Victor E Neuberg</author>, <title>The Penny Histories</title>.
<publisher>OUP</publisher>
<date>1968</date>.
</bibl> |
| Example | <bibl type="article" subtype="book_chapter"
xml:id="carlin_2003">
<author>
<name>
<surname>Carlin</surname>
(<forename>Claire</forename>)</name>
</author>,
<title level="a">The Staging of Impotence : France’s last
congrès</title> dans
<bibl type="monogr">
<title level="m">Theatrum mundi : studies in honor of Ronald W.
Tobin</title>, éd.
<editor>
<name>
<forename>Claire</forename>
<surname>Carlin</surname>
</name>
</editor> et
<editor>
<name>
<forename>Kathleen</forename>
<surname>Wine</surname>
</name>
</editor>,
<pubPlace>Charlottesville, Va.</pubPlace>,
<publisher>Rookwood Press</publisher>,
<date when="2003">2003</date>.
</bibl>
</bibl> |
| Content model |
<content>
<alternate minOccurs="0"
maxOccurs="unbounded">
<textNode/>
<classRef key="model.gLike"/>
<classRef key="model.highlighted"/>
<classRef key="model.pPart.data"/>
<classRef key="model.pPart.edit"/>
<classRef key="model.segLike"/>
<classRef key="model.ptrLike"/>
<classRef key="model.biblPart"/>
<classRef key="model.global"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element bibl
{
tei_att.global.attributes,
tei_att.declarable.attributes,
tei_att.typed.attributes,
tei_att.sortable.attributes,
tei_att.docStatus.attributes,
(
text
| tei_model.gLike
| tei_model.highlighted
| tei_model.pPart.data
| tei_model.pPart.edit
| tei_model.segLike
| tei_model.ptrLike
| tei_model.biblPart
| tei_model.global
)*
}⚓ |
| <biblFull> (fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. [3.12.1. Methods of Encoding Bibliographic References and Lists of References 2.2. The File Description 2.2.7. The Source Description 15.3.2. Declarable Elements] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.sortable (@sortKey) att.docStatus (@status) |
| Member of | |
| Contained by | |
| May contain | |
| Example | <biblFull>
<titleStmt>
<title>The Feminist Companion to Literature in English: women writers from the middle ages
to the present</title>
<author>Blain, Virginia</author>
<author>Clements, Patricia</author>
<author>Grundy, Isobel</author>
</titleStmt>
<editionStmt>
<edition>UK edition</edition>
</editionStmt>
<extent>1231 pp</extent>
<publicationStmt>
<publisher>Yale University Press</publisher>
<pubPlace>New Haven and London</pubPlace>
<date>1990</date>
</publicationStmt>
<sourceDesc>
<p>No source: this is an original work</p>
</sourceDesc>
</biblFull> |
| Content model |
<content>
<alternate>
<sequence>
<sequence>
<elementRef key="titleStmt"/>
<elementRef key="editionStmt"
minOccurs="0"/>
<elementRef key="extent" minOccurs="0"/>
<elementRef key="publicationStmt"/>
<elementRef key="seriesStmt"
minOccurs="0" maxOccurs="unbounded"/>
<elementRef key="notesStmt"
minOccurs="0"/>
</sequence>
<elementRef key="sourceDesc"
minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<sequence>
<elementRef key="fileDesc"/>
<elementRef key="profileDesc"/>
</sequence>
</alternate>
</content>
⚓ |
| Schema Declaration |
element biblFull
{
tei_att.global.attributes,
tei_att.declarable.attributes,
tei_att.sortable.attributes,
tei_att.docStatus.attributes,
(
(
(
tei_titleStmt,
tei_editionStmt?,
tei_extent?,
tei_publicationStmt,
tei_seriesStmt*,
tei_notesStmt?
),
tei_sourceDesc*
)
| ( tei_fileDesc, tei_profileDesc )
)
}⚓ |
| <biblScope> (scope of bibliographic reference) defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work. [3.12.2.5. Scopes and Ranges in Bibliographic Citations] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.citing (@unit, @from, @to) |
| Member of | |
| Contained by | header: seriesStmt |
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data |
| Note | When a single page is being cited, use the from and to attributes with an identical value. When no clear endpoint is provided, the from attribute may be used without to; for example a citation such as ‘p. 3ff’ might be encoded It is now considered good practice to supply this element as a sibling (rather than a child) of <imprint>, since it supplies information which does not constitute part of the imprint. |
| Example | <biblScope>pp 12–34</biblScope>
<biblScope unit="page" from="12" to="34"/>
<biblScope unit="volume">II</biblScope>
<biblScope unit="page">12</biblScope> |
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ |
| Schema Declaration |
element biblScope
{
tei_att.global.attributes,
tei_att.citing.attributes,
tei_macro.phraseSeq
}⚓ |
| <biblStruct> (structured bibliographic citation) contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order. [3.12.1. Methods of Encoding Bibliographic References and Lists of References 2.2.7. The Source Description 15.3.2. Declarable Elements] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declarable (@default) att.typed (@type, @subtype) att.sortable (@sortKey) att.docStatus (@status) |
| Member of | |
| Contained by | |
| May contain | |
| Example | <biblStruct>
<monogr>
<author>Blain, Virginia</author>
<author>Clements, Patricia</author>
<author>Grundy, Isobel</author>
<title>The Feminist Companion to Literature in English: women writers from the middle ages
to the present</title>
<edition>first edition</edition>
<imprint>
<publisher>Yale University Press</publisher>
<pubPlace>New Haven and London</pubPlace>
<date>1990</date>
</imprint>
</monogr>
</biblStruct> |
| Content model |
<content>
<sequence>
<elementRef key="analytic" minOccurs="0"
maxOccurs="unbounded"/>
<sequence minOccurs="1"
maxOccurs="unbounded">
<elementRef key="monogr"/>
<elementRef key="series" minOccurs="0"
maxOccurs="unbounded"/>
</sequence>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.noteLike"/>
<classRef key="model.ptrLike"/>
<elementRef key="relatedItem"/>
<elementRef key="citedRange"/>
</alternate>
</sequence>
</content>
⚓ |
| Schema Declaration |
element biblStruct
{
tei_att.global.attributes,
tei_att.declarable.attributes,
tei_att.typed.attributes,
tei_att.sortable.attributes,
tei_att.docStatus.attributes,
(
tei_analytic*,
( tei_monogr, tei_series* )+,
(
tei_model.noteLike
| tei_model.ptrLike
| tei_relatedItem
| tei_citedRange
)*
)
}⚓ |
| <birth> (birth) contains information about a person's birth, such as its date and place. [15.2.2. The Participant Description] | |||||||||||
| Module | namesdates — Formal specification | ||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.editLike (@evidence, @instant) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max, @confidence)) att.naming (@role, @nymRef) (att.canonical (@key, @ref)) att.typed (type, @subtype)
| ||||||||||
| Member of | |||||||||||
| Contained by | |||||||||||
| May contain | core: abbr add address cb choice cit corr date del distinct ellipsis email emph expan foreign gap gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit figures: figure formula notatedMusic gaiji: g header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||||||
| Example | <birth>Before 1920, Midlands region.</birth> | ||||||||||
| Example | <birth when="1960-12-10">In a small cottage near <name type="place">Aix-la-Chapelle</name>,
early in the morning of <date>10 Dec 1960</date>
</birth> | ||||||||||
| Content model |
<content>
<macroRef key="macro.phraseSeq"/>
</content>
⚓ | ||||||||||
| Schema Declaration |
element birth
{
tei_att.global.attributes,
tei_att.editLike.attributes,
tei_att.datable.attributes,
tei_att.dimensions.attributes,
tei_att.naming.attributes,
tei_att.typed.attribute.subtype,
attribute type { text }?,
tei_macro.phraseSeq
}⚓ | ||||||||||
| <body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. [4. Default Text Structure] | |
| Module | textstructure — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.declaring (@decls) |
| Contained by | textstructure: text |
| May contain | core: bibl biblStruct cb cit desc divGen ellipsis gap head index l label lb lg list listBibl meeting milestone note noteGrp p pb q quote said sp stage figures: figure notatedMusic table header: biblFull namesdates: listEvent listNym listObject listOrg listPerson listPlace listRelation transcr: addSpan damageSpan delSpan fw listTranspose metamark space substJoin |
| Example | <body>
<l>Nu scylun hergan hefaenricaes uard</l>
<l>metudæs maecti end his modgidanc</l>
<l>uerc uuldurfadur sue he uundra gihuaes</l>
<l>eci dryctin or astelidæ</l>
<l>he aerist scop aelda barnum</l>
<l>heben til hrofe haleg scepen.</l>
<l>tha middungeard moncynnæs uard</l>
<l>eci dryctin æfter tiadæ</l>
<l>firum foldu frea allmectig</l>
<trailer>primo cantauit Cædmon istud carmen.</trailer>
</body> |
| Content model |
<content>
<sequence>
<classRef key="model.global"
minOccurs="0" maxOccurs="unbounded"/>
<sequence minOccurs="0">
<classRef key="model.divTop"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divTop"/>
</alternate>
</sequence>
<sequence minOccurs="0">
<classRef key="model.divGenLike"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divGenLike"/>
</alternate>
</sequence>
<alternate>
<sequence minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.divLike"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divGenLike"/>
</alternate>
</sequence>
<sequence minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.div1Like"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divGenLike"/>
</alternate>
</sequence>
<sequence>
<sequence minOccurs="1"
maxOccurs="unbounded">
<alternate minOccurs="1" maxOccurs="1">
<elementRef key="schemaSpec"/>
<classRef key="model.common"/>
</alternate>
<classRef key="model.global"
minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<alternate minOccurs="0">
<sequence minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.divLike"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divGenLike"/>
</alternate>
</sequence>
<sequence minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.div1Like"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.global"/>
<classRef key="model.divGenLike"/>
</alternate>
</sequence>
</alternate>
</sequence>
</alternate>
<sequence minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.divBottom"/>
<classRef key="model.global"
minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</sequence>
</content>
⚓ |
| Schema Declaration |
element body
{
tei_att.global.attributes,
tei_att.declaring.attributes,
(
tei_model.global*,
( tei_model.divTop, ( tei_model.global | tei_model.divTop )* )?,
( tei_model.divGenLike, ( tei_model.global | tei_model.divGenLike )* )?,
(
( tei_model.divLike, ( tei_model.global | tei_model.divGenLike )* )+
| ( tei_model.div1Like, ( tei_model.global | tei_model.divGenLike )* )+
| (
( ( schemaSpec | tei_model.common ), tei_model.global* )+,
(
(
tei_model.divLike,
( tei_model.global | tei_model.divGenLike )*
)+
| (
tei_model.div1Like,
( tei_model.global | tei_model.divGenLike )*
)+
)?
)
),
( tei_model.divBottom, tei_model.global* )*
)
}⚓ |
| <c> (character) represents a character. [17.1. Linguistic Segment Categories] | |
| Module | analysis — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.segLike (@function) (att.datcat (@datcat, @valueDatcat)) (att.fragmentable (@part)) att.typed (@type, @subtype) att.notated (@notation) |
| Member of | |
| Contained by | core: abbr add addrLine author bibl biblScope citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure mentioned name note num orig p pubPlace publisher q quote rb ref reg rs rt said sic soCalled speaker stage street term textLang time title unclear unit figures: cell namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogFeat geogName nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: docDate |
| May contain | gaiji: g character data |
| Note | Contains a single character, a <g> element, or a sequence of graphemes to be treated as a single character. The type attribute is used to indicate the function of this segmentation, taking values such as letter, punctuation, or digit etc. |
| Example | <phr>
<c>M</c>
<c>O</c>
<c>A</c>
<c>I</c>
<w>doth</w>
<w>sway</w>
<w>my</w>
<w>life</w>
</phr> |
| Content model |
<content>
<macroRef key="macro.xtext"/>
</content>
⚓ |
| Schema Declaration |
element c
{
tei_att.global.attributes,
tei_att.segLike.attributes,
tei_att.typed.attributes,
tei_att.notated.attributes,
tei_macro.xtext
}⚓ |
| <cRefPattern> (canonical reference pattern) specifies an expression and replacement pattern for transforming a canonical reference into a URI. [2.3.6.3. Milestone Method 2.3.6. The Reference System Declaration 2.3.6.2. Search-and-Replace Method] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.patternReplacement (@matchPattern, @replacementPattern) |
| Contained by | header: refsDecl |
| May contain | |
| Note | The result of the substitution may be either an absolute or a relative URI reference. In the latter case it is combined with the value of xml:base in force at the place where the cRef attribute occurs to form an absolute URI in the usual manner as prescribed by XML Base. |
| Example | <cRefPattern matchPattern="([1-9A-Za-z]+)\s+([0-9]+):([0-9]+)"
replacementPattern="#xpath(//div[@type='book'][@n='$1']/div[@type='chap'][@n='$2']/div[@type='verse'][@n='$3'])"/> |
| Content model |
<content>
<classRef key="model.pLike" minOccurs="0"
maxOccurs="unbounded"/>
</content>
⚓ |
| Schema Declaration |
element cRefPattern
{
tei_att.global.attributes,
tei_att.patternReplacement.attributes,
tei_model.pLike*
}⚓ |
| <calendar> (calendar) describes a calendar or dating system used in a dating formula in the text. [2.4.5. Calendar Description] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate) |
| Contained by | header: calendarDesc |
| May contain | |
| Example | <calendarDesc>
<calendar xml:id="julianEngland">
<p>Julian Calendar (including proleptic)</p>
</calendar>
</calendarDesc> |
| Example | <calendarDesc>
<calendar xml:id="egyptian"
target="http://en.wikipedia.org/wiki/Egyptian_calendar">
<p>Egyptian calendar (as defined by Wikipedia)</p>
</calendar>
</calendarDesc> |
| Content model |
<content>
<classRef key="model.pLike" minOccurs="1"
maxOccurs="unbounded"/>
</content>
⚓ |
| Schema Declaration |
element calendar
{
tei_att.global.attributes,
tei_att.pointing.attributes,
tei_model.pLike+
}⚓ |
| <calendarDesc> (calendar description) contains a description of the calendar system used in any dating expression found in the text. [2.4. The Profile Description 2.4.5. Calendar Description] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | header: profileDesc |
| May contain | header: calendar |
| Note | In the first example above, calendars and short codes for xml:ids are from W3 guidelines at http://www.w3.org/TR/xpath-functions-11/#lang-cal-country |
| Example | <calendarDesc>
<calendar xml:id="cal_AD">
<p>Anno Domini (Christian Era)</p>
</calendar>
<calendar xml:id="cal_AH">
<p>Anno Hegirae (Muhammedan Era)</p>
</calendar>
<calendar xml:id="cal_AME">
<p>Mauludi Era (solar years since Mohammed's birth)</p>
</calendar>
<calendar xml:id="cal_AM">
<p>Anno Mundi (Jewish Calendar)</p>
</calendar>
<calendar xml:id="cal_AP">
<p>Anno Persici</p>
</calendar>
<calendar xml:id="cal_AS">
<p>Aji Saka Era (Java)</p>
</calendar>
<calendar xml:id="cal_BE">
<p>Buddhist Era</p>
</calendar>
<calendar xml:id="cal_CB">
<p>Cooch Behar Era</p>
</calendar>
<calendar xml:id="cal_CE">
<p>Common Era</p>
</calendar>
<calendar xml:id="cal_CL">
<p>Chinese Lunar Era</p>
</calendar>
<calendar xml:id="cal_CS">
<p>Chula Sakarat Era</p>
</calendar>
<calendar xml:id="cal_EE">
<p>Ethiopian Era</p>
</calendar>
<calendar xml:id="cal_FE">
<p>Fasli Era</p>
</calendar>
<calendar xml:id="cal_ISO">
<p>ISO 8601 calendar</p>
</calendar>
<calendar xml:id="cal_JE">
<p>Japanese Calendar</p>
</calendar>
<calendar xml:id="cal_KE">
<p>Khalsa Era (Sikh calendar)</p>
</calendar>
<calendar xml:id="cal_KY">
<p>Kali Yuga</p>
</calendar>
<calendar xml:id="cal_ME">
<p>Malabar Era</p>
</calendar>
<calendar xml:id="cal_MS">
<p>Monarchic Solar Era</p>
</calendar>
<calendar xml:id="cal_NS">
<p>Nepal Samwat Era</p>
</calendar>
<calendar xml:id="cal_OS">
<p>Old Style (Julian Calendar)</p>
</calendar>
<calendar xml:id="cal_RS">
<p>Rattanakosin (Bangkok) Era</p>
</calendar>
<calendar xml:id="cal_SE">
<p>Saka Era</p>
</calendar>
<calendar xml:id="cal_SH">
<p>Mohammedan Solar Era (Iran)</p>
</calendar>
<calendar xml:id="cal_SS">
<p>Saka Samvat</p>
</calendar>
<calendar xml:id="cal_TE">
<p>Tripurabda Era</p>
</calendar>
<calendar xml:id="cal_VE">
<p>Vikrama Era</p>
</calendar>
<calendar xml:id="cal_VS">
<p>Vikrama Samvat Era</p>
</calendar>
</calendarDesc> |
| Example | <calendarDesc>
<calendar xml:id="cal_Gregorian">
<p>Gregorian calendar</p>
</calendar>
<calendar xml:id="cal_Julian">
<p>Julian calendar</p>
</calendar>
<calendar xml:id="cal_Islamic">
<p>Islamic or Muslim (hijri) lunar calendar</p>
</calendar>
<calendar xml:id="cal_Hebrew">
<p>Hebrew or Jewish lunisolar calendar</p>
</calendar>
<calendar xml:id="cal_Revolutionary">
<p>French Revolutionary calendar</p>
</calendar>
<calendar xml:id="cal_Iranian">
<p>Iranian or Persian (Jalaali) solar calendar</p>
</calendar>
<calendar xml:id="cal_Coptic">
<p>Coptic or Alexandrian calendar</p>
</calendar>
<calendar xml:id="cal_Chinese">
<p>Chinese lunisolar calendar</p>
</calendar>
</calendarDesc> |
| Example | <calendarDesc>
<calendar xml:id="cal_Egyptian"
target="http://en.wikipedia.org/wiki/Egyptian_calendar">
<p>Egyptian calendar (as defined by Wikipedia)</p>
</calendar>
</calendarDesc> |
| Content model |
<content>
<elementRef key="calendar" minOccurs="1"
maxOccurs="unbounded"/>
</content>
⚓ |
| Schema Declaration |
element calendarDesc { tei_att.global.attributes, tei_calendar+ }⚓ |
| <catDesc> (category description) describes some category within a taxonomy or text typology, either in the form of a brief prose description or in terms of the situational parameters used by the TEI formal <textDesc>. [2.3.7. The Classification Declaration] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.canonical (@key, @ref) |
| Contained by | header: category |
| May contain | core: abbr address choice date distinct email emph expan foreign gloss hi measure measureGrp mentioned name num ptr q ref rs soCalled term time title unit corpus: textDesc header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait character data |
| Example | <catDesc>Prose reportage</catDesc> |
| Example | <catDesc>
<textDesc n="novel">
<channel mode="w">print; part issues</channel>
<constitution type="single"/>
<derivation type="original"/>
<domain type="art"/>
<factuality type="fiction"/>
<interaction type="none"/>
<preparedness type="prepared"/>
<purpose type="entertain" degree="high"/>
<purpose type="inform" degree="medium"/>
</textDesc>
</catDesc> |
| Content model |
<content>
<alternate minOccurs="0"
maxOccurs="unbounded">
<textNode/>
<classRef key="model.limitedPhrase"/>
<classRef key="model.catDescPart"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element catDesc
{
tei_att.global.attributes,
tei_att.canonical.attributes,
( text | tei_model.limitedPhrase | tei_model.catDescPart )*
}⚓ |
| <catRef> (category reference) specifies one or more defined categories within some taxonomy or text typology. [2.4.3. The Text Classification] | |||||||
| Module | header — Formal specification | ||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.pointing (@targetLang, @target, @evaluate)
| ||||||
| Contained by | |||||||
| May contain | Empty element | ||||||
| Note | The scheme attribute needs to be supplied only if more than one taxonomy has been declared. | ||||||
| Example | <catRef scheme="#myTopics"
target="#news #prov #sales2"/>
<!-- elsewhere -->
<taxonomy xml:id="myTopics">
<category xml:id="news">
<catDesc>Newspapers</catDesc>
</category>
<category xml:id="prov">
<catDesc>Provincial</catDesc>
</category>
<category xml:id="sales2">
<catDesc>Low to average annual sales</catDesc>
</category>
</taxonomy> | ||||||
| Content model |
<content>
<empty/>
</content>
⚓ | ||||||
| Schema Declaration |
element catRef
{
tei_att.global.attributes,
tei_att.pointing.attributes,
attribute scheme { text }?,
empty
}⚓ | ||||||
| <category> (category) contains an individual descriptive category, possibly nested within a superordinate category, within a user-defined taxonomy. [2.3.7. The Classification Declaration] | |
| Module | header — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Contained by | |
| May contain | |
| Example | <category xml:id="b1">
<catDesc>Prose reportage</catDesc>
</category> |
| Example | <category xml:id="b2">
<catDesc>Prose </catDesc>
<category xml:id="b11">
<catDesc>journalism</catDesc>
</category>
<category xml:id="b12">
<catDesc>fiction</catDesc>
</category>
</category> |
| Example | <category xml:id="LIT">
<catDesc xml:lang="pl">literatura piękna</catDesc>
<catDesc xml:lang="en">fiction</catDesc>
<category xml:id="LPROSE">
<catDesc xml:lang="pl">proza</catDesc>
<catDesc xml:lang="en">prose</catDesc>
</category>
<category xml:id="LPOETRY">
<catDesc xml:lang="pl">poezja</catDesc>
<catDesc xml:lang="en">poetry</catDesc>
</category>
<category xml:id="LDRAMA">
<catDesc xml:lang="pl">dramat</catDesc>
<catDesc xml:lang="en">drama</catDesc>
</category>
</category> |
| Content model |
<content>
<sequence>
<alternate>
<elementRef key="catDesc" minOccurs="1"
maxOccurs="unbounded"/>
<alternate minOccurs="0"
maxOccurs="unbounded">
<classRef key="model.descLike"/>
<elementRef key="equiv"/>
<elementRef key="gloss"/>
</alternate>
</alternate>
<elementRef key="category" minOccurs="0"
maxOccurs="unbounded"/>
</sequence>
</content>
⚓ |
| Schema Declaration |
element category
{
tei_att.global.attributes,
(
( tei_catDesc+ | ( tei_model.descLike | equiv | tei_gloss )* ),
tei_category*
)
}⚓ |
| <cb> (column beginning) marks the beginning of a new column of a text on a multi-column page. [3.11.3. Milestone Elements] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) att.edition (@ed, @edRef) att.spanning (@spanTo) att.breaking (@break) |
| Member of | |
| Contained by | core: abbr add addrLine address author bibl biblScope cit citedRange corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi imprint item l label lg list listBibl measure mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said series sic soCalled sp speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority change classCode distributor edition extent funder geoDecl language licence principal sponsor namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset org orgName persName persPronouns person personGrp persona placeName region residence roleName settlement sex socecStatus surname |
| May contain | Empty element |
| Note | On this element, the global n attribute indicates the number or other value associated with the column which follows the point of insertion of this <cb> element. Encoders should adopt a clear and consistent policy as to whether the numbers associated with column breaks relate to the physical sequence number of the column in the whole text, or whether columns are numbered within the page. The <cb> element is placed at the head of the column to which it refers. |
| Example | Markup of an early English dictionary printed in two columns: <pb/>
<cb n="1"/>
<entryFree>
<form>Well</form>, <sense>a Pit to hold Spring-Water</sense>:
<sense>In the Art of <hi rend="italic">War</hi>, a Depth the Miner
sinks into the Ground, to find out and disappoint the Enemies Mines,
or to prepare one</sense>.
</entryFree>
<entryFree>To <form>Welter</form>, <sense>to wallow</sense>, or
<sense>lie groveling</sense>.</entryFree>
<!-- remainder of column -->
<cb n="2"/>
<entryFree>
<form>Wey</form>, <sense>the greatest Measure for dry Things,
containing five Chaldron</sense>.
</entryFree>
<entryFree>
<form>Whale</form>, <sense>the greatest of
Sea-Fishes</sense>.
</entryFree> |
| Content model |
<content>
<empty/>
</content>
⚓ |
| Schema Declaration |
element cb
{
tei_att.global.attributes,
tei_att.typed.attributes,
tei_att.edition.attributes,
tei_att.spanning.attributes,
tei_att.breaking.attributes,
empty
}⚓ |
| <change> (change) documents a change or set of changes made during the production of a source document, or during the revision of an electronic file. [2.6. The Revision Description 2.4.1. Creation 11.7. Identifying Changes and Revisions] | |||||||
| Module | header — Formal specification | ||||||
| Attributes | att.ascribed (@who) att.datable (@calendar, @period) (att.datable.w3c (@when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) (att.datable.custom (@when-custom, @notBefore-custom, @notAfter-custom, @from-custom, @to-custom, @datingPoint, @datingMethod)) att.docStatus (@status) att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype)
| ||||||
| Contained by | header: listChange revisionDesc | ||||||
| May contain | core: abbr add address bibl biblStruct cb choice cit corr date del desc distinct ellipsis email emph expan foreign gap gloss graphic hi index l label lb lg list listBibl measure measureGrp media mentioned milestone name note noteGrp num orig p pb ptr q quote ref reg rs ruby said sic soCalled sp stage term time title unclear unit figures: figure formula notatedMusic table gaiji: g namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo character data | ||||||
| Note | The who attribute may be used to point to any other element, but will typically specify a <respStmt> or <person> element elsewhere in the header, identifying the person responsible for the change and their role in making it. It is recommended that changes be recorded with the most recent first. The status attribute may be used to indicate the status of a document following the change documented. | ||||||
| Example | <titleStmt>
<title> ... </title>
<editor xml:id="LDB">Lou Burnard</editor>
<respStmt xml:id="BZ">
<resp>copy editing</resp>
<name>Brett Zamir</name>
</respStmt>
</titleStmt>
<!-- ... -->
<revisionDesc status="published">
<change who="#BZ" when="2008-02-02"
status="public">Finished chapter 23</change>
<change who="#BZ" when="2008-01-02"
status="draft">Finished chapter 2</change>
<change n="P2.2" when="1991-12-21"
who="#LDB">Added examples to section 3</change>
<change when="1991-11-11" who="#MSM">Deleted chapter 10</change>
</revisionDesc> | ||||||
| Example | <profileDesc>
<creation>
<listChange>
<change xml:id="DRAFT1">First draft in pencil</change>
<change xml:id="DRAFT2"
notBefore="1880-12-09">First revision, mostly
using green ink</change>
<change xml:id="DRAFT3"
notBefore="1881-02-13">Final corrections as
supplied to printer.</change>
</listChange>
</creation>
</profileDesc> | ||||||
| Content model |
<content>
<macroRef key="macro.specialPara"/>
</content>
⚓ | ||||||
| Schema Declaration |
element change
{
tei_att.ascribed.attributes,
tei_att.datable.attributes,
tei_att.docStatus.attributes,
tei_att.global.attributes,
tei_att.typed.attributes,
attribute target { list { + } }?,
tei_macro.specialPara
}⚓ | ||||||
| <channel> (primary channel) describes the medium or channel by which a text is delivered or experienced. For a written text, this might be print, manuscript, email, etc.; for a spoken one, radio, telephone, face-to-face, etc. [15.2.1. The Text Description] | |||||||||
| Module | corpus — Formal specification | ||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))
| ||||||||
| Member of | |||||||||
| Contained by | corpus: textDesc | ||||||||
| May contain | core: abbr address cb choice date distinct ellipsis email emph expan foreign gap gloss hi index lb measure measureGrp mentioned milestone name note noteGrp num pb ptr q ref rs soCalled term time title unit figures: figure notatedMusic header: idno namesdates: addName affiliation bloc climate country district forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait transcr: addSpan damageSpan delSpan ex fw listTranspose metamark space subst substJoin character data | ||||||||
| Example | <channel mode="s">face-to-face conversation</channel> | ||||||||
| Content model |
<content>
<macroRef key="macro.phraseSeq.limited"/>
</content>
⚓ | ||||||||
| Schema Declaration |
element channel
{
tei_att.global.attributes,
attribute mode { "s" | "w" | "sw" | "ws" | "m" | "x" }?,
tei_macro.phraseSeq.limited
}⚓ | ||||||||
| <char> (character) provides descriptive information about a character. [5.2. Markup Constructs for Representation of Characters and Glyphs] | |
| Module | gaiji — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Contained by | gaiji: charDecl |
| May contain | |
| Example | <char xml:id="circledU4EBA">
<localProp name="Name"
value="CIRCLED IDEOGRAPH 4EBA"/>
<localProp name="daikanwa" value="36"/>
<unicodeProp name="Decomposition_Mapping"
value="circle"/>
<mapping type="standard">人</mapping>
</char> |
| Content model |
<content>
<alternate minOccurs="0"
maxOccurs="unbounded">
<elementRef key="unicodeProp"/>
<elementRef key="unihanProp"/>
<elementRef key="localProp"/>
<elementRef key="mapping"/>
<elementRef key="figure"/>
<classRef key="model.graphicLike"/>
<classRef key="model.noteLike"/>
<classRef key="model.descLike"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element char
{
tei_att.global.attributes,
(
tei_unicodeProp
| tei_unihanProp
| tei_localProp
| tei_mapping
| tei_figure
| tei_model.graphicLike
| tei_model.noteLike
| tei_model.descLike
)*
}⚓ |
| <charDecl> (character declarations) provides information about nonstandard characters and glyphs. [5.2. Markup Constructs for Representation of Characters and Glyphs] | |
| Module | gaiji — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | header: encodingDesc |
| May contain | |
| Example | <charDecl>
<char xml:id="aENL">
<unicodeProp name="Name"
value="LATIN LETTER ENLARGED SMALL A"/>
<mapping type="standard">a</mapping>
</char>
</charDecl> |
| Content model |
<content>
<sequence>
<elementRef key="desc" minOccurs="0"/>
<alternate minOccurs="1"
maxOccurs="unbounded">
<elementRef key="char"/>
<elementRef key="glyph"/>
</alternate>
</sequence>
</content>
⚓ |
| Schema Declaration |
element charDecl
{
tei_att.global.attributes,
( tei_desc?, ( tei_char | tei_glyph )+ )
}⚓ |
| <choice> (choice) groups a number of alternative encodings for the same point in a text. [3.5. Simple Editorial Changes] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) |
| Member of | |
| Contained by | core: abbr add addrLine author bibl biblScope choice citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose header: authority catDesc change classCode creation distributor edition extent funder geoDecl language licence principal rendition sponsor tagUsage namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname textstructure: docDate |
| May contain | |
| Note | Because the children of a <choice> element all represent alternative ways of encoding the same sequence, it is natural to think of them as mutually exclusive. However, there may be cases where a full representation of a text requires the alternative encodings to be considered as parallel. Note also that <choice> elements may self-nest. Where the purpose of an encoding is to record multiple witnesses of a single work, rather than to identify multiple possible encoding decisions at a given point, the <app> element and associated elements discussed in section 12.1. The Apparatus Entry, Readings, and Witnesses should be preferred. |
| Example | An American encoding of Gulliver's Travels which retains the British spelling but also provides a version regularized to American spelling might be encoded as follows. <p>Lastly, That, upon his solemn oath to observe all the above
articles, the said man-mountain shall have a daily allowance of
meat and drink sufficient for the support of <choice>
<sic>1724</sic>
<corr>1728</corr>
</choice> of our subjects,
with free access to our royal person, and other marks of our
<choice>
<orig>favour</orig>
<reg>favor</reg>
</choice>.</p> |
| Content model |
<content>
<alternate minOccurs="2"
maxOccurs="unbounded">
<classRef key="model.choicePart"/>
<elementRef key="choice"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element choice
{
tei_att.global.attributes,
( tei_model.choicePart | tei_choice )+
}⚓ |
| <cit> (cited quotation) contains a quotation from some other document, together with a bibliographic reference to its source. In a dictionary it may contain an example text with at least one occurrence of the word form, used in the sense being described, or a translation of the headword, or an example. [3.3.3. Quotation 4.3.1. Grouped Texts 9.3.5.1. Examples] | |
| Module | core — Formal specification |
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (@type, @subtype) |
| Member of | |
| Contained by | core: abbr add addrLine author biblScope cit citedRange corr del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg rs rt said sic soCalled sp speaker stage street term textLang title unclear unit |
| May contain | |
| Example | <cit>
<quote>and the breath of the whale is frequently attended with such an insupportable smell,
as to bring on disorder of the brain.</quote>
<bibl>Ulloa's South America</bibl>
</cit> |
| Example | <entry>
<form>
<orth>horrifier</orth>
</form>
<cit type="translation" xml:lang="en">
<quote>to horrify</quote>
</cit>
<cit type="example">
<quote>elle était horrifiée par la dépense</quote>
<cit type="translation" xml:lang="en">
<quote>she was horrified at the expense.</quote>
</cit>
</cit>
</entry> |
| Example | <cit type="example">
<quote xml:lang="mix">Ka'an yu tsa'a Pedro.</quote>
<media url="soundfiles-gen:S_speak_1s_on_behalf_of_Pedro_01_02_03_TS.wav"
mimeType="audio/wav"/>
<cit type="translation">
<quote xml:lang="en">I'm speaking on behalf of Pedro.</quote>
</cit>
<cit type="translation">
<quote xml:lang="es">Estoy hablando de parte de Pedro.</quote>
</cit>
</cit> |
| Content model |
<content>
<alternate minOccurs="1"
maxOccurs="unbounded">
<classRef key="model.biblLike"/>
<classRef key="model.egLike"/>
<classRef key="model.entryPart"/>
<classRef key="model.global"/>
<classRef key="model.graphicLike"/>
<classRef key="model.ptrLike"/>
<classRef key="model.attributable"/>
<elementRef key="pc"/>
<elementRef key="q"/>
</alternate>
</content>
⚓ |
| Schema Declaration |
element cit
{
tei_att.global.attributes,
tei_att.typed.attributes,
(
tei_model.biblLike
| tei_model.egLike
| tei_model.entryPart
| tei_model.global
| tei_model.graphicLike
| tei_model.ptrLike
| tei_model.attributable
| tei_pc
| tei_q
)+
}⚓ |
| <citeData> (citation data) specifies how information may be extracted from citation structures. [3.11.4. Declaring Reference Systems 16.2.5.4. Citation Structures] | |||||||
| Module | header — Formal specification | ||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.citeStructurePart (@use)
| ||||||
| Contained by | header: citeStructure | ||||||
| May contain | Empty element | ||||||
| Example | <citeStructure unit="book"
match="//body/div" use="@n">
<citeData property="http://purl.org/dc/terms/title"
use="head"/>
</citeStructure> | ||||||
| Content model |
<content>
<empty/>
</content>
⚓ | ||||||
| Schema Declaration |
element citeData
{
tei_att.global.attributes,
tei_att.citeStructurePart.attributes,
attribute property { text },
empty
}⚓ | ||||||
| <citeStructure> (citation structure) declares a structure and method for citing the current document. [3.11.4. Declaring Reference Systems 16.2.5.4. Citation Structures] | |||||||||||||
| Module | header — Formal specification | ||||||||||||
| Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.citeStructurePart (@use)
| ||||||||||||