provides attributes that can be used to associate a representation such as a name or title with canonical information about the object being named or referenced. fournit des attributs qui peuvent être utilisés pour associer une représentation telle qu'un nom ou un titre à l'information canonique concernant l'objet nommé ou auquel il est fait référence. 名前やタイトルのような表現を参照対象についての典拠情報と関連付けるのに利用する属性を提供する。 provides an externally-defined means of identifying the entity (or entities) being named, using a coded value of some kind. fournit un moyen, défini de façon externe, d'identifier l'entité (ou les entités) nommé(es), en utilisant une valeur codée d'un certain type. 何らかのコード化された値を用いて、名付けられたエンティティを識別する外部的に定義された手段を提供する。 Victor Hugo

The value may be a unique identifier from a database, or any other externally-defined string identifying the referent. No particular syntax is proposed for the values of the key attribute, since its form will depend entirely on practice within a given project.

La valeur peut être un identifiant unique dans une base de données, ou toute autre chaîne définie de façon externe identifiant le référent.

値はデータベースにおけるユニークな識別子や、外部で定義された指示対象を特定するなんらかの文字列であってよい。key属性の値に関してさだまった構文は提案されていない。なぜならば、それぞれのプロジェクトのやりかたに完全に依存するからである。同様の理由によって、データの相互交換においてこの属性は推奨されない。在るプロジェクトで用いられた値が他のプロジェクトの値と異なることを保証できないからである。そのような場面における魔法石的対処は、RFC4151に定義されるタグURIを値とするref属性を用いて、標準的なウェブにおける習慣にしたがってmagic tokenを使うことである。

reference référence 参照 provides an explicit means of locating a full definition or identity for the entity being named by means of one or more URIs. fournit un moyen explicite de localiser une définition complète de l'entité nommée au moyen d'un ou plusieurs URIs. 一つ以上のURIを用いて、名付けられたエンティティの完全な定義かIDを参照するための明確な手段を提供する。 Seamus Heaney

The value must point directly to one or more XML elements or other resources by means of one or more URIs, separated by whitespace. If more than one is supplied the implication is that the name identifies several distinct entities.

La valeur doit pointer directement vers un ou plusieurs éléments XML au moyen d'un ou plusieurs URIs, séparés par un espace. Si plus d'un URI est fourni, cela implique que le nom identifie plusieurs entités distinctes.

値は1つまたは複数のXML要素あるいは、空白によって区切られた1つまたは複数のURIを指し示すものでなければならない。1つ以上の値が与えられているときは、その名前が複数の異るエンティティに対応することを示唆する。

In this contrived example, a canonical reference to the same organisation is provided in four different ways.

New Zealand Parliament, Legislative Council New Zealand Parliament, Legislative Council New Zealand Parliament, Legislative Council New Zealand Parliament, Legislative Council

The first presumes the availability of an internet connection and a processor that can resolve a URI (most can). The second requires, in addition, a prefixDef that declares how the nzvm prefix should be interpreted. The third does not require an internet connection, but does require that a file named named_entities.xml be in the same directory as the TEI document. The fourth requires that an entire external system for key resolution be available.

The key attribute is more flexible and general-purpose, but its use in interchange requires that documentation about how the key is to be resolved be sent to the recipient of the TEI document. In contrast values of the ref attribute are resolved using the widely accepted protocols for a URI, and thus less documentation, if any, is likely required by the recipient in data interchange.

These guidelines provide no semantic basis or suggested precedence when both key and ref are provided. For this reason simultaneous use of both is not recommended unless documentation explaining the use is provided, probably in an ODD customization, for interchange.