Using @key attribute in inserted annotation references instead of @ref?

[daliboris]

Annotation feature in TEI Publisher creates in the registry (registry.xml file) an element with @xml:id attribute:

<place xml:id="geo-6946437">
   <placeName type="full">Basilika San Francisco</placeName>
   <!-- ... -->
</place>

Value of this attribute is referenced from the text using @ref attribute:

<placeName ref="geo-6946437">San Francisco</placeName>

According to the specification and examples, @ref is of type teidata.pointer and should use a URI, a prefix declared in prefixDef element, or point to an existing element using #.

If the identifier resolution system is external, the @key attribute shoul be used.

It seems to me that TEI Publisher uses it's own system (i.e. external) to identify referenced enetity and thus it should generate @key attribute in the text.

[daliboris]

The name of the attribute is configurable in the annotation-config.xqm module.

declare variable $anno:reference-key := 'ref';

The problem with the hash (#) prefix in teidata.pointer can be solved in the anno:get-key() function (in the same module):

declare function anno:get-key($node as element()) as xs:string? {
    let $key := $node/@*[local-name(.) = $anno:reference-key]
    return if(starts-with($key, '#')) then substring-after($key, '#') else $key
};