ZedAI Pointing Relationships

From zedwiki

Quick Summary

annoref      -@ref-> annotation
annotation   -@ref-> *

noteref      -@ref-> note
note         -@ref-> *

term         -@ref-> definition

abbr         -@ref-> expansion
abbr         -@ref-> name
abbr         -@ref-> definition

caption      -@ref-> *
*            -@ref-> caption (not disallowed)

citation     -@ref-> *
*            -@ref-> citation (not disallowed)
citation/ref -@ref-> external resource

*            -@desc-> description

Annotations

Annoations have bi-directional pointing.

An annoref may point to the annotation.

In the absence of a referent in the text, the annotation must point to an element in the document via its ref attribute. (Another reason against a global ref for pointing to descriptions.)

It is also possible that an annoref points to an annotation which also annotates other elements via its ref attribute, although extremely unlikely.

Notes

The note element, like annotation, also allows bi-directional pointing.

A noteref typically will point to the associated footnote/endnote.

In the absence of a referent in the text, the note must point to an element in the document via its ref attribute.

Again like annoation, it is possible that an noteref may point to a note/code> which also references other elements via its <code>ref attribute. Unlike annotations, however, there is almost no possible use for this kind of bi-directional linking and the schematron rules should probably prohibit it.

Terms/Definitions

The term element only allows one-way pointing to its associated definition.

A definition should never point to another element (global desc makes no sense here, for example).

Abbreviations/Expansions

The abbr element only allows one-way pointing.

The abbr element may point to an associated expansion, name and/or definition.

An expansion should never point to another element (global desc makes no sense here, as well).

Captions

The caption element allows one-way pointing to the element it's associated with.

A ref attribute is required to establish the relationship; implicit ownership does not exist.

There are no rules/prose forbidding any element from pointing to a caption, so long as it allows the ref attribute.

Citations

The citation element allows one-way pointing to the element or resource it's associated with.

A ref attribute is required to establish the relationship to another element in the document; implicit ownership does not exist.

The ref element can be used to reference an external resource.

There are no rules/prose forbidding any element from pointing to a citation, so long as it allows the ref attribute.

Descriptions

The description element only allows one-way pointing to it from other elements via the desc attribute.

A description cannot point to another description