2 The TEI Header
Table des matières
This chapter addresses the problems of describing an encoded work so that the text itself, its source, its encoding, and its revisions are all thoroughly documented. Such documentation is equally necessary for scholars using the texts, for software processing them, and for cataloguers in libraries and archives. Together these descriptions and declarations provide an electronic analogue to the title page attached to a printed work. They also constitute an equivalent for the content of the code books or introductory manuals customarily accompanying electronic data sets.
Every TEI-conformant text must carry such a set of descriptions, prefixed to it and encoded as described in this chapter. The set is known as the TEI header, tagged teiHeader, and has five major parts:
- a file description, tagged fileDesc, containing a full bibliographical description of the computer file itself, from which a user of the text could derive a proper bibliographic citation, or which a librarian or archivist could use in creating a catalogue entry recording its presence within a library or archive. The term computer file here is to be understood as referring to the whole entity or document described by the header, even when this is stored in several distinct operating system files. The file description also includes information about the source or sources from which the electronic document was derived. The TEI elements used to encode the file description are described in section 2.2 The File Description below.
- an encoding description, tagged encodingDesc, which describes the relationship between an electronic text and its source or sources. It allows for detailed description of whether (or how) the text was normalized during transcription, how the encoder resolved ambiguities in the source, what levels of encoding or analysis were applied, and similar matters. The TEI elements used to encode the encoding description are described in section 2.3 The Encoding Description below.
- a text profile, tagged profileDesc, containing classificatory and contextual information about the text, such as its subject matter, the situation in which it was produced, the individuals described by or participating in producing it, and so forth. Such a text profile is of particular use in highly structured composite texts such as corpora or language collections, where it is often highly desirable to enforce a controlled descriptive vocabulary or to perform retrievals from a body of text in terms of text type or origin. The text profile may however be of use in any form of automatic text processing. The TEI elements used to encode the profile description are described in section 2.4 The Profile Description below.
- a container element, tagged xenoData, which allows easy inclusion of metadata from non-TEI schemes (i.e., other than elements in the TEI namespace). For example, the MARC record for the encoded document might be included using MARCXML or MODS. A simple set of metadata for harvesting might be included encoded in Dublin Core.
- a revision history, tagged revisionDesc, which allows the encoder to provide a history of changes made during the development of the electronic text. The revision history is important for version control and for resolving questions about the history of a file. The TEI elements used to encode the revision description are described in section 2.6 The Revision Description below.
A TEI header can be a very large and complex object, or it may be a very simple one. Some application areas (for example, the construction of language corpora and the transcription of spoken texts) may require more specialized and detailed information than others. The present proposals therefore define both a core set of elements (all of which may be used without formality in any TEI header) and some additional elements which become available within the header as the result of including additional specialized modules within the schema. When the module for language corpora (described in chapter 16 Language Corpora) is in use, for example, several additional elements are available, as further detailed in that chapter.
The next section of the present chapter briefly introduces the overall structure of the header and the kinds of data it may contain. This is followed by a detailed description of all the constituent elements which may be used in the core header. Section 2.7 Minimal and Recommended Headers, at the end of the present chapter, discusses the recommended content of a minimal TEI header and its relation to standard library cataloguing practices.
TEI: Organization of the TEI Header⚓︎2.1 Organization of the TEI Header
TEI: The TEI Header and Its Components⚓︎2.1.1 The TEI Header and Its Components
The teiHeader element should be clearly distinguished from the front matter of the text itself (for which see section 4.5 Front Matter). A composite text, such as a corpus or collection, may contain several headers, as further discussed below. In the general case, however, a TEI-conformant text will contain a single teiHeader element, followed by a single text or facsimile element, or both.
The header element has the following description:
- teiHeader (en-tête TEI) fournit des informations descriptives et déclaratives qui constituent une page de titre électronique au début de tout texte conforme à la TEI.
As discussed above, the teiHeader element has five principal components:
- fileDesc (description bibliographique du fichier) contient une description bibliographique complète du fichier électronique.
- encodingDesc (description de l'encodage) documente la relation d'un texte électronique avec sa ou ses sources.
- profileDesc (description du profil) fournit une description détaillée des aspects non bibliographiques du texte, notamment les langues utilisées et leurs variantes, les circonstances de sa production, les collaborateurs et leur statut.
- xenoData (non-TEI metadata) provides a container element into which metadata in non-TEI formats may be placed.
- revisionDesc (descriptif des révisions) fournit un résumé de l’historique des révisions d’un fichier.
<fileDesc>
<titleStmt>
<title>
<!-- title of the resource -->
</title>
</titleStmt>
<publicationStmt>
<p>
<!-- Information about distribution of the resource -->
</p>
</publicationStmt>
<sourceDesc>
<p>
<!-- Information about source from which the resource derives -->
</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<teiHeader xml:lang="fr">
<!-- ... -->
</teiHeader>
<text xml:lang="en">
<!-- ... -->
</text>
</TEI>
<teiHeader>
<!-- corpus-level metadata here -->
</teiHeader>
<TEI>
<teiHeader>
<!-- metadata specific to this text here -->
</teiHeader>
<text>
<!-- ... -->
</text>
</TEI>
<TEI>
<teiHeader>
<!-- metadata specific to this text here -->
</teiHeader>
<text>
<!-- ... -->
</text>
</TEI>
</teiCorpus>
TEI: Types of Content in the TEI Header⚓︎2.1.2 Types of Content in the TEI Header
The elements occurring within the TEI header may contain several types of content; the following list indicates how these types of content are described in the following sections:
- free prose
- Most elements contain simple running prose at some level. Many elements may contain either prose (possibly organized into paragraphs) or more specific elements, which themselves contain prose. In this chapter's descriptions of element content, the phrase prose description should be understood to imply a series of paragraphs, each marked as a p element. The word phrase, by contrast, should be understood to imply character data, interspersed as need be with phrase-level elements, but not organized into paragraphs. For more information on paragraphs, highlighted phrases, lists, etc., see section 3.1 Paragraphs.
- grouping elements
- Elements whose names end with the suffix Stmt (e.g. editionStmt, titleStmt) and the xenoData element enclose a group of specialized elements recording some structured information. In the case of the bibliographic elements, the suffix Stmt is used in names of elements corresponding to the ‘areas’ of the International Standard Bibliographic Description.5 In the case of the xenoData element, the specialized elements are not TEI elements, but rather come from some other metadata scheme. In most cases grouping elements may contain prose descriptions as an alternative to the set of specialized elements, thus allowing the encoder to choose whether or not the information concerned should be presented in a structured form or in prose.
- declarations
- Elements whose names end with the suffix Decl (e.g. tagsDecl, refsDecl) enclose information about specific encoding practices applied in the electronic text; often these practices are described in coded form. Typically, such information takes the form of a series of declarations, identifying a code with some more complex structure or description. A declaration which applies to more than one text or division of a text need not be repeated in the header of each such text or subdivision. Instead, the decls attribute of each text (or subdivision of the text) to which the declaration applies may be used to supply a cross-reference to it, as further described in section 16.3 Associating Contextual Information with a Text.
- descriptions
- Elements whose names end with the suffix Desc (e.g. settingDesc, projectDesc) contain a prose description, possibly, but not necessarily, organized under some specific headings by suggested sub-elements.
TEI: Model Classes in the TEI Header⚓︎2.1.3 Model Classes in the TEI Header
The TEI header provides a very rich collection of metadata categories, but makes no claim to be exhaustive. It is certainly the case that individual projects may wish to record specialized metadata which either does not fit within one of the predefined categories identified by the TEI header or requires a more specialized element structure than is proposed here. To overcome this problem, the encoder may elect to define additional elements using the customization methods discussed in 24.3 Customization. The TEI class system makes such customizations simpler to effect and easier to use in interchange.
These classes are specific to parts of the header:
- model.applicationLike regroupe des éléments utilisés pour enregistrer dans l'en-tête TEI d'un document
des informations d'applications spécifiques.
application fournit des informations sur une application qui a été utilisée pour le traitement du document. - model.availabilityPart regroupe des éléments tels que les licences ou les paragraphes indiquant la disponibilité
d'un ouvrage.
licence contient des informations légales applicables au texte, notamment le contrat de licence définissant les droits d'utilisation. - model.catDescPart regroupe des éléments composants de l'élément catDesc dans l'en-tête TEI.
textDesc (description de texte) fournit la description d'un texte sous l'angle du contexte situationnel - model.editorialDeclPart regroupe des éléments qui peuvent être employés dans l'élément editorialDecl et souvent à de nombreuses reprises.
correction (règles de correction) établit comment et dans quelles circonstances des corrections ont été apportées au texte. hyphenation (césurage) résume la façon dont les traits d'union sécants de fin de ligne d’un texte source ont été traités dans sa version encodée. interpretation (Interprétation) décrit le champ d’application de toute information analytique ou interprétative ajoutée à la transcription du texte. normalization (normalisation) indique l'extension de la normalisation ou de la régularisation effectuée sur le texte source dans sa conversion vers sa forme électronique. punctuation specifies editorial practice adopted with respect to punctuation marks in the original. quotation (citation) décrit la pratique éditoriale adoptée par rapport aux guillements dans l’original. segmentation (segmentation) décrit les principes selon lesquels le texte a été segmenté, par exemple en phrases, en intonèmes (unités tonales), en strates graphématiques (niveaux superposés de signes graphiques), etc. stdVals (valeurs normalisées) précise le format utilisé pour exprimer une date ou une valeur numérique de manière normalisée . - model.encodingDescPart regroupe des éléments qui peuvent apparaître plusieurs fois dans l'élément encodingDesc.
appInfo (informations d'application) enregistre des informations sur l'application qui a été utilisée pour traiter le fichier TEI. charDecl (description de caractère) fournit des informations sur des caractères ou des glyphes sortant de l'ordinaire classDecl (déclaration de classification) contient une ou plusieurs taxinomies définissant les codes de classification utilisés n’importe où dans le texte. editorialDecl (déclaration des pratiques éditoriales) donne des précisions sur les pratiques et les principes éditoriaux appliqués au cours de l’encodage du texte. fsdDecl (Déclaration de système de traits (FSD)) fournit une déclaration du système de traits consistant en une ou plusieurs déclarations de structure de traits ou des liens vers une déclaration de structure de traits. geoDecl (déclaration de coordonnées géographiques.) documente la notation et les données utilisées pour exprimer les coordonnées géographiques dans l'élément geoailleurs dans le document. listPrefixDef (list of prefix definitions) contains a list of definitions of prefixing schemes used in teidata.pointer values, showing how abbreviated URIs using each scheme may be expanded into full URIs. metDecl (déclaration sur la métrique) documente la notation utilisée pour noter un modèle métrique lorsque celui-ci est spécifié comme la valeur des attributs met , real, ou rhyme, qui s’appliquent à tout élément de la structure d’un texte versifié (par exemple lg, l, ou seg). projectDesc (description du projet) décrit en détail le but ou l’objectif visé dans l’encodage d’un fichier électronique, ainsi que toute autre information pertinente sur la manière dont il a été construit ou recueilli. refsDecl (Déclaration du système de références) précise la manière dont les références canoniques ont été construites pour ce texte. samplingDecl (déclaration d'échantillonnage) contient une description en texte libre du raisonnement et des méthodes utilisés pour l'échantillonnage des textes dans la création d’un corpus ou d’une collection. schemaRef (schema reference) describes or points to a related customization or schema file schemaSpec (spécification de schéma) génère un schéma conforme à la TEI et la documentation qui l'accompagne. styleDefDecl (style definition language declaration) specifies the name of the formal language in which style or renditional information is supplied elsewhere in the document. The specific version of the scheme may also be supplied. tagsDecl (déclaration de balisage) donne l’information détaillée sur le balisage appliqué à un document . transcriptionDesc (transcription description) describes the set of transcription conventions used, particularly for spoken material. unitDecl (unit declarations) provides information about units of measurement that are not members of the International System of Units. variantEncoding (Méthode d'encodage des variantes) sert à déclarer la méthode utilisée pour encoder les variantes critiques du texte. - model.profileDescPart regroupe des éléments que l'on peut utiliser plusieurs fois dans l'élément profileDesc.
abstract contains a summary or formal abstract prefixed to an existing source document by the encoder. calendarDesc (description des calendriers) contient la description des différents calendriers utilisés dans des dates écrits dans un manuscrit. correspDesc (correspondence description) contains a description of the actions related to one act of correspondence. creation (création) contient des informations concernant la création d’un texte. handNotes contient un ou plusieurs éléments handNote qui documentent les différentes mains identifiées dans les textes source. langUsage (langue utilisée) décrit les langues, variétés de langues, registres, dialectes, etc. présents à l’intérieur d’un texte. listTranspose supplies a list of transpositions, each of which is indicated at some point in a document typically by means of metamarks. particDesc (description des participants) décrit les locuteurs, voix ou autres participants identifiables d'une interaction linguistique. settingDesc (description du contexte) décrit le(s) contexte(s) dans lesquels se situe une interaction linguistique, soit sous la forme d'une description en prose, soit sous celle d'une série d'éléments décrivant le contexte. textClass (classification du texte) regroupe des informations décrivant la nature ou le sujet d’un texte selon des termes issus d’un système de classification standardisé, d’un thésaurus, etc. textDesc (description de texte) fournit la description d'un texte sous l'angle du contexte situationnel - model.teiHeaderPart regroupe des éléments de macrostructure qui peuvent apparaître plus d'une fois dans
l’en-tête TEI.
encodingDesc (description de l'encodage) documente la relation d'un texte électronique avec sa ou ses sources. profileDesc (description du profil) fournit une description détaillée des aspects non bibliographiques du texte, notamment les langues utilisées et leurs variantes, les circonstances de sa production, les collaborateurs et leur statut. xenoData (non-TEI metadata) provides a container element into which metadata in non-TEI formats may be placed. - model.sourceDescPart regroupe des éléments que l'on peut utiliser plusieurs fois dans l'élément sourceDesc.
recordingStmt (déclaration d'enregistrements) décrit un ensemble d’enregistrements utilisés pour la transcription de la parole. scriptStmt (déclaration du script) contient une citation donnant des détails sur le script à l’origine de la parole. [le terme ‘script’ est entendu au sens large dans ce document comme tout texte préparatoire à une prise de parole (discours politique, sermon, interview, allocution, conférence, émission, etc.)]. - model.textDescPart regroupe des éléments destinés à attribuer une catégorie à un texte, par exemple
en utilisant des termes qui caractérisent sa situation.
channel (canal principal) décrit le médium ou le canal par le biais duquel un texte est délivré ou reçu. Pour un texte écrit, cela peut être un imprimé, un manuscrit, un courriel, etc. ; pour un texte parlé, la radio, le téléphone, un face à face, etc. constitution (composition) décrit la composition interne d'un texte ou d'une partie de texte, par exemple : fragmentaire, complet, etc. derivation (dérivation) décrit la nature et le degré d'originalité de ce texte. domain (domaine d'usage) décrit le contexte social principal dans lequel le texte a été réalisé ou pour lequel il est conçu, par exemple : sphère privée ou publique, contexte éducatif, religieux, etc. factuality (degré de réalité) décrit le degré de fiction ou de réalité caractérisant un texte, c'est-à-dire s'il décrit un monde imaginaire ou réel. interaction (interaction) décrit l'étendue, la cardinalité et la nature de toute interaction entre ceux qui produisent et ceux qui reçoivent le texte, par exemple sous forme d'une réponse ou d'une interjection, d'un commentaire, etc. preparedness (degré de préparation) décrit le degré de préparation ou de spontanéité d'un texte
TEI: The File Description⚓︎2.2 The File Description
This section describes the fileDesc element, which is the first component of the teiHeader element.
The bibliographic description of a machine-readable or digital text resembles in structure that of a book, an article, or any other kind of textual object. The file description element of the TEI header has therefore been closely modelled on existing standards in library cataloguing; it should thus provide enough information to allow users to give standard bibliographic references to the electronic text, and to allow cataloguers to catalogue it. Bibliographic citations occurring elsewhere in the header, and also in the text itself, are derived from the same model (on bibliographic citations in general, see further section 3.12 Bibliographic Citations and References). See further section 2.8 Note for Library Cataloguers.
The bibliographic description of an electronic text should be supplied by the mandatory fileDesc element:
- fileDesc (description bibliographique du fichier) contient une description bibliographique complète du fichier électronique.
The fileDesc element contains three mandatory elements and four optional elements, each of which is described in more detail in sections 2.2.1 The Title Statement to 2.2.6 The Notes Statement below. These elements are listed below in the order in which they must be given within the fileDesc element.
- titleStmt (mention de titre) regroupe les informations sur le titre d’une œuvre et les personnes ou institutions responsables de son contenu intellectuel.
- editionStmt (mention d'édition) regroupe les informations relatives à l’édition d’un texte.
- extent (étendue) décrit la taille approximative d’un texte stocké sur son support, numérique ou non numérique, exprimé dans une unité quelconque appropriée.
- publicationStmt (mention de publication) regroupe des informations concernant la publication ou la diffusion d’un texte électronique ou d’un autre type de texte.
- seriesStmt (mention de collection) regroupe toute information relative à la collection (si elle existe) à laquelle appartient une publication.
- notesStmt (mention de notes) rassemble toutes les notes fournissant des informations sur un texte, en plus des informations mentionnées dans d'autres parties de la description bibliographique.
- sourceDesc (description de la source) décrit la source à partir de laquelle un texte électronique a été dérivé ou produit, habituellement une description bibliographique pour un texte numérisé, ou une expression comme ‘document numérique natif’ pour un texte qui n'a aucune existence précédente.
<fileDesc>
<titleStmt>
<title>
<!-- title of the resource -->
</title>
</titleStmt>
<editionStmt>
<p>
<!-- information about the edition of the resource -->
</p>
</editionStmt>
<extent>
<!-- description of the size of the resource -->
</extent>
<publicationStmt>
<p>
<!-- information about the distribution of the resource -->
</p>
</publicationStmt>
<seriesStmt>
<p>
<!-- information about any series to which the resource belongs -->
</p>
</seriesStmt>
<notesStmt>
<note>
<!-- notes on other aspects of the resource -->
</note>
</notesStmt>
<sourceDesc>
<p>
<!-- information about the source from which the resource was derived -->
</p>
</sourceDesc>
</fileDesc>
</teiHeader>
TEI: The Title Statement⚓︎2.2.1 The Title Statement
The titleStmt element is the first component of the fileDesc element, and is mandatory:
- titleStmt (mention de titre) regroupe les informations sur le titre d’une œuvre et les personnes ou institutions responsables de son contenu intellectuel.
It contains the title given to the electronic work, together with one or more optional statements of responsibility which identify the encoder, editor, author, compiler, or other parties responsible for it:
- title (titre) contient le titre complet d'une oeuvre quelconque
- author (auteur) dans une référence bibliographique contient le nom de la (des) personne(s) physique(s) ou du collectif, auteur(s) d'une oeuvre ; par exemple dans la même forme que celle utilisée par une référence bibliographique reconnue.
- editor mention de responsabilité secondaire pour un item bibliographique, par exemple le nom d'une personne, d'une institution ou d'un organisme (ou de plusieurs d'entre eux) comme éditeur scientifique, compilateur, traducteur, etc.
- sponsor (commanditaire) indique le nom d’une institution ou d’un organisme partenaires.
- funder (financeur) désigne le nom d’une personne ou d’un organisme responsable du financement d’un projet ou d’un texte.
- principal (chercheur principal) contient le nom du chercheur qui est principalement responsable de la création d’un texte électronique.
- respStmt (mention de responsabilité) indique la responsabilité quant au contenu intellectuel d'un texte, d'une édition, d'un enregistrement ou d'une publication en série, lorsque les éléments spécifiques relatifs aux auteurs, éditeurs, etc. ne suffisent pas ou ne s'appliquent pas.
- resp (responsabilité) contient une expression décrivant la nature de la responsabilité intellectuelle d'une personne.
- name (nom, nom propre) contient un nom propre ou un syntagme nominal.
The title element contains the chief name of the electronic work, including any alternative title or subtitles it may have. It may be repeated, if the work has more than one title (perhaps in different languages) and takes whatever form is considered appropriate by its creator. Where the electronic work is derived from an existing source text, it is strongly recommended that the title for the former should be derived from the latter, but clearly distinguishable from it, for example by the addition of a phrase such as ‘: an electronic transcription’ or ‘a digital edition’. This will distinguish the electronic work from the source text in citations and in catalogues which contain descriptions of both types of material.
The electronic work will also have an external name (its ‘filename’ or ‘data set name’) or reference number on the computer system where it resides at any time. This name is likely to change frequently, as new copies of the file are made on the computer system. Its form is entirely dependent on the particular computer system in use and thus cannot always easily be transferred from one system to another. Moreover, a given work may be composed of many files. For these reasons, these Guidelines strongly recommend that such names should not be used as the title for any electronic work.
Helpful guidance on the formulation of useful descriptive titles in difficult cases may be found in chapter 25 of Anglo-American Cataloguing Rules (2002–2005)) or another national cataloguing code.
The elements author, editor, sponsor, funder, and principal, are specializations of the more general respStmt element. These elements are used to provide the statements of responsibility which identify the person(s) responsible for the intellectual or artistic content of an item and any corporate bodies from which it emanates.
Any number of such statements may occur within the title statement. At a minimum, identify the author of the text and (where appropriate) the creator of the file. If the bibliographic description is for a corpus, identify the creator of the corpus. Optionally include also names of others involved in the transcription or elaboration of the text, sponsors, and funding agencies. The name of the person responsible for physical data input need not normally be recorded, unless that person is also intellectually responsible for some aspect of the creation of the file.
Where the person whose responsibility is to be documented is not an author, sponsor, funding body, or principal researcher, the respStmt element should be used. This has two subcomponents: a name element identifying a responsible individual or organization, and a resp element indicating the nature of the responsibility. No specific recommendations are made at this time as to appropriate content for the resp: it should make clear the nature of the responsibility concerned, as in the examples below.
Names given may be personal names or corporate names. Give all names in the form in which the persons or bodies wish to be publicly cited. This would usually be the fullest form of the name, including first names.6
<title>Capgrave's Life of St. John Norbert: a
machine-readable transcription</title>
<respStmt>
<resp>compiled by</resp>
<name>P.J. Lucas</name>
</respStmt>
</titleStmt>
<title>Two stories by Edgar Allen Poe: electronic version</title>
<author>Poe, Edgar Allen (1809-1849)</author>
<respStmt>
<resp>compiled by</resp>
<name>James D. Benson</name>
</respStmt>
</titleStmt>
<title>Yogadarśanam (arthāt
yogasūtrapūṭhaḥ):
a digital edition.</title>
<title>The Yogasūtras of Patañjali:
a digital edition.</title>
<funder>Wellcome Institute for the History of Medicine</funder>
<principal>Dominik Wujastyk</principal>
<respStmt>
<name>Wieslaw Mical</name>
<resp>data entry and proof correction</resp>
</respStmt>
<respStmt>
<name>Jan Hajic</name>
<resp>conversion to TEI-conformant markup</resp>
</respStmt>
</titleStmt>
TEI: The Edition Statement⚓︎2.2.2 The Edition Statement
The editionStmt element is the second component of the fileDesc element. It is optional but recommended.
- editionStmt (mention d'édition) regroupe les informations relatives à l’édition d’un texte.
It contains either phrases or more specialized elements identifying the edition and those responsible for it:
- edition (édition) décrit les particularités de l’édition d’un texte.
- respStmt (mention de responsabilité) indique la responsabilité quant au contenu intellectuel d'un texte, d'une édition, d'un enregistrement ou d'une publication en série, lorsque les éléments spécifiques relatifs aux auteurs, éditeurs, etc. ne suffisent pas ou ne s'appliquent pas.
- name (nom, nom propre) contient un nom propre ou un syntagme nominal.
- resp (responsabilité) contient une expression décrivant la nature de la responsabilité intellectuelle d'une personne.
For printed texts, the word edition applies to the set of all the identical copies of an item produced from one master copy and issued by a particular publishing agency or a group of such agencies. A change in the identity of the distributing body or bodies does not normally constitute a change of edition, while a change in the master copy does.
For electronic texts, the notion of a ‘master copy’ is not entirely appropriate, since they are far more easily copied and modified than printed ones; nonetheless the term edition may be used for a particular state of a machine-readable text at which substantive changes are made and fixed. Synonymous terms used in these Guidelines are version, level, and release. The words revision and update, by contrast, are used for minor changes to a file which do not amount to a new edition.
No simple rule can specify how ‘substantive’ changes have to be before they are regarded as producing a new edition, rather than a simple update. The general principle proposed here is that the production of a new edition entails a significant change in the intellectual content of the file, rather than its encoding or appearance. The addition of analytic coding to a text would thus constitute a new edition, while automatic conversion from one coded representation to another would not. Changes relating to the character code or physical storage details, corrections of misspellings, simple changes in the arrangement of the contents and changes in the output format do not normally constitute a new edition, whereas the addition of new information (e.g. a linguistic analysis expressed in part-of-speech tagging, sound or graphics, referential links to external data sets) almost always does.
Clearly, there will always be borderline cases and the matter is somewhat arbitrary. The simplest rule is: if you think that your file is a new edition, then call it such. An edition statement is optional for the first release of a computer file; it is mandatory for each later release, though this requirement cannot be enforced by the parser.
Note that all changes in a file considered significant, whether or not they are regarded as constituting a new edition or simply a new revision, should be independently noted in the revision description section of the file header (see section 2.6 The Revision Description).
The edition element should contain phrases describing the edition or version, including the word edition, version, or equivalent, together with a number or date, or terms indicating difference from other editions such as new edition, revised edition etc. Any dates that occur within the edition statement should be marked with the date element. The n attribute of the edition element may be used as elsewhere to supply any formal identification (such as a version number) for the edition.
One or more respStmt elements may also be used to supply statements of responsibility for the edition in question. These may refer to individuals or corporate bodies and can indicate functions such as that of a reviser, or can name the person or body responsible for the provision of supplementary matter, of appendices, etc., in a new edition. For further detail on the respStmt element, see section 3.12 Bibliographic Citations and References.
<edition n="P2">Second draft, substantially
extended, revised, and corrected.</edition>
</editionStmt>
<edition>Student's edition, <date>June 1987</date>
</edition>
<respStmt>
<resp>New annotations by</resp>
<name>George Brown</name>
</respStmt>
</editionStmt>
TEI: Type and Extent of File⚓︎2.2.3 Type and Extent of File
The extent element is the third component of the fileDesc element. It is optional.
- extent (étendue) décrit la taille approximative d’un texte stocké sur son support, numérique ou non numérique, exprimé dans une unité quelconque appropriée.
For printed books, information about the carrier, such as the kind of medium used and its size, are of great importance in cataloguing procedures. The print-oriented rules for bibliographic description of an item's medium and extent need some re-interpretation when applied to electronic media. An electronic file exists as a distinct entity quite independently of its carrier and remains the same intellectual object whether it is stored on a magnetic tape, a CD-ROM, a set of floppy disks, or as a file on a mainframe computer. Since, moreover, these Guidelines are specifically aimed at facilitating transparent document storage and interchange, any purely machine-dependent information should be irrelevant as far as the file header is concerned.
This is particularly true of information about file-type although library-oriented rules for cataloguing often distinguish two types of computer file: ‘data’ and ‘programs’. This distinction is quite difficult to draw in some cases, for example, hypermedia or texts with built in search and retrieval software.
Although it is equally system-dependent, some measure of the size of the computer file may be of use for cataloguing and other practical purposes. Because the measurement and expression of file size is fraught with difficulties, only very general recommendations are possible; the element extent is provided for this purpose. It contains a phrase indicating the size or approximate size of the computer file in one of the following ways:
- in bytes of a specified length (e.g. ‘4000 16-bit bytes’)
- as falling within a range of categories, for example:
- less than 1 Mb
- between 1 Mb and 5 Mb
- between 6 Mb and 10 Mb
- over 10 Mb
- in terms of any convenient logical units (for example, words or sentences, citations, paragraphs)
- in terms of any convenient physical units (for example, blocks, disks, tapes)
The use of standard abbreviations for units of quantity is recommended where applicable, here as elsewhere (see http://physics.nist.gov/cuu/Units/binary.html).
2 Mb</extent>
<extent>4.2 MiB</extent>
<extent>4532 bytes</extent>
<extent>3200 sentences</extent>
<extent>Five 90 mm High Density Diskettes</extent>
<measure unit="MiB" quantity="4.2">About four megabytes</measure>
<measure unit="pages" quantity="245">245 pages of source
material</measure>
</extent>
TEI: Publication, Distribution, Licensing, etc.⚓︎2.2.4 Publication, Distribution, Licensing, etc.
The publicationStmt element is the fourth component of the fileDesc element and is mandatory. Its function is to name the agency by which a resource is made available (for example, a publisher or distributor) and to supply any additional information about the way in which it is made available such as licensing conditions, identifying numbers, etc.
- publicationStmt (mention de publication) regroupe des informations concernant la publication ou la diffusion d’un texte électronique ou d’un autre type de texte.
It may contain either a simple prose description organized as one or more paragraphs, or the more specialised elements described below.
A structured publication statement must begin with one of the following elements:
- publisher (éditeur) donne le nom de l'organisme responsable de la publication ou de la distribution d'un élément de la bibliographie.
- distributor (diffuseur) donne le nom d’une personne ou d’un organisme responsable de la diffusion d’un texte.
- authority (responsable de la publication.) donne le nom de la personne ou de l'organisme responsable de la publication d’un fichier électronique, autre qu’un éditeur ou un distributeur.
These elements form the model.publicationStmtPart.agency class; if the agency making the resource available is unknown, but other structured information about it is available, an explicit statement such as ‘publisher unknown’ should be used.
The publisher is the person or institution by whose authority a given edition of the file is made public. The distributor is the person or institution from whom copies of the text may be obtained. Where a text is not considered formally published, but is nevertheless made available for circulation by some individual or organization, this person or institution is termed the release authority.
Whichever of these elements is chosen, it may be followed by one or more of the following elements, which together form the model.publicationStmtPart.detail class
- pubPlace (lieu de publication) contient le nom du lieu d'une publication.
- address (address) contient une adresse postale ou d'un autre type, par exemple l'adresse d'un éditeur, d'un organisme ou d'une personne.
- idno (identifiant) donne un identifiant standardisé qui peut être utilisé pour identifier
une référence bibliographique, une personne, un titre d'ouvrage ou une organisation.
type classe un numéro dans une catégorie, par exemple comme étant un numéro ISBN ou comme appartenant une autre série normalisée. - availability (disponibilité) renseigne sur la disponibilité du texte, par exemple sur toutes restrictions
quant à son usage ou sa diffusion, son copyright, etc.
status (status) donne un code caractérisant la disponibilité actuelle d’un texte. - date (date) contient une date exprimée dans n'importe quel format.
- licence contient des informations légales applicables au texte, notamment le contrat de licence définissant les droits d'utilisation.
<publisher>Oxford University Press</publisher>
<pubPlace>Oxford</pubPlace>
<date>1989</date>
<idno type="ISBN">0-19-254705-4</idno>
<availability>
<p>Copyright 1989, Oxford University Press</p>
</availability>
</publicationStmt>
<authority>James D. Benson</authority>
<pubPlace>London</pubPlace>
<date>1994</date>
</publicationStmt>
A resource may have (for example) both a publisher and a distributor, or more than one publisher each using different identifiers for the same resource, and so on. For this reason, the sequence of at least one model.publicationStmtPart.agency element followed by zero or more model.publicationStmtPart.detail elements may be repeated as often as necessary.
<publisher>Sigma Press</publisher>
<address>
<addrLine>21 High Street,</addrLine>
<addrLine>Wilmslow,</addrLine>
<addrLine>Cheshire M24 3DF</addrLine>
</address>
<date>1991</date>
<distributor>Oxford Text Archive</distributor>
<idno type="OTA">1256</idno>
<availability>
<p>Available with prior consent of depositor for
purposes of academic research and teaching only.</p>
</availability>
<date>1994</date>
</publicationStmt>
The date element used within publicationStmt always refers to the date of publication, first distribution, or initial release. If the text was created at some other date, this may be recorded using the creation element within the profileDesc element. Other useful dates (such as dates of collection of data) may be given using a note in the notesStmt element.
<publisher>University of Victoria Humanities Computing and Media Centre</publisher>
<pubPlace>Victoria, BC</pubPlace>
<date>2011</date>
<availability status="restricted">
<licence target="http://creativecommons.org/licenses/by-sa/3.0/"> Distributed under a Creative Commons Attribution-ShareAlike 3.0 Unported License
</licence>
</availability>
</publicationStmt>
TEI: The Series Statement⚓︎2.2.5 The Series Statement
The seriesStmt element is the fifth component of the fileDesc element and is optional.
- seriesStmt (mention de collection) regroupe toute information relative à la collection (si elle existe) à laquelle appartient une publication.
In bibliographic parlance, a series may be defined in one of the following ways:
- A group of separate items related to one another by the fact that each item bears, in addition to its own title proper, a collective title applying to the group as a whole. The individual items may or may not be numbered.
- Each of two or more volumes of essays, lectures, articles, or other items, similar in character and issued in sequence.
- A separately numbered sequence of volumes within a series or serial.
A seriesStmt element may contain a prose description or one or more of the following more specific elements:
- title (titre) contient le titre complet d'une oeuvre quelconque
- idno (identifiant) donne un identifiant standardisé qui peut être utilisé pour identifier une référence bibliographique, une personne, un titre d'ouvrage ou une organisation.
- respStmt (mention de responsabilité) indique la responsabilité quant au contenu intellectuel d'un texte, d'une édition, d'un enregistrement ou d'une publication en série, lorsque les éléments spécifiques relatifs aux auteurs, éditeurs, etc. ne suffisent pas ou ne s'appliquent pas.
- resp (responsabilité) contient une expression décrivant la nature de la responsabilité intellectuelle d'une personne.
- name (nom, nom propre) contient un nom propre ou un syntagme nominal.
The idno may be used to supply any identifying number associated with the item, including both standard numbers such as an ISSN and particular issue numbers. (Arabic numerals separated by punctuation are recommended for this purpose: 6.19.33, for example, rather than VI/xix:33). Its type attribute is used to categorize the number further, taking the value ISSN for an ISSN for example. Multiple seriesStmt elements may be supplied if the TEI document is associated with more than one series.
<title level="s">Machine-Readable Texts for the Study of
Indian Literature</title>
<respStmt>
<resp>ed. by</resp>
<name>Jan Gonda</name>
</respStmt>
<biblScope unit="volume">1.2</biblScope>
<idno type="ISSN">0 345 6789</idno>
</seriesStmt>
TEI: The Notes Statement⚓︎2.2.6 The Notes Statement
The notesStmt element is the sixth component of the fileDesc element and is optional. If used, it contains one or more note elements, each containing a single piece of descriptive information of the kind treated as ‘general notes’ in traditional bibliographic descriptions.
- notesStmt (mention de notes) rassemble toutes les notes fournissant des informations sur un texte, en plus des informations mentionnées dans d'autres parties de la description bibliographique.
- note (note) contient une note ou une annotation
Some information found in the notes area in conventional bibliography has been assigned specific elements in these Guidelines; in particular the following items should be tagged as indicated, rather than as general notes:
- the nature, scope, artistic form, or purpose of the file; also the genre or other intellectual category to which it may belong: e.g. ‘Text types: newspaper editorials and reportage, science fiction, westerns, and detective stories’. These should be formally described within the profileDesc element (section 2.4 The Profile Description).
- an abstract or summary of the content of a document which has been supplied by the encoder because no such abstract forms part of the content of the source. This should be supplied in the abstract element within the profileDesc element (section 2.4 The Profile Description).
- summary description providing a factual, non-evaluative account of the subject content of the file: e.g. ‘Transcribes interviews on general topics with native speakers of English in 17 cities during the spring and summer of 1963.’ These should also be formally described within the profileDesc element (section 2.4 The Profile Description).
- bibliographic details relating to the source or sources of an electronic text: e.g. ‘Transcribed from the Norton facsimile of the 1623 Folio’. These should be formally described in the sourceDesc element (section 2.2.7 The Source Description).
- further information relating to publication, distribution, or release of the text, including sources from which the text may be obtained, any restrictions on its use or formal terms on its availability. These should be placed in the appropriate division of the publicationStmt element (section 2.2.4 Publication, Distribution, Licensing, etc.).
- publicly documented numbers associated with the file: e.g. ‘ICPSR study number 1803’ or ‘Oxford Text Archive text number 1243’. These should be placed in an idno element within the appropriate division of the publicationStmt element. International Standard Serial Numbers (ISSN), International Standard Book Numbers (ISBN), and other internationally agreed upon standard numbers that uniquely identify an item, should be treated in the same way, rather than as specialized bibliographic notes.
Nevertheless, the notesStmt element may be used to record potentially significant details about the file and its features, e.g.:
- dates, when they are relevant to the content or condition of the computer file: e.g. ‘manual dated 1983’, ‘Interview wave I: Apr. 1989; wave II: Jan. 1990’
- names of persons or bodies connected with the technical production, administration, or consulting functions of the effort which produced the file, if these are not named in statements of responsibility in the title or edition statements of the file description: e.g. ‘Historical commentary provided by Mark Cohen’
- availability of the file in an additional medium or information not already recorded about the availability of documentation: e.g. ‘User manual is loose-leaf in eleven paginated sections’
- language of work and abstract, if not encoded in the langUsage element, e.g. ‘Text in English with summaries in French and German’
- The unique name assigned to a serial by the International Serials Data System (ISDS), if not encoded in an idno
- lists of related publications, either describing the source itself, or concerned with the creation or use of the electronic work, e.g. ‘Texts used in Burrows (1987)’
<note>Historical commentary provided by Mark Cohen.</note>
<note>OCR scanning done at University of Toronto.</note>
</notesStmt>
<title>…</title>
<respStmt>
<persName>Mark Cohen</persName>
<resp>historical commentary</resp>
</respStmt>
<respStmt>
<orgName>University of Toronto</orgName>
<resp>OCR scanning</resp>
</respStmt>
</titleStmt>
TEI: The Source Description⚓︎2.2.7 The Source Description
The sourceDesc element is the seventh and final component of the fileDesc element. It is a mandatory element and is used to record details of the source or sources from which a computer file is derived. This might be a printed text or manuscript, another computer file, an audio or video recording of some kind, or a combination of these. An electronic file may also have no source, if what is being catalogued is an original text created in electronic form.
- sourceDesc (description de la source) décrit la source à partir de laquelle un texte électronique a été dérivé ou produit, habituellement une description bibliographique pour un texte numérisé, ou une expression comme ‘document numérique natif’ pour un texte qui n'a aucune existence précédente.
Alternatively, it may contain elements drawn from the following three classes:
- model.biblLike regroupe des éléments contenant une description bibliographique.
bibl (référence bibliographique.) contient une référence bibliographique faiblement structurée dans laquelle les sous-composants peuvent ou non être explicitement balisés. biblFull (référence bibliographique totalement structurée) contient une référence bibliographique totalement structurée : tous les composants de la description du fichier TEI y sont présents. biblStruct (référence bibliographique structurée) contient une référence bibliographique dans laquelle seuls des sous-éléments bibliographiques apparaissent et cela, selon un ordre déterminé. listBibl (liste de références bibliographiques) contient une liste de références bibliographiques de toute nature. msDesc (description d'un manuscrit) contient la description d'un manuscrit individuel - model.sourceDescPart regroupe des éléments que l'on peut utiliser plusieurs fois dans l'élément sourceDesc.
recordingStmt (déclaration d'enregistrements) décrit un ensemble d’enregistrements utilisés pour la transcription de la parole. scriptStmt (déclaration du script) contient une citation donnant des détails sur le script à l’origine de la parole. [le terme ‘script’ est entendu au sens large dans ce document comme tout texte préparatoire à une prise de parole (discours politique, sermon, interview, allocution, conférence, émission, etc.)]. - model.listLike regroupe les éléments de type liste.
list (liste) contient une suite d'items ordonnés dans une liste. listApp (liste d'entrées dans un apparat critique) contient une liste d'entrées dans un apparat critique. listEvent (liste d'événements) contient une liste de descriptions, chacune d'entre elles fournissant des informations sur un événement connu. listNym (liste de noms canoniques) contient une liste de noms normalisés pour tous types d'objets. listObject (list of objects) contains a list of descriptions, each of which provides information about an identifiable physical object. listOrg (liste d'organisations) contient une liste d'éléments, chacun d'eux fournissant des informations sur une organisation identifiable. listPerson (liste de personnes) contient une liste d'éléments, chacun d'entre eux apportant des informations sur une personne précise ou sur un groupe de personnes, par exemple les participants à une interaction linguistique, ou les personnes citées dans une source historique. listPlace (liste de lieux) contient une liste de lieux, qui peut être suivie d'une liste de relations définies entre les lieux (autres que la relation d'inclusion). listRelation donne des informations sur les relations qui existent entre des personnes, des lieux, ou des organisations, soit de manière informelle en prose, soit de manière formelle. listWit (liste de témoins) donne une liste de définitions pour tous les témoignages cités dans un apparat critique, pouvant être groupées de façon hiérarchique. table (tableau) contient du texte affiché sous forme de tableau, en rangées et colonnes.
- bibl (référence bibliographique.) contient une référence bibliographique faiblement structurée dans laquelle les sous-composants peuvent ou non être explicitement balisés.
- biblStruct (référence bibliographique structurée) contient une référence bibliographique dans laquelle seuls des sous-éléments bibliographiques apparaissent et cela, selon un ordre déterminé.
- listBibl (liste de références bibliographiques) contient une liste de références bibliographiques de toute nature.
<bibl>The first folio of Shakespeare, prepared by
Charlton Hinman (The Norton Facsimile, 1968)</bibl>
</sourceDesc>
<biblStruct xml:lang="fr">
<monogr>
<author>Eugène Sue</author>
<title>Martin, l'enfant trouvé</title>
<title type="sub">Mémoires d'un valet de chambre</title>
<imprint>
<pubPlace>Bruxelles et Leipzig</pubPlace>
<publisher>C. Muquardt</publisher>
<date when="1846">1846</date>
</imprint>
</monogr>
</biblStruct>
</sourceDesc>
When the header describes a text derived from some pre-existing TEI-conformant or other digital document, it may be simpler to use the following element, which is designed specifically for documents derived from texts which were ‘born digital’:
- biblFull (référence bibliographique totalement structurée) contient une référence bibliographique totalement structurée : tous les composants de la description du fichier TEI y sont présents.
For further discussion see section 2.2.8 TEI documents derived from other TEI documents.
When the module for manuscript description is included in a schema, this class also makes available the following element:
- msDesc (description d'un manuscrit) contient la description d'un manuscrit individuel
This element enables the encoder to record very detailed information about one or more manuscript or analogous sources, as further discussed in 11 Manuscript Description.
The model.sourceDescPart class also makes available additional elements when additional modules are included. For example, when the spoken module is included, the sourceDesc element may also include the following special-purpose elements, intended for cases where an electronic text is derived from a spoken text rather than a written one:
- scriptStmt (déclaration du script) contient une citation donnant des détails sur le script à l’origine de la parole. [le terme ‘script’ est entendu au sens large dans ce document comme tout texte préparatoire à une prise de parole (discours politique, sermon, interview, allocution, conférence, émission, etc.)].
- recordingStmt (déclaration d'enregistrements) décrit un ensemble d’enregistrements utilisés pour la transcription de la parole.
Full descriptions of these elements and their contents are given in section 8.2 Documenting the Source of Transcribed Speech.
A single electronic text may be derived from multiple source documents, in whole or in part. The sourceDesc may therefore contain a listBibl element grouping together bibl, biblStruct, or msDesc elements for each of the sources concerned. It is also possible to repeat the sourceDesc element in such a case. The decls attribute described in section 16.3 Associating Contextual Information with a Text may be used to associate parts of the encoded text with the bibliographic element from which it derives in either case.
The source description may also include lists of names, persons, places, etc. when these are considered to form part of the source for an encoded document. When such information is recorded using the specialized elements discussed in the namesdates module (14 Names, Dates, People, and Places), the class model.listLike makes available the following elements to hold such information:
- listNym (liste de noms canoniques) contient une liste de noms normalisés pour tous types d'objets.
- listOrg (liste d'organisations) contient une liste d'éléments, chacun d'eux fournissant des informations sur une organisation identifiable.
- listPerson (liste de personnes) contient une liste d'éléments, chacun d'entre eux apportant des informations sur une personne précise ou sur un groupe de personnes, par exemple les participants à une interaction linguistique, ou les personnes citées dans une source historique.
- listPlace (liste de lieux) contient une liste de lieux, qui peut être suivie d'une liste de relations définies entre les lieux (autres que la relation d'inclusion).
TEI: TEI documents derived from other TEI documents⚓︎2.2.8 TEI documents derived from other TEI documents
When a TEI document (call it B) is derived not from a printed source but from another TEI file (call it A), then the five sections of A's file header will need to be incorporated into the new header for B as indicated below:
- fileDesc
- A's file description should be copied into the sourceDesc section of B's file description, enclosed within a biblFull element
- profileDesc
- A's profileDesc should be copied into B's, in principle unchanged; it may however be expanded by project-specific information relating to B.
- encodingDesc
- A's encoding practice may or (more likely) may not be the same as B's. Since the object of the encoding description is to define the relationship between the current file and its source, in principle only changes in encoding practice between A and B need be documented in B. The relationship between A and its source(s) is then only recoverable from the original header of A. In practice it may be more convenient to create a new complete encodingDesc for B based on A's.
- xenoData
- B is a new computer file, with a different source than A's source (namely, A). Thus it is unlikely that metadata from other schemes about A or its source can be copied wholesale to B, although there may be similarities.
- revisionDesc
- B is a new computer file, and should therefore have a new revision description. If, however, it is felt useful to include some information from A's revisionDesc, for example dates of major updates or versions, such information must be clearly marked as relating to A rather than to B.
This concludes the discussion of the fileDesc element and its contents.
TEI: The Encoding Description⚓︎2.3 The Encoding Description
The encodingDesc element is the second major subdivision of the TEI header. It specifies the methods and editorial principles which governed the transcription or encoding of the text in hand and may also include sets of coded definitions used by other components of the header. Though not formally required, its use is highly recommended.
- encodingDesc (description de l'encodage) documente la relation d'un texte électronique avec sa ou ses sources.
The encoding description may contain any combination of paragraphs of text, marked up using the p element, along with more specialized elements taken from the model.encodingDescPart class. By default, this class makes available the following elements:
- projectDesc (description du projet) décrit en détail le but ou l’objectif visé dans l’encodage d’un fichier électronique, ainsi que toute autre information pertinente sur la manière dont il a été construit ou recueilli.
- samplingDecl (déclaration d'échantillonnage) contient une description en texte libre du raisonnement et des méthodes utilisés pour l'échantillonnage des textes dans la création d’un corpus ou d’une collection.
- editorialDecl (déclaration des pratiques éditoriales) donne des précisions sur les pratiques et les principes éditoriaux appliqués au cours de l’encodage du texte.
- tagsDecl (déclaration de balisage) donne l’information détaillée sur le balisage appliqué à un document .
- styleDefDecl (style definition language declaration) specifies the name of the formal language in which style or renditional information is supplied elsewhere in the document. The specific version of the scheme may also be supplied.
- refsDecl (Déclaration du système de références) précise la manière dont les références canoniques ont été construites pour ce texte.
- classDecl (déclaration de classification) contient une ou plusieurs taxinomies définissant les codes de classification utilisés n’importe où dans le texte.
- geoDecl (déclaration de coordonnées géographiques.) documente la notation et les données utilisées pour exprimer les coordonnées géographiques dans l'élément geoailleurs dans le document.
- unitDecl (unit declarations) provides information about units of measurement that are not members of the International System of Units.
- schemaSpec (spécification de schéma) génère un schéma conforme à la TEI et la documentation qui l'accompagne.
- schemaRef (schema reference) describes or points to a related customization or schema file
Each of these elements is further described in the appropriate section below. Other modules have the ability to extend this class; examples are noted in section 2.3.12 Module-Specific Declarations
TEI: The Project Description⚓︎2.3.1 The Project Description
The projectDesc element may be used to describe, in prose, the purpose for which a digital resource was created, together with any other relevant information concerning the process by which it was assembled or collected. This is of particular importance for corpora or miscellaneous collections, but may be of use for any text, for example to explain why one kind of encoding practice has been followed rather than another.
- projectDesc (description du projet) décrit en détail le but ou l’objectif visé dans l’encodage d’un fichier électronique, ainsi que toute autre information pertinente sur la manière dont il a été construit ou recueilli.
<projectDesc>
<p>Texts collected for use in the
Claremont Shakespeare Clinic, June 1990.</p>
</projectDesc>
</encodingDesc>
TEI: The Sampling Declaration⚓︎2.3.2 The Sampling Declaration
- samplingDecl (déclaration d'échantillonnage) contient une description en texte libre du raisonnement et des méthodes utilisés pour l'échantillonnage des textes dans la création d’un corpus ou d’une collection.
- the size of individual samples
- the method or methods by which they were selected
- the underlying population being sampled
- the object of the sampling procedure used
<p>Text of stories only has been transcribed. Pull quotes, captions,
and advertisements have been silently omitted. Any mathematical
expressions requiring symbols not present in the ISOnum or ISOpub
entity sets have been omitted, and their place marked with a GAP
element.</p>
</samplingDecl>
A sampling declaration which applies to more than one text or division of a text need not be repeated in the header of each such text. Instead, the decls attribute of each text (or subdivision of the text) to which the sampling declaration applies may be used to supply a cross-reference to it, as further described in section 16.3 Associating Contextual Information with a Text.
TEI: The Editorial Practices Declaration⚓︎2.3.3 The Editorial Practices Declaration
The editorialDecl element is used to provide details of the editorial practices applied during the encoding of a text.
- editorialDecl (déclaration des pratiques éditoriales) donne des précisions sur les pratiques et les principes éditoriaux appliqués au cours de l’encodage du texte.
It may contain a prose description only, or one or more of a set of specialized elements, members of the TEI model.editorialDeclPart class. Where an encoder wishes to record an editorial policy not specified above, this may be done by adding a new element to this class, using the mechanisms discussed in chapter 24.3 Customization.
Some of these policy elements carry attributes to support automated processing of certain well-defined editorial decisions; all of them contain a prose description of the editorial principles adopted with respect to the particular feature concerned. Examples of the kinds of questions which these descriptions are intended to answer are given in the list below.
- correction
-
- correction (règles de correction) établit comment et dans quelles circonstances des corrections
ont été apportées au texte.
status indique le degré de correction apporté au texte. method indique la méthode adoptée pour signaler les corrections dans le texte.
Was the text corrected during or after data capture? If so, were corrections made silently or are they marked using the tags described in section 3.5 Simple Editorial Changes? What principles have been adopted with respect to omissions, truncations, dubious corrections, alternate readings, false starts, repetitions, etc.?
- correction (règles de correction) établit comment et dans quelles circonstances des corrections
ont été apportées au texte.
- normalization
-
- normalization (normalisation) indique l'extension de la normalisation ou de la régularisation effectuée
sur le texte source dans sa conversion vers sa forme électronique.
source [att.global.source] specifies the source from which some aspect of this element is drawn. method indique la méthode adoptée pour signaler les normalisations dans le texte.
Was the text normalized, for example by regularizing any non-standard spellings, dialect forms, etc.? If so, were normalizations performed silently or are they marked using the tags described in section 3.5 Simple Editorial Changes? What authority was used for the regularization? Also, what principles were used when normalizing numbers to provide the standard values for the value attribute described in section 3.6.3 Numbers and Measures and what format used for them?
- normalization (normalisation) indique l'extension de la normalisation ou de la régularisation effectuée
sur le texte source dans sa conversion vers sa forme électronique.
- punctuation
-
- punctuation specifies editorial practice adopted with respect to punctuation marks in the original.
marks indicates whether or not punctation marks have been retained as content within the text. placement indicates the positioning of punctuation marks that are associated with marked up text as being encoded within the element surrounding the text or immediately before or after it.
Are punctuation marks present in the original source retained? Are they identified with the element pc, or implied by markup? If retained, how are they placed with respect to related elements? For example, do commas and periods appear inside or outside elements marking phrases and sentences?
- punctuation specifies editorial practice adopted with respect to punctuation marks in the original.
- quotation
-
- quotation (citation) décrit la pratique éditoriale adoptée par rapport aux guillements dans
l’original.
marks (guillemets) indique si les guillemets ont été retenus ou non comme faisant partie du texte.
How were quotation marks processed? Are apostrophes and quotation marks distinguished? How? Are quotation marks retained as content in the text or replaced by markup? Are there any special conventions regarding for example the use of single or double quotation marks when nested? Is the file consistent in its practice or has this not been checked? See section 3.3.3 Quotation for discussion of ways in which quotation marks may be encoded.
- quotation (citation) décrit la pratique éditoriale adoptée par rapport aux guillements dans
l’original.
- hyphenation
-
- hyphenation (césurage) résume la façon dont les traits d'union sécants de fin de ligne d’un texte
source ont été traités dans sa version encodée.
eol (fin de ligne) indique si des traits d'union sécants de fin de ligne ont été conservés ou non dans un texte.
Does the encoding distinguish ‘soft’ and ‘hard’ hyphens? What principle has been adopted with respect to end-of-line hyphenation where source lineation has not been retained? Have soft hyphens been silently removed, and if so what is the effect on lineation and pagination? See section 3.2.2 Hyphenation for discussion of ways in which hyphenation may be encoded.
- hyphenation (césurage) résume la façon dont les traits d'union sécants de fin de ligne d’un texte
source ont été traités dans sa version encodée.
- segmentation
-
- segmentation (segmentation) décrit les principes selon lesquels le texte a été segmenté, par exemple en phrases, en intonèmes (unités tonales), en strates graphématiques (niveaux superposés de signes graphiques), etc.
How is the text segmented? If s or seg segmentation units have been used to divide up the text for analysis, how are they marked and how was the segmentation arrived at?
- stdVals
-
- stdVals (valeurs normalisées) précise le format utilisé pour exprimer une date ou une valeur numérique de manière normalisée .
In most cases, attributes bearing standardized values (such as the when or when-iso attribute on dates) should conform to a defined W3C or ISO datatype. In cases where this is not appropriate, this element may be used to describe the standardization methods underlying the values supplied.
- interpretation
-
- interpretation (Interprétation) décrit le champ d’application de toute information analytique ou interprétative ajoutée à la transcription du texte.
Has any analytic or ‘interpretive’ information been provided—that is, information which is felt to be non-obvious, or potentially contentious? If so, how was it generated? How was it encoded? If feature-structure analysis has been used, are fsdDecl elements (section 19.11 Feature System Declaration) present?
<segmentation>
<p>
<gi>s</gi> elements mark orthographic sentences and
are numbered sequentially
within their parent <gi>div</gi> element
</p>
</segmentation>
<interpretation>
<p>The part of speech analysis applied throughout section 4 was
added by hand and has not been checked.</p>
</interpretation>
<correction>
<p>Errors in transcription controlled by using the
WordPerfect spelling checker.</p>
</correction>
<normalization source="http://szotar.sztaki.hu/webster/">
<p>All words converted to Modern American spelling following
Websters 9th Collegiate dictionary.</p>
</normalization>
<quotation marks="all">
<p>All opening quotation marks represented by entity reference
<ident type="ge">odq</ident>; all closing quotation marks
represented by entity reference <ident type="ge">cdq</ident>.</p>
</quotation>
</editorialDecl>
An editorial practices declaration which applies to more than one text or division of a text need not be repeated in the header of each such text. Instead, the decls attribute of each text (or subdivision of the text) to which it applies may be used to supply a cross-reference to it, as further described in section 16.3 Associating Contextual Information with a Text.
TEI: The Tagging Declaration⚓︎2.3.4 The Tagging Declaration
The tagsDecl element is used to record the following information about the tagging used within a particular document:
- the namespace to which elements appearing within the transcribed text belong.
- how often particular elements appear within the text, so that a recipient can validate the integrity of a text during interchange.
- any comment relating to the usage of particular elements not specified elsewhere in the header.
- a default rendition applicable to all instances of an element.
This information is conveyed by the following elements:
- rendition (rendu) donne des informations sur le rendu ou sur l'apparence d'un ou de plusieurs
éléments dans le texte source.
selector contains a selector or series of selectors specifying the elements to which the contained style description applies, expressed in the language specified in the scheme attribute. - att.styleDef provides attributes to specify the name of a formal definition language used to provide
formatting or rendition information.
scheme identifie la langue employée pour décrire le rendu schemeVersion supplies a version number for the style language provided in scheme. - namespace (espace de noms) fournit le nom formel de l'espace de noms auquel appartiennent les éléments documentés par ses éléments fils.
- tagUsage (usage des balises) donne des informations sur l’utilisation d’un élément spécifique dans un texte.
The tagsDecl element is descriptive, rather than prescriptive: if used, it simply documents practice in the TEI document containing it. The elements constituting a TEI customization file (discussed in chapter 23 Documentation Elements) by contrast document expected practice in a number of documents, and may thus be used prescriptively. If there is an inconsistency between the actual state of a document and what is documented by its tagsDecl, then the latter should be corrected. If there is an inconsistency between a document and what is required by the customization file, or a schema derived from it, then it will usually be the document that requires correction.
The tagsDecl element consists of an optional sequence of rendition elements, each of which must bear a unique identifier, followed by an optional sequence of one or more namespace elements, each of which contains a series of tagUsage elements, up to one for each element type from that namespace occurring within the associated text element. Note that these tagUsage elements must be nested within a namespace element, and cannot appear directly within the tagsDecl element.
TEI: Rendition⚓︎2.3.4.1 Rendition
The rendition element allows the encoder to specify how one or more elements are rendered in the original source in any of the following ways:
- using an informal prose description
- using a standard stylesheet language such as CSS or XSL-FO
- using a project-defined formal language
One or more such specifications may be associated with elements of a document in two ways:
- the selector attribute on any rendition element may be used to select a collection of elements to which it applies
- the global rendition attribute may be used on any element to indicate its rendition, overriding or complementing any supplied default value
The global rend and style attributes may also be used to describe the rendering of an element. See further 1.3.1.1.3 Rendition Indicators.
The content of a rendition element may describe the appearance of the source material using prose, a project-defined formal language, or any standard languages such as the Cascading Stylesheet Language (Bos et al. (eds.) (2011)) or the XML vocabulary for specifying formatting semantics which forms a part of the W3C's Extensible Stylesheet Language (Berglund (ed.) (2006)). A styleDefDecl element (2.3.5 The Default Style Definition Language Declaration) may be supplied within the encodingDesc to specify which of these applies by default, and it may be overridden for one or more specific rendition elements using the scheme attribute.
font-size: 110%;
margin-top: 0.5em;
margin-bottom: 0.5em;
</rendition>
font-size: 100%;
margin-top: 0;
margin-bottom: 0;
</rendition>
In the following extended example we consider how to capture the appearance of a typical early 20th century titlepage, such as that in the following figure:
![](Images/HDswinburne.jpg)
Elements for the encoding of the information on a titlepage are presented in 4.6 Title Pages; here we consider how we might go about encoding some of the visual information as well, using the rendition element and its corresponding attributes.
schemeVersion="2.1"/>
<!-- ... -->
<tagsDecl>
<rendition xml:id="center">text-align: center;</rendition>
<rendition xml:id="small">font-size: small;</rendition>
<rendition xml:id="large">font-size: large;</rendition>
<rendition xml:id="x-large">font-size: x-large;</rendition>
<rendition xml:id="xx-large">font-size: xx-large</rendition>
<rendition xml:id="expanded">letter-spacing: +3pt;</rendition>
<rendition xml:id="x-space">line-height: 150%;</rendition>
<rendition xml:id="xx-space">line-height: 200%;</rendition>
<rendition xml:id="red">color: red;</rendition>
</tagsDecl>
<docTitle rendition="#center #x-space">
<titlePart>
<lb/>
<hi rendition="#x-large">THE POEMS</hi>
<lb/>
<hi rendition="#small">OF</hi>
<lb/>
<hi rendition="#red #xx-large">ALGERNON CHARLES SWINBURNE</hi>
<lb/>
<hi rendition="#large #xx-space">IN SIX VOLUMES</hi>
</titlePart>
<titlePart rendition="#xx-space">
<lb/> VOLUME I.
<lb/>
<hi rendition="#red #x-large">POEMS AND BALLADS</hi>
<lb/>
<hi rendition="#x-space">FIRST SERIES</hi>
</titlePart>
</docTitle>
<docImprint rendition="#center">
<lb/>
<pubPlace rendition="#xx-space">LONDON</pubPlace>
<lb/>
<publisher rendition="#red #expanded">CHATTO & WINDUS</publisher>
<lb/>
<docDate when="1904" rendition="#small">1904</docDate>
</docImprint>
</titlePage>
When CSS is used as the style definition language, the scope attribute may be used to specify CSS pseudo-elements. These pseudo-elements are used
to specify styling applicable to only a portion of the given text. For example, the
first-letter
pseudo-element defines styling to be applied to the first letter in the targeted
element, while the before
and after
pseudo-elements can be used often in conjunction with the "content" property to add
additional characters which need to be added before or after the element content to
make it more closely resemble the appearance of the source.
scheme="css" scope="before">content:
'“';</rendition>
<rendition xml:id="quoteAfter" scheme="css"
scope="after">content:
'”';</rendition>
quoteBefore
and quoteAfter
. Where a q element is actually rendered in the source with initial and final quotation marks,
it may then be encoded as follows:
TEI: Tag Usage⚓︎2.3.4.2 Tag Usage
As noted above, each namespace element, if present, should contain up to one occurrence of a tagUsage element for each element type from the given namespace that occurs within the outermost text element associated with the teiHeader in which it appears.7 The tagUsage element may be used to supply a count of the number of occurrences of this element within the text, which is given as the value of its occurs attribute. It may also be used to hold any additional usage information, which is supplied as running prose within the element itself.
</tagUsage>
(1734) edition only </tagUsage>
The content of the tagUsage element is not susceptible of automatic processing. It should not therefore be used to hold information for which provision is already made by other components of the encoding description. A TEI-conformant document is not required to provide any tagUsage elements or occurs attributes, but if it does, then the counts provided must correspond with the number of such elements present in the associated text.
TEI: The Default Style Definition Language Declaration⚓︎2.3.5 The Default Style Definition Language Declaration
The content of the rendition element, the value of its selector attribute, and the value of the style attribute are expressed using one of a small number of formally defined style definition languages. For ease of processing, it is strongly recommended to use a single such language throughout an encoding project, although the TEI system permits a mixture.
The element styleDefDecl, a sibling of the tagsDecl element, is used to supply the name of the default style definition language. The name is supplied as the value of the scheme attribute and may take any of the following values:
- free
- Informal free text description
- css
- Cascading Stylesheet Language
- xslfo
- Extensible Stylesheet Language Formatting Objects
- other
- A user-defined formal description language
. The schemeVersion attribute may be used to supply the precise version of the style definition language used, and the content of this element, if any, may supply additional information.
When the style attribute is used, its value must always be expressed using whichever default style definition language is in force. If more than one occurrence of the styleDefDecl is provided, there will be more than one default available, and the decls attribute must be used to select which is applicable in a given context, as discussed in section 16.3 Associating Contextual Information with a Text.
TEI: The Reference System Declaration⚓︎2.3.6 The Reference System Declaration
The refsDecl element is used to document the way in which any standard referencing scheme built into the encoding works.
- refsDecl (Déclaration du système de références) précise la manière dont les références canoniques ont été construites pour ce texte.
It may contain either a series of prose paragraphs or the following specialized elements:
- citeStructure (citation structure) declares a structure and method for citing the current document.
- cRefPattern (Modèle de référence canonique) spécifie un modèle d’expression et des règles de remplacement pour transformer une référence canonique en URI.
- refState (état de la référence) spécifie un composant d’une référence canonique définie par la méthode du bornage.
- att.patternReplacement provides attributes for regular-expression matching and replacement.
matchPattern specifies a regular expression against which the values of other attributes can be matched. replacementPattern spécifie une ‘règle de remplacement’ qui, après avoir opéré les substitutions prévues à chaque nœud, génère une URI. - att.citeStructurePart provides attributes for selecting particular elements within a document.
use (use) supplies an XPath selection pattern using the syntax defined in Kay (ed.) (2017). The XPath pattern is relative to the context given in match, which will either be a sibling attribute in the case of <citeStructure> or on the parent <citeStructure> in the case of <citeData>.
Note that not all possible referencing schemes are equally easily supported by current software systems. A choice must be made between the convenience of the encoder and the likely efficiency of the particular software applications envisaged, in this context as in many others. For a more detailed discussion of referencing systems supported by these Guidelines, see section 3.11 Reference Systems below.
A referencing scheme may be described in one of four ways using this element:
- as a prose description
- as nested set of citation structure declarations
- as a series of pairs of regular expressions and XPaths
- as a concatenation of sequentially organized milestones
Each method is described in more detail below. Only one method can be used within a single refsDecl element.
More than one refsDecl element can be included in the header if more than one canonical reference scheme is to be used in the same document, but the current proposals do not check for mutual inconsistency.
TEI: Prose Method⚓︎2.3.6.1 Prose Method
The referencing scheme may be specified within the refsDecl by a simple prose description. Such a description should indicate which elements carry identifying information, and whether this information is represented as attribute values or as content. Any special rules about how the information is to be interpreted when reading or generating a reference string should also be specified here. Such a prose description cannot be processed automatically, and this method of specifying the structure of a canonical reference system is therefore not recommended for automatic processing.
<p>The <att>n</att> attribute of each text in this corpus carries a
unique identifying code for the whole text. The title of the text is
held as the content of the first <gi>head</gi> element within each
text. The <att>n</att> attribute on each <gi>div1</gi> and
<gi>div2</gi> contains the canonical reference for each such
division, in the form 'XX.yyy', where XX is the book number in Roman
numerals, and yyy the section number in arabic. Line breaks are
marked by empty <gi>lb</gi> elements, each of which includes the
through line number in Casaubon's edition as the value of its
<gi>n</gi> attribute.</p>
<p>The through line number and the text identifier uniquely identify
any line. A canonical reference may be made up by concatenating the
<gi>n</gi> values from the <gi>text</gi>, <gi>div1</gi>, or
<gi>div2</gi> and calculating the line number within each part.</p>
</refsDecl>
TEI: Search-and-Replace Method⚓︎2.3.6.2 Search-and-Replace Method
This method often requires a significant investment of effort initially, but permits extremely flexible addressing. For details, see section 17.2.5 Canonical References.
- cRefPattern (Modèle de référence canonique) spécifie un modèle d’expression et des règles de remplacement pour transformer une référence canonique en URI.
TEI: Milestone Method⚓︎2.3.6.3 Milestone Method
This method is appropriate when only ‘milestone’ tags (see section 3.11.3 Milestone Elements) are available to provide the required referencing information. It does not provide any abilities which cannot be mimicked by the search-and-replace referencing method discussed in the previous section, but in the cases where it applies, it provides a somewhat simpler notation.
A reference based on milestone tags concatenates the values specified by one or more such tags. Since each tag marks the point at which a value changes, it may be regarded as specifying the refState of a variable. A reference declaration using this method therefore specifies the individual components of the canonical reference as a sequence of refState elements:
- refState (état de la référence) spécifie un composant d’une référence canonique définie par
la méthode du bornage.
delim (délimiteur) fournit une suite de caractères de délimitation après le composant de référence. length spécifie la longueur fixe du composant de la référence. - att.milestoneUnit provides attributes to indicate the type of section which is changing at a specific
milestone.
unit fournit un nom conventionnel pour le type de section qui change à partir de cette balise de bornage Les valeurs suggérées comprennent: 1] page; 2] column; 3] line; 4] book; 5] poem; 6] canto; 7] speaker; 8] stanza; 9] act; 10] scene; 11] section; 12] absent; 13] unnumbered
For example, the reference ‘Matthew 12:34’ might be thought of as representing the state of three variables: the book variable is in state ‘Matthew’; the chapter variable is in state ‘12’, and the verse variable is in state ‘34’. If milestone tagging has been used, there should be a tag marking the point in the text at which each of the above ‘variables’ changes its state.8 To find ‘Matthew 12:34’ therefore an application must scan left to right through the text, monitoring changes in the state of each of these three variables as it does so. When all three are simultaneously in the required state, the desired point will have been reached. There may of course be several such points.
The delim and length attributes are used to specify components of a canonical reference using this method in exactly the same way as for the stepwise method described in the preceding section. The other attributes are used to determine which instances of milestone tags in the text are to be checked for state-changes. A state-change is signalled whenever a new milestone tag is found with unit and, optionally, ed attributes identical to those of the refState element in question. The value for the new state may be given explicitly by the n attribute on the milestone element, or it may be implied, if the n attribute is not specified.
<refState ed="first" unit="page" length="2"
delim="."/>
<refState ed="first" unit="line" length="3"/>
</refsDecl>
The milestone referencing scheme, though conceptually simple, is not supported by a generic XML parser. Its use places a correspondingly greater burden of verification and accuracy on the encoder.
A reference system declaration which applies to more than one text or division of a text need not be repeated in the header of each such text. Instead, the decls attribute of each text (or subdivision of the text) to which the declaration applies may be used to supply a cross-reference to it, as further described in section 16.3 Associating Contextual Information with a Text.
TEI: The Classification Declaration⚓︎2.3.7 The Classification Declaration
- classDecl (déclaration de classification) contient une ou plusieurs taxinomies définissant les codes de classification utilisés n’importe où dans le texte.
- taxonomy (taxinomie) définit une typologie soit implicitement au moyen d’une référence bibliographique, soit explicitement au moyen d’une taxinomie structurée.
- category (catégorie) contient une catégorie descriptive particulière, éventuellement intégrée dans une catégorie de niveau supérieur, à l’intérieur d’une taxinomie définie par l’utilisateur.
- catDesc (Description de la catégorie) décrit une catégorie particulière à l’intérieur d’une taxinomie ou d’une typologie de texte, sous forme d’un court texte descriptif suivi ou dans les termes des paramètres contextuels utilisés dans l’élément Description du texte textDesc.
<bibl>
<title>Dewey Decimal Classification</title>
<edition>Abridged Edition 12</edition>
</bibl>
</taxonomy>
<bibl>Brown Corpus</bibl>
<category xml:id="b.a">
<catDesc>Press Reportage</catDesc>
<category xml:id="b.a1">
<catDesc>Daily</catDesc>
</category>
<category xml:id="b.a2">
<catDesc>Sunday</catDesc>
</category>
<category xml:id="b.a3">
<catDesc>National</catDesc>
</category>
<category xml:id="b.a4">
<catDesc>Provincial</catDesc>
</category>
<category xml:id="b.a5">
<catDesc>Political</catDesc>
</category>
<category xml:id="b.a6">
<catDesc>Sports</catDesc>
</category>
</category>
<category xml:id="b.d">
<catDesc>Religion</catDesc>
<category xml:id="b.d1">
<catDesc>Books</catDesc>
</category>
<category xml:id="b.d2">
<catDesc>Periodicals and tracts</catDesc>
</category>
</category>
</taxonomy>
<category xml:id="poe">
<catDesc>Poetry</catDesc>
<category xml:id="sonn">
<catDesc>Sonnet</catDesc>
<category xml:id="shakesSonn">
<catDesc>Shakespearean Sonnet</catDesc>
</category>
<category xml:id="petraSonn">
<catDesc>Petrarchan Sonnet</catDesc>
</category>
</category>
<category xml:id="met">
<catDesc>Metrical Categories</catDesc>
<category xml:id="ft">
<catDesc>Metrical Feet</catDesc>
<category xml:id="iamb">
<catDesc>Iambic</catDesc>
</category>
<category xml:id="troch">
<catDesc>trochaic</catDesc>
</category>
</category>
<category xml:id="ftNm">
<catDesc>Number of feet</catDesc>
<category xml:id="penta">
<catDesc>>Pentameter</catDesc>
</category>
<category xml:id="tetra">
<catDesc>>Tetrameter</catDesc>
</category>
</category>
</category>
</category>
</taxonomy>
<!-- elsewhere in document -->
<lg ana="#shakesSonnet #iamb #penta">
<l>Shall I compare thee to a summer's day</l>
<!-- ... -->
</lg>
<catDesc xml:lang="pl">literatura piękna</catDesc>
<catDesc xml:lang="en">fiction</catDesc>
<category xml:id="litProza">
<catDesc xml:lang="pl">proza</catDesc>
<catDesc xml:lang="en">prose</catDesc>
</category>
<category xml:id="litPoezja">
<catDesc xml:lang="pl">poezja</catDesc>
<catDesc xml:lang="en">poetry</catDesc>
</category>
<category xml:id="litDramat">
<catDesc xml:lang="pl">dramat</catDesc>
<catDesc xml:lang="en">drama</catDesc>
</category>
</category>
TEI: The Geographic Coordinates Declaration⚓︎2.3.8 The Geographic Coordinates Declaration
The following element is provided to indicate (within the header of a document, or in an external location) that a particular coordinate notation, or a particular datum, has been employed in a text. The default notation is a string containing two real numbers separated by whitespace, of which the first indicates latitude and the second longitude according to the 1984 World Geodetic System (WGS84).
- geoDecl (déclaration de coordonnées géographiques.) documente la notation et les données
utilisées pour exprimer les coordonnées géographiques dans l'élément geoailleurs dans le document.
datum donne un nom de code d'usage général pour les données employées. Les valeurs suggérées comprennent: 1] WGS84 (World Geodetic System); 2] MGRS (Military Grid Reference System); 3] OSGB36 (ordnance survey great britain); 4] ED50 (European Datum coordinate system)
TEI: The Unit Declaration⚓︎2.3.9 The Unit Declaration
When documents feature units of measurement that are not listed in the International System of Units, the unitDecl element may be used in the encoding description to provide definitions and information about their origins and equivalents.
- unitDecl (unit declarations) provides information about units of measurement that are not members of the International System of Units.
The unitDecl contains one or more unitDef child elements that serve to describe units of measure which may be marked in unit elements within the text.
- unitDef (unit definition) contains descriptive information related to a specific unit of measurement.
- unit contains a symbol, a word or a phrase referring to a unit of measurement in any kind of formal or informal system.
- conversion defines how to calculate one unit of measure in terms of another.
fromUnit indicates a source unit of measure that is to be converted into another unit indicated in toUnit. toUnit the target unit of measurement for a conversion from a source unit referenced in fromUnit. from [att.datable.w3c] indique le point de départ d'une période sous une forme normalisée, par ex. aaaa-mm-jj to [att.datable.w3c] indique le terme de la période sous une forme normalisée, par ex. aaaa-mm-jj notBefore [att.datable.w3c] spécifie la date la plus ancienne pour l'événement sous une forme normalisée, par ex. aaaa-mm-jj notAfter [att.datable.w3c] spécifie la date la plus récente possible pour l'événement sous une forme normalisée, par ex. aaaa-mm-jj when [att.datable.w3c] spécifie une date exacte pour un événement sous une forme normalisée, par ex. aaaa-mm-jj. - att.formula provides attributes for defining a mathematical formula.
formula A formula is provided to describe a mathematical calculation such as a conversion between measurement systems. - att.locatable provides attributes for referencing locations by pointing to entries in a canonical
list of places.
where indique une ou plusieurs localisations en pointant vers un élément place ou autre description canonique.
Within the unitDef, a conversion element may be used to store information relating to conversion between units. The conversion element holds a special pair of attributes, fromUnit and toUnit, which serve to indicate the direction of a calculation from one unit of measure (stored in fromUnit) to another (stored in toUnit). A mathematical calculation to define the relation between these units may be stored in formula, as shown in the following examples. The formula attribute takes a value expressed as an XPath expression, for which see Robie et al. (eds.) (2017). Among other things, this means that division must be expressed with ‘div’ as opposed to the more common forward slash (‘/’, U+002F), so as not to be confused with path navigation. The conversion element may also use attributes to store dates and date ranges as well as location(s) that specify when and where a conversion formula was applied.
<unitDecl>
<unitDef xml:id="keel" type="weight">
<label>keel</label>
<placeName ref="#england"/>
<conversion fromUnit="#chalder"
toUnit="#keel" formula="$fromUnit * 20" from="1421"
to="1676"/>
<conversion fromUnit="#chalder"
toUnit="#keel" formula="$fromUnit * 16" from="1676"
to="1824"/>
<desc>Keel was a unit measuring weight of coal. It had been equal to 20 chalders from 1421 to 1676, and it was made to be equivalent to 16 chalders from 1676 to 1824.</desc>
</unitDef>
<unitDef xml:id="chalder" type="weight">
<label>chalder</label>
<placeName ref="#england"/>
<conversion fromUnit="#bushel"
toUnit="#chalder" formula="$fromUnit * 32" from="1421"
to="1676"/>
<conversion fromUnit="#bushel"
toUnit="#chalder" formula="$fromUnit * 36" from="1676"
to="1824"/>
<desc>Chalder was a unit measuring weight of coal. It had been equal to 32 bushels from 1421 to 1676, and it was made to be equivalent to 36 bushels from 1676 to 1824.</desc>
</unitDef>
<unitDef xml:id="bushel" type="weight">
<label>bushel</label>
<placeName ref="#england"/>
<desc>Bushel was a unit measuring weight of coal.</desc>
</unitDef>
</unitDecl>
</encodingDesc>
<unitDecl>
<unitDef xml:id="Celsius"
type="temperature">
<label>Celsius or Centigrade scale</label>
<conversion fromUnit="#Fahrenheit"
toUnit="#Celsius" formula="($fromUnit - 32) * (5 div 9)"/>
<desc>To convert from the Fahrenheit to the Celsius scale, subtract 32 from the Celsius temperature and multiply by 5/9.</desc>
</unitDef>
</unitDecl>
</encodingDesc>
<label xml:lang="ar-Latn-x-ijmes">shunbul</label>
<label xml:lang="ar">شنبل</label>
<conversion formula="$fromUnit * 2.5"
fromUnit="#shunbul" toUnit="#kile" when="1873"
where="#acre #tripoli"/>
<conversion formula="$fromUnit * 2.25"
fromUnit="#shunbul" toUnit="#kile" when="1878"
where="#acre #tripoli"/>
<conversion formula="$fromUnit * 3"
from="1891" fromUnit="#shunbul" to="1910"
toUnit="#kile" where="#aleppo"/>
<conversion formula="$fromUnit * 2.5"
fromUnit="#shunbul" toUnit="#kile_istanbul" when="1860"
where="#aleppo"/>
<conversion formula="$fromUnit * 72"
fromUnit="#shunbul" toUnit="#madd" when="1893"
where="#damascus"/>
<desc xml:lang="en">The <foreign xml:lang="ar-Latn-x-ijmes">shunbul</foreign> was the main unit to measure grain in the Northern parts of Greater Syria.</desc>
</unitDef>
TEI: The Schema Specification⚓︎2.3.10 The Schema Specification
The schemaSpec element contains a schema specification. When this element appears inside encodingDesc, it allows embedding of a TEI ODD customization file inside a TEI header; alternatively, this element may be used in the body of an ODD document. The use of ODD files, and their relationship to schemas, is described in detail in 23 Documentation Elements.
<!-- Other encoding description elements... -->
<schemaSpec ident="myTEICustomization"
docLang="en" prefix="tei_" xml:lang="en" source="#NONE">
<moduleRef key="core"/>
<moduleRef key="tei"/>
<moduleRef key="header"/>
<moduleRef key="textstructure"/>
</schemaSpec>
</encodingDesc>
url="http://www.tei-c.org/release/xml/tei/custom/odd/tei_lite.odd"/>
<schemaRef type="interchangeRNG"
url="http://www.tei-c.org/release/xml/tei/custom/odd/tei_lite.rng"/>
<schemaRef type="projectODD"
url="file:///schema/project.odd"/>
TEI: The Application Information Element⚓︎2.3.11 The Application Information Element
It is sometimes convenient to store information relating to the processing of an encoded resource within its header. Typical uses for such information might be:
- to allow an application to discover that it has previously opened or edited a file, and what version of itself was used to do that;
- to show (through a date) which application last edited the file to allow for diagnosis of any problems that might have been caused by that application;
- to allow users to discover information about an application used to edit the file
- to allow the application to declare an interest in elements of the file which it has edited, so that other applications or human editors may be more wary of making changes to those sections of the file.
The class model.applicationLike provides an element, application, which may be used to record such information within the appInfo element.
- appInfo (informations d'application) enregistre des informations sur l'application qui a été utilisée pour traiter le fichier TEI.
- application fournit des informations sur une application qui a été utilisée pour le traitement
du document.
ident fournit un identifiant pour l'application, indépendamment de son numéro de version ou du nom affiché. version fournit un numéro de version pour l'application, indépendamment de son identifiant ou du nom affiché.
Each application element identifies the current state of one software application with regard to the current file. This element is a member of the att.datable class, which provides a variety of attributes for associating this state with a date and time, or a temporal range. The ident and version attributes should be used to uniquely identify the application and its major version number (for example, ImageMarkupTool 1.5). It is not intended that an application should add a new application each time it touches the file.
<application version="1.5"
ident="ImageMarkupTool" notAfter="2006-06-01">
<label>Image Markup Tool</label>
<ptr target="#P1"/>
<ptr target="#P2"/>
</application>
</appInfo>
TEI: Module-Specific Declarations⚓︎2.3.12 Module-Specific Declarations
The elements discussed so far are available to any schema. When the schema in use includes some of the more specialized TEI modules, these make available other more module-specific components of the encoding description. These are discussed fully in the documentation for the module in question, but are also noted briefly here for convenience.
The fsdDecl element is available only when the iso-fs module is included in a schema. Its purpose is to document the feature system declaration (as defined in chapter 19.11 Feature System Declaration) underlying any analytic feature structures (as defined in chapter 19 Feature Structures) present in the text documented by this header.
The metDecl element is available only when the verse module is included in a schema. Its purpose is to document any metrical notation scheme used in the text, as further discussed in section 6.4 Rhyme and Metrical Analysis. It consists either of a prose description or a series of metSym elements.
The variantEncoding element is available only when the textcrit module is included in a schema. Its purpose is to document the method used to encode textual variants in the text, as discussed in section 13.2 Linking the Apparatus to the Text.
TEI: The Profile Description⚓︎2.4 The Profile Description
The profileDesc element is the third major subdivision of the TEI header. It is an optional element, the purpose of which is to enable information characterizing various descriptive aspects of a text or a corpus to be recorded within a single unified framework.
- profileDesc (description du profil) fournit une description détaillée des aspects non bibliographiques du texte, notamment les langues utilisées et leurs variantes, les circonstances de sa production, les collaborateurs et leur statut.
In principle, almost any component of the header might be of importance as a means of characterizing a text. The author of a written text, its title or its date of publication, may all be regarded as characterizing it at least as strongly as any of the parameters discussed in this section. The rule of thumb applied has been to exclude from discussion here most of the information which generally forms part of a standard bibliographic style description, if only because such information has already been included elsewhere in the TEI header.
The profileDesc element contains elements taken from the model.profileDescPart class. The default members of this class are the following :
- abstract contains a summary or formal abstract prefixed to an existing source document by the encoder.
- creation (création) contient des informations concernant la création d’un texte.
- langUsage (langue utilisée) décrit les langues, variétés de langues, registres, dialectes, etc. présents à l’intérieur d’un texte.
- textClass (classification du texte) regroupe des informations décrivant la nature ou le sujet d’un texte selon des termes issus d’un système de classification standardisé, d’un thésaurus, etc.
- correspDesc (correspondence description) contains a description of the actions related to one act of correspondence.
- calendarDesc (description des calendriers) contient la description des différents calendriers utilisés dans des dates écrits dans un manuscrit.
These elements are further described in the remainder of this section.
When the corpus module described in chapter 16 Language Corpora is included in a schema, three further elements become available within the profileDesc element:
- textDesc (description de texte) fournit la description d'un texte sous l'angle du contexte situationnel
- particDesc (description des participants) décrit les locuteurs, voix ou autres participants identifiables d'une interaction linguistique.
- settingDesc (description du contexte) décrit le(s) contexte(s) dans lesquels se situe une interaction linguistique, soit sous la forme d'une description en prose, soit sous celle d'une série d'éléments décrivant le contexte.
For descriptions of these elements, see section 16.2 Contextual Information.
When the transcr module for the transcription of primary sources described in chapter 12 Representation of Primary Sources is included in a schema, the following elements become available within the profileDesc element:
- handNotes contient un ou plusieurs éléments handNote qui documentent les différentes mains identifiées dans les textes source.
- listTranspose supplies a list of transpositions, each of which is indicated at some point in a document typically by means of metamarks.
For a description of the handNotes element, see section 12.3.2.1 Document Hands. Its purpose is to group together a number of handNote elements, each of which describes a different hand or equivalent identified within a manuscript. The handNote element can also appear within a structured manuscript description, when the msdescription module described in chapter 11 Manuscript Description is included in a schema. For this reason, the handNote element is actually declared within the header module, but is only accessible to a schema when one or other of the transcr or msdescription modules is included in a schema. See further the discussion at 12.3.2.1 Document Hands.
The listTranspose element is discussed in detail in section 12.3.4.5 Transpositions.
TEI: Creation⚓︎2.4.1 Creation
- creation (création) contient des informations concernant la création d’un texte.
<date when="1992-08">August 1992</date>
<rs type="city">Taos, New Mexico</rs>
</creation>
TEI: Language Usage⚓︎2.4.2 Language Usage
The langUsage element is used within the profileDesc element to describe the languages, sublanguages, registers, dialects, etc. represented within a text. It contains one or more language elements, each of which provides information about a single language, notably the quantity of that language present in the text. Note that this element should not be used to supply information about any non-standard characters or glyphs used by this language; such information should be recorded in the charDecl element in the encoding description (see further 5 Characters, Glyphs, and Writing Modes).
- langUsage (langue utilisée) décrit les langues, variétés de langues, registres, dialectes, etc. présents à l’intérieur d’un texte.
- language (langue) caractérise une langue ou une variété de langue utilisée dans un texte.
usage précise approximativement le pourcentage du volume de texte utilisant cette langue. ident (identificateur) fournit un code de langue issu de la recommandation BCP 47 (ou son successeur) utilisé pour identifier la langue précisée par cet élément, référencé par l’attribut global xml:lang s’appliquant à l’élément considéré.
A language element may be supplied for each different language used in a document. If used, its ident attribute should specify an appropriate language identifier, as further discussed in section vi.1. Language Identification. This is particularly important if extended language identifiers have been used as the value of xml:lang attributes elsewhere in the document.
<language ident="fr-CA" usage="60">Québecois</language>
<language ident="en-CA" usage="20">Canadian business English</language>
<language ident="en-GB" usage="20">British English</language>
</langUsage>
TEI: The Text Classification⚓︎2.4.3 The Text Classification
The textClass element is used to classify a text in some way.
- textClass (classification du texte) regroupe des informations décrivant la nature ou le sujet d’un texte selon des termes issus d’un système de classification standardisé, d’un thésaurus, etc.
Text classification may be carried out according to one or more of the following methods:
- by reference to a recognized international classification such as the Dewey Decimal Classification, the Universal Decimal Classification, the Colon Classification, the Library of Congress Classification, or any other system widely used in library and documentation work
- by providing a set of keywords, as provided for example by British Library or Library of Congress Cataloguing in Publication data
- by referencing any other taxonomy of text categories recognized in the field concerned, or peculiar to the material in hand; this may include one based on recurring sets of values for the situational parameters defined in section 16.2.1 The Text Description, or the demographic elements described in section 16.2.2 The Participant Description
The last of these may be particularly important for dealing with existing corpora or collections, both as a means of avoiding the expense or inconvenience of reclassification and as a means of documenting the organizing principles of such materials.
The following elements are provided for this purpose:
- keywords (mot clé) contient une liste de mots clés ou d’expressions décrivant la nature ou
le sujet d’un texte.
scheme désigne la liste close de mots dans lequel l'ensemble des mots-clés concernés est défini. - classCode (code de classification) contient le code de classification attribué à ce texte en
référence à un système standard de classification.
scheme identifie le système de classification ou la taxinomie utilisée. - catRef (référence à la catégorie) spécifie une ou plusieurs catégories définies dans une taxinomie ou une typologie textuelle.
The keywords element simply categorizes an individual text by supplying a list of keywords which may describe its topic or subject matter, its form, date, etc. In some schemes, the order of items in the list is significant, for example, from major topic to minor; in others, the list has an organized substructure of its own. No recommendations are made here as to which method is to be preferred. Wherever possible, such keywords should be taken from a recognized source, such as the British Library/Library of Congress Cataloguing in Publication data in the case of printed books, or a published thesaurus appropriate to the field.
<term>Babbage, Charles</term>
<term>Mathematicians - Great Britain - Biography</term>
</keywords>
<term>English literature -- History and criticism -- Data processing.</term>
<term>English literature -- History and criticism -- Theory, etc.</term>
<term>English language -- Style -- Data processing.</term>
<term>Style, Literary -- Data processing.</term>
</keywords>
<term>ceremonials</term>
<term>fairs</term>
<term>street life</term>
</keywords>
<!-- elsewhere in the document -->
<taxonomy xml:id="welch">
<bibl>
<title>Notes on London Municipal Literature, and a Suggested
Scheme for Its Classification</title>
<author>Charles Welch</author>
<edition>1895</edition>
</bibl>
</taxonomy>
If no authority file exists, perhaps because the keywords used were assigned directly by an author, the scheme attribute should be omitted.
Alternatively, if the keyword vocabulary itself is locally defined, the scheme attribute will point to the local definition, which will typically be held in a taxonomy element within the classDecl part of the encoding description (see section 2.3.7 The Classification Declaration).
The catRef element categorizes an individual text by pointing to one or more category elements using the target attribute, which it inherits from the att.pointing class. The category element (which is fully described in section 2.3.7 The Classification Declaration) holds information about a particular classification or category within a given taxonomy. Each such category must have a unique identifier, which may be supplied as the value of the target attribute for catRef elements which are regarded as falling within the category indicated.
scheme="http://www.example.com/browncorpus"/>
<catRef target="http://www.example.com/SUC/#A45"/>
In general, it is a matter of style whether to use a single catRef with multiple identifiers in the value of target or multiple catRef elements, each with a single identifier in the value of target. However, note that maintenance of a TEI document with a large number of values within a single target can be cumbersome.
The distinction between the catRef and classCode elements is that the values used as identifying codes are exhaustively enumerated for the former, typically within the TEI header. In the latter case, however, the values use any externally-defined scheme, and therefore may be taken from a more open-ended descriptive classification system.
TEI: Abstracts⚓︎2.4.4 Abstracts
<abstract>
<p>This paper is a draft studying
various aspects of using the TEI
as a reference serialization framework
for LMF. Comments are welcome to bring
this to a useful document for the
community.
</p>
</abstract>
</profileDesc>
<abstract xml:lang="en">
<p>The recent archaeological emphasis
on the study of settlement patterns,
landscape and palaeoenvironments has
shaped and re-shaped our understanding
of the Viking settlement of Iceland.
This paper reviews the developments
in Icelandic archaeology, examining
both theoretical and practical advances.
Particular attention is paid to new
ideas in terms of settlement patterns
and resource exploitation. Finally,
some of the key studies of the ecological
consequences of the Norse
<foreign xml:lang="is">landnám</foreign>
are presented. </p>
</abstract>
<abstract xml:lang="fr">
<p>L’accent récent des
recherches archéologiques sur l’étude des
configurations spatiales des colonies, de la
géographie des sites ainsi que des éléments
paléo-environnementaux nous mène à réexaminer
et réévaluer nos connaissances acquises sur
la colonisation de l’Islande par les Vikings.
Cet article passe en revue le développement
de l’archéologie islandaise en examinant les
progrès théoriques et pratiques en la matière.
Une attention particulière est portée sur
l’étude des configurations spatiales des
colonies ainsi qu’une considération des
questions d’exploitation des ressources.
Finalement, l’article présente un aperçu des
études principales qui traitent des
conséquences écologiques du
<foreign xml:lang="is">landnám</foreign>
islandais.</p>
</abstract>
</profileDesc>
<abstract>
<list>
<item>An annual HBC supply ship is
set to the North West Coast for mid-September.</item>
<item>
<name key="pelly_jh">Pelly</name> writes
to ascertain the British Government's plans
for the lands associated with the Oregon Treaty;
he wants to know what will happen to the HBC's
establishment on the southern <name type="place"
key="vancouver_island">Vancouver Island</name>.
He adds that a former Crown grant, an 1838 exclusive
trade-grant for the lands in question, has yet to
expire.</item>
<item>The minutes discuss the nature of the HBC's
original entitlements and question whether or not,
and in what capacity, the Oregon Treaty affects the
HBC's position. The majority council further
investigation, and to reply cautiously and
judiciously to the HBC inquiry.</item>
<item>A
summary of a meeting with <name key="pelly_jh">Pelly</name> is offered in
order to elucidate the HBC's intentions.</item>
<item>
<name key="grey_hg">Lord Grey</name> calls
for greater consideration on the issue of
colonization; he asks that <name key="stephen_j">Stephen</name> write the Company,
asking them to detail their intentions, and to
state their legal opinion for entitlement.
</item>
</list>
</abstract>
</profileDesc>
TEI: Calendar Description⚓︎2.4.5 Calendar Description
The calendarDesc element is used within the profileDesc element to document objects referenced by means of either the calendar attribute on date or the datingMethod attribute on any member of the att.datable class.
- calendarDesc (description des calendriers) contient la description des différents calendriers utilisés dans des dates écrits dans un manuscrit.
This element may contain one or more calendar elements:
- calendar (calendrier) describes a calendar or dating system used in a dating formula in the text.
<calendar xml:id="Gregorian" type="actual">
<p>Gregorian calendar</p>
</calendar>
<calendar xml:id="Stardate"
type="fictional">
<p>Fictional Stardate (from Star Trek series)</p>
</calendar>
<calendar xml:id="BP" type="actual">
<p>Calendar years before present (measured from 1950)</p>
</calendar>
</calendarDesc>
to the nearest decimal point</date>...</p>
TEI: Correspondence Description⚓︎2.4.6 Correspondence Description
The correspDesc element is used within the profileDesc element to provide detailed correspondence-specific metadata, concerning in particular the communicative aspects (sending, receiving, forwarding etc.) associated with an act of correspondence.
This information is complementary to the detailed descriptions of physical objects (such as letters) associated with correspondence acts, which are typically provided by the sourceDesc element.
- correspDesc (correspondence description) contains a description of the actions related to one act of correspondence.
The correspDesc element contains the elements correspAction and correspContext, describing the actions identified and the context in which the correspondence occurs respectively.
- correspAction (correspondence action) contains a structured description of the place, the name
of a person/organization and the date related to the sending/receiving of a message
or any other action related to the correspondence.
type describes the nature of the action. - correspContext (correspondence context) provides references to preceding or following correspondence related to this piece of correspondence.
<ref type="prev" target="#CLF0102">Previous letter of <persName>Chamisso</persName> to <persName>de La
Foye</persName>: <date when="1807-01-16">16 January 1807</date>
</ref>
<ref type="next" target="#CLF0104">Next letter of <persName>Chamisso</persName> to <persName>de La Foye</persName>:
<date when="1810-05-07">07 May 1810</date>
</ref>
</correspContext>
Many types of correspondence actions may be distinguished. The type attribute should be used to indicate the type of action being documented, using values such as those suggested above.
<persName>Adelbert von Chamisso</persName>
<placeName>Vertus</placeName>
<date when="1807-01-29"/>
</correspAction>
<correspAction type="received">
<persName>Louis de La Foye</persName>
<placeName>Caen</placeName>
<date>unknown</date>
</correspAction>
<persName>Hermann Hesse</persName>
<persName>Ninon Hesse</persName>
<placeName>Montagnola</placeName>
</correspAction>
<persName>PN0001</persName>
<date when="1999-06-02"/>
</correspAction>
<correspAction type="received" subtype="to">
<persName>PN0002</persName>
</correspAction>
<correspAction type="received" subtype="to">
<persName>PN0003</persName>
</correspAction>
<correspAction type="received" subtype="cc">
<persName>PN0004</persName>
</correspAction>
<correspAction type="sent">
<persName>John Gneisenau Neihardt</persName>
<placeName>Branson (Montgomery)</placeName>
<date when="1932-12-17"/>
</correspAction>
<correspAction type="received">
<persName xml:id="JTH">Julius Temple House</persName>
<placeName>New York</placeName>
</correspAction>
</correspDesc>
<correspDesc xml:id="message2">
<correspAction type="sent">
<persName>Enid Neihardt</persName>
<placeName>Branson (Montgomery)</placeName>
<date when="1932-12-17"/>
</correspAction>
<correspAction type="received">
<persName sameAs="#JTH"/>
<placeName>New York</placeName>
</correspAction>
</correspDesc>
TEI: Non-TEI Metadata⚓︎2.5 Non-TEI Metadata
Projects often maintain metadata about their TEI documents in more than one form or system. For example, a project may have a database of bibliographic information on the set of documents they intend to encode. From this database, both a MARC record and a teiHeader are generated. The document is then encoded, during which process additional information is added to the teiHeader manually. Then, when the document is published on the web, a Dublin Core record is generated for discoverability of the resource. It is sometimes advantageous to store some or all of the non-TEI metadata in the TEI file.
Such non-TEI data may be placed anywhere within a TEI file (other than as the root element), as it does not affect TEI conformance. However, it is easier for humans to manage these kinds of data if they are grouped together in a single location. In addition, such grouping makes it easy to avoid accidentally flagging non-TEI data as errors during validation of the file against a TEI schema. The xenoData element, which may appear in the TEI header after the fileDesc but before the optional revisionDesc, is provided for this purpose. Where the use of xenoData is primarily to store linked data, contextual information, or stand-off annotations that refer to the contents of the TEI file itself, the xenoData element may be placed inside the standOff element instead.
- xenoData (non-TEI metadata) provides a container element into which metadata in non-TEI formats may be placed.
The xenoData element may contain anything except TEI elements. It may contain one or more elements from outside the TEI9 or data in some non-XML text format.10
rdf
is bound to the namespace http://www.w3.org/1999/02/22-rdf-syntax-ns#
, the prefix dc
is bound to the namespace http://purl.org/dc/elements/1.1/
, and the prefix cc
is bound to the namespace http://web.resource.org/cc/
.
<rdf:RDF>
<cc:Work rdf:about="">
<dc:title>Applied Software Project Management - review</dc:title>
<dc:type rdf:resource="http://purl.org/dc/dcmitype/Text"/>
<dc:license rdf:resource="http://creativecommons.org/licenses/by-sa/2.0/uk/"/>
</cc:Work>
<cc:License rdf:about="http://creativecommons.org/licenses/by-sa/2.0/uk/">
<cc:permits rdf:resource="http://web.resource.org/cc/Reproduction"/>
<cc:permits rdf:resource="http://web.resource.org/cc/Distribution"/>
<cc:requires rdf:resource="http://web.resource.org/cc/Notice"/>
<cc:requires rdf:resource="http://web.resource.org/cc/Attribution"/>
<cc:permits rdf:resource="http://web.resource.org/cc/DerivativeWorks"/>
<cc:requires rdf:resource="http://web.resource.org/cc/ShareAlike"/>
</cc:License>
</rdf:RDF>
</xenoData>
TEI: The Revision Description⚓︎2.6 The Revision Description
The final sub-element of the TEI header, the revisionDesc element, provides a detailed change log in which each change made to a text may be recorded. Its use is optional but highly recommended. It provides essential information for the administration of large numbers of files which are being updated, corrected, or otherwise modified as well as extremely useful documentation for files being passed from researcher to researcher or system to system. Without change logs, it is easy to confuse different versions of a file, or to remain unaware of small but important changes made in the file by some earlier link in the chain of distribution. No significant change should be made in any TEI-conformant file without corresponding entries being made in the change log.
- revisionDesc (descriptif des révisions) fournit un résumé de l’historique des révisions d’un fichier.
- listChange groups a number of change descriptions associated with either the creation of a source text or the revision of an encoded text.
- change (change) résume une modification ou une correction apportée à une version particulière d’un texte électronique partagé entre plusieurs chercheurs.
The main purpose of the revision description is to record changes in the text to which a header is prefixed. However, it is recommended TEI practice to include entries also for significant changes in the header itself (other than the revision description itself, of course). At the very least, an entry should be supplied indicating the date of creation of the header.
The log consists of a list of entries, one for each change. Changes may be grouped and organised using either the listChange element described in section 12.7 Identifying Changes and Revisions or the simple list element described in section 3.8 Lists. Alternatively, a simple sequence of change elements may be given. The attributes when and who may be supplied for each change element to indicate its date and the person responsible for it respectively. The description of the change itself can range from a simple phrase to a series of paragraphs. If a number is to be associated with one or more changes (for example, a revision number), the global n attribute may be used to indicate it.
It is recommended to give changes in reverse chronological order, most recent first.
<!-- ... --><revisionDesc>
<change n="RCS:1.39" when="2007-08-08"
who="#jwernimo.lrv">Changed <val>drama.verse</val>
<gi>lg</gi>s to <gi>p</gi>s. <note>we have opened a discussion about the need for a new
value for <att>type</att> of <gi>lg</gi>, <val>drama.free.verse</val>, in order to address
the verse of Behn which is not in regular iambic pentameter. For the time being these
instances are marked with a comment note until we are able to fully consider the best way
to encode these instances.</note>
</change>
<change n="RCS:1.33" when="2007-06-28"
who="#pcaton.xzc">Added <att>key</att> and <att>reg</att>
to <gi>name</gi>s.</change>
<change n="RCS:1.31" when="2006-12-04"
who="#wgui.ner">Completed renovation. Validated.</change>
</revisionDesc>
<title>The Amorous Prince, or, the Curious Husband, 1671</title>
<author>
<persName ref="#abehn.aeh">Behn, Aphra</persName>
</author>
<respStmt xml:id="pcaton.xzc">
<persName>Caton, Paul</persName>
<resp>electronic publication editor</resp>
</respStmt>
<respStmt xml:id="wgui.ner">
<persName>Gui, Weihsin</persName>
<resp>encoder</resp>
</respStmt>
<respStmt xml:id="jwernimo.lrv">
<persName>Wernimont, Jacqueline</persName>
<resp>encoder</resp>
</respStmt>
</titleStmt>
TEI: Minimal and Recommended Headers⚓︎2.7 Minimal and Recommended Headers
The TEI header allows for the provision of a very large amount of information concerning the text itself, its source, its encodings, and revisions of it, as well as a wealth of descriptive information such as the languages it uses and the situation(s) in which it was produced, together with the setting and identity of participants within it. This diversity and richness reflects the diversity of uses to which it is envisaged that electronic texts conforming to these Guidelines will be put. It is emphatically not intended that all of the elements described above should be present in every TEI header.
The amount of encoding in a header will depend both on the nature and the intended use of the text. At one extreme, an encoder may expect that the header will be needed only to provide a bibliographic identification of the text adequate to local needs. At the other, wishing to ensure that their texts can be used for the widest range of applications, encoders will want to document as explicitly as possible both bibliographic and descriptive information, in such a way that no prior or ancillary knowledge about the text is needed in order to process it. The header in such a case will be very full, approximating to the kind of documentation often supplied in the form of a manual. Most texts will lie somewhere between these extremes; textual corpora in particular will tend more to the latter extreme. In the remainder of this section we demonstrate first the minimal, and next a commonly recommended, level of encoding for the bibliographic information held by the TEI header.
<fileDesc>
<titleStmt>
<title>Thomas Paine: Common sense, a
machine-readable transcript</title>
<respStmt>
<resp>compiled by</resp>
<name>Jon K Adams</name>
</respStmt>
</titleStmt>
<publicationStmt>
<distributor>Oxford Text Archive</distributor>
</publicationStmt>
<sourceDesc>
<bibl>The complete writings of Thomas Paine, collected and edited
by Phillip S. Foner (New York, Citadel Press, 1945)</bibl>
</sourceDesc>
</fileDesc>
</teiHeader>
The only mandatory component of the TEI header is the fileDesc element. Within this, titleStmt, publicationStmt, and sourceDesc are all required constituents. Within the title statement, a title is required, and an author should be specified, even if it is unknown, as should some additional statement of responsibility, here given by the respStmt element. Within the publicationStmt, a publisher, distributor, or other agency responsible for the file must be specified. Finally, the source description should contain at the least a loosely structured bibliographic citation identifying the source of the electronic text if (as is usually the case) there is one.
<fileDesc>
<titleStmt>
<title>Common sense, a machine-readable transcript</title>
<author>Paine, Thomas (1737-1809)</author>
<respStmt>
<resp>compiled by</resp>
<name>Jon K Adams</name>
</respStmt>
</titleStmt>
<editionStmt>
<edition>
<date>1986</date>
</edition>
</editionStmt>
<publicationStmt>
<distributor>Oxford Text Archive.</distributor>
<address>
<addrLine>Oxford University Computing Services,</addrLine>
<addrLine>13 Banbury Road,</addrLine>
<addrLine>Oxford OX2 6RB,</addrLine>
<addrLine>UK</addrLine>
</address>
</publicationStmt>
<notesStmt>
<note>Brief notes on the text are in a
supplementary file.</note>
</notesStmt>
<sourceDesc>
<biblStruct>
<monogr>
<editor>Foner, Philip S.</editor>
<title>The collected writings of Thomas Paine</title>
<imprint>
<pubPlace>New York</pubPlace>
<publisher>Citadel Press</publisher>
<date>1945</date>
</imprint>
</monogr>
</biblStruct>
</sourceDesc>
</fileDesc>
<encodingDesc>
<samplingDecl>
<p>Editorial notes in the Foner edition have not
been reproduced. </p>
<p>Blank lines and multiple blank spaces, including paragraph
indents, have not been preserved. </p>
</samplingDecl>
<editorialDecl>
<correction status="high"
method="silent">
<p>The following errors
in the Foner edition have been corrected:
<list>
<item>p. 13 l. 7 cotemporaries contemporaries</item>
<item>p. 28 l. 26 [comma] [period]</item>
<item>p. 84 l. 4 kin kind</item>
<item>p. 95 l. 1 stuggle struggle</item>
<item>p. 101 l. 4 certainy certainty</item>
<item>p. 167 l. 6 than that</item>
<item>p. 209 l. 24 publshed published</item>
</list>
</p>
</correction>
<normalization>
<p>No normalization beyond that performed
by Foner, if any. </p>
</normalization>
<quotation marks="all">
<p>All double quotation marks
rendered with ", all single quotation marks with
apostrophe. </p>
</quotation>
<hyphenation eol="none">
<p>Hyphenated words that appear at the
end of the line in the Foner edition have been reformed.</p>
</hyphenation>
<stdVals>
<p>The values of <att>when-iso</att> on the <gi>time</gi>
element always end in the format <val>HH:MM</val> or
<val>HH</val>; i.e., seconds, fractions thereof, and time
zone designators are not present.</p>
</stdVals>
<interpretation>
<p>Compound proper names are marked. </p>
<p>Dates are marked. </p>
<p>Italics are recorded without interpretation. </p>
</interpretation>
</editorialDecl>
<classDecl>
<taxonomy xml:id="lcsh">
<bibl>Library of Congress Subject Headings</bibl>
</taxonomy>
<taxonomy xml:id="lc">
<bibl>Library of Congress Classification</bibl>
</taxonomy>
</classDecl>
</encodingDesc>
<profileDesc>
<creation>
<date>1774</date>
</creation>
<langUsage>
<language ident="en" usage="100">English.</language>
</langUsage>
<textClass>
<keywords scheme="#lcsh">
<term>Political science</term>
<term>United States -- Politics and government —
Revolution, 1775-1783</term>
</keywords>
<classCode scheme="#lc">JC 177</classCode>
</textClass>
</profileDesc>
<revisionDesc>
<change when="1996-01-22" who="#MSM"> finished proofreading </change>
<change when="1995-10-30" who="#LB"> finished proofreading </change>
<change notBefore="1995-07-04" who="#RG"> finished data entry at end of term </change>
<change notAfter="1995-01-01" who="#RG"> began data entry before New Year 1995 </change>
</revisionDesc>
</teiHeader>
Many other examples of recommended usage for the elements discussed in this chapter are provided here, in the reference index and in the associated tutorials.
TEI: Note for Library Cataloguers⚓︎2.8 Note for Library Cataloguers
A strong motivation in preparing the material in this chapter was to provide in the TEI header a viable chief source of information for cataloguing computer files. The TEI header is not a library catalogue record, and so will not make all of the distinctions essential in standard library work. It also includes much information generally excluded from standard bibliographic descriptions. It is the intention of the developers, however, to ensure that the information required for a catalogue record be retrievable from the TEI file header, and moreover that the mapping from the one to the other be as simple and straightforward as possible. Where the correspondence is not obvious, it may prove useful to consult one of the works which were influential in developing the content of the TEI header. These include:
- ISBD
- ISBD: International Standard Bibliographic Description is an international standard setting out what information should be recorded in a description of a bibliographical item. Until a consolidated edition published in 2011, there was a general standard called ISBD(G) and separate ISBDs covering different types of material, e.g. ISBD(M) for monographs, ISBD(ER) for electronic resources. These separate ISBDs follow the same general scheme as the main ISBD(G), but provide appropriate interpretations for the specific materials under consideration.
- AACR2
- The Anglo-American Cataloguing Rules (second edition) were published in 1978, with revisions appearing periodically through 2005. AACR2 provides guidelines for the construction of catalogues in general libraries in the English-speaking world. AACR2 is explicitly based on the general framework of the ISBD(G) and the subsidiary ISBDs: it gives a description of how to describe bibliographic items and how to create access points such as subject or name headings and uniform titles. Other national cataloguing codes exist as well, including the Z44 series of standards from issued by the Association française de normalisation (AFNOR), Regeln für die alphabetische Katalogisierung in wissenschaftlichen Bibliotheken (RAK-WB), Regole italiane di catalogazione per autore (RICA), and Система стандартов по информации, библиотечному и издательскому делу. Библиографическая запись. Библиографическое описание. Общие требования и правила составления (ГОСТ 7.1).
- ANSI Z39.29
- The American National Standard for Bibliographic References was an American national standard governing bibliographic references for use in bibliographies, end-of-work lists, references in abstracting and indexing publications, and outputs from computerized bibliographic data bases. A revised version is maintained by the National Information Standards Organization (NISO). The related ISO standard is ISO 690. Other relevant national standards include BS 5605:1990, BS 6371:1983, DIN 1505-2, and ГОСТ 7.0.5.
Since the TEI file description elements are based on the ISBD areas, it should be possible to use the content of file description as the basis for a catalog record for a TEI document. However, cataloguers should be aware that the permissive nature of the TEI Guidelines may lead to divergences between practice in using the TEI file description and the comparatively strict recommendations of AACR2 and other national cataloguing codes. Such divergences as the following may preclude automatic generation of catalogue records from TEI headers:
- The TEI Guidelines do not require that text be transcribed from the ‘chief source of information’ using normalized capitalization and punctuation .
- The TEI title statement may not categorize constituent titles in the same way as prescribed by a national cataloguing code.
- The TEI title statement contains authors, editors, and other responsible parties in separate elements, with names which may not have been normalized; it does not necessarily contain a single statement of responsibility .
- There is no specific place in a TEI header to specify the main entry or added entries (name or title headings under which a catalogue record is filed) for the catalogue record.
- The TEI header does not require use of a particular vocabulary for subject headings nor require the use of subject headings.
TEI: The TEI Header Module⚓︎2.9 The TEI Header Module
The module described in this chapter makes available the following components:
- Module header: En-tête TEI
-
- Eléments définis: abstract appInfo application authority availability biblFull cRefPattern calendar calendarDesc catDesc catRef category change citeData citeStructure classCode classDecl conversion correction correspAction correspContext correspDesc creation distributor edition editionStmt editorialDecl encodingDesc extent fileDesc funder geoDecl handNote hyphenation idno interpretation keywords langUsage language licence listChange listPrefixDef namespace normalization notesStmt prefixDef principal profileDesc projectDesc publicationStmt punctuation quotation refState refsDecl rendition revisionDesc samplingDecl schemaRef scriptNote segmentation seriesStmt sourceDesc sponsor stdVals styleDefDecl tagUsage tagsDecl taxonomy teiHeader textClass titleStmt unitDecl unitDef xenoData
- Classes définies: att.citeStructurePart att.patternReplacement
The selection and combination of modules to form a TEI schema is described in 1.2 Defining a TEI Schema.
<
and &
respectively. See Character References.