This file documents the JLP TEI extension. It does not document the TEI-derived elements. For the necessary background, please read the following chapters from the TEI Guidelines:
This section is intended to narrow the broad TEI Guidelines to a single way that we encode. It assumes that you are familiar with the above referenced chapters of the TEI Guidelines.
Any element may be given an identifier using its xml:id attribute. The identifier must be unique within the file.
Identifiers may be autogenerated using the auto-encoder program (to be written). Paragraph identifiers are in the Latin alphabet and use the first significant word in the paragraph, transliterated using the "simple" transliteration table.
The main header is stored in one file for the entire project. It contains the project's full TEI header, as described in the TEI Guidelines.
Basic elements of text are encoded in seg elements. The smallest encoded portion of text is a word, encoded with w. All seg and w elements must be identified by xml:id attributes. Note that, one convention is to assign the xml:id attributes of words ending with a number in the sequence it appears at the time of initial encoding. These numbers should be assumed by all processors to be arbitrary identifiers. It should not be taken to mean anything about the sequence of the words in the text.
Each file is thus comprised of libraries of segments, which are composed virtually into prose or poetic text.
The divisions of prose text are sentences, represented by s elements, contained in paragraphs, represented by p elements. Sentences are paragraphs must be identified by xml:id attributes.
Divisions of poetic text are lines, represented by l elements, contained in line groups, represented by lg elements. l and lg elements must be identified by xml:id attributes.
Poetic text may have a secondary hierarchy, representing it as if it were prose. In that case, virtual p or s elements may be used to group together lines and line groups into sentences and paragraphs.
Repetition of content should be avoided to the maximal reasonable extent. In order to avoid repetition, you may use:
The file identified by the URI "Contributors" contains the contributor list, which maintains the names of all contributors to the project. The list is a list element whose item children contain name elements. Each of the name elements is identified by an xml:id attribute, which is used as an identifier of the contributor anywhere else in the project a contributor name is needed. The name elements should contain as much encoded detail as possible about how to divide the name between first name, last name, etc. First and middle names should be enclosed in forename elements, last names in surname elements, and generational names (such as "Jr" or "II" in genName. The following example shows a minimum contributor list with one example name:
In responsibility assignments (respStmt/resp, and respons elements), the contributor is referred to by his/her identifier:
For the most part, translations should be encoded exactly as original texts are encoded. In fact, it should be possible to use a translation file as a starting document to obtain a complete translated siddur. This section describes only the specific changes required for translations.
An individual translation should have a description of the philosophy used to produce the translation. This description can go in the projectDesc section of the translation's header, or in an introductory note.
Each translation should have a two-way type property associated with it. The "yes" value indicates that the translation should be included. This property must default to the "no" value.
Translations are linked to the original texts in two ways: The first is that the original text file contains a linkGrp or ptr, type="translation" which references the translation of the specific file. This pointer must have its j:prop attribute set to the property associated with the translation. Individual segments of translated text are linked to the original text using the global corresp attribute, which points from the translation to the original's URI. Each translation should choose one level of hierarchy as its lowest level of linkage. The level may be seg or s or p, or even w for example. An individual translation should be consistent in translating one hierarchical level.
Each translation file must specify its language somewhere (usually the body element) using an xml:lang attribute.
Translations need not use w elements to mark up each word, unless the w level is the level of translation linkage.
A complete document contains everything that is needed for a particular siddur to compile, from beginning to end. Most files on disk will contain small parts of the siddur, such as individual paragraphs or sections. Document fragments need only contain metadata that is relevant to the independent section of text, and need not repeat the content of the main header. The following elements are used to encode these independent text fragments that are intended to be maintained separately from other files, but do not themselves comprise a complete document. In order to build a complete siddur, fragments are pasted together by transclusion from other documents (or fragments) by reference.
Like any other JLPTEI document, the root element of a fragment is the TEI element. The root element contains a teiHeader, the new metaLink and propDecls and the text proper. The differences between a fragment and a root document are that the fragment's header is shortened considerably from the project main header.
A minimal fragment document is shown below:
The first thing to notice is that this header lacks many of the features of a full TEI header. Most of those details will be the same throughout the entire project. In the metaLink section, note the ptr with type="header." This pointer provides a URI to the complete header. If any of the details presented in the main header differ from how the fragment was prepared, the fragment header must reference the difference using the mechanisms available to all TEI headers, and described in full in the TEI Guidelines.
Replacing the full respStmt in the titleStmt is the respList element, whose purpose is to gather respons elements. The respons elements provide a concise, out-of-line way to assign responsibility for specific portions of the text. Possible responsibility types include "author" (for an original work of authorship), "transcriber", "proofreader," or "encoder." "editor" may be used as a generic type of responsibility.
Instead of maintaining a full availability element in all fragments, the availability element instead contains an ab which contains a ptr, type="license", which points to the boilerplate for the license. The boilerplate is available in the main header.
A number of specialized metadata links are maintained in a separate header-like section under the metaLink element. These are:
Property declarations should be placed inside a propDecls element between the header and text of the file where the property is used. Property declarations are covered below in part 7.5 Declaring properties.
| props | Specifies that the pointed-to properties or property groups apply to the element containing the attribute. |
| set | Specifies that the pointed-to properties should be considered to be active with their specified values when conditions are evaluated for the current element and for all processed children of the current element. |
A property links a URI to a textual value, and is associated with a segment of text. The property defines some aspect of a section of the service or an instruction, such as when the section of the service is said, whether it has a special function in context, or what custom it is associated with.
| uri | A URI defining the name of the property. If it is omitted, the URI is assumed to be the URI of the containing element. |
| value | A string containing the value of the property, or the value of the property that is being tested against. |
| inline | Whether the property should be interpreted in-place or is pointed to by stand-off markup using j:condition. |
The prop element associates text with a property. It is global, and therefore, it may appear anywhere in the XML hierarchy. By default, properties affect the element in which they appear and any elements that are processed under the same element's hierarchy, including any elements incorporated into the text by transclusion mechanisms, such as XInclude, the copyOf attribute or join elements. Property values for a given URI may be overridden by a redefinition down the XML hierarchy. The following example shows properties being set for a segment of text. Another seg is used as the definition of the property.
The example above illustrates the association between texts and the time of year that they are said.
In the example, <seg xml:id="Ex1_DuringSummer"> has rather complicated set of nested properties. The properties a text segment has can be combined in two ways. Simply listing the properties in order results in both properties being applied to the text. Nesting properties results in the parent property being applied to the text under the conditions when the child properties are applied. This is a natural extension of the property concept, in which the parent property has its own properties.
Unless declared differently with a propDecl tag, a property may have one of 3 values: yes, no, or maybe. A yes value indicates that the property given by uri applies to the segment of text. A no value indicates that the property does not apply. A maybe value indicates that property applies only when it is uncertain whether the text will be included (see 7.4 Properties define the conditions for conditional text below). An unspecified value is the equivalent of yes.
The propGrp element can be used to group together properties.
In addition to a text's properties, a text has a second set of properties known as its active properties. Active properties may be thought of as instructions to a JLPTEI processor describing which textual properties should be selected for a given text. Active properties may also be used to specify special processor-specific formatting. Active properties are set using the propGrp tag with type="set". Property activation applies to the parent of the propGrp and all of its siblings and their children. Like a text's properties, active properties apply to the entire hierarchy as processed.
Properties are used to define when conditional sections should be included in a text. During processing, the text's properties are compared to the active properties. Texts with properties that are the same as the active properties are included. Texts with properties that contradict the active properties are excluded.
By default, active properties for textual inclusion may include the values yes, no, or maybe. The yes value is generally used to indicate that the section should be included, the no value that it should be excluded. The maybe value is used to indicate that the section should be included and if any optInstruct siblings are present, they should also be processed. One use case for the the maybe value is in a complete siddur. In such a case, all properties may be set as maybe, all texts will be included and all instructions will be included as necessary.
Texts may also set active properties for specific portions of themselves. For example, the text of the Amidah will be included a number of times in a complete siddur. The copy of the Amidah for the Shalosh Regalim need not include the possibility for the insertions between Rosh Hashanna and Yom Kippur. While the entire complete siddur may have the property covering these insertions with the value maybe, the section for the Shalosh Regalim will set it to no.
| type | Whether the property's value set is open or closed. |
| value | The value being declared. |
The propDecl tag is used to declare a property. Declaration of a property specifies a URI at which the property has a natural language definition, and also allows the property's possible values to be specified. The xml:id attribute is used to define the property's URI. One or more child desc tags give the natural language description. The property's values may be specified in one of two ways. The type attribute can have the values: open, closed, two-way or three-way. If it has the values two-way or three-way, no further specification is required. The property may be valued yes, no, or, maybe. The maybe value is available to three-way switches only. type="closed" indicates that the property may only be valued with values specified by one or more propVal child tags. type="open" indicates that the property may be valued with any values listed in the propVal tags, in addition to any possible value. type="open" with no given values indicates that the property may take any value.
The meaning of given property values may be documented using one or more desc tags as children of the propVal element. The value is specified by the value attribute of propVal.
Wherever possible, property declarations should be in the resource list section of the document (between the teiHeader and text) at the highest level of hierarchy where the property exercises its control. Property declarations may appear in the header only in the propDecls element.
The existence of an xml:id attribute on any element automatically declares a property with uri pointing to that element. The automatically declared property is a two-way switch, with values yes and no and defaults to yes. Setting the active property to no is a way to remove the element with the given xml:id without having to formally declare a property.
| props | Specifies that the pointed-to properties or property groups apply to the element containing the attribute. |
| set | Specifies that the pointed-to properties should be considered to be active with their specified values when conditions are evaluated for the current element and for all processed children of the current element. |
| inline | Whether the property should be interpreted in-place or is pointed to by stand-off markup using j:condition. |
| inline | Whether the property group should be interpreted in-place or is pointed to by stand-off markup using j:condition. |
Certain elements may only be empty. These include elements such as ptr, or those with a copyOf attribute, which implies that the content of the element is ignored. These elements may need to be included or excluded conditionally. In order to facilitate setting textual properties and active properties, the props and set global attributes are defined. These attributes point to either one or more propGrp elements or one or more prop elements. The props attribute is the equivalent of the pointed to elements being included in a propGrp child, the set attribute is the equivalent of the pointed to elements being included as a propGrp child with type=set.
Properties that will be referred to in a stand-off fashion may not apply to their parent elements. To prevent a property from affecting the its parent element, the inline attribute is provided. If set to false, the prop or propGrp element is ignored in processing unless referred to by reference with props or set. The inline attribute's default value is "true". If a set of properties is intended to apply to a number of elements with equivalent sets of properties, the properties may be declared once inline and referred to by reference in other places.
When a section of text may have more than one alternative content or encoding, the choice and option tags are used to indicate it. If the reason for the alternation is timing or custom, it is specified by option's properties, using prop and propGrp, as shown in 7 Properties and conditionals. If the reason for the alternation is a difference between sources, each option references its source using the decls attribute, which points to an appropriate biblStruct in the global bibliography.
In these types of alternations, the choice element and each option element should have a unique xml:id. For exclusive alternation (where only one option will be selected), the choice/xml:id attribute can be used as the URI of a property whose value is the option/xml:id that is intended to be included. All other options would automatically be excluded. If the alternation is intended to be inclusive, the option elements' child properties can be used to perform the selection, or the automatic declaration mechanism in section 7.5.2 Automatic declaration of properties may be used.
Instructions and comments are special types of notes that are associated with the text. While they may appear inline, they are usually placed out-of-line in separate files. A pointer to instructions is placed inline at the point the instruction should appear. A pointer to a file containing notes is placed in the fragment header (see 6 Encoding text fragments).
Related instructions, usually meaning translations of the same instruction, are grouped under an instructGrp element. Instructions can be selected using the mechanisms described in 7 Properties and conditionals or they can be selected by an active property that describes the primary instruction language. If instructions are being selected by language, each instruct element must have an xml:lang attribute specifying its primary language.
When instructions are in conditionally included blocks, the optInstruct element may be used to conditionally include the instruction. The content of the optInstruct element will be evaluated as follows:
The optInstruct element specifies when instructions should only appear if more than one alternant is possible. For example, if the instruction is "On Shabbat", and the siddur is being generated for Shabbat only, the instruction should not appear.
Comments are note elements of type="comment". The location where the commentary should appear is the content of the target attribute.
Two new elements are provided to support Massoretic emendations as a special type of variant text.
Both read and written must be direct descendants of choice.
The vowels on the "written" portion of the texts should correspond to the vowels on the "read" portion. The tetragrammaton, a consistent emendation, should not be included under these elements.
The divine name (Tetragrammaton) is kept within its own element, divineName, which is a special case of name. JLPTEI processors may use the divineName element to apply special processing to divine names, such as replacing them with abbreviated versions.
| model.addrPart groups elements such as names or postal codes which may appear as part of a postal address. | |
| Module | tei |
| Used by | |
| Members | model.nameLike [ model.nameLike.agent [ name orgName persName] model.persNamePart [ addName forename genName nameLink roleName surname] model.placeStateLike divineName rs] addrLine postBox postCode street |
| model.addressLike groups elements used to represent a postal or e-mail address. | |
| Module | tei |
| Used by | |
| Members | address affiliation email |
| model.applicationLike groups elements used to record application-specific information about a document in its header. | |
| Module | header |
| Used by | |
| Members | application |
| model.biblLike groups elements containing a bibliographic description. | |
| Module | tei |
| Used by | |
| Members | bibl biblFull biblStruct |
| model.biblPart groups elements which represent components of a bibliographic description. | |
| Module | tei |
| Used by | |
| Members | model.imprintPart [ biblScope distributor pubPlace publisher] model.respLike [ author editor funder principal respList respStmt sponsor] edition extent idno meeting relatedItem series |
| model.choicePart groups elements (other than choice itself) which can be used within a choice alternation. | |
| Module | tei |
| Used by | |
| Members | abbr corr expan optInstruct option orig read reg seg sic written |
| model.common groups common chunk- and inter-level elements. | |
| Module | tei |
| Used by | |
| Members | model.divPart [ model.lLike [ l] model.pLike [ ab p] floatingText lg] model.inter [ model.biblLike [ bibl biblFull biblStruct] model.labelLike [ desc label] model.listLike [ list listBibl listOrg listPerson listPlace listWit] model.qLike [ model.quoteLike [ cit quote] q said] ] |
| Note |
This class defines the set of chunk- and inter-level elements;
it is used in many content models, including those for textual
divisions.
|
| model.dateLike groups elements containing temporal expressions. | |
| Module | tei |
| Used by | |
| Members | date |
| model.divBottom groups elements appearing at the end of a text division. | |
| Module | tei |
| Used by | |
| Members | model.divBottomPart [ closer postscript signed trailer] model.divWrapper [ argument byline dateline docAuthor docDate epigraph meeting] |
| model.divBottomPart groups elements which can occur only at the end of a text division. | |
| Module | tei |
| Used by | |
| Members | closer postscript signed trailer |
| model.divGenLike groups elements used to represent a structural division which is generated rather than explicitly present in the source. | |
| Module | tei |
| Used by | |
| Members | divGen |
| model.divLike groups elements used to represent un-numbered generic structural divisions. | |
| Module | tei |
| Used by | |
| Members | div |
| model.divPart groups paragraph-level elements appearing directly within divisions. | |
| Module | tei |
| Used by | |
| Members | model.lLike [ l] model.pLike [ ab p] floatingText lg |
| Note |
Note that this element class does not include members of the
model.inter class, which can appear either within or between
paragraph-level items.
|
| model.divTop groups elements appearing at the beginning of a text division. | |
| Module | tei |
| Used by | |
| Members | model.divTopPart [ model.headLike [ head] opener salute] model.divWrapper [ argument byline dateline docAuthor docDate epigraph meeting] |
| model.divTopPart groups elements which can occur only at the beginning of a text division. | |
| Module | tei |
| Used by | |
| Members | model.headLike [ head] opener salute |
| model.divWrapper groups elements which can appear at either top or bottom of a textual division. | |
| Module | tei |
| Used by | |
| Members | argument byline dateline docAuthor docDate epigraph meeting |
| model.editorialDeclPart groups elements which may be used inside editorialDecl and appear multiple times. | |
| Module | header |
| Used by | |
| Members | correction hyphenation interpretation normalization quotation segmentation stdVals |
| model.emphLike groups phrase-level elements which are typographically distinct and to which a specific function can be attributed. | |
| Module | tei |
| Used by | |
| Members | distinct emph foreign gloss mentioned soCalled term title |
| model.encodingPart groups elements which may be used inside encodingDesc and appear multiple times. | |
| Module | header |
| Used by | |
| Members | appInfo classDecl editorialDecl projectDesc refsDecl samplingDecl tagsDecl variantEncoding |
| model.entryPart.top groups high level elements within a structured dictionary entry | |
| Module | tei |
| Used by | |
| Members | cit |
| Note |
Members of this class typically contain related parts of a
dictionary entry which form a coherent
subdivision, for example a particular sense, homonym, etc.
|
| model.frontPart groups elements which appear at the level of divisions within front or back matter. | |
| Module | tei |
| Used by | |
| Members | divGen titlePage |
| model.global groups elements which may appear at any point within a TEI text. | |
| Module | tei |
| Used by | |
| Members | model.global.meta [ interp interpGrp join joinGrp link linkGrp respons span spanGrp] model.milestoneLike [ anchor milestone] model.noteLike [ model.instructLike [ instruct instructGrp] note witDetail] prop propDecl propGrp |
| model.global.meta groups globally available elements which describe the status of other elements. | |
| Module | tei |
| Used by | |
| Members | interp interpGrp join joinGrp link linkGrp respons span spanGrp |
| Note |
Elements in this class are typically used to hold groups of
links or of abstract interpretations, or by provide indications of
certainty etc. It may find be convenient to localize all metadata
elements, for example to contain them within the same divison as
the elements that they relate to; or to locate them all to a
division of their own. They may however appear at any point in a
TEI text.
|
| model.glossLike groups elements which provide an alternative name, explanation, or description for any markup construct. | |
| Module | tei |
| Used by | |
| Members | desc gloss |
| model.graphicLike groups elements containing images, formulae, and similar objects. | |
| Module | tei |
| Used by | |
| Members | graphic |
| model.headLike groups elements used to provide a title or heading at the start of a text division. | |
| Module | tei |
| Used by | |
| Members | head |
| model.headerPart groups high level elements which may appear more than once in a TEI Header. | |
| Module | header |
| Used by | |
| Members | encodingDesc profileDesc |
| model.hiLike groups phrase-level elements which are typographically distinct but to which no specific function can be attributed. | |
| Module | tei |
| Used by | |
| Members | hi |
| model.highlighted groups phrase-level elements which are typographically distinct. | |
| Module | tei |
| Used by | |
| Members | model.emphLike [ distinct emph foreign gloss mentioned soCalled term title] model.hiLike [ hi] |
| model.imprintPart groups the bibliographic elements which occur inside imprints. | |
| Module | tei |
| Used by | |
| Members | biblScope distributor pubPlace publisher |
| model.instructLike Groups elements that act like instructions. | |
| Module | liturgy |
| Used by | |
| Members | instruct instructGrp |
| model.inter groups elements which can appear either within or between paragraph-like elements. | |
| Module | tei |
| Used by | |
| Members | model.biblLike [ bibl biblFull biblStruct] model.labelLike [ desc label] model.listLike [ list listBibl listOrg listPerson listPlace listWit] model.qLike [ model.quoteLike [ cit quote] q said] |
| model.lLike groups elements representing metrical components such as verse lines. | |
| Module | tei |
| Used by | |
| Members | l |
| model.labelLike groups elements used to gloss or explain other parts of a document. | |
| Module | tei |
| Used by | |
| Members | desc label |
| model.limitedPhrase groups phrase-level elements excluding those elements primarily intended for transcription of existing sources. | |
| Module | tei |
| Used by | |
| Members | model.emphLike [ distinct emph foreign gloss mentioned soCalled term title] model.pPart.data [ model.addressLike [ address affiliation email] model.dateLike [ date] model.nameLike [ model.nameLike.agent [ name orgName persName] model.persNamePart [ addName forename genName nameLink roleName surname] model.placeStateLike divineName rs] ] model.pPart.editorial [ abbr choice expan] model.ptrLike [ ptr ref] |
| model.listLike groups list-like elements. | |
| Module | tei |
| Used by | |
| Members | list listBibl listOrg listPerson listPlace listWit |
| model.milestoneLike groups milestone-style elements used to represent reference systems. | |
| Module | tei |
| Used by | |
| Members | anchor milestone |
| model.msItemPart groups elements which can appear within a manuscript item description. | |
| Module | tei |
| Used by | |
| Members | model.quoteLike [ cit quote] model.respLike [ author editor funder principal respList respStmt sponsor] bibl listBibl title |
| model.nameLike groups elements which name or refer to a person, place, or organization. | |
| Module | tei |
| Used by | |
| Members | model.nameLike.agent [ name orgName persName] model.persNamePart [ addName forename genName nameLink roleName surname] model.placeStateLike divineName rs |
| Note |
A superset of the naming elements that may appear in datelines,
addresses, statements of responsibility, etc.
|
| model.nameLike.agent groups elements which contain names of individuals or corporate bodies. | |
| Module | tei |
| Used by | |
| Members | name orgName persName |
| Note |
This class is used in the content model of elements which
reference names of people or organizations.
|
| model.noteLike groups globally-available note-like elements. | |
| Module | tei |
| Used by | |
| Members | model.instructLike [ instruct instructGrp] note witDetail |
| model.pLike.front groups paragraph-like elements which can occur as direct constituents of front matter. | |
| Module | tei |
| Used by | |
| Members | argument byline docAuthor docDate docEdition docImprint docTitle epigraph head titlePart |
| model.pPart.data groups phrase-level elements containing names, dates, numbers, measures, and similar data. | |
| Module | tei |
| Used by | |
| Members | model.addressLike [ address affiliation email] model.dateLike [ date] model.nameLike [ model.nameLike.agent [ name orgName persName] model.persNamePart [ addName forename genName nameLink roleName surname] model.placeStateLike divineName rs] |
| model.pPart.edit groups phrase-level elements for simple editorial correction and transcription. | |
| Module | tei |
| Used by | |
| Members | model.pPart.editorial [ abbr choice expan] model.pPart.transcriptional [ corr option orig read reg sic written] |
| model.pPart.editorial groups phrase-level elements for simple editorial interventions that may be useful both in transcribing and in authoring. | |
| Module | tei |
| Used by | |
| Members | abbr choice expan |
| model.pPart.transcriptional groups phrase-level elements used for editorial transcription of pre-existing source materials. | |
| Module | tei |
| Used by | |
| Members | corr option orig read reg sic written |
| model.persEventLike groups elements describing specific events in a person's history, for example birth, marriage, or appointment. | |
| Module | tei |
| Used by | |
| Members | birth death |
| Note |
These are not
characteristics of an individual, but often cause an individual to
gain such characteristics, or to enter a new state.
|
| model.persNamePart groups elements which form part of a personal name. | |
| Module | namesdates |
| Used by | |
| Members | addName forename genName nameLink roleName surname |
| model.persStateLike groups elements describing changeable characteristics of a person which have a definite duration, for example occupation, residence, or name. | |
| Module | tei |
| Used by | |
| Members | affiliation persName |
| Note |
These characteristics of an individual are
typically a consequence of their own action or that of others.
|
| model.personLike groups elements which provide information about people and their relationships. | |
| Module | tei |
| Used by | |
| Members | org person personGrp |
| model.personPart groups elements which form part of the description of a person. | |
| Module | tei |
| Used by | |
| Members | model.persEventLike [ birth death] model.persStateLike [ affiliation persName] bibl |
| model.phrase groups elements which can occur at the level of individual words or phrases. | |
| Module | tei |
| Used by | |
| Members | model.graphicLike [ graphic] model.highlighted [ model.emphLike [ distinct emph foreign gloss mentioned soCalled term title] model.hiLike [ hi] ] model.lPart model.pPart.data [ model.addressLike [ address affiliation email] model.dateLike [ date] model.nameLike [ model.nameLike.agent [ name orgName persName] model.persNamePart [ addName forename genName nameLink roleName surname] model.placeStateLike divineName rs] ] model.pPart.edit [ model.pPart.editorial [ abbr choice expan] model.pPart.transcriptional [ corr option orig read reg sic written] ] model.ptrLike [ ptr ref] model.segLike [ c cl m phr s seg w] |
| Note |
This class of elements can occur only within larger
elements of the class inter or chunk.
In prose, this means these elements can occur within paragraphs,
list items, lines of verse, etc.
|
| model.profileDescPart groups elements which may be used inside profileDesc and appear multiple times. | |
| Module | header |
| Used by | |
| Members | langUsage textClass |
| model.ptrLike groups elements used for purposes of location and reference. | |
| Module | tei |
| Used by | |
| Members | ptr ref |
| model.publicationStmtPart groups elements which may appear within the publicationStmt element of the TEI Header. | |
| Module | tei |
| Used by | |
| Members | address authority availability date distributor idno pubPlace publisher |
| model.qLike groups elements related to highlighting which can appear either within or between chunk-level elements. | |
| Module | tei |
| Used by | |
| Members | model.quoteLike [ cit quote] q said |
| model.quoteLike groups elements used to directly contain quotations. | |
| Module | tei |
| Used by | |
| Members | cit quote |
| model.rdgPart groups elements which mark the beginning or ending of a fragmentary manuscript or other witness. | |
| Module | textcrit |
| Used by | |
| Members | wit |
| Note |
These elements may appear anywhere within the elements <lem>
and <rdg>, and also within any of their constituent elements.
|
| model.resourceLike groups non-textual elements which may appear together with a header and a text to constitute a TEI document. | |
| Module | tei |
| Used by | |
| Members | metaLink propDecls |
| model.respLike groups elements which are used to indicate intellectual or other significant responsibility, for example within a bibliographic element. | |
| Module | tei |
| Used by | |
| Members | author editor funder principal respList respStmt sponsor |
| model.segLike groups elements used for arbitrary segmentation. | |
| Module | tei |
| Used by | |
| Members | c cl m phr s seg w |
| Note |
The principles on which segmentation is carried out, and
any special codes or attribute values used, should be defined explicitly
in the segmentation element of the encodingDesc within
the associated TEI header.
|
| model.titlepagePart groups elements which can occur as direct constituents of a title page, such as docTitle, docAuthor, docImprint, or epigraph. | |
| Module | tei |
| Used by | |
| Members | byline docAuthor docDate docEdition docImprint docTitle epigraph graphic imprimatur titlePart |
| att.ascribed provides attributes for elements representing speech or action that can be ascribed to a specific individual. | |||||||||
| Module | tei | ||||||||
| Members | change q said | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| att.canonical provides attributes which can be used to associate a representation such as a name or title with canonical information about the object being named or referenced. | |||||||||||||||||||
| Module | tei | ||||||||||||||||||
| Members | att.naming [ att.personal [ addName forename genName orgName persName roleName surname] affiliation birth death name pubPlace rs] author docAuthor docTitle resp term title | ||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||
| att.datable provides attributes for normalization of elements that contain dates, times, or datable events. | |
| Module | tei |
| Members | affiliation application birth date death orgName persName |
| Attributes | Global attributes and those inherited from att.datable.w3c (@period, @when, @notBefore, @notAfter, @from, @to) att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso) |
| Note |
This ‘superclass’ provides attributes that
can be used to provide normalized values of temporal information.
By default, the attributes from the att.datable.w3c class are provided. If the
module for names & dates is loaded, this class also provides
attributes from the att.datable.iso
class. In general, the possible values of attributes restricted to
the W3C datatypes form a subset of those values available via the
ISO 8601 standard. However, the greater expressiveness of the ISO
datatypes may not be needed, and there exists much greater
software support for the W3C datatypes.
|
| att.datable.iso provides attributes for normalization of elements that contain datable events using the ISO 8601 standard. | |||||||||||||||||||||||||||||||||||||||||||||||
| Module | namesdates | ||||||||||||||||||||||||||||||||||||||||||||||
| Members | att.datable [ affiliation application birth date death orgName persName] | ||||||||||||||||||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||||||||||||||||||||||||||||
| Note |
If both when-iso and dur-iso are specified, the values should be
interpreted as indicating a span of time by its starting time (or date) and duration.
That is,
<date when-iso="2007-06-01" dur-iso="P8D"/> indicates the same time period as <date when-iso="2007-06-01/P8D"/> In providing a ‘regularized’ form, no claim is made that the form in
the source text is incorrect; the regularized form is simply that chosen as the main
form for purposes of unifying variant forms under a single heading.
|
||||||||||||||||||||||||||||||||||||||||||||||
| att.datable.w3c provides attributes for normalization of elements that contain datable events using the W3C datatypes. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Module | tei | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Members | att.datable [ affiliation application birth date death orgName persName] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| att.declarable provides attributes for those elements in the TEI Header which may be independently selected by means of the special purpose decls attribute. | |||||||||
| Module | tei | ||||||||
| Members | availability bibl biblFull biblStruct correction editorialDecl hyphenation interpretation langUsage listBibl listOrg listPerson listPlace normalization projectDesc quotation refsDecl samplingDecl segmentation sourceDesc stdVals textClass | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Note |
The rules governing the association of declarable elements with
individual parts of a TEI text are fully defined in chapter ??. Only one element of a particular type may have a
default attribute with a value of true.
|
||||||||
| att.declaring provides attributes for elements which may be independently associated with a particular declarable element within the header, thus overriding the inherited default for that element. | |||||||||
| Module | tei | ||||||||
| Members | ab back body div floatingText front gloss graphic group lg option p ptr ref term text | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Note |
The rules governing the association of declarable elements
with individual parts of a TEI text are fully defined in chapter ??.
|
||||||||
| att.dimensions provides attributes for describing the size of physical objects. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Module | tei | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Members | att.editLike [ affiliation birth corr date death expan org orgName persName person read reg written] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| att.divLike provides attributes common to all elements which behave in the same way as divisions. | |||||||||||||||||||||
| Module | tei | ||||||||||||||||||||
| Members | div lg | ||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||
| att.editLike provides attributes describing the nature of a encoded scholarly intervention or interpretation of any kind. | |||||||||||||||||||||||||||||||
| Module | tei | ||||||||||||||||||||||||||||||
| Members | affiliation birth corr date death expan org orgName persName person read reg written | ||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes and those inherited from att.dimensions (@unit, @quantity, @extent, @atLeast, @atMost, @min, @max, @precision, @scope)
|
||||||||||||||||||||||||||||||
| Note |
The members of this attribute class are typically used to
represent any kind of editorial intervention in a text, for
example a correction or interpretation, or to date or localize manuscripts etc.
|
||||||||||||||||||||||||||||||
| att.global provides attributes common to all elements in the TEI encoding scheme. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Module | tei | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Members | divineName instruct instructGrp metaLink optInstruct prop propDecl propDecls propGrp propVal respList | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes and those inherited from att.global.liturgy (@set, @props) att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select) att.global.analytic (@ana)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| att.global.analytic provides additional global attributes for associating specific analyses or interpretations with appropriate portions of a text. | |||||||||||
| Module | analysis | ||||||||||
| Members | att.global [ divineName instruct instructGrp metaLink optInstruct prop propDecl propDecls propGrp propVal respList] | ||||||||||
| Attributes | In addition to global attributes
|
||||||||||
| att.global.linking defines a set of attributes for hypertext and other linking, which are enabled for all elements when the additional tag set for linking is selected. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Module | linking | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Members | att.global [ divineName instruct instructGrp metaLink optInstruct prop propDecl propDecls propGrp propVal respList] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| att.global.liturgy Groups global attributes used by the liturgy module, eg the property-conditional system. | |||||||||||||||||
| Module | liturgy | ||||||||||||||||
| Members | att.global [ divineName instruct instructGrp metaLink optInstruct prop propDecl propDecls propGrp propVal respList] | ||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||
| att.internetMedia provides attributes for specifying the type of a computer resource using a standard taxonomy. | |||||||||
| Module | tei | ||||||||
| Members | graphic | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Note |
This attribute class provides attributes for describing a
computer resource, typically available over the internet,
according to standard taxonomies. At present only a single
taxonomy is supported, the Multipurpose Internet Mail Extensions
Media Type system. This system of typology of media types is
defined by the Internet Engineering Task Force in RFC 2046. The
list of
types is maintained by the Internet Assigned Numbers
Authority.
|
||||||||
| att.interpLike provides attributes for elements which represent a formal analysis or interpretation. | |||||||||||||||||||||||||||
| Module | tei | ||||||||||||||||||||||||||
| Members | interp interpGrp span spanGrp | ||||||||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||||||||
| att.naming provides attributes common to elements which refer to named persons, places, organizations etc. | |||||||||||
| Module | tei | ||||||||||
| Members | att.personal [ addName forename genName orgName persName roleName surname] affiliation birth death name pubPlace rs | ||||||||||
| Attributes | In addition to global attributes and those inherited from att.canonical (@key, @ref)
|
||||||||||
| att.personal (attributes for components of personal names) common attributes for those elements which form part of a personal name. | |||||||||||||||
| Module | tei | ||||||||||||||
| Members | addName forename genName orgName persName roleName surname | ||||||||||||||
| Attributes | In addition to global attributes and those inherited from att.naming (@nymRef) (att.canonical (@key, @ref))
|
||||||||||||||
| att.placement provides attributes for describing where on the source page or object a textual element appears. | |||||||||||||
| Module | tei | ||||||||||||
| Members | note witDetail | ||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||
| att.pointing defines a set of attributes used by all elements which point to other elements by means of one or more URI references. | |||||||||||||||||
| Module | linking | ||||||||||||||||
| Members | att.pointing.group [ joinGrp linkGrp] join link ptr ref | ||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||
| att.pointing.group defines a set of attributes common to all elements which enclose groups of pointer elements. | |||||||||||||||||||||
| Module | linking | ||||||||||||||||||||
| Members | joinGrp linkGrp | ||||||||||||||||||||
| Attributes | In addition to global attributes and those inherited from att.pointing (@type, @evaluate)
|
||||||||||||||||||||
| att.rdgPart attributes for elements which mark the beginning or ending of a fragmentary manuscript or other witness. | |||||||||
| Module | textcrit | ||||||||
| Members | wit | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Note |
These elements may appear anywhere within the elements <lem>
and <rdg>, and also within any of their constituent elements.
|
||||||||
| att.segLike provides attributes for elements used for arbitrary segmentation. | |||||||||||||||||
| Module | tei | ||||||||||||||||
| Members | c cl m phr s seg w | ||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||
| att.sourced provides attributes identifying the source edition from which some encoded feature derives. | |||||||||
| Module | tei | ||||||||
| Members | milestone refState | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Example |
<l>Of Mans First Disobedience,<lb ed="1674"/> and<lb ed="1667"/> the Fruit</l>
<l>Of that Forbidden Tree, whose<lb ed="1667 1674"/> mortal tast</l> <l>Brought Death into the World,<lb ed="1667"/> and all<lb ed="1674"/> our woe,</l> |
||||||||
| att.translatable provides attributes used to indicate the status of a translatable portion of an ODD document. | |||||||||
| Module | tei | ||||||||
| Members | desc gloss | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| att.typed provides attributes which can be used to classify or subclassify elements in any way. | |||||||||||||||
| Module | tei | ||||||||||||||
| Members | ab addName anchor application bibl biblStruct c cit cl corr date div divineName floatingText forename genName gloss head instruct lg listBibl listOrg listPerson listPlace m milestone name nameLink org orgName persName phr quote reg relatedItem roleName s seg surname term text w | ||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||
| Note |
The typology used may be formally defined using
the <classification> element of the encodingDesc within
the associated TEI header, or as a list within one of the components
of the encodingDesc element, or informally as descriptive prose within
the encodingDesc element.
|
||||||||||||||
| macro.anyXML defines a content model within which any XML elements are permitted | |
| Module | tei |
| Used by | |
| Declaration |
macro.anyXML = element * { ( attribute * - (xml:id | xml:lang) { text } | text | macro.anyXML )* } |
| macro.limitedContent (paragraph content) defines the content of prose elements that are not used for transcription of extant materials. | |
| Module | tei |
| Used by | |
| Declaration |
macro.limitedContent = ( text | model.limitedPhrase | model.inter )* |
| macro.paraContent (paragraph content) defines the content of paragraphs and similar elements. | |
| Module | tei |
| Used by | |
| Declaration |
macro.paraContent = ( text | model.gLike | model.phrase | model.inter | model.global )* |
| macro.phraseSeq (phrase sequence) defines a sequence of character data and phrase-level elements. | |
| Module | tei |
| Used by |
abbr addName addrLine affiliation author biblScope birth cl dateline death distinct distributor divineName docAuthor docDate edition editor email expan extent foreign forename genName gloss headItem headLabel label mentioned name nameLink orgName persName phr pubPlace publisher roleName rs s salute signed soCalled street surname term trailer wit witDetail
|
| Declaration |
macro.phraseSeq = ( text | model.gLike | model.phrase | model.global )* |
| macro.phraseSeq.limited (limited phrase sequence) defines a sequence of character data and those phrase-level elements that are not typically used for transcribing extant documents. | |
| Module | tei |
| Used by | |
| Declaration |
macro.phraseSeq.limited = ( text | model.limitedPhrase | model.global )* |
| macro.specialPara ('special' paragraph content) defines the content model of elements such as notes or list items, which either contain a series of component-level elements or else have the same structure as a paragraph, containing a series of phrase-level and inter-level elements. | |
| Module | tei |
| Used by | |
| Declaration |
macro.specialPara =
(
text
| model.gLike
| model.phrase
| model.inter
| model.divPart
| model.global
)*
|
| macro.xtext (extended text) defines a sequence of character data and gaiji elements. | |
| Module | tei |
| Used by | |
| Declaration |
macro.xtext = ( text | model.gLike )* |
| <TEI> (TEI document) contains a single TEI-conformant document, comprising a TEI header and a text, either in isolation or as part of a <teiCorpus> element. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DS http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCDEF | |||||||||
| Module | textstructure | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Used by | |||||||||
| May contain | |||||||||
| Declaration |
element TEI { att.global.attributes, attribute version { xsd:decimal }?, ( teiHeader, ( ( model.resourceLike+, text? ) | text ) ) } <sch:ns prefix="tei" uri="http://www.tei-c.org/ns/1.0"/> <sch:ns prefix="rng" uri="http://relaxng.org/ns/structure/1.0"/> |
||||||||
| Example |
<TEI>
<teiHeader> <fileDesc> <titleStmt> <title>The shortest TEI Document Imaginable</title> </titleStmt> <publicationStmt> <p>First published as part of TEI P2.</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> |
||||||||
| Note |
This element is required.
|
||||||||
| <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. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/SA.html#SASE | |||||||||
| Module | linking | ||||||||
| Attributes | In addition to global attributes and those inherited from att.typed (@type, @subtype) att.declaring (@decls)
|
||||||||
| Used by | |||||||||
| May contain |
certainty:
respons
core:
abbr address bibl biblStruct choice cit corr date desc distinct email emph expan foreign gloss graphic hi label list listBibl mentioned milestone name note orig ptr q quote ref reg rs said sic soCalled term title
header:
biblFull
liturgy:
divineName instruct instructGrp option prop propDecl propGrp read written
|
||||||||
| Declaration |
element ab { att.global.attributes, att.typed.attributes, att.declaring.attributes, attribute part { "Y" | "N" | "I" | "M" | "F" }?, macro.paraContent } |
||||||||
| Example |
<div type="book" n="Genesis">
<div type="chapter" n="1"> <ab>In the beginning God creaqted 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> |
||||||||
| 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.
|
||||||||
| <abbr> (abbreviation) contains an abbreviation of any sort. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#CONAAB | |||||||||||
| Module | core | ||||||||||
| Attributes | In addition to global attributes
|
||||||||||
| Used by | |||||||||||
| May contain | |||||||||||
| Declaration |
element abbr { att.global.attributes, attribute type { xsd:Name }?, macro.phraseSeq } |
||||||||||
| Example |
<abbr>SPQR</abbr>
|
||||||||||
| Example |
<choice>
<abbr>SPQR</abbr> <expan>senatus populusque romanorum</expan> </choice> |
||||||||||
| Note |
The abbr tag is not required; if appropriate, the encoder may transcribe
abbreviations in the source text silently, without tagging them. If abbreviations are
not transcribed directly but expanded silently, then the TEI header should
so indicate.
|
||||||||||
| <addName> (additional name) contains an additional name component, such as a nickname, epithet, or alias, or any other descriptive phrase used within a personal name. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ND.html#NDPER | |
| Module | namesdates |
| Attributes | Global attributes and those inherited from att.personal (@full, @sort) (att.naming (@nymRef) (att.canonical (@key, @ref)) ) att.typed (@type, @subtype) |
| Used by | |
| May contain | |
| Declaration |
element addName { att.global.attributes, att.personal.attributes, att.typed.attributes, macro.phraseSeq } |
| Example |
<persName>
<forename>Frederick</forename> <addName type="epithet">the Great</addName> <roleName>Emperor of Prussia</roleName> </persName> |
| <addrLine> (address line) contains one line of a postal address. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#CONAAD http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD24 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBICOI | |
| Module | core |
| Attributes | Global attributes only |
| Used by | |
| May contain | |
| Declaration |
element addrLine { att.global.attributes, macro.phraseSeq }
|
| Example |
<address>
<addrLine>Computing Center, MC 135</addrLine> <addrLine>P.O. Box 6998</addrLine> <addrLine>Chicago, IL</addrLine> <addrLine>60680 USA</addrLine> </address> |
| 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.
|
| <address> contains a postal address, for example of a publisher, an organization, or an individual. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#CONAAD http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD24 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBICOI | |
| Module | core |
| Attributes | Global attributes only |
| Used by | |
| May contain |
certainty:
respons
liturgy:
divineName instruct instructGrp prop propDecl propGrp
textcrit:
witDetail
|
| Declaration |
element address { att.global.attributes, ( model.global*, ( ( model.addrPart ), model.global* )+ ) } |
| Example |
<address>
<street>via Marsala 24</street> <postCode>40126</postCode> <name>Bologna</name> <name n="I">Italy</name> </address> |
| Example |
<address>
<addrLine>Computing Center, MC 135</addrLine> <addrLine>P.O. Box 6998</addrLine> <addrLine>Chicago, IL 60680</addrLine> <addrLine>USA</addrLine> </address> |
| Note | |
| <affiliation> (affiliation) contains an informal description of a person's present or past affiliation with some organization, for example an employer or sponsor. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAHPA | |
| Module | namesdates |
| Attributes | Global attributes and those inherited from att.editLike (@cert, @resp, @evidence, @source) (att.dimensions (@unit, @quantity, @extent, @atLeast, @atMost, @min, @max, @precision, @scope)) att.datable (att.datable.w3c (@period, @when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) att.naming (@nymRef) (att.canonical (@key, @ref)) |
| Used by | |
| May contain | |
| Declaration |
element affiliation { att.global.attributes, att.editLike.attributes, att.datable.attributes, att.naming.attributes, macro.phraseSeq } |
| Example |
<affiliation>Junior project officer for the US <name type="org">National Endowment for
the Humanities</name> </affiliation> <affiliation notAfter="1960-01-01" notBefore="1957-02-28">Paid up member of the <orgName>Australian Journalists Association</orgName> </affiliation> |
| Note | |
| <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. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBICOL | |
| Module | core |
| Attributes | Global attributes only |
| Used by | |
| May contain | |
| Declaration |
element analytic { att.global.attributes, ( author | editor | respStmt | title )* } |
| 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> <biblScope>25.6</biblScope> <date when="1991-12">(December, 1991):</date> <biblScope>377–380</biblScope> </imprint> </monogr> </biblStruct> |
| Note |
May contain titles and statements of responsibility (author, editor, or
other), in any order.
The analytic element may only occur only within a biblStruct, where its use
is mandatory for the description of an analytic level bibliographic item.
|
| <anchor> (anchor point) attaches an identifier to a point within a text, whether or not it corresponds with a textual element. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TS.html#TSSAPA http://www.tei-c.org/release/doc/tei-p5-doc/en/html/SA.html#SACS | |
| Module | linking |
| Attributes | Global attributes and those inherited from att.typed (@type, @subtype) |
| Used by | |
| May contain | Empty element |
| Declaration |
element anchor { att.global.attributes, att.typed.attributes, empty }
|
| Example |
<s>The anchor is he<anchor xml:id="A234"/>re somewhere.</s>
<s>Help me find it.<ptr target="#A234"/> </s> |
| 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.
|
| <appInfo> (application information) records information about an application which has edited the TEI file. | |
| Module | header |
| Attributes | Global attributes only |
| Used by | |
| May contain |
header:
application
|
| Declaration |
element appInfo { att.global.attributes, model.applicationLike+ }
|
| Example |
<appInfo>
<application version="1.24" ident="Xaira"> <label>XAIRA Indexer</label> <ptr target="#P1"/> </application> </appInfo> |
| <application> provides information about an application which has acted upon the document. | |||||||||||||
| Module | header | ||||||||||||
| Attributes | In addition to global attributes and those inherited from att.typed (@type, @subtype) att.datable (att.datable.w3c (@period, @when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso))
|
||||||||||||
| Used by | |||||||||||||
| May contain | |||||||||||||
| Declaration |
element application { att.global.attributes, att.typed.attributes, att.datable.attributes, attribute ident { xsd:Name }, attribute version { token { pattern = "[\d]+[a-z]*[\d]*(\.[\d]+[a-z]*[\d]*){0,3}" } }, ( model.labelLike+, ( model.ptrLike* | model.pLike* ) ) } |
||||||||||||
| 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. |
||||||||||||
| <argument> A formal list or prose description of the topics addressed by a subdivision of a text. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DSCO http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DSDTB | |
| Module | textstructure |
| Attributes | Global attributes only |
| Used by | |
| May contain |
certainty:
respons
header:
biblFull
liturgy:
instruct instructGrp prop propDecl propGrp
namesdates:
listOrg listPerson listPlace
textstructure:
floatingText
|
| Declaration |
element argument { att.global.attributes, ( ( model.global | model.headLike )*, ( ( model.common ), model.global* )+ ) } |
| Example |
<argument>
<p>Monte Video — Maldonado — Excursion to R Polanco — Lazo and Bolas — Partridges — Absence of Trees — Deer — Capybara, or River Hog — Tucutuco — Molothrus, cuckoo-like habits — Tyrant Flycatcher — Mocking-bird — Carrion Hawks — Tubes formed by Lightning — House struck</p> </argument> |
| Note |
Often contains either a list or a
paragraph
|
| <author> in a bibliographic reference, contains the name of the author(s), personal or corporate, of a work; the primary statement of responsibility for any bibliographic item. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBICOR http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD21 | |
| Module | core |
| Attributes | Global attributes and those inherited from att.canonical (@key, @ref) |
| Used by | |
| May contain | |
| Declaration |
element author { att.global.attributes, att.canonical.attributes, macro.phraseSeq } |
| Example |
<author>British Broadcasting Corporation</author>
<author>La Fayette, Marie Madeleine Pioche de la Vergne, comtesse de (1634–1693)</author> |
| Note |
Particularly where cataloguing is likely to be based on the content of the header, it is
advisable to use generally recognized authority lists for the exact form of personal names.
The attributes key or ref may also be used to reference canonical
information about the author intended in an 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.
|
| <authority> (release authority) supplies the name of a person or other agency responsible for making an electronic file available, other than a publisher or distributor. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD24 | |
| Module | header |
| Attributes | Global attributes only |
| Used by | |
| May contain | |
| Declaration |
element authority { att.global.attributes, macro.phraseSeq.limited }
|
| Example |
<authority>John Smith</authority>
|
| <availability> supplies information about the availability of a text, for example any restrictions on its use or distribution, its copyright status, etc. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD24 | |||||||
| Module | header | ||||||
| Attributes | In addition to global attributes and those inherited from att.declarable (@default)
|
||||||
| Used by | |||||||
| May contain | |||||||
| Declaration |
element availability { attribute status { "free" | "unknown" | "restricted" | "public-domain" | "permissive" | "copyleft-gpl" }?, att.global.attributes, att.declarable.attributes, model.pLike+ } |
||||||
| 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> |
||||||
| Note | Specifies the license under which the text is made available, in computer parsable form. | ||||||
| <back> (back matter) contains any appendixes, etc. following the main part of a text. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DSBACK http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DS | |
| Module | textstructure |
| Attributes | Global attributes and those inherited from att.declaring (@decls) |
| Used by | |
| May contain | |
| Declaration |
element back { att.global.attributes, att.declaring.attributes, ( ( model.frontPart | model.pLike.front | model.global )*, ( ( ( ( model.div1Like ), ( model.frontPart | model.div1Like | model.global )* ) | ( ( model.divLike ), ( model.frontPart | model.divLike | model.global )* ) )? ), ( ( ( model.divBottomPart ), ( model.divBottomPart | model.global )* )? ) ) } |
| Example |
<back>
<div1 type="appendix"> <head>The Golden Dream or, the Ingenuous Confession</head> <p>To shew the Depravity of human Nature</p> </div1> <div1 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> </div1> <div1 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> </div1> <div1 type="advert"> <head> <hi rend="center">By the KING's Royal Patent,</hi> 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> </div1> </back> |
| Note |
The content model of back matter is identical to that of front matter, reflecting the facts
of cultural history.
|
| <bibl> (bibliographic citation) contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBITY http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD3 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAS2 | |
| Module | core |
| Attributes | Global attributes and those inherited from att.declarable (@default) att.typed (@type, @subtype) |
| Used by | |
| May contain | |
| Declaration |
element bibl { att.global.attributes, att.declarable.attributes, att.typed.attributes, ( text | model.gLike | model.highlighted | model.pPart.data | model.pPart.edit | model.segLike | model.ptrLike | model.biblPart | model.global )* } |
| 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> |
| Note |
Contains phrase-level elements, together with any combination of elements
from the biblPart class
|
| <biblFull> (fully-structured bibliographic citation) contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBITY http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD3 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAS2 | |
| Module | header |
| Attributes | Global attributes and those inherited from att.declarable (@default) |
| Used by | |
| May contain | |
| Declaration |
element biblFull { att.global.attributes, att.declarable.attributes, ( ( titleStmt, editionStmt?, extent?, publicationStmt, seriesStmt?, notesStmt? ), sourceDesc* ) } |
| 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> |
| <biblScope> (scope of citation) defines the scope of a bibliographic reference, for example as a list of page numbers, or a named subdivision of a larger work. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBICOI | |||||||||
| Module | core | ||||||||
| Attributes | In addition to global attributes
|
||||||||
| Used by | |||||||||
| May contain | |||||||||
| Declaration |
element biblScope { att.global.attributes, attribute type { "vol" | "issue" | "pp" | "chap" | "part" | xsd:Name }?, macro.phraseSeq } |
||||||||
| Example |
<biblScope>pp 12–34</biblScope>
<biblScope type="vol">II</biblScope> <biblScope type="pp">12</biblScope> |
||||||||
| <biblStruct> (structured bibliographic citation) contains a structured bibliographic citation, in which only bibliographic sub-elements appear and in a specified order. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBITY http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD3 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAS2 | |
| Module | core |
| Attributes | Global attributes and those inherited from att.declarable (@default) att.typed (@type, @subtype) |
| Used by | |
| May contain |
core:
analytic monogr note relatedItem series
header:
idno
liturgy:
instruct instructGrp
textcrit:
witDetail
|
| Declaration |
element biblStruct { att.global.attributes, att.declarable.attributes, att.typed.attributes, ( analytic*, ( monogr, series* )+, ( model.noteLike | idno | relatedItem )* ) } |
| 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> |
| <birth> (birth) contains information about a person's birth, such as its date and place. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CC.html#CCAHPA | |
| Module | namesdates |
| Attributes | Global attributes and those inherited from att.editLike (@cert, @resp, @evidence, @source) (att.dimensions (@unit, @quantity, @extent, @atLeast, @atMost, @min, @max, @precision, @scope)) att.datable (att.datable.w3c (@period, @when, @notBefore, @notAfter, @from, @to)) (att.datable.iso (@when-iso, @notBefore-iso, @notAfter-iso, @from-iso, @to-iso)) att.naming (@nymRef) (att.canonical (@key, @ref)) |
| Used by | |
| May contain | |
| Declaration |
element birth { att.global.attributes, att.editLike.attributes, att.datable.attributes, att.naming.attributes, macro.phraseSeq } |
| 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> |
| <body> (text body) contains the whole body of a single unitary text, excluding any front or back matter. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DS | |
| Module | textstructure |
| Attributes | Global attributes and those inherited from att.declaring (@decls) |
| Used by | |
| May contain | |
| Declaration |
element body { att.global.attributes, att.declaring.attributes, ( model.global*, ( ( model.divTop ), ( model.global | model.divTop )* )?, ( ( model.divGenLike ), ( model.global | model.divGenLike )* )?, ( ( ( model.divLike ), ( model.global | model.divGenLike )* )+ | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+ | ( ( ( model.common ), model.global* )+, ( ( ( model.divLike ), ( model.global | model.divGenLike )* )+ | ( ( model.div1Like ), ( model.global | model.divGenLike )* )+ )? ) ), ( ( model.divBottom ), model.global* )* ) } |
| 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> |
| <byline> contains the primary statement of responsibility given for a work on its title page or at the head or end of the work. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DSOC http://www.tei-c.org/release/doc/tei-p5-doc/en/html/DS.html#DSFRONT | |
| Module | textstructure |
| Attributes | Global attributes only |
| Used by | |
| May contain |
certainty:
respons
core:
abbr address choice corr date distinct email emph expan foreign gloss graphic hi mentioned milestone name note orig ptr ref reg rs sic soCalled term title
liturgy:
divineName instruct instructGrp option prop propDecl propGrp read written
textcrit:
witDetail
textstructure:
docAuthor
|
| Declaration |
element byline { att.global.attributes, ( text | model.gLike | model.phrase | docAuthor | model.global )* } |
| Example |
<byline>Written by a CITIZEN who continued all the
while in London. Never made publick before.</byline> |
| Example |
<byline>Written from her own MEMORANDUMS</byline>
|
| Example |
<byline>By George Jones, Political Editor, in Washington</byline>
|
| Example |
<dateline>Zagreb:</dateline>
<byline>de notre envoyé spécial.</byline> |
| Example |
<byline>BY
<docAuthor>THOMAS PHILIPOTT,</docAuthor> Master of Arts, (Somtimes) Of Clare-Hall in Cambridge.</byline> |
| Note |
The byline on a title page may include either the name
or a description for the document's author. Where the name is included,
it may optionally be tagged using the docAuthor element.
|
| <c> (character) represents a character. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/AI.html#AILC | |
| Module | analysis |
| Attributes | Global attributes and those inherited from att.segLike (@function, @part) att.typed (@type, @subtype) |
| Used by | |
| May contain | Empty element |
| Declaration |
element c { att.global.attributes, att.segLike.attributes, att.typed.attributes, macro.xtext } |
| Example |
<c type="punctuation">?</c>
|
| 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.
|
| <cRefPattern> (canonical reference pattern) specifies an expression and replacement pattern for transforming a canonical reference into a URI. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD54M http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD54 http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD54S | |||||||||||||||||||||
| Module | header | ||||||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||||||
| Used by | |||||||||||||||||||||
| May contain | |||||||||||||||||||||
| Declaration |
element cRefPattern { att.global.attributes, attribute matchPattern { token }, attribute replacementPattern { text }, model.pLike* } |
||||||||||||||||||||
| 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'])"/> |
||||||||||||||||||||
| 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.
|
||||||||||||||||||||
| <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. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD55 | |
| Module | header |
| Attributes | Global attributes only |
| Used by | |
| May contain | |
| Declaration |
element catDesc { att.global.attributes, ( text | model.limitedPhrase | model.catDescPart )* } |
| 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> |
| <catRef> (category reference) specifies one or more defined categories within some taxonomy or text typology. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD43 | |||||||||||||||||
| Module | header | ||||||||||||||||
| Attributes | In addition to global attributes
|
||||||||||||||||
| Used by | |||||||||||||||||
| May contain | Empty element | ||||||||||||||||
| Declaration |
element catRef { att.global.attributes, attribute target { list { xsd:anyURI+ } }, attribute scheme { xsd:anyURI }?, empty } |
||||||||||||||||
| Example |
<catRef target="#news #prov #sales2"/>
<!-- elsewhere --> <taxonomy> <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> |
||||||||||||||||
| Note |
The scheme attribute need be supplied only if more than
one taxonomy has been declared
|
||||||||||||||||
| <category> contains an individual descriptive category, possibly nested within a superordinate category, within a user-defined taxonomy. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD55 | |
| Module | header |
| Attributes | Global attributes only |
| Used by | |
| May contain | |
| Declaration |
element category { att.global.attributes, ( ( catDesc | model.glossLike* ), category* ) } |
| Example |
<category xml:id="b1">
<catDesc>Prose reportage</catDesc> </category> |
| Example |
<category xml:id="b2">
<catDesc>Prose</catDesc> <category xml:id="b11"> <catDesc>reportage</catDesc> </category> <category xml:id="b12"> <catDesc>fiction</catDesc> </category> </category> |
| <change> summarizes a particular change or correction made to a particular version of an electronic text which is shared between several researchers. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html#HD6 | |||||||||
| Module | header | ||||||||
| Attributes | In addition to global attributes and those inherited from att.ascribed (@who)
|
||||||||
| Used by | |||||||||
| May contain |
certainty:
respons
core:
abbr address bibl biblStruct choice cit date desc distinct email emph expan foreign gloss label list listBibl mentioned milestone name note ptr q quote ref rs said soCalled term title
header:
biblFull
liturgy:
divineName instruct instructGrp prop propDecl propGrp
|
||||||||
| Declaration |
element change { att.global.attributes, att.ascribed.attributes, attribute when { xsd:date | xsd:gYear | xsd:gMonth | xsd:gDay | xsd:gYearMonth | xsd:gMonthDay | xsd:time | xsd:dateTime }?, ( text | model.limitedPhrase | model.inter | model.global )* } |
||||||||
| 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> <change who="#BZ" when="2008-02-02">Finished chapter 23</change> <change who="#BZ" when="2008-01-02">Finished chapter 2</change> <change n="P2.2" when="1991-12-21" who="#LDB">Added examples to section 3</change> <change when | ||||||||