Elements Available in All TEI Documents

This chapter describes elements which may appear in any kind of text and the tags used to mark them in all TEI documents. Most of these elements are freely floating phrases, which can appear at any point within the textual structure, although they must generally be contained by a higher-level element of some kind (such as a paragraph). A few of the elements described in this chapter (for example, bibliographic citations and lists) have a comparatively well-defined internal structure, but most of them have no consistent inner structure of their own. In the general case, they contain only a few words, and are often identifiable in a conventionally printed text by the use of typographic conventions such as shifts of font, use of quotation or other punctuation marks, or other changes in layout.

To use the terminology introduced in section , most of the elements described in this chapter are members of the class phrase, and a small number are members of the classes chunk or inter.

This chapter begins by describing the p tag used to mark paragraphs, which serve as the fundamental formal unit for running text in many base tag sets, and are available in all. This is followed, in section , by a discussion of some specific problems associated with the interpretation of conventional punctuation, and the methods proposed by the current Guidelines for resolving ambiguities therein.

The next section (section ) describes a number of phrase-level elements commonly marked by typographic features (and thus well-represented in conventional markup languages). These include features commonly marked by font shifts (section ) and features commonly marked by quotation marks (section ) as well as such features as terms, cited words, and glosses (section ).

The next section (section ) describes several phrase-level and inter-level elements which, although often of interest for analysis or processing, are rarely explicitly identified in conventional printing. These include names (section ), numbers and measures (section ), dates and times (section ), abbreviations (section ), and addresses (section ).

Section introduces some phrase-level elements which may be used to record simple editorial emendation or correction of the encoded text. The tags described here constitute a simple subset of the full mechanisms for encoding such information (described in full in chapter ), which should be adequate to most commonly encountered situations.

In the same way, the following section (section ) presents only a subset of the facilities available for the encoding of cross-references or text-linkage. The full story may be found in chapter ; the tags presented here are intended to be usable for a wide variety of simple applications.

Sections , and , describe two kinds of quasi-structural elements, lists and notes, which may appear either within chunk-level elements such as paragraphs, or between them. Several kinds of lists are catered for, of an arbitrary complexity. The section on notes discusses both notes found in the source and simple mechanisms for adding annotations of an interpretive nature during the encoding; again, only a subset of the facilities described in full elsewhere (specifically, in chapter ) is discussed.

Next, section , describes methods of encoding within a text the conventional system or systems used when making references to the text. Some reference systems have attained canonical authority and must be recorded to make the text useable in normal work; in other cases, a convenient reference system must be created by the creator or analyst of an electronic text.

Like lists and notes, the bibliographic citations discussed in section , may be regarded as structural elements in their own right. A range of possibilities is presented for the encoding of bibliographic citations or references, which may be treated as simple phrases within a running text, or as highly-structured components suitable for inclusion in a bibliographic database.

Additional elements for the encoding of passages of verse or drama (whether prose or verse) are discussed in section .

The chapter concludes with a technical overview of the structure and organization of the tag set described here. This should be read in conjunction with chapter , describing the structure of the TEI document type definition. Paragraphs

The paragraph is the fundamental organizational unit for all prose texts, being the smallest regular unit into which prose can be divided. Prose can appear in all TEI texts, not simply in those using the prose base (section ); the paragraph is therefore described here, as an element which can appear in any kind of text.

Paragraphs can contain any of the other elements described within this chapter, as well as some other elements which are specific to individual text types. We distinguish phrase-level elements, which must be entirely contained within a paragraph and cannot appear except within one, from chunks, which can appear between, but not within, paragraphs, and from inter-level elements, which can appear either within a single paragraph or between paragraphs. The class of phrases includes emphasized or quoted phrases, names, dates, etc. The class of inter-level elements includes bibliographic citations, notes, lists, etc. The class of chunks includes the paragraph itself.

Because paragraphs may appear in different base or additional tag sets, their possible contents may differ in different kinds of documents. In particular, additional elements not listed in this chapter may appear in paragraphs in certain kinds of text. However, the elements described in this chapter are always by default available in all kinds of text.

The paragraph is marked using the p element: marks paragraphs in prose.

If a consistent internal subdivision of paragraphs is desired, the s or seg (segment) elements may be used, as discussed in chapters and respectively. More usually, however, paragraphs have no firm internal structure, but contain prose encoded as a mix of characters, entity references, phrases marked as described in the rest of this chapter, and embedded elements like lists, figures, or tables.

Since paragraphs are usually explicitly marked in Western texts, typically by indentation, the application of the p tag usually presents few problems.

In some cases, the body of a text may comprise but a single paragraph:

I fully appreciate Gen. Pope's splendid achievements with their invaluable results; but you must know that Major Generalships in the Regular Army, are not as plenty as blackberries. ]]> A fly built a castle, a tall and mighty castle. There came to the castle the Crawling Louse. Who, who's in the castle? Who, who's in your house? said the Crawling Louse. I, I, the Languishing Fly. And who art thou? I'm the Crawling Louse.

Then came to the castle the Leaping Flea. Who, who's in the castle? said the Leaping Flea. I, I, the Languishing Fly, and I, the Crawling Louse. And who art thou? I'm the Leaping Flea.

Then came to the castle the Mischievous Mosquito. Who, who's in the castle? said the Mischievous Mosquito. I, I, the Languishing Fly, and I, the Crawling Louse, and I, the Leaping Flea. And who art thou? I'm the Mischievous Mosquito. ]]>

The p element is formally declared as follows: ]]> Treatment of Punctuation

Punctuation marks cause problems for text markup because they may not be available in the character set used and because they are often ambiguous. In the former case entity names should be used to render the punctuation mark (see ). In the latter case, ambiguous punctuation may be treated as described below.

Full stop (period) may mark (orthographic) sentence boundaries, abbreviations, decimal points, or serve as a visual aid in printing numbers. These usages can be distinguished by tagging S-units, abbreviations, and numbers, as described in sections , , and . There are independent reasons for tagging these, whether or not they are marked by full stops. Alternatively, the following TEI-specific entity names may be used to distinguish stops (and other characters) used for these purposes: These entities are defined in the file teipunc2, which is documented in chapter .

Question mark and exclamation mark typically mark the end of orthographic sentences, but may also be used as a mid-sentence comment by the author (! to express surprise or some other strong feeling, ? to query a word or expression or mark a sentence as dubious in linguistic discussion). These uses may be distinguished by marking S-units, in which case the mid-sentence uses of these punctuation marks may be left unmarked.

Hyphens at line-end may or may not indicate permanent (hard) hyphens in the word. Where the lineation of the machine-readable text differs from the original, the editor may eliminate soft (line-end) hyphens or replace them by a reference to the entity shy (soft hyphen), which is defined in the standard public entity set ISOnum defined in ISO 8879 (which should be invoked in the DTD subset if the entity shy is to be used). The solution chosen should be reported in the hyphenation tag of the encoding declarations in the TEI header. See chapter for discussion of the TEI header and encoding declarations.

Creators of machine-readable texts are recommended to avoid soft hyphens, as one cannot tell whether the hyphens are soft or hard in the case of compounds or prefixed words which might or might not be hyphenated in mid-sentence.

Dashes are best distinguished in form by using the entity names provided in the public entity set ISOpub, defined in ISO 8879: mdash, ndash, and dash (the true hyphen). Dashes are used for a variety of purposes: insertion, interruption, new speaker (in dialogue), list item. In the latter two cases it is preferable to mark the underlying feature using the elements q or item, on which see section , and section , respectively.

Quotation marks should generally be replaced by the tags q or quote, especially as quotations are not always marked by quotation marks (notably long quotations) or may be marked in a variety of ways; see the discussion of quotation and related features in section .

Apostrophes must be distinguished from single quote marks. This is best done by tagging quotations or other uses of quotation marks (see above). However, apostrophes have a variety of uses. In English they mark contractions, genitive forms, and (occasionally) plural forms. Full disambiguation of these uses belongs to the level of linguistic analysis and interpretation.

Parentheses and other marks of suspension such as dashes or ellipses are often used to signal information about the syntactic structure of a text fragment. Full disambiguation of their uses also belongs to the level of linguistic analysis and interpretation, and is therefore discussed in chapter .

Where punctuation marks are disambiguated by tagging the underlying feature they signal, it may be debated whether they should be excluded or left as part of the text. In the case of quotation marks, it may sometimes be more convenient to distinguish opening from closing marks simply by using the appropriate entity reference, rather than using the q element, with or without a rend attribute. The solution chosen will vary depending upon the feature and depending upon the purpose of the project. Highlighting and Quotation

This section deals with a variety of textual features, all of which have in common that they are frequently realized in conventional printing practice by the use of such features as underlining, italic fonts, or quotation marks, collectively referred to here as highlighting. After an initial discussion of this phenomenon and alternate approaches to encoding it, this section describes ways of encoding the following textual features, all of which are conventionally rendered using some kind of highlighting: emphasis, foreign words and other linguistically distinct uses of highlighting representation of speech and thought, quotation, etc. technical terms, glosses, etc. What Is Highlighting?

By highlighting we mean the use of any combination of typographic features (font, size, hue, etc.) in a printed or written text in order to distinguish some passage of a text from its surroundings.Although the way in which a spoken text is performed, (for example, the voice quality, loudness, etc.) might be regarded as analogous to highlighting in this sense, these Guidelines recommend distinct elements for the encoding of such highlighting in spoken texts. See further section . The purpose of highlighting is generally to draw the reader's attention to some feature or characteristic of the passage highlighted; this section describes the elements recommended by these Guidelines for the encoding of such textual features.

In conventionally printed modern texts, highlighting is often employed to identify words or phrases which are regarded as being one or more of the following: distinct in some way --- as foreign, dialectal, archaic, technical, etc. emphatic, and which would for example be stressed when spoken not part of the body of the text, for example cross references, titles, headings, labels, etc. identified with a distinct narrative stream, for example an internal monologue or commentary. attributed by the narrator to some other agency, either within the text or outside it: for example, direct speech or quotation. set apart from the text in some other way: for example, proverbial phrases, words mentioned but not used, names of persons and places in older texts, editorial corrections or additions, etc.

The textual functions signalled by highlighting may not be rendered consistently in different parts of a text or in different texts. (For example, a foreign word may appear in italics if the surrounding text is in roman, but in roman if the surrounding text is in italics.) For this reason, these Guidelines distinguish between the encoding of rendering itself and the encoding of the underlying feature expressed by it.

Highlighting as such may be encoded by using the global rend attribute which can be specified for any element in the TEI scheme. This allows the encoder both to specify the function of a highlighted phrase or word, by selecting the appropriate element described here or elsewhere in the Guidelines, and to further describe the way in which it is highlighted, by means of the rend attribute. If the encoder wishes to offer no interpretation of the feature underlying the use of highlighting in the source text, then the hi element may be used, which indicates only that the text so tagged was highlighted in some way.

The possible values carried by the rend attribute are not formally defined in this version of the Guidelines. Since the rend attribute may be used to document any peculiarity of the way a given segment of text was rendered in the original source text, it may need to express a very large range of typographic features, by no means restricted to type face, type size, etc.

Where it is both appropriate and feasible, these Guidelines recommend that the textual feature marked by the highlighting should be encoded, rather than just the simple fact of the highlighting. This is for the following reasons: the same kind of highlighting may be used for different purposes in different contexts the same textual function may be highlighted in different ways in different contexts for analytic purposes, it is in general more useful to know the intended function of a highlighted phrase than simply that it is distinct.

In many, if not most, cases the underlying function of a highlighted phrase will be obvious and non-controversial, since the distinctions indicated by a change of highlighting correspond with distinctions discussed elsewhere in these Guidelines. It should be recognized, however, that cases do exist in which is it not economically feasible to mark the underlying function of highlighting (e.g. in the preparation of large text corpora), as well as cases in which it is not intellectually appropriate (as in the transcription of some older materials, or in the preparation of material for the study of typographic practice). In such cases, the hi element should be used, as further discussed below.

Elements which are sometimes realized by typographic distinction but which are not discussed in this section include title (discussed in section ) and name (discussed in section ). Emphasis, Foreign Words, and Unusual Language

This subsection discusses the following elements: identifies a word or phrase as belonging to some language other than that of the surrounding text. Attributes include: identifies the language of the word or phrase marked. marks words or phrases which are stressed or emphasized for linguistic or rhetorical effect. marks a word or phrase as graphically distinct from the surrounding text, for reasons concerning which no claim is made. Attributes include: describes the rendition or presentation of the word or phrase highlighted. identifies any word or phrase which is regarded as linguistically distinct, for example as archaic, technical, dialectal, non-preferred, etc., or as forming part of a sublanguage. Attributes include: specifies the sublanguage or register to which the word or phrase is being assigned specifies how the phrase is distinct diachronically specifies how the phrase is distinct diatopically specifies how the phrase is distinct diastatically Foreign Words or Expressions

Words or phrases which are not in the main language of the text should be tagged as such, at least where the fact is indicated in the text. Where the word or phrase concerned is already distinguished from the rest of the text by virtue of its function (for example, because it is a name, a technical term, a quotation, a mentioned word, etc.) then the global lang attribute should be used to specify additionally that its language distinguishes it from the surrounding text. Any element in the TEI scheme may take a lang attribute, which specifies both the writing system and the language used by its content (see section for discussion of this attribute). Where there is no other applicable element, the tag foreign may be used to provide a peg onto which the lang may be attached. Aren't you confusing post hoc with propter hoc? said the Bee Master. Wax-moth only succeed when weak bees let them in. ]]>

The foreign tag should not be used to encode foreign words which are mentioned or glossed within the text: for these use the appropriate element from section below. Compare the following example sentences: croissant every morning. ]]> Croissant is difficult to pronounce with your mouth full. ]]> croissant is a crescent-shaped piece of light, buttery, pastry that is usually eaten for breakfast, especially in France. ]]>

The foreign element is formally defined as follows: ]]> Emphatic Words and Phrases

The emph element is provided to mark words or phrases which are linguistically emphatic or stressed. Text which is only typographically emphasized falls into the class of highlighted text, and may be tagged with the hi element. In printed works, emphasis is generally indicated by devices such as the use of an italic font, a large typeface or extra wide letter spacing; in manuscripts and typescripts, it is usually indicated by the use of underlining. As the following examples demonstrate, an encoder may choose whether or not to make explicit the particular type of rendition associated with the emphasis, by use of the rend attribute. If a source text consistently renders a particular feature (e.g. emphasis or words in foreign languages) in a particular way, the rendering associated with that feature may be described in the TEI header and the rend attribute used only to describe examples which deviate from the norm. Sex, sir, is purely a question of appetite! Tarr exclaimed. ]]> What it all comes to is this, he said. What does Christopher Robin do in the morning nowadays? ]]> Here Thou, great Anna! whom three Realms obey, Doth sometimes Counsel take — and sometimes Tea. ]]>

The hi element is used to mark words or phrases which are highlighted in some way, but for which identification of the intended distinction is difficult, controversial or impossible. It enables an encoder simply to record the fact of highlighting, possibly describing it by the use of a rend attribute, as discussed above, without however taking a position as to the function of the highlighting. This may also be useful if the text is to be processed in two stages: representing simply typographic distinctions during a first pass, and then replacing the hi tags with more specific tags in a second pass.

Some simple examples: And this Indenture further witnesseth that the said Walter Shandy, merchant, in consideration of the said intended marriage ... ]]> In this example, the first highlighted phrase uses black letter or gothic print to mimic the appearance of a legal document, and italic to mark Walter Shandy as a name. In a second pass, the elements head or label might be appropriate for the first use, and the element name for the second. came down handsomely, and Scrooge never did. ]]> In this example, the phrase came down uses inverted commas to indicate a play on words.The Oxford English Dictionary documents the phrase to come down in the sense to bring or put down; esp. to lay down money; to make a disbursement as being in use, mostly in colloquial or humorous contexts, from at least 1700 to the latter half of the 19th century. In a second pass, the element soCalled might be preferred.

The emph and hi elements are formally defined as follows: ]]> Other Linguistically Distinct Material

For some kinds of analysis, it may be desirable to encode the linguistic distinctiveness of words and phrases with more delicacy than is allowed by the foreign element. The distinct element is provided for this purpose. Its attributes allow for additional information characterizing the nature of the linguistic distinction to be made in two distinct ways: the type attribute simply assigns a user-defined code of some kind to the word or phrase which assigns it to some register, sub-language, etc. No recommendations as to the set of values for this attribute are provided at this time, as little consensus exists in the field.

Alternatively, the remaining three attributes may be used in combination to place a word or phrase on a three-dimensional scale sometimes used in descriptive linguistics.See, for example, Sociolinguistics/Soziolinguistik (An international handbook of the science of language and society. Ein internationales Handbuch zur Wissenschaft von Sprache und Gesellschaft) (Berlin, New York: De Gruyter, 1988), I, pp. 271 and 274. The time attribute places a word diachronically, for example as archaic, old-fashioned, contemporary, futuristic, etc.; the space attribute places a word diatopically, that is, with respect to a geographical classification, for example as national, regional, international, etc.; the social attribute places a word diastatically, that is, with respect to a social classification, for example as technical, polite, impolite, restricted, etc. Again, no recommendations are made for the values of these attributes at this time; the encoder should provide a description of the scheme used in the appropriate section of the header (see section ).

Examples: fag of Macrea's, that there was trouble in their midst which King would fain keep secret. ]]> fag of Macrea's, that there was trouble in their midst which King would fain keep secret. ]]> Where more complex (or more rigorous) interpretive analyses of the associations of a word are required, the more detailed and general mechanisms described in chapter should be preferred to these simple characterizations. It may also be preferable to record the kinds of analysis suggested here by means of the simple annotation element note described in section , or the span element described in section .

The distinct element has the following formal definition: ]]> Quotation

This section discusses the following elements, all of which are often rendered by the use of quotation marks: contains a quotation or apparent quotation --- a representation of speech or thought marked as being quoted from someone else (whether in fact quoted or not); in narrative, the words are usually those of of a character or speaker; in dictionaries, q may be used to mark real or contrived examples of usage. Attributes include: identifies the speaker of a piece of direct speech. may be used to indicate whether the quoted matter is spoken or thought, or to characterize it more finely. Sample values include: representation of direct speech, usually marked by quotation marks. representation of thought, e.g. internal monologue. may be used to indicate whether the quoted matter is regarded as direct or indirect speech. Sample values include: speech or thought is represented directly. speech or thought is represented indirectly, e.g. by use of a marked verbal aspect. no claim is made. contains a phrase or passage attributed by the narrator or author to some agency external to the text. A quotation from some other document, together with a bibliographic reference to its source. contains a word or phrase for which the author or narrator indicates a disclaiming of responsibility, for example by the use of scare quotes or italics.

One form of presentational variation found particularly frequently in written and printed texts is the use of quotation marks. As with the typographic variations discussed in the preceding section, it is generally helpful to separate the encoding of the underlying textual feature (for example, a quotation or a piece of direct speech) from the encoding of its rendering (for example, the use of a particular style of quotation marks).

The most common and important use of quotation marks is, of course, to mark quotation, by which we mean simply any part of the text attributed by the author or narrator to some agency other than the narrative voice. Typical examples include passages cited from other works, for which the element quote may be used, and words or phrases attributed to other voices within the current work, for which the element q may be used. If this distinction between intra-textual and inter-textual voices cannot be made reliably, or is not of interest, then all quoted matter may simply be marked using the q tag. The editorial policy in this respect should be stated in the encoding description of the TEI Header. The soCalled element is used for cases where the author or narrator distances him or herself from the words in question without however attributing them to any other voice in particular.

Quotation may be rendered by changes in type face, by special punctuation marks (single or double or angled quotes, dashes, etc.) and by layout (indented paragraphs, etc.). If these characteristics are of interest, an appropriate value for the rend attribute should be given, to record how the q or quote element is rendered. For discussion of suggested values for this attribute, see below.

Quotation marks themselves may, like other punctuation marks, be felt for some purposes to be worth retaining within a text, quite independently of their description by the rend attribute. Where this is done, an appropriate entity reference should be chosen from the standard entity sets listed in chapter ; this has the advantage that the entity may be redefined as null when the punctuation is to be ignored for some analytic purpose. Well-known ambiguities, such as whether the character ' represents an apostrophe or a closing single quotation mark, or whether the character " represents an opening or closing double quotation mark may all be resolved by the use of appropriate entity references, as discussed in section .

Alternatively, the encoder may suppress all quotation marks, possibly recording their form using the rend attribute. Where this is done, the following list of entity names (taken from the public entity sets ISOpub and ISOnum) may be found useful to describe quotation-mark styles common in European and American typesetting: These may be used in the rend attribute to show how the quotation was opened and closed. For example, if the words pre and post are used to indicate preceding and following punctuation, then the following example would describe a conventional American book printed using single quotation marks: Who-e debel you? &mdash he at last said &mdash you no speak-e, damme, I kill-e. And so saying, the lighted tomahawk began flourishing about me in the dark. ]]> The following example demonstrates alternative policies which may be adopted with respect to encoding of the punctuation used to mark quotation: &mdash Alors, Albert, quoi de neuf? &mdash Pas grand-chose. &mdash Il fait beau, dit Robert. ]]> Alors, Albert, quoi de neuf ? Pas grand-chose. Il fait beau, dit Robert. ]]> To make explicit who is speaking, which is not always stated in the above example, the who attribute should be used: &mdash Alors, Albert, quoi de neuf? &mdash Pas grand-chose. &mdash Il fait beau, dit Robert. ]]> The who attribute is also useful as a means of supplying a normalized form of the speaker's name, to facilitate selection of text by particular speakers. As indicated above, it may be supplied whether or not an indication of the speaker is given explicitly in the text.

Where investigation of narrative voice is the primary object of the encoding, it may be convenient to identify each speaker as a participant in the work, and to associate individual speeches with them by means of SGML's ID/IDREF mechanism. See section for discussion of the participant description component of the TEI Header.

For such analyses, it may also be useful to distinguish representations of speech from representations of thought, in modern printed texts often indicated by a change of typeface. The type attribute should be used for this purpose, as in this example: Oh yes, said Henry, I mean Gordon Macrae, for example... Jungian Analyst with Winebox! That's what you called him, you callous bastard, didn't you? Eh? Eh? ]]>

Quoted matter may be embedded within quoted matter, as when one speaker reports the speech of another: Spaulding, he came down into the office just this day eight weeks with this very paper in his hand, and he says:—I wish to the Lord, Mr. Wilson, that I was a red-headed man. ]]>

Direct speech nested in this way is treated in the same way as elsewhere: a change of rendition may occur, but the same element should be used. An encoder may however choose to distinguish between direct speech which contains quotations from extra-textual matter and direct speech itself, as in the following example: The Lord! The Lord! It is Sakya Muni himself, the lama half sobbed; and under his breath began the wonderful Buddhist invocation:- To Him the Way -- the Law -- Apart -- Whom Maya held beneath her heart Ananda's Lord -- the Bodhisat And He is here! The Most Excellent Law is here also. My pilgrimage is well begun. And what work! What work! ]]>

Quotations from other works are often accompanied by a reference to their source. The cit element may be used to group together the quotation and its associated bibliographic reference, which should be encoded using the elements for bibliographic references discussed in section , as in the following example. Chapter 1 Since I can do no good because a woman Reach constantly at something that is near it. The Maid's Tragedy Beaumont and Fletcher

Miss Brooke had that kind of beauty which seems to be thrown into relief by poor dress... ]]> Like other bibliographic references, the citation attached to a quotation may be represented simply by a pointer, as in this example: You shall know a word by the company it keeps. (Firth, 1957) ]]> Unlike most of the other elements discussed in this chapter, direct speech and quotations may frequently contain other high-level elements such as paragraphs or verse lines, as well as being themselves contained by such elements. Three possible solutions exist for this well-known structural problem: the quotation is broken into segments, each of which is entirely contained within a paragraph the quotation is marked up as part of a concurrent but independent hierarchy the quotation boundaries are represented by empty milestone tags For further discussion, and several examples, see chapter .

Finally, in this section, the element soCalled is provided for all cases in which quotation marks are used to distance the quoted text from the narrator or speaker. Common examples include the scare quotes often found in newspaper headlines and advertising copy, where the effect is to cast doubts on the veracity of an assertion: PM dodges election threat in interview ]]>

The same element should be used to mark a variety of special ironic usages. Some further examples follow: good books. Croissants indeed! toast not good enough for you? ]]> social justification. It was commonly assumed in works on logic until fairly recently that the notion language is necessarily restricted to finite strings. ]]>

The elements discussed in this section are formally defined as follows: ]]> Terms, Glosses, and Cited Words

This section describes the following textual elements, all of which have in common that they may be variously realized using italics, quotation marks or other devices: contains a single-word, multi-word or symbolic designation which is regarded as a technical term. identifies a phrase or word used to provide a gloss or definition for some other word or phrase. marks words or phrases mentioned, not used.

Technical terms are often italicized or emboldened upon first mention in printed texts; an explanation or gloss is sometimes given in quotation marks. Linguistic analyses conventionally cite words in languages under discussion in italics, providing a gloss immediately following marked with single quotation marks. Other texts in which individual words or phrases are mentioned (for example, as examples) rather than used may mark them either with italics or with quotation marks, and will gloss them less regularly.

A term may appear with or without a gloss, as may a mentioned element. Where the gloss is present, it may be linked to the term it is glossing by means of SGML's ID/IDREF mechanism. To establish such a link, the encoder should give an id value to the term or mentioned element and provide that id as the value of the target attribute on the gloss element. The following examples demonstrate this facility: for more discussion of this and other kinds of linkage within TEI documents, see chapter .

Examples: discoursal point of view as the relationship, expressed through discourse structure, between the implied author or some other addresser, and the fiction. ]]> A computational device that infers structure from grammatical strings of words is known as a parser, and much of the history of NLP over the last 20 years has been occupied with the design of parsers. ]]> eluthemen we were released, accented on the second syllable of the word, and its participial derivative lutheis released, accented on the last. ]]>

The elements discussed in this section have the following formal definitions: ]]> Some Further Examples

As a simple example of the elements discussed here, consider the following sentence: On the one hand the Nibelungenlied is associated with the new rise of romance of twelfth-century France, the romans d'antiquité, the romances of Chrétien de Troyes, and the German adaptations of these works by Heinrich van Veldeke, Hartmann von Aue, and Wolfram von Eschenbach. A first approximation to the encoding of this sentence, might be simply to record the fact that the phrases printed above in italics are highlighted, as follows: Nibelungenlied is associated with the new rise of romance of twelfth-century France, the romans d'antiquité, the romances of Chrétien de Troyes, ... ]]> This encoding would however lose the important distinction between an italicized title and an italicized foreign phrase. Many other phrases might also be italicized in the text, and a retrieval program seeking to identify foreign terms (for example) would not be able to produce reliable results by simply looking for italicized words. Where economic and intellectual constraints permit, therefore, it would be preferable to encode both the function of the highlighted phrases and their appearance, as follows: Nibelungenlied is associated with the new rise of romance of twelfth-century France, the romans d'antiquité, the romances of Chrétien de Troyes, ... ]]>

In this example, the decision as to which textual features are distinguished by the highlighting is relatively uncontroversial. As a less straightforward example, consider the use of italic font in the following passage from Samuel Richardson's Clarissa (1747). A pretty common case, I believe; in all vehement debatings. She says I am too witty; Anglicé, too pert; I, that she is too wise; that is to say, being likewise put into English, not so young as she has been: in short, she is grown so much into a mother, that she had forgotten she ever was a daughter. ...

Clearly, the word vehement is not italicized for the same reason as the phrase not so young as she has been; the former is emphasized, while the latter is proverbial. It also provides an ironic gloss for the words too wise, in the same way as too pert glosses too witty. The glossed phrases are not however technical terms or cited words, but quoted phrases, as if Clarissa were putting words into her own and her mother's mouths. Finally, the words mother and daughter are apparently italicized simply to oppose them in the sentence; certainly they do not fit into any of the categories so far proposed as reasons for italicizing. Note also that the word Anglicé is not italicized although it is not generally considered an English word.

The following sample encoding for the above passage attempts to take into account all the above points: vehement debatings. She says I am too witty; Anglicè, too pert; I, that she is too wise; that is to say, being likewise put into English, not so young as she has been: in short, she is grown so much into a mother, that she had forgotten she ever was a daughter. ]]> Names, Numbers, Dates, Abbreviations, and Addresses

This section describes a number of textual features which it is often convenient to distinguish from their surrounding text. Names, dates and numbers are likely to be of particular importance to the scholar treating a text as source for a database; distinguishing such items from the surrounding text is however equally important to the scholar primarily interested in lexis.

The treatment of these textual features proposed here is not intended to be exhaustive: fuller treatments for names, numbers, measures and dates are provided in the additional tag set for names and dates (see chapter ). Referring Strings

A referring string is a phrase which refers to some person, place, object etc. Two elements are provided to mark such strings: contains a general purpose name or referring string. Attributes include: indicates more specifically the object referred to by the referencing string. Values might include person, place, ship, element etc. contains a proper noun or noun phrase. Attributes include: indicates the type of the object which is being named by the phrase. Where it is thought useful to do so, the kind of object referred to may be specified using the type attribute.

Examples include: My dear Mr. Bennet, said his lady to him one day, have you heard that Netherfield Park is let at last? ]]> Watering Committee. They were paid a commission not exceeding four per cent, and gave bond. ]]> Circumlocution Office never, on any account whatsoever, to give a straightforward answer, Mr Barnacle said, Possibly. ]]>

As the following example shows, the rs element may be used for any reference to a person, place, etc., not only to references in the form of a proper noun or noun phrase. My dear Mr. Bennet, said his lady to him one day... ]]>

The name element by contrast is provided for the special case of referencing strings which consist only of proper nouns; it may be used synonymously with the rs element, or nested within it if a referring string contains a mixture of common and proper nouns. The following example shows an alternative way of encoding the short sentence from Pride and Prejudice quoted above: My dear Mr. Bennet, said his lady to him one day, have you heard that Netherfield Park is let at last? ]]> The following example shows how a proper name may be nested within a referring string: His Excellency the Life President, Ngwazi Dr H. Kamuzu Banda ]]>

Simply tagging something as a name is generally not enough to enable automatic processing of personal names into the canonical forms usually required for reference purposes. The name as it appears in the text may be inconsistently spelled, partial, or vague. Moreover, name prefixes such as van or de la, may or may not be included as part of the reference form of a name, depending on the language and country of origin of the bearer.

The following attributes, common to all members of the names element class, are provided to help overcome these difficulties: provides an alternative identifier for the object being named, such as a database record key. gives a normalized or regularized form of the name used.

Either or both of these attributes may be specified, as appropriate. The key attribute may be useful as a means of gathering together all references to the same individual or location scattered throughout a document: My dear Mr. Bennet, said his lady to him one day, have you heard that Netherfield Park is let at last? ]]>

This use should be distinguished from the case of the reg (regularization) attribute, which provides a means of marking the standard form of a referencing string as demonstrated below: Col. Polk has but poorly compensated me for the suspended enjoyments and pursuits of private and professional spheres ]]> Mme. de Volanges marie sa fille: c'est encore un secret; mais elle m'en a fait part hier. ]]> Walter de la Mare was born at Charlton, in Kent, in 1873. ]]> Montaillou is not a large parish. At the time of the events which led to Fournier's investigations, the local population consisted of between 200 and 250 inhabitants. ]]>

This method is adequate for many simple applications. For more complex applications, such as onomastics, or wherever a detailed analysis of the component parts of a name is needed, the specialized elements described in chapter or the analytical tools described in chapter should be used.

These elements are formally declared as follows: ]]> Addresses

The simplest way of encoding an address is to regard it as a series of distinct lines, just as they might be printed on an envelope. The following elements support this view: contains a postal or other address, for example of a publisher, an organization, or an individual. contains one line of a postal or other address.

Alternatively, an address may be encoded as a structure composed of the following elements, which constitute the addrPart element class: a full street address including any name or number identifying a building as well as the name of the street or route on which it is located. contains a proper noun or noun phrase. Attributes include: indicates the type of the object which is being named by the phrase. contains a numerical or alphanumeric code used as part of a postal address to simplify sorting or delivery of mail. contains a number or other identifier for some postal delivery point other than a street address. Any number of addrPart elements may appear within an address and in any order. None of them is required. Where code letters are commonly used in addresses (for example, to identify regions or countries) a useful practice is to supply the full name of the region or country as the content of the element, but to supply the abbreviatory code as the value of the global n attribute, so that (for example) an application preparing formatted labels can readily find the required information. Other components of addresses should be represented using the general-purpose name element.

Some examples follow: 110 Southmoor Road, Oxford, OX2 6RB, UK ]]>

The above address could also be represented as follows : 110 Southmoor Road Oxford OX2 6RB United Kingdom ]]>

The order of elements within an address is highly culture-specific, and is therefore unconstrained: Università di Bologna Italy40126 Bologna via Marsala 24 ]]>

For further discussion of ways of regularizing the names of places, see section . A full postal address may also include the name of the addressee, tagged as above using the general purpose name element. When the additional tag set for names and dates is enabled, more specific elements such as publisher or org may be used, as further discussed in chapter .

The address element and its components are formally described as follows: ]]> Numbers and Measures

This section describes two elements provided for the simple encoding of numbers and measures and gives some indication of circumstances in which this may usefully be done. The following phrase level elements are provided for this purpose: contains a number, written in any form. Attributes include: indicates the type of numeric value. Suggested values include: absolute number, e.g. 21, 21.5 ordinal number, e.g. 21st fraction, e.g. one half or three halves e.g. ten percent supplies the value of the number in an application-dependent standard form. contains a word or phrase referring to some quantity of an object or commodity, usually comprising a number, a unit and a commodity name. Attributes include: specifies the type of unit in which the measure is expressed. Sample values include: measure of weight e.g. kg, pound. unit of count, e.g. dozen, score. measure of length, e.g. pole, mm. measure of area e.g. acre, hectare. measure of volume e.g. litre, gallon. unit of currency e.g. ecu, escudo, mark.

Like names or abbreviations, numbers can occur virtually anywhere in a text. Numbers are special in that they can be written with either letters or digits (twenty-one, xxi, and 21) and their presentation is language-dependent (e.g. English 5th becomes Greek 5.; English 123,456.78 equals French 123.456,78).

For many kinds of application, e.g. natural-language processing or machine translation, numbers are not regarded as lexical in the same way as other parts of a text. For these and other applications, the num element provides a convenient method of distinguishing numbers from the surrounding text. For other kinds of application, numbers are only useful if normalized: here the num element is useful precisely because it provides a standardized way of representing a numerical value.

For example: xxxiii twenty-one ten percent 10% 5th ]]> one half 1/2 ]]>

The word measure is used here to refer to a special kind of referring string, the referent of which is a virtual object. In its fullest form, a measure consists of a number, a phrase expressing units of measure and a phrase expressing the commodity being measured. Not all of these components need be present in every case. For some applications, particularly quantitative ones, the internal components of measure need to be marked so that their values can be calculated. Thus, in order to evaluate a monetary measure according to some standard, it is necessary to mark its currency unit (e.g. US dollars, pounds sterling). Similarly, the expression 2 ounces will have a different meaning when it is associated with flour from that which it has when associated with water.

Such applications will require the elements discussed in chapter , or the more powerful analytical tools discussed in chapter . Elsewhere, it may be sufficient simply to encode measures as such, perhaps also indicating their numeric content with the num element, as in the following examples: I've measured it from side to side 'Tis three feet long, and two feet wide. ]]> As the above example also demonstrates, the measure element is a member of the class names like other referencing strings, and may thus bear a reg attribute to indicate a normalized value. It may also carry a key attribute to indicate a database key value as in the following example: ii bags hops six trusses Woolen and linen goods 5 tonnes coale ]]>

These elements are formally defined as follows: ]]> Dates and times

Dates and times, like numbers, can appear in widely varying culture- and language-dependent forms, and can pose similar problems in automatic language processing. The following elements are provided to identify them: contains a date in any format. Attributes include: indicates the system or calendar to which the date belongs. gives the value of the date in some standard form, usually yyyy-mm-dd. contains a phrase defining a time of day in any format. Attributes include: gives the value of the time in a standard form. contains two dates or another phrase delimiting a time period. Attributes include: indicates the system or calendar to which the date belongs. indicates the starting point of the period in standard form. indicates the ending point of the period in standard form. indicates the precision to be attached to either or both dates specified. Sample values include: the to date is exact the from date is exact both dates are exact both dates are approximate or unspecified contains two times or another phrase indicating a time period. Attributes include: indicates the starting point of the time period in standard form. indicates the ending point of the time period in standard form. indicates the precision to be attached to either or both times specified. Sample values include: the to time is exact the from time is exact both times are exact both times are approximate or unspecified

Dates can occur virtually anywhere in a text, but in some contexts (e.g. bibliographic citations) their encoding is recommended or required rather than optional. Times can also appear anywhere but are generally optional.

Partial dates or times (e.g. 1990, September 1990, twelvish) can be expressed in the value attribute by simply omitting a part of the value supplied. Imprecise dates or times (for example early August, some time after ten and before twelve) may be expressed as date or time ranges. If either end of the date or time range is known to be accurate (for example, at some time before 1230, a few days after Hallowe'en), the exact attribute may be used to specify this.

Where the certainty (i.e. reliability) of the date or time itself is in question, rather than its precision, the encoder should record this fact using the mechanisms discussed in chapter .

These mechanisms are useful primarily for fully specified dates or times known with certainty. If component parts of dates or times are to be marked up, or if a more complex analysis of the meaning of a temporal expression is required, the techniques described in chapter should be used in preference to the simple method outlined here.

Examples: 21 Feb 1980 ]]> Twelfth Day of June in the Year of Our Lord One Thousand Nine Hundred and Seventy-seven of the Republic the Two Hundredth and first and of the University the Eighty-Sixth. ]]> 1990 September 1990 ]]> 1918 to 1923 &mdash had been, he suspected, somehow very important. ]]> the second half of the thirteenth century, and Hervarar saga dates from around 1300. ]]>

These elements are formally defined as follows: ]]> Abbreviations and Their Expansions

It is sometimes desirable to mark abbreviations in the copy text, whether to trigger special processing for them, to provide the full form of the word or phrase abbreviated, or to allow for different possible expansions of the abbreviation. Abbreviations may be transcribed as they stand, or expanded; they may be left unmarked, or marked using these tags: contains an abbreviation of any sort. Attributes include: gives an expansion of the abbreviation. signifies the editor or transcriber responsible for supplying the expansion of the abbreviation held as the value of the expan attribute. allows the encoder to classify the abbreviation according to some convenient typology. Sample values include: the abbreviation provides the first letter(s) of the word or phrase, omitting the remainder. the abbreviation omits some letter(s) in the middle. the abbreviation comprises a special symbol or mark. the abbreviation includes writing above the line. the abbreviation comprises the initial letters of the words of a phrase. the abbreviation is for a title of address (Dr, Ms, Mr, ...) the abbreviation is for the name of an organization. the abbreviation is for a geographic name. signifies the degree of certainty ascribed to the expansion of the abbreviation. contains the expansion of an abbreviation. Attributes include: gives the abbreviation in its unexpanded form. signifies the editor or transcriber responsible for supplying the expansion of the abbreviation held as the content of the expan element. allows the encoder to classify the abbreviation according to some convenient typology. signifies the degree of certainty ascribed to the expansion of the abbreviation.

The abbr element is useful as a means of distinguishing semi-lexical items such as acronyms or jargon: CC is defined by that calibration of values which motivates the elements of its GSP; ... ]]> 3GL or 4GL languages is currently nailing on OOP extensions. ]]>

The type attribute may be used to distinguish types of abbreviation by their function, and the expan attribute may be used to supply an expansion: Dr. M. Deegan is the Director of the CTI Centre for Textual Studies. ]]>

Abbreviations such as Dr M above may be treated as two abbreviations, as above, or as one: Dr. M. Deegan is the Director of the CTI Centre for Textual Studies. ]]>

This element is particularly useful where manuscript materials in which abbreviation is very frequent are being transcribed. For example: Ex&per;ience, thogh noon auctoritee Were in this world, is right ynogh for me To speke of wo that is in mariage; ]]>

Here an entity reference per has been used to represent the common manuscript symbol crossed-p, and its expansion supplied in the associated abbr tag. The same lines might be transcribed, expanded, as follows: Experience, thogh noon auctoritee Were in this world, is right ynogh for me To speke of wo that is in mariage; ]]>

In practice, it may be most convenient to transcribe the abbreviation as an entity reference; this allows the entity reference itself to be expanded either as an abbr or as an expan element, depending on the processing to be done at the moment. (For further discussion of such documentation, see section .) The text shown here: Ex&per;ience, thogh noon auctoritee Were in this world, is right ynogh for me To speke of wo that is in mariage; ]]> may be expanded as desired by providing the appropriate choice between the two entity declarations: &p.crossed;" > per" > ]]> For further discussion of manuscript abbreviations, see chapter .

These elements are formally defined as follows: ]]> Simple Editorial Changes

As in editing a printed text, so in encoding a text in electronic form, it may be necessary to accommodate editorial comment on the text and to render account of any changes made to the text in preparing it. The tags described in this section may be used to record such editorial interventions, whether made by the encoder, by the editor of a printed edition used as a copy text, by earlier editors, or by the copyists of manuscripts.

The tags described here handle most common types of editorial intervention and stereotyped comment; where less structured commentary of other types is to be included, it should be marked using the note element described in section . Systematic interpretive annotation is also possible using the various methods described in chapter . The examples given here illustrate only simple cases of editorial intervention; in particular, they permit economical encoding of two alternative readings of a text only. To encode more than two views of any one segment of text, the mechanisms described in chapters and must be used.

The first two pairs of elements here discussed (sic and corr, reg and orig) may both be used to record simultaneously a text in its original, uncorrected and unaltered form and also in an edited form. In this way they resemble the pair abbr and expan, described in section . Such paired elements enable software to move automatically from one view of the text to the other.

Three categories of editorial intervention are discussed in this section: correction (or non-correction) of apparent errors regularization (or non-regularization) of variant, irregular, non-standard, or eccentric forms editorial additions, suppressions, and omissions

A more extended treatment of the use of these tags in transcriptional and editorial work is given in chapter . Correction of Apparent Errors

When the copy text is manifestly faulty, an encoder or transcriber may elect simply to correct it without comment. For scholarly purposes, it will often be more generally useful to record both the correction and the original state of the text. The elements described here enable this to be done is such a way as not to distract the reader. contains text reproduced although apparently incorrect or inaccurate. Attributes include: gives a correction for the apparent error in the copy text. signifies the editor or transcriber responsible for suggesting the correction held as the value of the corr attribute. signifies the degree of certainty ascribed to the correction held as the value of the corr attribute. contains the correct form of a passage apparently erroneous in the copy text. Attributes include: gives the original form of the apparent error in the copy text. signifies the editor or transcriber responsible for suggesting the correction held as the content of the corr element. signifies the degree of certainty ascribed to the correction held as the content of the corr element.

The following examples show alternative treatment of the same material. The copy text reads: Another property of computer-assisted historical research is that data modelling must permit any one textual feature or part of a textual feature to be a part of more than one information model and to allow the researcher to draw on several such models simultaneously, for example, to select from a machine-readable text those marginal comments which indicate that the date's mentioned in the main body of the text are incorrect.

An encoder may choose to correct the typographic error, either silently or with an indication that a correction has been made, as follows: dates mentioned in the main body of the text are incorrect. ]]>

Alternatively, the encoder may simply record the typographic error without correcting it, either without comment or with a sic element to indicate the error is not a transcription error in the encoding: date's mentioned in the main body of the text are incorrect. ]]>

If the encoder elects both to record the original source text and to provide a correction for the sake of word-search and other programs, either sic or corr may be used with the appropriate attribute: date's mentioned in the main body of the text are incorrect. ]]> dates mentioned in the main body of the text are incorrect. ]]> If both readings are given, the choice between sic and corr is largely a question of individual preference; since both record the same information, either may be mechanically transformed into the other. If the original reading contains SGML tags, it will prove more convenient to use sic than corr (and vice versa if there are tags within the corrected reading), since SGML tags are not recognized in attribute values. If both readings contain subordinate tags, then recourse must be had to the methods described in chapter .

The cert attribute on the sic and corr elements permits a statement of the degree of editorial confidence in a particular correction. For example, using a confidence scale of one to ten, an editor may indicate the conjectural status of a correction by assigning a value to this attribute of less than ten. In the following instance, some uncertainty is expressed concerning a commonly-accepted emendation: Autumn it was, That grew the more by reaping ]]> See further the discussion in section .

Where the correction takes the form of adding text, the encoder must choose whether to use the corr (or sic) tag, the add tag (see section below), or the more detailed facilities provided by the additional tag set for primary source description. The following discussion may be helpful when making this decision: where the correction is an addition by a scribe or author in a manuscript or other primary source (typescript, proof or galley, etc.) then either corr (or sic) or add might be appropriate, depending on the circumstances. The add tag is more expressive, and may convey information on just how the addition was performed (hand, place, etc.) which the corr tag cannot. See further the discussion in section . where the correction is an addition by a transcriber or editor, correcting a perceived deficiency in the text but in circumstances where there is no clearly assertable reason for the deficiency (as a manuscript lacuna, or damage to the page) the corr tag should be used. The add tag should not be used in this case. where the correction is an addition by a transcriber or editor, correcting a perceived deficiency in the text and where there is a clearly assertable reason for the deficiency (as a manuscript lacuna, or damage to the page) which the encoder wishes to record, or when supplying text from a parallel version of the text, the supplied element provided by the additional tag set for primary source description should be used (see section ).

The formal definition of these elements is as follows: ]]> Regularization and Normalization

When the source text makes extensive use of variant forms or non-standard spellings, it may be desirable for a number of reasons to regularize it: that is, to provide standard or regularized forms equivalent to the non-standard forms.In some contexts, the term regularization has a narrower and more specific significance than that proposed here: the reg element may be used for any kind of regularization, including normalization, standardization, and modernization.

As with other such changes to the copy text, the changes may be made silently (in which case the TEI header should specify the types of silent changes made) or may be explicitly marked using the following elements: contains a reading which has been regularized or normalized in some sense. Attributes include: gives the unregularized form of the text as found in the source copy. identifies the individual responsible for the regularization of the word or phrase. contains the original form of a reading, for which a regularized form is given in an attribute value. Attributes include: gives a regularized (normalized) form of the text. identifies the individual responsible for the regularization of the word or phrase.

Typical applications for these elements include the production of editions intended for student or lay readers, linguistic research in which spelling or usage variation is not the main question at issue, production of spelling dictionaries, etc.

Consider this 16th-century text: how godly a dede it is to overthrowe so wicked a race the world may judge: for my part I thinke there canot be a greater sacryfice to God.

An encoder may choose to preserve the original spelling of this text, but simply flag it as nonstandard by using the orig element with no attributes specified, as follows: dede it is to overthrowe so wicked a race the world may judge: for my part I thinke there canot be a greater sacryfice to God. ]]>

Alternatively, the encoder may simply indicate that certain words have been modernized by using the reg element with no attributes specified, as follows: deed it is to overthrow so wicked a race the world may judge: for my part I think there cannot be a greater sacrifice to God. ]]>

More usefully, the encoder may elect to record both old and new spellings, so that (for example) the same electronic text may serve as the basis of an old- or new-spelling edition: deed it is to overthrow so wicked a race the world may judge: for my part I think there cannot be a greater sacrifice to God. ]]>

Or the orig tag might be preferred dede it is to overthrowe so wicked a race the world may judge: for my part I thinke there canot be a greater sacryfice to God. ]]>

The resp attribute should be used to specify the agency responsible for the regularization. This may be an identifiable individual, for example an editor, or a descriptive phrase such as copyist. For example, in the first stanza of the Old Norse poem Grógaldr, the manuscript form dura is usually regularized in modern editions to dyra doors. The manuscript's vek ek þik dauðra dura might thus be recorded together with its regularization in two ways, as follows: dyra ]]> or: dura ]]>

These elements are formally defined as follows: ]]> Additions, Deletions and Omissions

The following elements are used to indicate when words or phrases have been omitted from, added to, or marked for deletion from, a text. Like the other editorial elements, they allow for a wide range of editorial practices: indicates a point where material has been omitted in a transcription, whether for editorial reasons described in the TEI header, as part of sampling practice, or because the material is illegible or inaudible. Attributes include: gives a description of the omitted text. gives the reason for omission. Sample values include sampling, illegible, inaudible, irrelevant, canceled, canceled and illegible. indicates approximately how much text has been omitted from the transcription, in letters, minims, inches, or any appropriate unit, either because of editorial policy or because a deletion, damage or other cause has rendered transcription impossible. indicates the editor, transcriber or encoder responsible for the decision not to provide any transcription of the text and hence the application of the gap tag. contains a word, phrase, or passage which cannot be transcribed with certainty because it is illegible or inaudible in the source. Attributes include: indicates why the material is hard to transcribe. indicates the individual responsible for the transcription of the letter, word or passage contained with the unclear element. contains a letter, word or passage deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator or corrector. Attributes include: classifies the type of deletion using any convenient typology. may be used to indicate faulty deletions, e.g. strikeouts which include too much or too little text. signifies the editor or transcriber responsible for identifying the hand of the deletion. signifies the hand of the agent which made the deletion. signifies the degree of certainty ascribed to the identification of the hand of the deletion.

Encoders may choose to omit parts of the copy text for reasons ranging from illegibility of the source or impossibility of transcribing it, to editorial policy, e.g. a systematic exclusion of poetry or prose from an encoding. The full details of the policy decisions concerned should be documented in the TEI Header (see section ). Each place in the text at which omission has taken place should be marked with a gap element, with optionally further information about the reason for the omission, its extent and the person or agency responsible for it, as in the following examples: ]]> That is, there were two starts on the easterly side and one to the west; ... ]]> ]]> ]]>

The add and del elements may be used to record where words or phrases have been added or deleted in the copy text. They are not appropriate where longer passages have been added or deleted, which span several SGML elements; for these, the elements addSpan and delSpan, or other mechanisms described in section must be used.

Additions to a text may be recorded for a number of reasons. Sometimes they are marked in a distinctive way in the source text, for example by brackets or insertion above the line (supralinear insertion), as in the following example, taken from a 19th century manuscript: of these facts from which this tale takes its title. ]]>

The add element should not be used to mark editorial changes, such as supplying a word omitted by mistake from the source text or a passage present in another version. In these cases, either the corr or supplied tags should be used, as discussed above in section , and in section , respectively.

The unclear element is used to mark passages in the original which cannot be read with confidence, or about which the transcriber is uncertain for other reasons, as for example when transcribing a partially inaudible or illegible source. Its reason and resp attributes are used, as with the gap element, to indicate the cause of uncertainty and the person responsible for the conjectured reading.

For example: And where the sandy mountain Fenwick scald The sea between yet hence his pray'r prevail'd ]]> or from a spoken text: marbled queen ]]> Where the material affected is entirely illegible or inaudible, the gap element discussed above should be used in preference.

The del element is used to mark material which is deleted in the source but which can still be read with some degree of confidence, as opposed to material which has been omitted by the encoder or transcriber either because it is entirely illegible or for some other reason. This is of particular importance in transcribing manuscript material, though deletion is also found in printed texts, sometimes for humorous purposes: One day I will sojourn to your shores I live in the middle of England But! Norway! My soul resides in your watery fiords fyords fiiords Inlets. ]]>

The type attribute may be used to distinguish different methods of deletion in manuscript or typescript material, as in this line from the typescript of Eliot's Waste Land: Mein Frisch schwebt weht der Wind ]]>

Deletion in manuscript or typescript is often associated with addition: Inviolable Inexplicable splendour of Corinthian white and gold ]]>

The del element should not be used where the deletion is such that material cannot be read with confidence, or read at all, or where the material has been omitted by the transcriber or editor for some other reason. Where the material cannot be read with confidence following deletion, the unclear tag should be used with the reason attribute indicated that the difficulty of transcription is due to deletion. Where material has been omitted by the transcriber or editor, this may be indicated by use of the corr (or sic) and gap elements. Observe that the distinction between recommended uses of the del, corr and gap tags parallels the distinction drawn between the add, corr and supplied tags in section and section : where the correction is a deletion by a scribe or author in a manuscript or other primary source (typescript, proof or galley, etc.) then either corr (or sic) or del might be appropriate, depending on the circumstances. The del tag is more expressive, and may convey information on just how the deletion was performed (hand, place, etc.) which the corr tag cannot. See further the discussion in section . where the correction is a deletion by a transcriber or editor, correcting a perceived superfluity in the text but in circumstances where there is no clearly assertable reason for the superfluity (as a spurious addition) the corr tag should be used. The del tag should not be used in this case. where the correction is a deletion by a transcriber or editor, correcting a perceived superfluity in the text where there is a clearly assertable reason for the superfluity (as a spurious addition) the gap tag should be used with the reason attribute carrying the reason for the superfluity and hence the deletion of text. Neither the del nor corr tag should be used in these cases.

For any detailed transcription of a manuscript or typescript with more than trivial amounts of alteration, the reader should consult chapter , and chapter .

These elements are formally defined as follows: ]]> Simple Links and Cross References

Cross-references or links between one location in a document and another, or between one location and several others, may be encoded using the elements ptr and ref, as discussed in this section. These elements both point from one location in a document, the place that the element itself appears, to another (or to several), specified by the target attribute. Linkages of several other kinds are also provided for in these guidelines; see further chapter .

The pointing facility of these elements depends on the ability to supply a unique identifier for any element in the TEI scheme, using the global id attribute. Where the object or objects of a cross-reference are not identifiable in this way, either because they are located in a distinct SGML document or because no id attribute is available, the elements xptr or xref may be used instead.See chapter , for a discussion of these elements and the extended syntax they provide for hypertext links. Alternatively, if no explicit link is to be encoded, but it is simply required to mark the phrase as a cross-reference, the ref element may be used without a target attribute. defines a pointer to another location in the current document in terms of one or more identifiable elements. Attributes include: specifies the destination of the pointer as one or more SGML identifiers defines a reference to another location in the current document, in terms of one or more identifiable elements, possibly modified by additional text or comment. Attributes include: specifies the destination of the reference as one or more SGML identifiers

The elements ptr and ref share, as members of the element class pointer, the following attributes: categorizes the pointer in some respect, using any convenient set of categories. specifies the creator of the pointer. specifies when the pointer was created. specifies the kinds of elements to which this pointer may point. where more than one identifier is supplied as the value of the target attribute, this attribute specifies whether the order in which they are supplied is significant. Legal values are: Yes: the order in which IDREFs are specified as the value of a target attribute should be followed when combining the targeted elements. No: the order in which IDREFs are specified as the value of a target attribute has no significance when combining the targeted elements. Unspecified: the order in which IDREFs are specified as the value of a target attribute may or may not be significant. specifies the intended meaning when the target of a pointer is itself a pointer. Sample values include: if the element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer. if the element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer. no further evaluation of targets is carried out beyond that needed to find the element specified in the pointer's target.

The shared attributes of the two elements may be used in the same way; the difference between the elements is that while the ptr element is empty, the ref element may contain phrases specifying, or defining more exactly, the target of a cross reference, which form the content of the element. Since its content thus serves as a human-readable pointer, in the simplest case a ref element need not identify its target in any other way. For example: section 12 on page 34. ]]>

More usually, it will be desirable to identify the target of the cross-reference using the target attribute, so that processing software can access it directly, for example to implement a linkage or to generate an appropriate reference. Assuming that section 12 in the previous example has been tagged div1 id=SEC12, the same cross reference might more exactly be encoded as section 12 on page 34. ]]>

If the text for the cross reference is to be generated according to a fixed pattern, or if no text is to appear in the body of the cross reference, the ptr element would be used as follows: . ]]>

A cross-reference may point to any number of locations simultaneously, simply by giving more than one identifier as the value of its target attribute. This may be particularly useful where an analytic index is to be encoded, as in the following example: Saints aid rejected in mel. Sallets censured Sanguine mel. signs Scilla or sea onyon, a purger of mel. ... ]]> Here the targets of the cross references are simply page numbers; it is assumed that corresponding elements with identifiers p299 p143, etc. have been provided in the body of the text. If it is desired to check that the target elements are of a particular type, the targType (target type) attribute may be specified: Saints aid rejected in mel Sallets censured ... ]]> Here, a processing application can check that the elements with identifiers p299, p143, and p144 are all pb (page-break) elements. It is a semantic error in a text if the targets given do not match the values specified on a targType attribute.

The type and resp attributes may be used, as elsewhere, to categorize the cross reference according to any system of importance to the encoder and to supply a code identifying the person or agency responsible for the cross reference. If bibliographic references require special processing (e.g. in order to provide a consistent short-form reference), they might be tagged thus: rewriting systems, have a long history among mathematicians, but the specific form of was first studied extensively by Chomsky . ]]> Here type=bibliog signals for the processing appropriate to a bibliographic reference, while targType='bibl bibl.struct bibl.full' restricts the legal targets to bibliographic elements, and target=Chom59 indicates which bibliographic element actually is being referred to. For further discussion of bibliographic references, see section .

If the order in which the objects of a multi-headed cross reference are specified is of importance, the targOrder (target order) attribute should be specified. The following discussions of this topic should be consulted for further information: ]]>

The ptr and ref tags have many applications in addition to the simple cross-referencing facilities illustrated in this section. In conjunction with the analytic tools discussed in chapters , , and , they may be used to link analyses of a text to their object, to combine corresponding segments of a text, or to align segments of a text with a temporal or other axis or with each other.

These elements are formally defined as follows: ]]> Lists

The following elements are provided for the encoding of lists, their constituent items, and the labels or headings associated with them: contains any sequence of items organized as a list. Attributes include: describes the form of the list. Suggested values include: list items are numbered or lettered. list items are marked with a bullet or other typographic device. list items are not numbered or bulleted. each list item glosses some term or concept, which is given by a label element preceding the list item. contains one component of a list. Attributes include: indicates the number (or letter, or other enumerator) borne by this list item in the copy text. contains the label associated with an item in a list; in glossaries, marks the term being defined. contains any heading, for example, the title of a section, or the heading of a list or glossary. contains the heading for the label or term column in a glossary list or similar structured list. contains the heading for the item or gloss column in a glossary list or similar structured list.

The list element should be used to mark any kind of list: numbered, lettered, bulleted, or unmarked. Lists formatted as such in the copy text should in general be encoded using this element, with an appropriate value for the type attribute. Lists given as run-on text may also be encoded using this element, where this is felt to be appropriate.

Each distinct item in the list should be encoded as a distinct item element. If the numbering or other identification for the items in a list is unremarkable and may be reconstructed by any processing program, no enumerator need be specified. If however an enumerator is retained in the encoded text, it may be supplied either by using the n attribute on the item element, or by using a label element. The following examples are thus equivalent: My first rough manuscript, without any intermediate copy, has been sent to the press. Not a sheet has been seen by any human eyes, excepting those of the author and the printer: the faults and the merits are exclusively my own. ]]> The two styles may not be mixed in the same list: if one item is preceded by a label, all must be.

A list need not necessarily be displayed in list format. For example, those that belong to the Emperor, embalmed ones, those that are trained, suckling pigs, mermaids, fabulous ones, stray dogs, those that are included in this classification, those that tremble as if they were mad, innumerable ones, those drawn with a very fine camel's-hair brush, others, those that have just broken a flower vase, those that resemble flies from a distance. ]]>

A list may be given a heading or title, for which the head element should be used, as in the next example, which also demonstrates simple use of the label element to mark a tabular or glossary list in which each item is associated with a word or phrase rather than a numeric or alphabetic enumerator: Report of the conduct and progress of Ernest Pontifex. Upper Vth form &mdash half term ending Midsummer 1851

In such a list, the individual items have internal structure. In complex cases, where list items contain many components, the list is better treated as a table, on which see chapter . A particularly important instance of the simple two-column table is the glossary list, which should be marked by the tag list type=gloss. In such lists, each label element contains a term and each item its gloss; it is a semantic error for a list tagged with type=gloss not to have labels. For example: Unit Three -- Vocabulary Additionally, the term and gloss elements discussed in section might be used to make explicit the role that each column in the glossary list has, as follows: Unit Three -- Vocabulary Note in the above examples the use of the global lang attribute to specify on the label (or term) element what language the term is from. For further discussion of the lang attribute see section , and section . A more elaborate markup for this glossary would distinguish the headword forms from the grammatical information (principal parts and gender), using tags described more fully in chapters or .

In addition to the head element used to supply a title or heading for the whole list, headings for the two columns of a glossary-style list may be specified using the two special elements headLabel and headItem: TRITE SIMPLE, STRAIGHTFORWARD

The elements label, head, headLabel, and headItem may contain only phrase-level elements. The item element however may contain paragraphs or other chunks, including other lists. In this example, a glossary list contains two items, each of which is itself a simple list: I am cast upon a horrible desolate island, void of all hope of recovery. I am singled out and separated as it were from all the world to be miserable. I am divided from mankind &mdash a solitaire; one banished from human society. But I am alive; and not drowned, as all my ship's company were. But I am singled out, too, from all the ship's crew, to be spared from death... But I am not starved, and perishing on a barren place, affording no sustenances.... ]]>

Lists of different types may be nested to arbitrary depths in this way.

The formal declarations for lists and list items are as follows. ]]> Notes, Annotation, and Indexing Notes and Simple Annotation

The following elements are provided for the encoding of discursive notes, either already present in the copy text or supplied by the encoder: contains a note or annotation. Attributes include: indicates the symbol or number used to mark the note's point of attachment to the main text. describes the type of note. indicates who is responsible for the annotation: author, editor, translator, etc. Sample values include: note originated with the author of the text. note added by the editor of the text. note added by the compiler of a collection. note added by the translator of a text. note added by the transcriber of a text into electronic form. note added by the individual indicated by the initials. indicates where the note appears in the source text. Sample values include: note appears at foot of page. note appears at end of chapter or volume. note appears as a marked paragraph in the body of the text. note appears in left margin. note appears in right margin. note appears between lines of the text. note appears in the apparatus at the foot of the page. indicates whether the copy text shows the exact place of reference for the note. Legal values are: copy text indicates the place of attachment for the note. copy text indicates no place of attachment for the note. indicates the point of attachment of a note, or the beginning of the span to which the note is attached. points to the end of the span to which the note is attached, if the note is not embedded in the text at that point.

A note is any additional comment found in a text, marked in some way as being out of the main textual stream. All notes should be marked using the same tag, note, whether they appear as block notes in the main text area, at the foot of the page, at the end of the chapter or volume, in the margin, or in some other place.

Notes may be in a different hand or typeface, may be authorial or editorial, and may have been added later. Attributes may be used to specify these and other characteristics of notes, as detailed below.

Where possible, the body of a note should be inserted in the text at the point at which its identifier or mark first appears. This may not be possible for example with marginal notes, which may not be anchored to an exact location. For simplicity, it may be adequate to position marginal notes before the relevant paragraph or other element. In some cases, however, it may be desirable to transcribe notes not at their point of attachment to the text but at their point of appearance (at the end of the volume, or the end of the chapter --- not, in general, when the notes appear at the foot of the page); in this case the target and targetEnd attributes should be used to specify the point of attachment. In some cases, the note is explicitly attached not to a point but to a span of text; for a full discussion of pointing to points and spans in the text, see section .

Examples: The self-same moment I could pray And from my neck so free The albatross fell off, and sank Like lead into the sea. The spell begins to break ]]> We explain below why we use the uncommon term collection instead of the expected set. Our usage corresponds to the aggregate of many mathematical writings and to the sense of class found in older logical writings. The elements ... ]]>

In addition to transcribing notes from the copy text, researchers may wish to annotate the electronic text itself, by attaching analytic notes in some structured vocabulary to particular passages of text, e.g. to specify the topics or themes of a text. The empty span element is provided for such applications; it is available only when the additional tag set for simple analysis is selected (see section ).

The formal declarations for the note element is this: ]]> Index Entries

Machine-readable versions of existing texts rarely reproduce any index published with the copy text. Should a printed index be transcribed, the div1 tag or a div tag at an appropriate level should be used to demarcate the index, and the index itself may be transcribed as a structured list or table.

It is convenient, however, to be able to generate a new index from a machine-readable text, whether the text is being written for the first time with the tags here defined or was transcribed from some other source. The index tag is provided for this purpose; it may be useful for marking points of particular interest for whatever reason, and not merely for generating printed indexes for a printed version of the text. The divGen element indicates the point at which an index, or any other generated text (e.g. a table of contents), is to appear in the output of a text production process. marks a location to be indexed for whatever purpose. Attributes include: gives the form under which the index entry is to be made. gives the second-level form, if any. gives the third-level form, if any. gives the fourth-level form, if any. indicates which index (of several) the index entry belongs to. indicates the location at which a textual division generated automatically by a text-processing application is to appear. Attributes include: specifies what type of generated text division (e.g. index, table of contents, etc.) is to appear. Sample values include: an index is to be generated and inserted at this point. a table of contents a list of figures a list of tables

The tag index associates up to four levels of index terms with a specific point in the text. The index terms are supplied in attributes named level1, level2, level3, and level4. An index attribute associates the entry with a particular index, so multiple indices are possible.

All index terms must be supplied as attribute values; no part of the text itself is taken as a term. This may require words or phrases to be repeated, as illustrated below; it also allows spelling to be normalized, as the example shows: and are beginning to build parsers. ]]>

The divGen element marks the place at which an index generated from the index elements should be inserted into the output of a processing program; typically, this will be at some point within the back matter of the document; its type attribute should be used to specify which index is to be generated, and its n attribute to specify a name for the index:

Examples

...

Bibliography ...
]]>

The formal declaration for these elements is as follows. ]]> Reference Systems

By reference system we mean the system by which names or references are associated with particular passages of a text (e.g. Ps. 23:3 for the third verse of Psalm 23 or Amores 2.10.7 for Ovid's Amores, book 2, poem 10, line 7). Such names make it possible to mark a place within a text and enable other readers to find it again. A reference system may be based on structural units (chapters, paragraphs, sentences; stanza and verse), typographic units (page and line numbers), or divisions created specifically for reference purposes (chapter and verse in Biblical texts). Where one exists, the traditional reference system for a text should be preserved in an electronic transcript of it, if only to make it easier to compare electronic and non-electronic versions of the text.

Reference systems may be recorded in TEI-encoded texts in any of the following ways: where a reference system exists, and is based on the same logical structure as that of the text's SGML markup, the reference for a passage may be recorded as the value of the global id or n attribute on an appropriate tag, or may be constructed by combining attribute values from several levels of tags, as described below in section . where there is no pre-existing reference system, the global id or n attributes may be used to construct one (e.g. collections and corpora created in electronic form), as described below in section . where a reference system exists which is not based on the same logical structure as that of the text's SGML markup, (for example, one based on the page and line numbers of particular editions of the text rather than on the structural divisions of it), then a distinct logical structure representing the reference system may be encoded as a concurrent markup stream, as described in section . where a reference system exists which does not correspond to any particular logical structure, or where the logical structure concerned is of no interest to the encoder except as a means of supporting the referencing system, then references may be encoded by means of milestone elements, which simply mark points in the text at which values in the reference system change, as described below in section . The specific method used to record traditional or new reference systems for a text should be declared in the TEI header, as further described in section and in chapter .

When a text has no pre-existing associated reference system of any kind, these Guidelines recommend as a minimum that at least the page boundaries of the source text be marked using one of the methods outlined in this section. Retaining page breaks in the markup is also recommended for texts which have a detailed reference system of their own. Line breaks in prose texts may be, but need not be, tagged. Many encoders find it convenient to retain the line breaks of the original during data entry, to simplify proof-reading, but this may be done without inserting a tag for each line break of the original. Using the ID and N Attributes

When traditional reference schemes represent a hierarchical structuring of the text which mirrors that of the SGML document, the n attribute defined for all elements may be used to indicate the traditional identifier of the relevant structural units. The n attribute may also be used to record the numbering of sections or list items in the copy text if the copy-text numbering is important for some reason, for example because the numbers are out of sequence.

For example, a traditional reference to Ovid's Amores might be Amores 2.10.7---book 2, poem 10, line 7. Book, poem, and line are structural units of the work and will therefore be tagged in any case. (See chapter for a discussion of structural units in verse collections.) In such cases, it is convenient to record traditional reference numbers of the structural units using the n attribute. The relevant tags for our example would be: ... ... ... ... ]]>

One may also place the entire standard reference for each portion of the text into the appropriate value for the n attribute, though for obvious reasons this takes more space in the file: ... ... ... ... ]]>

If the names used by the traditional reference system can be formulated as SGML identifiers, then the references can be given as values for the id attribute; this requires that the reference be given without internal spaces, begin with a letter, and contain no characters other than letters, digits, hyphens, and full stops. The legal form of identifiers depends in part on the SGML declaration. With appropriate modifications in the declaration, other characters may be made legal in identifiers; this is allowed though not encouraged in TEI-conformant documents. Unlike values for the n attribute, values for the id attribute must be unique throughout the document. Our example then looks like this: ... ... ... ... ]]>

To document the usage and to allow automatic processing of these standard references, it is recommended that the TEI header be used to declare whether standard references are recorded in the n or id attributes and which elements may carry standard references or portions of them. For examples of declarations for the reference systems just shown, see section .

Using the n attribute one can specify only a single standard referencing system, a limitation not without problems, since some editions may define structural units differently and thus create alternative reference systems. For example, another edition of the Amores considers poem 10 a continuation of poem 9, and therefore would specify the same line as Amores 2.9.31. In order to record both of these reference systems, one must either use the id or n attribute for one, with competing systems in concurrent markup hierarchies, as discussed below in section , or else use the milestone tags described in section . Creating New Reference Systems

If a text has no canonical reference system of its own, a reference system, if needed, may be derived from the structure of the electronic text, specifically from the SGML markup of the text. As with any reference system intended for long-term use, it is important to see the reference as an established, unchanging point in the text. Should the text be revised or rearranged, the reference-system identifiers associated with any bit of text must stay with that bit of text, even if it means the reference numbers fall out of sequence. (A new reference system may always be created beside the old one if out-of-sequence numbers must be avoided.)

The global attributes n and id may be used to assign reference identifiers to segments of the text. Identifiers specified by either attribute apply to the entire element for which they are given. SGML enforces uniqueness on ID attributes within a single document, and ID values must begin with a letter. No such restrictions are made on the values of n attributes.

A convenient method of mechanically generating unique values for id or n attributes based on the SGML structure of the document is to construct, for each element, a domain-style address comprising a series of components separated by full stops, with one component for each level of the SGML document hierarchy. Two methods may be use. In the typed path form of identifier, each component in the identifier takes the form element-type - number. The element name specifies what type of element to be sought, and the number specifies which occurrence of that element type is to be selected. (The hyphen and number may be omitted if there is only one element of the given type.) In the untyped path form of identifier, each component consists of a number, indicating which element in the sequence of nodes at each level is to be selected. A fixed prefix beginning with a letter may be used to make the untyped path legal as an SGML ID value.

Identifiers generated with these methods should use the text segment as their starting point, rather than the tei.2 or body elements, since the tei.2 element need be taken as a starting point only if identifiers need to be generated for the teiHeader, which is not usually the case, and using the body element as a root would prevent assignment of identifiers for the front and back matter. The component corresponding to the root element can be omitted from identifiers, if no confusion will result. In collections and corpora, the component corresponding to the root may be replaced by the unique identifier assigned to the text or sample.

In the following example, each element within the text element has been given a typed-path identifier as its id value, and an untyped-path identifier as its n value; the latter are prefixed with the string AB, which may be imagined to be the general identifier for this text. ...

...
...
...

...

...

...

...

...

...

...

...

]]> The typed and untyped path methods are convenient, but are in no way required for anyone creating a reference system.

If the id attribute is used to record the reference identifiers generated, each value should record the entire path. If the n attribute is used, each value may record either the entire path or only the subpath from the SGML parent element. The attribute used, the elements which can bear standard reference identifiers, and the method for constructing standard reference identifiers, should all be declared in the header as described in section .

When the hierarchy of the SGML-encoded document and that of the reference system differ (e.g. for reference systems based on page and line numbers) or when more than one reference system is to be encoded, the encoder may choose to represent the alternative reference system(s) as elements in one or more concurrent document hierarchies. For an introduction to the concept of concurrent hierarchies, see the discussion of the CONCUR feature in section . For further discussion of this and other mechanisms, see chapter . Milestone Tags

If concurrent markup is not desired (e.g. because the available SGML parser does not support the CONCUR feature), or if the desired reference system does not correspond to any particular structural hierarchy, it may be more convenient to mark up changes in the reference system by using one or more of the following milestone elements: marks the boundary between sections of a text, as indicated by changes in a standard reference system. Attributes include: indicates which edition or version the milestone applies to. indicates the new number or other value for the unit which changes at this milestone. indicates what kind of section is changing at this milestone. Suggested values include: page breaks in the reference edition. column breaks. line breaks. any units termed book, liber, etc. individual poems in a collection. cantos or other major sections of a poem. stanzas within a poem, book, or canto. acts within a play. scenes within a play or act. sections of any kind. passages not present in the reference edition. marks the boundary between one page of a text and the next in a standard reference system. Attributes include: indicates the edition or version in which the page break is located at this point indicates the number or other value associated with the page which follows the point of insertion of this pb. marks the start of a new (typographic) line in some edition or version of a text. Attributes include: indicates the edition or version in which the line break is located at this point indicates the number or other value associated with the line which follows the point of insertion of this lb. marks the boundary between one column of a text and the next in a standard reference system. Attributes include: indicates the edition or version in which the column break is located at this point indicates the number or other value associated with the column which follows the point of insertion of this cb element.

These elements simply mark the points in a text at which some category in a reference system changes. They have no content but subdivide the text into regions, rather in the same way as milestones divide a road into segments. The elements pb, cb, and lb are provided to mark specific types of milestone, namely page, column, and line boundaries, as further described in chapter . No SGML validation of a reference system based on milestone tags is possible, so it will be the responsibility of the encoder or the application software to ensure that milestone tags occur in a correct order.

Milestone tags may be useful where a text has two competing structures. For example, many English novels were first published as serial works, individual parts of which do not always contain a whole number of chapters. An encoder may decide to represent the chapter-based structure using div1 elements, with milestone elements to mark the points at which individual parts end; or the reverse. Thus, an encoding in which chapters are regarded as more important than parts might encode some work in which chapter three begins in part one and is concluded in part two as follows: . ]]> An encoding of the same work in which parts are regarded as more important than chapters might begin as follows: . ]]>

Milestone tags also make it possible to record the reference systems used in a number of different editions of the same work. The reference system of any one edition can be recreated from a text in which all are marked by simply ignoring all elements that do not specify that edition on their ed attribute.

As a simple example, assuming that edition E1 of some collection of poems regards the first two poems as constituting the first book, while edition E2 regards the first poem as prefatory, a markup scheme like the following might be adopted: ]]>

In this case no n value is specified, since the numbers rise predictably and the application can keep a count from the start of the document, if desired.

The value of the n attribute may but need not include the identifiers used for any larger sections. That is, either of the following styles is legitimate: ... ... ... ]]> or ... ... ... ]]>

When using milestone tags, line numbers may be supplied for every line or only periodically (every fifth, every tenth line). The latter may be simpler; the former is more reliable.

The style of numbering used in the values of n is unrestricted: for the example above, I.i, I.ii, and I.iii could have been used equally well if preferred. The special value unnumbered should be reserved for marking sections of text which fall outside the normal numbering system (e.g. chapter heads, poem numbers, titles, or speaker attributions in a verse drama).

Because the ed attribute is unrestricted, no change need be made to the document type declaration of a file before adding tags to describe a new reference system. (The value of ed may be restricted to a defined set of edition symbols by using the techniques described in chapter .)

See below, section , for examples of declarations for the reference systems just shown.

The milestone elements are formally defined as follows: ]]> Declaring Reference Systems

Whatever kind of reference system is used in an electronic text, it is recommended that the TEI header contain a description of its construction in the refsDecl element described in section . As described there, the declaration may consist either of a formal declaration using the step tag or an informal description in prose. The former is recommended because unlike prose it can be processed by software.

The three examples given in section would be declared as follows. The first example encodes the standard references for Ovid's Amores one level at a time, using the n attribute on the div0, div1, div2, and l tags. The header for such an encoding should look something like this: ... ... ... ]]>

The second example encodes the same reference system, again using the n attribute on the div0, div1, div2, and l tags, but giving the reference string in full on each tag. If canonical references are made only to lines, the reference system could be declared as follows: ]]> Since no delimiter is specified, the entire canonical reference string is sought as the value of the n attribute on an l element.

In order to handle references to works, books, and poems as well as to individual lines, the declaration for the reference system must be more complicated: ]]> This declaration indicates that the entire reference string must be sought as the value of the n attribute on a div0, div1, div2, or l element.

The third example encodes the same reference system, this time giving the entire reference string as the value of the id attribute on the relevant tags. The reference system declaration for such an encoding would be: ]]>

As in the previous example, no single value can be given for the refunit attribute in this declaration, as the single step handles references to works, books, and poems, as well as to lines. The type attribute on the div0, div1, and div2 elements may be used, however, to indicate the type of the result returned from a match.

Reference systems recorded by means of milestone tags can also be declared; the following prose description could be used to declare the example given in section .

Standard references to work, book, poem, and line may be constructed from the milestone tags in the text. ]]> Or in this way, using a formal declaration for this reference scheme derived from edition E1. ]]>

This is synonymous with the following declaration using the step element: ]]> Bibliographic Citations and References

Bibliographic references (that is, full descriptions of bibliographic items such as books, articles, films, broadcasts, songs, etc.) or pointers to them may appear at various places in a TEI text. They are required at several points within the TEI Header's source description, as discussed in section ; they may also appear within the body of a text, either singly, (for example within a footnote), or collected together in a list as a distinct part of a text.

In printed texts, the individual constituents of a bibliographic reference are conventionally marked off from each other and from the flow of text by such features as bracketing, italics, special punctuation conventions, underlining, etc. In electronic texts, such distinctions are also important, whether in order to produce acceptably formatted output or to facilitate intelligent retrieval processing,For example, to distinguish London as an author's name from London as a place of publication or as a component of a title. quite apart from the need to distinguish the reference itself as a textual object with particular linguistic properties.

It should be emphasized that for references as for other textual features, the primary or sole consideration is not how the text should be formatted when it is printed. The distinctions permitted by the scheme outlined here may not necessarily be all that particular formatters or bibliographic styles require, although they should prove adequate to the needs of many such commonly used software systems.Among the bibliographic software systems and subsystems consulted in the design of the biblStruct structure were BibTeX, Scribe, and ProCite. The distinctions made by all three may be preserved in biblStruct structures, though the nature of their design prevents a simple one-to-one mapping from their data elements to TEI elements. For further information, see section . The features distinguished and described below (in section ) constitute a set which has been useful for a wide range of bibliographic purposes and in many applications, and which moreover corresponds to a great extent with existing bibliographic and library cataloguing practice. For a fuller account of that practice as applied to electronic texts see section ; for a brief mention of related library standards see section . Elements of Bibliographic References

The following elements are used to mark individual bibliographic references as wholes, or in groups: contains a loosely-structured bibliographic citation of which the sub-components may or may not be explicitly tagged. contains a structured bibliographic citation, in which only bibliographic subelements appear and in a specified order. contains a fully-structured bibliographic citation, in which all components of the TEI file description are present. contains a list of bibliographic citations of any kind. These elements all share a number of possible component sub-elements. For the bibl and biblStruct elements, exactly the same sub-elements are concerned, and they are described together in section ; for the biblFull element, the sub-elements concerned are fully described in section .

Different levels of specific tagging may be appropriate in different situations. In some cases, it may be felt necessary to mark just the extent of the reference itself, with perhaps a few distinctions being made within it (for example, between the part of the reference which identifies a title or author and the rest). Such references, containing a mixture of text with specialized bibliographic elements, are regarded as bibl elements, and tagged accordingly. For example: A book which had a great influence on him was Tufte's Envisioning Information, although he may never have actually read it. ]]> Indeed, some encoders may find it unnecessary to mark the bibliographic reference at all: A book which had a great influence on him was Tufte's Envisioning Information, although he may never have actually read it. ]]>

Some bibliographic references are extremely elliptical, often only a string of the form Baxter, 1983. If no further details of Baxter's book are given in the source text and none are supplied by the encoder, then the reference thus given should be tagged as a bibl: Baxter, 1983. ]]> In general, however, normal modern bibliographic practice, and these Guidelines, distinguish between a bibliographic reference, which is a self-sufficient description of a bibliographic item, and a bibliographic pointer, which is a short-form citation (such as Baxter, 1983) which serves usually as a place-holder or pointer to a full long-form reference found elsewhere in the text. The usual encoding of short-form references such as Baxter, 1983 is not as bibl elements but as cross-references to such elements; see section below.

In cases where the encoder wishes to impose more structure on the bibliographic information, for example to make sure it conforms to a particular style-sheet or retrieval processor, the biblStruct element should be used. Note that several of the features in this and later examples are explained later in the current section. Edward R. Tufte Envisioning Information</> <imprint> <pubPlace>Cheshire, Conn.</> <publisher>Graphics Press</> <date>1990</> </imprint></monogr> </biblStruct> ]]> </eg> <p>The highest level of detail and the most complex structure supported by the current proposals is provided by the <gi>biblFull</gi> element, which closely resembles the <gi>fileDesc</gi> element of the TEI Header (section <ptr target=HD2>). <eg><![ CDATA[ <biblFull> <titleStmt> <title>Envisioning Information</> <author>Tufte, Edward R[olf]</> </titleStmt> <extent>126 pp.</> <publicationStmt> <creationDate>1990</> <publisher>Graphics Press</> <pubPlace>Cheshire, Conn. USA</> <date>1990</> </publicationStmt> </biblFull> ]]> </eg> <p>A list of bibliographic items, of whatever kind, may be treated in the same way as any other list (see section <ptr target=COli>). Alternatively, the specialized <gi>listBibl</gi> element may be used. The difference between the two is that a <gi>list</gi> contains <gi>item</gi> elements, within which bibliographic elements (<gi>bibl</gi>, <gi>biblStruct</gi> or <gi>biblFull</gi>) may appear, as well as other phrase- and paragraph-level elements, whereas the <gi>listBibl</gi> may contain only bibliographic elements, optionally preceded by a heading and a series of introductory paragraphs. The former would be appropriate for a list of bibliographic elements in which descriptive prose predominated, and the latter for a more formal bibliography. The following are thus both legal encodings of a list of bibliographic entries: a <gi>listBibl</gi>: <eg><![ CDATA[ <listBibl> <head>Bibliography</head> <biblStruct id=NEL80> <analytic> <author>Nelson, T. H.</> <title>Replacing the printed word: a complete literary system.</> </analytic> <monogr> <title>Information Processing '80: Proceedings of the IFIPS Congress, October 1980</> <editor>Simon H. Lavington</> <imprint> <publisher>North-Holland</> <pubPlace>Amsterdam</> <date>1980</> </imprint> <biblScope>pp 1013-23 </monogr> <note>Apparently a draft of section 4 of <title>Literary Machines. Ted Nelson: Literary Machines (privately published, 1987) Baxter, Glen Glen Baxter His Life: the years of struggle London: Thames and Hudson, 1988. ]]> or a simple list: Bibliography Nelson, T. H. Replacing the printed word: a complete literary system.</> <title level=m>Information Processing '80: Proceedings of the IFIPS Congress, October 1980</> <editor>Simon H. Lavington</> <publisher>North-Holland</> <pubPlace>Amsterdam</> <date>1980</> <biblScope>pp 1013-23 <note>Apparently a draft of section 4 of <title>Literary Machines. Ted Nelson: Literary Machines (privately published, 1987) Baxter, Glen Glen Baxter His Life: the years of struggle London: Thames and Hudson, 1988. ]]>

The formal declarations for these elements are as follows: ]]> Components of Bibliographic References

This section discusses a number of very commonly occurring component elements of bibliographic references. They fall into four groups: elements for grouping components of the analytic, monographic, and series levels in a structured bibliographic reference titles of various kinds, and statements of intellectual responsibility (authorship, etc.) information relating to the publication, pagination, etc. of an item annotation, commentary and further detail The following sections describe the elements which may be used to represent such information within a bibl or biblStruct element. Within the former, any or all of these may be used and in any order. Within the latter, such of these elements as exist for a given reference must be distinguished, and must also be presented in a specific order, discussed further below (section ). Analytic, Monographic, and Series Levels

In common library practice a clear distinction is made between an individual item within a larger collection and a free-standing book, journal, or collection. Similarly a book in a series is distinguished sharply from the series within which it appears. An article forming part of a collection which itself appears in a series thus has a bibliographic description with three quite distinct levels of information: the analytic level, giving the title, author, etc., of the article; the monographic level, giving the title, editor, etc., of the collection; the series level, giving the title of the series, possibly the names of its editors, etc., and the number of the volume within that series. In the same way, an article in a journal requires at least two levels of information: the analytic level describing the article itself, and the monographic level describing the journal.

These three levels may be distinguished within a bibl element, and must be distinguished within a biblStruct element if present, by means of the following tags: contains bibliographic elements describing an item (e.g. an article or poem) published within a monograph or journal and not as an independent publication. contains bibliographic elements describing an item (e.g. a book or journal) published as an independent item (i.e. as a separate physical object). contains information about the series in which a book or other bibliographic item has appeared.

For purposes of TEI encoding, journals and anthologies are both treated as monographs; a journal title will thus be tagged title level=j or monogrtitle ... /title ... /monogr. Individual articles in the journal or collected texts should be treated at the analytic level. When an article has been printed in more than one journal or collection, the bibliographic reference may have more than one monogr element, each possibly followed by one or more series elements. A series element always relates to the most recently preceding monogr element. (Whether reprints of an article are treated in the same bibliographic reference or a separate one varies among different styles. Library lists typically use a different entry for each publication, while academic footnoting practice typically treats all publications of the same article in a single entry.)

For example, the article cited in this example has been published twice, once in a journal and once in a collection which appeared in a series: Thaller, Manfred A Draft Proposal for a Standard for the Coding of Machine Readable Sources</> </analytic> <monogr> <!-- In --> <title level=j>Historical Social Research 40 October 1986 3-46 Modelling Historical Data: Towards a Standard for Encoding and Exchanging Machine-Readable Texts Daniel I. Greenstein St. Katharinen Max-Planck-Institut für Geschichte In Kommission bei Scripta Mercaturae Verlag 1991 Halbgraue Reihe zur Historischen Fachinformatik Herausgegeben von Manfred Thaller Max-Planck-Institut für Geschichte Serie A: Historische Quellenkunden</> <biblScope>Band 11</biblScope> </series> </biblStruct> ]]> </eg> <p>Punctuation may not appear between the elements within a structured bibliographic entry; if punctuation is to be given explicitly in the encoding, it must be contained within the elements it delimits. As the example shows, it is possible to encode the entry without any inter-element punctuation: this facilitates use of the <gi>biblStruct</gi> element in systems which can render bibliographic references in any of several styles. <p>The formal declarations for the elements defined in this section are as follows: <eg id=dcobilv> <![ CDATA [ <!-- 6.10.2.1: Tags for Bibliographic References (cont'd) --> <!-- (continuation of sec. 6.10.1) --> <!ELEMENT analytic - O (author | editor | respStmt | title)* > <!ATTLIST analytic %a.global; > <!ELEMENT monogr - O ( ( ((author | editor | respStmt)+, title+, (editor | respStmt)*) | (title+, (author | editor | respStmt)*))?, (note | meeting)*, (edition, (editor | respStmt)*)*, imprint, (imprint | extent | biblScope)* ) > <!ATTLIST monogr %a.global; > <!ELEMENT series - O (title | editor | respStmt | biblScope)* > <!ATTLIST series %a.global; > ]]> </eg> <div4 id=CObicor><head>Authors, Titles, and Editors</head> <p>Bibliographic references typically begin with a statement of the title being cited and the names of those intellectually responsible for it. For articles in journals or collections, such statements should appear both for the analytic and for the monographic level. The following elements are provided for tagging such elements: <list type=gloss> <label><gi>title</gi></label> <item>contains the title of a work, whether article, book, journal, or series, including any alternative titles or subtitles. Attributes include: <list type=gloss> <label><att>level</att></label> <item>indicates whether this is the title of an article, book, journal, series, or unpublished material. Legal values are: <list type=gloss> <label><term>a</term></label> <item>analytic title (article, poem, or other item published as part of a larger item)</item> <label><term>m</term></label> <item>monographic title (book, collection, or other item published as a distinct item, including single volumes of multi-volume works)</item> <label><term>j</term></label> <item>journal title</item> <label><term>s</term></label> <item>series title</item> <label><term>u</term></label> <item>title of unpublished material (including theses and dissertations unless published by a commercial press)</item> </list></item> <label><att>type</att></label> <item>classifies the title according to some convenient typology. Sample values include: <list type=gloss> <label><term>main</term></label> <item>main title</item> <label><term>subordinate</term></label> <item>subtitle, title of part</item> <label><term>parallel</term></label> <item>alternate title, often in another language, by which the work is also known</item> <label><term>abbreviated</term></label> <item>abbreviated form of title</item> </list></item> </list> </item> <label><gi>author</gi></label> <item>in a bibliographic reference, contains the name of the author(s), personal or corporate, of a work; the primary <term>statement of responsibility</term> for any bibliographic item. </item> <label><gi>editor</gi></label> <item>secondary <term>statement of responsibility</term> for a bibliographic item, for example the name of an individual, institution or organization, (or of several such) acting as editor, compiler, translator, etc. </item> <label><gi>respStmt</gi></label> <item>supplies a statement of responsibility for someone responsible for the intellectual content of a text, edition, recording, or series, where the specialized elements for authors, editors, etc. do not suffice or do not apply.</item> <label><gi>resp</gi></label> <item>contains a phrase describing the nature of a person's intellectual responsibility.</item> <label><gi>name</gi></label> <item>contains a proper noun or noun phrase.</item> <label><gi>meeting</gi></label> <item>in bibliographic references, contains a description of the meeting or conference from which the bibliographic item derives.</item> </list> <p>In bibliographic references, all titles should be tagged as such, whether analytic, monographic, or series titles. The single element <gi>title</gi> is used for all these cases. When it appears directly within an <gi>analytic</gi>, <gi>monogr</gi>, or <gi>series</gi> element, <gi>title</gi> is interpreted as belonging to the appropriate level. When it appears elsewhere, its <att>level</att> attribute should be used to signal its bibliographic level. It is a semantic error to give a value for the <att>level</att> attribute which is inconsistent with the context; such values may be ignored. The <att>level</att> value <code type=val>a</code> implies the analytic level; the values <code type=val>m</code>, <code type=val>j</code>, and <code type=val>u</code> imply the monographic level; the value <code type=val>s</code> implies the series level. Note, however, that the semantic error occurs only if the nested title is directly enclosed by the <gi>analytic</gi>, <gi>monogr</gi>, or <gi>series</gi> element; if it is enclosed only indirectly, no semantic error need be present. For example, the analytic title may contain a monographic title: <eg><![ CDATA [ <biblStruct> <analytic><author>Lucy Allen Paton</> <title>Notes on Manuscripts of the <title level=m>Prophécies de Merlin PMLA</> <imprint><biblscope type=vol>8</> <date>1913</date> <biblscope type=pages>122</> </imprint> </monogr> </biblStruct> ]]> </eg> In this case, the analytic title <q>Notes on Manuscripts of the <title>Prophécies de Merlin needs no level attribute because it is directly contained by the analytic level; the monographic title contained within it, Prophécies de Merlin, does not create a semantic error because it is not directly contained by the analytic element.

In some bibliographic applications, it may prove useful to distinguish main titles from subordinate titles, parallel titles, etc. The type attribute is provided to allow this distinction to be recorded.

The following reference, from a national standard for bibliographic references,American National Standard for Bibliographic References, ANSI Z39.29-1977 (New York: American National Standards Institute, 1977), p. 34 (sec. A.2.2.1). illustrates this type of analysis with its distinction between main and subordinate titles. Saarikoski, Pirkko-Liisa, and Paavo Suomalainen, Studies on the physiology of the hibernating hedgehog, 15 Effects of seasonal and temperature changes on the in vitro glycerol release from brown adipose tissue</> <title level=j>Ann. Acad. Sci. Fenn., Ser. A4</> <date>1972</> <biblScope type='vol: pp'>187: 1-4</> </bibl> ]]> </eg> <!-- example from ANSI Z39.29, sec. A.2.2.1, p.34 --> <p>Slightly more complex is the distinction made below among main, subordinate, and parallel titles, in an example from the same source (p. 63). The punctuation and the bibliographic analysis are those given in ANSI Z39.29-1977; the punctuation is in the style prescribed by the International Standard Bibliographic Description (ISBD).<note place=foot>The analysis is not wholly unproblematic: as the text of the standard points out, the first subordinate title is subordinate only to the parallel title in French, while the second is subordinate to both the English main title and the French parallel title, without this relationship being made clear, either in the markup given in the example or in the reference structure offered by the standard.</note> <eg><![ CDATA [ <bibl>Tchaikovsky, Peter Ilich. <title level=m type=main>The swan lake ballet</> = <title level=m type=parallel>Le lac des cygnes</> : <title level=m type=subordinate>grand ballet en 4 actes</> : <title level=m type=subordinate>op. 20</> [Score]. New York: Broude Brothers; [1951] (B.B. 59). vi, 685 p. </bibl> ]]> </eg> <!-- example from ANSI Z39.29, sec. A.12.2, p.63 --> <p>The elements <gi>author</gi> and <gi>editor</gi> have, for printed books and articles, a fairly obvious significance; for other kinds of bibliographic items their proper usage may be less obvious. The <gi>author</gi> element should be used for the person or agency with primary responsibility for a work's intellectual content, and the element <gi>editor</gi> for an editor of the work. Thus an organization such as a radio or television station is usually accounted <soCalled>author</socalled> of a broadcast, for example, while the author of a Government report will usually be the agency which produced it. <p>For anyone else with responsibility for the work, the <gi>respStmt</gi> element should be used. The nature of the responsibility is indicated by means of a <gi>resp</gi> element, and the person, organization etc. responsible by a <gi>name</gi> element. At least one of each of these must be given within the <gi>respStmt</gi> element, followed optionally by any number of either. Examples of secondary responsibility of this kind include the roles of illustrator, translator, editor, annotator. The <gi>respStmt</gi> element may also be used for editors, if it is desired to record the specific terms in which their role is described. <p>Examples of <gi>author</gi> and <gi>editor</gi> may be found in sections <ptr target=CObity>, and <ptr target=CObicol>; wherever <gi>author</gi> and <gi>editor</gi> may occur, the <gi>respStmt</gi> element may also occur. When one of these elements precedes or immediately follows a title, it applies to that title; when it follows an <gi>edition</gi> element or occurs within an edition statement, it applies to the edition in question. <p>In this example, the <gi>respStmt</gi> elements apply to the work as a whole, not merely to the first edition: <eg><![ CDATA [ <bibl> <author>Lominadze, D. G.</> <title level=m>Cyclotron waves in plasma. translated by A. N. Dellis; edited by S. M. Hamberger. 1st ed. Oxford: Pergamon Press, 1981. 206 p. International series in natural philosophy.</> <note place=inline>Translation of: <title level=m lang=RU>Ciklotronnye volny v plazme.</></> </bibl> ]]> </eg> <!-- from ISO 690: 1987, clause 4.1, p. 2. --> <p>In this example, by contrast, the <gi>respStmt</gi> element applies to the edition, and not to the collection per se (Moser and Tervooren were not responsible for the first thirty-five printings); the elements of the reference have been reordered from their appearance on the title page of the volume in order to ensure the correct relationship of the collection title, the edition statement, and the statement of responsibility. <eg><![ CDATA [ <biblStruct> <monogr> <title>Des Minnesangs Frühling Mit 1 Faksimile 36., neugestaltete und erweiterte Auflage Unter Benutzung der Ausgaben von Karl Lachmann und Moriz Haupt, Friedrich Vogt und Carl von Kraus bearbeitet von Hugo Moser Helmut Tervooren I Texte Stuttgart S. Hirzel Verlag 1977 ]]> With the exception of the name element (for which see section ), the elements described in this section are defined as follows: ]]> Imprint, Pagination, and Other Details

By imprint is meant all the information relating to the publication of a work: the person or organization by whose authority and in whose name a bibliographic entity such as a book is made public or distributed (whether a commercial publisher or some other organization), the place of publication, and a date. It may also include a full address for the publisher or organization. Full bibliographic references usually specify either the number of pages in a print publication (or equivalent information for non-print materials), or the specific location of the material being cited within its containing publication. The following elements are provided to hold this information: groups information relating to the publication or distribution of a bibliographic item. contains a postal or other address, for example of a publisher, an organization, or an individual. contains the name of the place where a bibliographic item was published. provides the name of the organization responsible for the publication or distribution of a bibliographic item. contains a date in any format. supplies any standard or non-standard number used to identify a bibliographic item. Attributes include: categorizes the number, for example as an ISBN or other standard series. describes the approximate size of the electronic text as stored on some carrier medium, specified in any convenient units. defines the scope of a bibliographic reference, for example as a list of pagenumbers, or a named subdivision of a larger work. Attributes include: identifies the type of information conveyed by the element, e.g. pages, volume. Suggested values include: the element contains a volume number. the element contains an issue number, or volume and issue numbers. the element contains a page number or page range. the element contains a chapter indication (number and/or title) the element identifies a part of a book or collection.

For bibliographic purposes, usually only the place (or places) of publication are required, possibly including the name of the country, rather than a full address; the element pubPlace is provided for this purpose. Where however the full postal address is likely to be of importance in identifying or locating the bibliographic item concerned, it may be supplied and tagged using the address element described in section . Alternatively, if desired, the rs or name elements described in section may be used; this involves no claim that the information given is either a full address or the name of a city.

The name of the publisher of an item should be marked using the publisher tag even if the item is made public (published) by an organization other than a conventional publisher, as is frequently the case with technical reports: Nicholas, Charles K. Welsch, Lawrence A. On the interchangeability of SGML and ODA</> <imprint> <pubPlace>Gaithersburg, MD</pubPlace> <publisher>National Institute of Standards and Technology</> <date value='1992-01'>January 1992</> </imprint> </monogr> <extent>19 pp.</> <idno type='NIST'>NISTIR 4681</> </biblStruct> ]]> </eg> and with dissertations: <eg><![ CDATA [ <biblStruct> <monogr> <author>Hansen, W.</> <title level=u>Creation of hierarchic text with a computer display</> <note place=inline>Ph.D. dissertation</> <imprint> <publisher>Dept. of Computer Science, Stanford Univ.</> <pubPlace>Stanford, CA</> <date value='1971-06'>June 1971</> </imprint> </monogr> </biblStruct> ]]> </eg> <!-- reference is from p. 304, bibliography, of Reps and --> <!-- Teitelbaum, The Synthesizer Generator: A system for --> <!-- constructing language-based editors. --> <p>When an item has been reprinted, especially reprinted without change from a specific earlier edition, the reprint may appear in a <gi>monogr</gi> element with only the <gi>imprint</gi> and other details of the reprint. In the following example, a microform reprint has been issued without any change in the title or authorship. The series statement here applies only to the second <gi>monogr</gi> element. <eg><![ CDATA [ <biblStruct> <monogr> <author>Shirley, James</> <title type=main>The gentlemen of Venice</> <title type=subordinate>a tragi-comedie presented at the private house in Salisbury Court by Her Majesties servants</> <note place=inline>[Microform]</> <imprint> <pubPlace>London</> <publisher>H. Moseley</> <date>1655</> </imprint> <extent>78 p.</> </monogr> <monogr> <imprint> <pubPlace>New York</> <publisher>Readex Microprint</> <date>1953</> </imprint> <extent>1 microprint card, 23 x 15 cm.</> </monogr> <series> <title>Three centuries of drama: English, 1642-1700</> </series> </biblStruct> ]]> </eg> <!-- example from ANSI Z39.29, sec. A.3.12.1, p.41 --> <p>A bibliographic description, particularly for an analytic title, will often include some additional information specifying its location, for example as a volume number, page number, range of page numbers, or name or number of a subdivision of the host work. The element <gi>biblScope</gi> may be used to identify such information if it is present. Where it is desired to distinguish different classes of such information (volume number, page number, chapter number, etc.), the <att>type</att> attribute may be used with any convenient typology. <p>When the item being cited is a journal article, the <gi>imprint</gi> element describing the issue in which it appeared will typically contain <gi>biblScope</gi> elements for volume and page numbers, together with a <gi>date</gi> element. <p>For example: <eg><![ CDATA [ <biblStruct> <analytic> <author>Wrigley, E. A.</> <title>Parish registers and the historian</> </analytic> <!-- in --> <monogr> <editor>Steel, D. J.</> <title>National index of parish registers</> <imprint> <pubPlace>London</pubPlace> <publisher>Society of Genealogists</> <date value='1968'>1968</> </imprint> <biblScope type=volume>vol. 1</> <biblScope type=pages>pp. 155-167.</> </monogr> </biblStruct> ]]> </eg> <p>The <att>type</att> attribute on <gi>biblScope</gi> is optional: both the following are legal examples: <eg><![ CDATA [ <biblStruct> <analytic> <author>Boguraev, Branimir</> <author>Neff, Mary</> <title>Text Representation, Dictionary Structure, and Lexical Knowledge</> </analytic> <!-- in --> <monogr> <title level=j>Literary & Linguistic Computing</> <imprint> <biblScope type=volume>7</> <biblScope type=issue>2</> <date>1992</> <biblScope type=pages>110-112</> </imprint> </monogr> </biblStruct> ]]> </eg> <eg><![ CDATA [ <biblStruct> <analytic> <author>Chesnutt, David</> <title>Historical Editions in the States</> </analytic> <!-- in --> <monogr> <title level=j>Computers and the Humanities</> <imprint> <biblScope>25.6</> <date value='1991-12'>(December, 1991):</> <biblScope>377-380</> </imprint> </monogr> </biblStruct> ]]> </eg> <p>Formal definitions for the elements described in this section are as follows: <eg id=dcopub> <![ CDATA [ <!-- 6.10.2.3: Tags for Bibliographic References (cont'd) --> <!-- (continuation of sec. 6.10.1) --> <!ELEMENT imprint - O (pubPlace | publisher | date | biblScope)* > <!ATTLIST imprint %a.global; > <!ELEMENT publisher - o (%phrase.seq) > <!ATTLIST publisher %a.global; > <!ELEMENT biblScope - o (%phrase.seq) > <!ATTLIST biblScope %a.global; type CDATA #IMPLIED > <!ELEMENT pubPlace - - (%phrase.seq;) > <!ATTLIST pubPlace %a.global; %a.names; > <!-- Note and date are defined elsewhere, as are extent, --> <!-- address, and idno. --> ]]> </eg> <div4 id=CObicos><head>Series Information</head> <p>Series information may (in <gi>bibl</gi> elements) or must (in <gi>biblStruct</gi> elements) be enclosed in a <gi>series</gi> element or (in a <gi>biblFull</gi> element) a <gi>seriesStmt</gi> element. The title of the series may be tagged <tag>title level=s</tag>, the volume number <tag>biblScope type=volume</tag>, and responsibility statements for the series (e.g. the name and affiliation of the editor, as in the example in section <ptr target=CObicol>) may be tagged <tag>editor</tag> or <tag>respStmt</tag>. <div4 id=CObicon><head>Notes and Other Additional Information</head> <p>Explanatory notes about the publication of unusual items, the form of an item (e.g. <mentioned>[Score]</mentioned> or <mentioned>[Microform]</mentioned>), or its provenance (e.g. <mentioned>translation of ...</mentioned>) may be tagged using the <gi>note</gi> element. The same element may be used for any descriptive annotation of a bibliographic entry in a database. <list type=gloss> <label><gi>note</gi></label> <item>contains a note or annotation. Attributes include: <list type=gloss> <label><att>type</att></label> <item>describes the type of note.</item> <label><att>place</att></label> <item>indicates where the note appears in the source text. Sample values include: <list type=gloss> <label><term>foot</term></label> <item>note appears at foot of page.</item> <label><term>end</term></label> <item>note appears at end of chapter or volume.</item> <label><term>inline</term></label> <item>note appears as a marked paragraph in the body of the text.</item> <label><term>left</term></label> <item>note appears in left margin.</item> <label><term>right</term></label> <item>note appears in right margin.</item> <label><term>interlinear</term></label> <item>note appears between lines of the text.</item> <label><term>app[aratus]</term></label> <item>note appears in the apparatus at the foot of the page.</item> </list></item> </list> </item> </list> <p>For example: <eg><![ CDATA[ <bibl><author>Coombs, James H., Allen H. Renear, and Steven J. DeRose.</author> <title level=a>Markup Systems and the Future of Scholarly Text Processing. Communications of the ACM 30.11 (November 1987): 933-947. Classic polemic supporting descriptive over procedural markup in scholarly work. ]]> Order of Components within References

The order of elements in bibl elements is not constrained.

In biblStruct elements, the analytic element, if it occurs, must come first, followed by one or more monogr and series elements, which may appear intermingled (as long as a monogr element comes first). Within analytic, the title(s), author(s), editor(s), and other statements of responsibility may appear in any order; it is recommended that all forms of the title be given together. Within monogr, the author, editor, and statements of responsibility may either come first or else follow the monographic title(s). Following these, the elements must appear in the following order: notes on the publication (and meeting elements describing the conference, in the case of a proceedings volume) edition elements, each followed by any related editor or respStmt elements imprint biblScope Within imprint, the elements allowed may appear in any order.

Finally, within the series information in a biblStruct, the sequence of elements is not constrained.

If more detailed structuring of a bibliographic description is required, the biblFull element should be used. This is not further described here, as its contents are essentially equivalent to those of the fileDesc element in the teiHeader, which is fully described in section . Bibliographic Pointers

References which are pointers to bibliographic items, of whatever kind, should be treated in the same way as other cross-references (see section ). As discussed in that section, cross referencing within TEI texts is in general represented by means of ptr or ref elements. A target attribute on these elements is used to supply an identifying value for the target of the cross reference, which should be, in the case of bibliographic elements, a bibliographic reference of some kind. Where the form of the reference itself is unimportant, or may be reconstructed mechanically, or is not to be encoded, the ptr element is used, as in the following example: )... ]]>

Where the form of the reference is important, or contains additional qualifying information which is to be kept but distinguished from the surrounding text, the ref element should be used, as in the following example: (ibid, passim) ... ]]> It may be important to distinguish between the short form of a bibliographic reference and some qualifying or additional information. The latter should not appear within the scope of the ref element when this is the case, as for example in an application concerned to normalize bibliographic references: Nelson [1980], pages 13-37) ... ]]> Relationship to Other Bibliographic Schemes

The bibliographic tagging defined here can capture the distinctions required by most bibliographic encoding systems; for the benefit of users of some commonly used systems, the following lists of equivalences are offered, showing the relationship of the markup defined here to the fields defined for bibliographic records in the Scribe, BibTeX, and ProCite systems.

The various bibliographic fields defined for use in the Scribe and BibTeX systems of bibliographic databases have the following equivalents in the scheme presented here:The BibTeX scheme is intentionally compatible with that of Scribe, although it omits some fields used by Scribe. Hence only one list of fields is given here. Elements and structures available in the tag set defined here which have no analogues in Scribe and BibTeX are not noted. Passages of Verse or Drama

The following elements are included in the core tag set for the convenience of those encoding texts which include mixtures of prose, verse and drama. contains a single, possibly incomplete, line of verse. Attributes include: specifies whether or not the line is metrically complete. Legal values are: the line is metrically incomplete either the line is complete, or no claim is made as to its completeness the initial part of an incomplete line a medial part of an incomplete line the final part of an incomplete line contains a group of verse lines functioning as a formal unit e.g. a stanza, refrain, verse paragraph, etc. An individual speech in a performance text, or a passage presented as such in a prose or verse text. A specialized form of heading or label, giving the name of one or more speakers in a dramatic text or fragment. contains any kind of stage direction within a dramatic text or fragment. Attributes include: indicates the kind of stage direction. Suggested values include: describes a setting. describes an entrance. describes an exit. describes stage business. is a narrative, motivating stage direction. describes how a character speaks. gives some detail about a character. describes a location. more than one of the above

Full details of other, more specialized, elements for the encoding of texts which are predominantly verse or drama are described in the appropriate chapter of part three (for verse, see the verse base described in chapter ; for performance texts, see the drama base described in chapter ). In this section, we describe only the elements listed above, all of which can appear in any text, whichever of the three modes prose, verse, or drama may predominate in it. Core Tags for Verse

Like other written texts, verse texts or poems may be hierarchically subdivided, for example into books or cantos. These structural subdivisions should be encoded using the general purpose div or div1 (etc.) elements described below in chapters and . The fundamental unit of a verse text is the verse line rather than the paragraph, however.

The l element is used to mark up verse lines, that is metrical rather than typographic lines. Where a metrical line is interrupted by a typographic line break, the encoder may choose to ignore the fact entirely or to use the empty lb (line break) element discussed in . In the copy text, the following example is printed on four typographic lines, beginning with the words There, From, The, and the. There they lie, in the largest, in an open space in the woods, From 500 to 600 poor fellows — the groans and screams — The odor of blood, mixed with the fresh scent of the night, the grass, the trees — that Slaughter-house! ]]>

Where verse lines are not properly nested within the enclosing hierarchy (for example where verse lines cross larger boundaries such as verse paragraphs or speeches) the encoder may choose to use one of the techniques discussed in chapter , or to use the part attribute to indicate that the verse line is incomplete, as in the following example: Thou fumblest Eros, and my Queenes a Squire More tight at this, then thou: Dispatch. O Loue, That thou couldst see my Warres to day, and knew'st The Royall Occupation, thou should'st see A Workeman in't. Enter an Armed Soldier. Good morrow to thee, welcome. ... ]]>

In some verse forms, regular groupings of lines are regarded as units of some kind, often identified by a regular verse scheme. In stichic verse and couplets, groups of lines analogous to paragraphs are often indicated by indentation. In other verse forms, lines are grouped into irregular sequences indicated simply by white space. The neutral lg or line group element may be used to mark any such grouping of lines; the type is available to further categorize the line group where this is felt desirable, as in the following example. This example also demonstrates the rend attribute to indicate whether or not a line is indented. Come fill up the Glass, Round, round let it pass, 'Till our Reason be lost in our Wine: Leave Conscience's Rules To Women and Fools, This only can make us divine. Then a Mohock, a Mohock I'll be, No Laws shall restrain Our Libertine Reign, We'll riot, drink on, and be free. ]]>

For some kinds of analysis, it may be useful to identify different kinds of line group within the same piece of verse. Such line groups may self-nest, in much the same way as the un-numbered div element described in chapter . For example:

The part attribute may also be attached to a lg element to indicate that it is incomplete, for example because it forms part of a group that is divided between two speakers, as in the following example: First Voice But why drives on that ship so fast Withouten wave or wind? Second Voice The air is cut away before, And closes from behind. ]]>

For alternative methods of aligning groups of lines which do not form simple hierarchic groups, or which are discontinuous, see the more detailed discussion in chapter . For discussion of other elements and attributes specific to the encoding of verse, see chapter .

These elements are defined as follows: ]]> Core Tags for Drama

Like other written texts, dramatic and other performance texts such as cinema or TV scripts are often hierarchically organized, for example into acts and scenes. These structural subdivisions should be encoded using the general purpose div or div1 (etc.) elements described below in chapters and . Within these divisions, the body of a performance text typically consists of speeches, often prefixed by a phrase indicating who is speaking, and occasionally interspersed with stage directions of various kinds.

In the following simple example, each speech consists of a single paragraph: Scene 2. Peachum, Filch. FILCH.

Sir, Black Moll hath sent word her Trial comes on in the Afternoon, and she hopes you will order Matters so as to bring her off. PEACHUM.

Why, she may plead her Belly at worst; to my Knowledge she hath taken care of that Security. But, as the Wench is very active and industrious, you may satisfy her that I'll soften the Evidence. FILCH.

Tom Gagg, sir, is found guilty. ]]>

In the following example, each speech consists of a sequence of verse lines, some of them being marked as metrically incomplete: ACT I SCENE I Enter Barnardo and Francisco, two Sentinels, at several doors BarnWho's there? FranNay, answer me. Stand and unfold yourself. BarnLong live the King! FranBarnardo? BarnHe. FranYou come most carefully upon your hour. Barn'Tis now struck twelve. Get thee to bed, Francisco. FranFor this relief much thanks.'Tis bitter cold, And I am sick at heart. ]]>

In some cases, as here in the First Quarto of Hamlet, the printed speaker attributions need to be supplemented by use of the who attribute; again, the lines are marked as complete or incomplete: Enter two Centinels. Now call'd Bernardo & Francesco. 1. STand: who is that? 2. Tis I. 1. O you come most carefully vpon your watch, 2. And if you meete Marcellus and Horatio, The partners of my watch, bid them make haste. 1. I will: See who goes there. Enter Horatio and Marcellus. Hor. Friends to this ground. Mar. And leegemen to the Dane, O farewell honest souldier, who hath releeued you? 1. Barnardo hath my place, giue you good night. ]]>

By contrast with the preceding examples, the following encodes an early printed edition without making any assumption about which parts are prose or verse: Actus primus, Scena prima. A tempestuous noise of Thunder and Lightning heard: Enter a Ship-master, and a Boteswaine. Master.

Bote-swaine. Botes.

Heere Master: What cheere? Mast.

Good: Speake to th' Mariners: fall too't, yarely, or we run our selues a ground, bestirre, bestirre. Exit. Enter Mariners. Botes.

Heigh my hearts, cheerely, cheerely my harts: yare, yare: Take in the toppe-sale: Tend to th' Masters whistle: Blow till thou burst thy winde, if roome e-nough. ]]>

The sp and stage elements should also be used to mark parts of a text otherwise in prose which are presented as if they were dialogue in a play. For example: The reverend Doctor Opimiam

I do not think I have named a single unpresentable fish. Mr Gryll

Bream, Doctor: there is not much to be said for bream. The Reverend Doctor Opimiam

On the contrary, sir, I think there is much to be said for him. In the first place....

Fish, Miss Gryll -- I could discourse to you on fish by the hour: but for the present I will forbear... ]]> Lord Curryfin (after a pause).

Mass as the second grave-digger says in Hamlet, I cannot tell.

A chorus of laughter dissolved the sitting. ]]>

These elements are defined as follows: ]]> Overview of the Core Tag Set

Except for those tags designed to be used in concurrent markup streams, all the elements described in this chapter occur in the core of TEI tags, defined by the following DTD fragment. ]]>