A CITE library for the JVM, version 0.96.0 > CTS URNs >
Determining the contents of a CTS URN
Part of the expressive power of the CTS URN notation is that it explicitly represents in a single reference a precise reference to the situation of the reference in both a hierarchical model of the work, and in a reference scheme that is both hierarchical and ordered. The cite
library provides methods to determine:
- the position of a reference in the work hierarchy
- the level of a reference in the hierarchy of the passage citation
- whether the passage reference refers to a single node or a range of nodes in the passage reference
- whether the passage reference includes a subreference
Examples: position in work hierarchy
- the URN urn:cts:greekLit:tlg0012.tlg001.msA.lex:1.1-2.75 is cited at the exemplar level.
- the URN urn:cts:greekLit:tlg0012.tlg001.msA:1.1-2.75 is cited at the version level.
- the URN urn:cts:greekLit:tlg0012.tlg001:1.1-2.75 is cited at the work level.
Examples: level of passage citation
- the URN urn:cts:greekLit:tlg0012.tlg001:1 is cited at 1 level (book of the Iliad).
- the URN urn:cts:greekLit:tlg0012.tlg001:1.1 is cited at 2 levels (book and line of the Iliad).
- the URN urn:cts:greekLit:tlg0012.tlg001.msA.lex:1.1.1 is cited at 3 levels (book and line of the Iliad, lexical token within the line).
Examples: nodes and ranges
Examples: subreferences
On a single node:
- the URN urn:cts:greekLit:tlg0012.tlg001.msA:1.1@Μῆνιν includes a subreference.
- the URN urn:cts:greekLit:tlg0012.tlg001.msA:1.1 does not include a subreference.
On a range:
the URN urn:cts:greekLit:tlg0012.tlg001.msA:1.1@Μῆνιν-2.75 includes a subreference on the first node of the range; it does not have a subreference on the last node of the range.
the URN urn:cts:greekLit:tlg0012.tlg001.msA:1.1-2.75@νήεσσι does not have a subreference on the first node of the range; it does on the last node of the range.