<?xml version="1.0" encoding="utf-8"?>
<!--
    Copyright TEI Consortium.
    Dual-licensed under CC-by and BSD2 licences
    See the file COPYING.txt for details
    $Date$
    $Id$
-->
<?xml-model href="http://tei.oucs.ox.ac.uk/jenkins/job/TEIP5/lastSuccessfulBuild/artifact/P5/release/xml/tei/odd/p5.nvdl" type="application/xml" schematypens="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"?>

<classSpec xmlns="http://www.tei-c.org/ns/1.0" module="tei" type="atts" ident="att.canonical">
  <desc versionDate="2008-09-05" xml:lang="en">provides attributes which can be used to associate a representation such as a name or title
    with canonical information about the object being named or referenced.</desc>
  <desc versionDate="2009-05-25" xml:lang="fr">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.</desc>
  <attList>
    <attDef ident="key" usage="opt">
      <desc versionDate="2008-09-05" xml:lang="en">provides an externally-defined means of identifying the entity (or entities) being
        named, using a coded value of some kind.</desc>
      <desc versionDate="2009-05-25" xml:lang="fr"> 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.</desc>
      <datatype>
        <rng:ref xmlns:rng="http://relaxng.org/ns/structure/1.0" name="data.text"/>
      </datatype>
      <exemplum xml:lang="en">
        <egXML xmlns="http://www.tei-c.org/ns/Examples" xml:lang="en">
          <author>
            <name key="name 427308" type="organisation">[New Zealand Parliament, Legislative Council]</name>
          </author>
        </egXML>
      </exemplum>
      <exemplum xml:lang="en">
        <egXML xmlns="http://www.tei-c.org/ns/Examples" xml:lang="fr">
          <author>
            <name key="Hugo, Victor (1802-1885)" ref="http://www.idref.fr/026927608">Victor Hugo</name>
          </author>
        </egXML>
      </exemplum>
      <remarks versionDate="2013-06-20" xml:lang="en">
        <p>The value may be a unique identifier from a database, or any other externally-defined
          string identifying the referent. </p>
        <p>No particular syntax is proposed for the values of the <att>key</att> attribute, since 
          its form will depend entirely on practice within a given project. For the same reason, this 
          attribute is not recommended in data interchange, since there is no way of ensuring 
          that the values used by one project are distinct from those used by another. In such
          a situation, a preferable approach for magic tokens which follows standard practice 
          on the Web is to use a <att>ref</att> attribute whose value is a tag URI as defined in 
          <ref target="#RFC4151">RFC 4151</ref>.</p>
      </remarks>
      <remarks versionDate="2009-05-25" xml:lang="fr">
        <p>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. </p>
      </remarks>
    </attDef>
    <attDef ident="ref" usage="opt">
      <gloss versionDate="2008-09-05" xml:lang="en">reference</gloss>
      <gloss versionDate="2009-05-25" xml:lang="fr">référence</gloss>
      <desc versionDate="2008-09-05" xml:lang="en">provides an explicit means of locating a full definition or identity for the entity being named by
        means of one or more URIs.</desc>
      <desc versionDate="2009-05-25" xml:lang="fr">fournit un moyen explicite de localiser une
        définition complète de l'entité nommée au moyen d'un ou plusieurs URIs.</desc>
      <datatype minOccurs="1" maxOccurs="unbounded">
        <rng:ref xmlns:rng="http://relaxng.org/ns/structure/1.0" name="data.pointer"/>
      </datatype>
        <exemplum xml:lang="en">
            <egXML xmlns="http://www.tei-c.org/ns/Examples" xml:lang="en">
            <name ref="http://viaf.org/viaf/109557338" type="person">Seamus Heaney</name>
            </egXML>
        </exemplum>         
      <remarks versionDate="2014-01-09" xml:lang="en">
<p>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.</p>
      </remarks>
      <remarks versionDate="2009-05-25" xml:lang="fr">
        <p>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.</p>
      </remarks>
    </attDef>
  </attList>
</classSpec>
