att.canonical

att.canonical 名前やタイトルのような表現を参照対象についての典拠情報と関連付けるのに利用する属性を提供する。 [13.1.1 Linking Names and Their Referents]
モジュール tei — The TEI Infrastructure
構成 att.naming [att.personal [addName eventName forename genName name objectName orgName persName placeName roleName surname] affiliation author birth bloc climate collection country death district editor education event geogFeat geogName institution nationality occupation offset origPlace population pubPlace region repository residence rs settlement socecStatus state terrain trait] actor authority catDesc correspDesc date distributor docAuthor docTitle faith funder material meeting object objectType principal publisher relation resp respStmt sponsor term time title unitDecl unitDef
属性
key⚓︎ 何らかのコード化された値を用いて、名付けられたエンティティを識別する外部的に定義された手段を提供する。
状態 任意
データ型 teidata.text
<author>
 <name key="Hugo, Victor (1802-1885)"
  ref="http://www.idref.fr/026927608">Victor Hugo</name>
</author>
解説

値はデータベースにおけるユニークな識別子や、外部で定義された指示対象を特定するなんらかの文字列であってよい。key属性の値に関してさだまった構文は提案されていない。なぜならば、それぞれのプロジェクトのやりかたに完全に依存するからである。同様の理由によって、データの相互交換においてこの属性は推奨されない。在るプロジェクトで用いられた値が他のプロジェクトの値と異なることを保証できないからである。そのような場面における魔法石的対処は、RFC4151に定義されるタグURIを値とするref属性を用いて、標準的なウェブにおける習慣にしたがってmagic tokenを使うことである。
ref⚓︎ (参照) 一つ以上のURIを用いて、名付けられたエンティティの完全な定義かIDを参照するための明確な手段を提供する。
状態 任意
データ型 1–∞ occurrences of teidata.pointer 空白文字で区切られる
<name ref="http://viaf.org/viaf/109557338"
 type="person">Seamus Heaney</name>
解説

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

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

<author n="1">
 <name ref="http://nzetc.victoria.ac.nz/tm/scholarly/name-427308.html"
  type="organisation">New Zealand Parliament, Legislative Council</name>
</author>
 
<author n="2">
 <name ref="nzvn:427308"
  type="organisation">New Zealand Parliament, Legislative Council</name>
</author>
 
<author n="3">
 <name ref="./named_entities.xml#o427308"
  type="organisation">New Zealand Parliament, Legislative Council</name>
</author>
 

<author n="4">
 <name key="name-427308"
  type="organisation">New Zealand Parliament, Legislative Council</name>
</author>

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.