The element anchor-div-ref
refers to a group of one or more <div>
s (or segments of <div>
s) to which <div>
s from other versions of the same work should be realigned (defined by the <div-ref>
s that follow). The first child of a <realign>
, it is constructed exactly like <div-ref>
, except that only @src
, not @work
, is used, and @seg
is excluded.
<anchor-div-ref>
does not permit the comma in @ref
in an undistributed realignment, since realignment must always be made to a contiguous range of text.
If the parent <realign>
's @distribute
is false, or missing, then each <div-ref>
group will be realigned as a whole to the anchor, treated as a whole.
If @distribute
is true, then every nth realign head will serve as the anchor for the nth realign head in each subsequent <div-ref>
s (grouped by source).
@seg
, which applies to splits in specific sources, is not allowed because the job of an anchor is to reconcile other <div>
s to a reference that is valid independent of any particular edition. @seg
would defeat that purpose.
For more, see <div-ref>
.
Formal Definition
~ed-stamp
?,@src
,@ref
Used by: ~realignment
Caution | |
---|---|
A |
Example 8.157. <anchor-div-ref>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"> ......... <body> ......... <realign> <anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/> <div-ref src="fra" ref="1 1 - 1 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/> <div-ref src="fra" ref="3 1 - 3 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/> <div-ref src="fra" ref="4 1 - 4 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="5 1 1-4"/> <div-ref src="fra" ref="5 1 - 5 4"/> </realign> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
The element div-ref
refers to and groups one or more <div>
s (or segments of <div>
s).
<div-ref>
s are expanded against @src
/@work
, @ref
, and @seg.
That is, a <div-ref>
points to every segment of every div of every source cited.
A <div-ref>
, or a group of <div-ref>
s joined by @cont
, are treated as many groups as sources referred to. That is, <div-ref src="X Y" ... /> will be treated as shorthand for <div-ref src="X" ... /> and <div-ref src="Y" ... />. This applies to @work
as well: <div-ref work="w" ... /> is equivalent to <div-ref src="w1" ... />, <div-ref src="w2" ... />, etc.
After this distinction between sources is made, the entire set of <div>
s pointed to will be treated as a group, and processed as a whole (see @distribute
).
<div-ref>
is a grouping device, and is therefore unlike <tok>
, which always refers to single items, never sets. As a result, the siblings <div-ref src="X" ref="a"/> and <div-ref src="X" ref="b"/> are NOT identical to <div-ref src="X" ref="a, b"/>
Formal Definition
~ed-stamp
?, {[TAN-class-2 (~source-refs
):]@src
} OR {[TAN-core (~source-refs
):] {empty}},@ref
,@seg
?~ed-stamp
?,@ref
,@seg
?
Used by: ~realignment
, ~complex-text-ref
Important | |
---|---|
A defective reference is a value of |
Caution | |
---|---|
A |
Example 8.158. <div-ref>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"> ......... <body> ......... <realign> <anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/> <div-ref src="fra" ref="1 1 - 1 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/> <div-ref src="fra" ref="3 1 - 3 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/> <div-ref src="fra" ref="4 1 - 4 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="5 1 1-4"/> <div-ref src="fra" ref="5 1 - 5 4"/> </realign> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
The element div-type-ref
points to a <div-type>
in one or more sources, using the @xml:id
assigned by the source to that div type.
Formal Definition
~ed-stamp
?, {[TAN-class-2 (~source-refs
):]@src
} OR {[TAN-core (~source-refs
):] {empty}},@div-type-ref
Used by: ~div-type-equiv
, ~div-type-ref-cluster
, ~decl-supp-div-type
, ~decl-rename-div-n
Caution | |
---|---|
Every div type reference must be valid in every source |
Example 8.159. <div-type-ref>
<body> ......... <equate-div-types> <div-type-ref src="ger" div-type-ref="Zeile"/> <div-type-ref src="eng-uk" div-type-ref="line"/> </equate-div-types> ......... </body>
Note | |
---|---|
Taken from ringoroses.div.1 |
The element equate-div-types
declares an ad hoc equivalence between div types that are not defined by the <IRI>
values in their sources as being identical.
<equate-div-types>
are assumed to be greedy and transitive. If this element is used to equate div type X with type Y, then any div type in any source identical to X's or Y's IRI values will treated as identical.
This element does not imply that the two types of division are, in reality, one and the same. It merely states that, for the purposes of this alignment, they should be treated as equivalent.
Formal Definition
~ed-stamp
?, (~inclusion
| (<div-type-ref>
,<div-type-ref>
+))
Used by: ~TAN-body-core
Caution | |
---|---|
Items that share IRI values should not be equated. |
Caution | |
---|---|
Every div type reference must be valid in every source |
Example 8.160. <equate-div-types>
<body> <equate-works work="eng-uk ger"/> <equate-div-types> <div-type-ref src="ger" div-type-ref="Zeile"/> <div-type-ref src="eng-uk" div-type-ref="line"/> </equate-div-types> <split-leaf-div-at src="eng-us"> ......... </split-leaf-div-at> </body>
Note | |
---|---|
Taken from ringoroses.div.1 |
The element equate-works
declares an ad hoc equivalence between works that are not defined by the <IRI>
s in their sources as being identical.
This element extends the automatic equating of works, which is transitive and greedy. If work A is defined with <IRI>
X, work B with <IRI>
s X and Y, and work C with only <IRI>
Y, then works A and C will be automatically equated.
<equate-works>
does not imply that the two works are, in reality, one and the same. It merely states that, for the purposes of this alignment, they should be treated as equivalent.
Formal Definition
~ed-stamp
?, (~inclusion
|@work
)
Used by: ~TAN-body-core
Caution | |
---|---|
Items that share IRI values should not be equated. |
Example 8.161. <equate-works>
<body> <equate-works work="eng-uk ger"/> <equate-div-types> ......... </equate-div-types> ......... </body>
Note | |
---|---|
Taken from ringoroses.div.1 |
The element realign
corrects misaligned or unaligned divisions and segments in versions of the same work. <realign>
is intended to reconcile discordant reference systems by mapping <div>
s from one or more sources onto the <div>
s of another, treated as an anchor. The reanchored divs are then excluded from any default alignments, but they inherit the anchor's alignments.
Realignments come in four types.
An UNANCHORED, ONE-SOURCE realigment consists solely of one or more <div-ref>
s belonging to only one source. Any number of <div>
s may be referred to by the child <div-ref>
s. All <div>
s referred to will be excluded from automatic alignment with every other version of the same work.
An UNANCHORED, MULTIPLE-SOURCE realignment realigns <div>
s from multiple sources. The number of <div>
s per source must be identical, since these <div>
s will not only be excluded from automatic alignment, but realigned with each other, with the nth <div>
in each source constituting a realigned group.
An ANCHORED, ONE-TO-ONE realignment consists of an <anchor-div-ref>
that points to n <div>
s, and each source invoked by the following <div-ref>
s also point to n <div>
s, which will be reanchored to the nth <div>
in the anchor.
An ANCHORED, ONE-TO-MANY realignment consists of an <anchor-div-ref>
that points only to one <div>
, and <div-ref>
s that point to any number of sources and any number of <div>
s. To that one anchor will be remapped each source's collection of <div>
s to be reanchored. The sequence of <div>
s referred to will be respected. If to an anchor A is remapped <div>
s 2, 4, and 3, then
Realignment is disruptive, displacing any default alignment that might have been inferred in the reanchored source. Assume a case where a <div>
with reference B is being realigned to an anchor with reference A. In the source to be reanchored reference A, if it exists, will be excluded from automatic alignment with the anchor, unless if it is explicitly included in a <realign>
.
All realignment, except one-to-many anchored, is inheritable, affecting not only the specified <div>
s but also their descendants. That is, if X is realigned to Y, then children in X will be automatically aligned with children in Y, based on normalized values of @n.
Children of <div>
s in one-to-many anchored realignments must be explicitly realigned.
Because of the distributive nature of the realignment, every value of @ref
that involves a hyphen must have siblings with balanced depth on the left and right side of the hyphen (i.e., ref="1 - 2.1" would be invalid).
<realign>
does not affect subsequent nomenclature of @ref.
If in source x a <div>
A is realigned with <div>
B in source y, then subsequent references to the realigned <div>
in source x should still use A as a value of @ref
, not B.
The order of <realign>
s is immaterial. No <realign>
overwrites any other <realign>
. If two <realign>
s each reanchor A and B in the same source to C in the anchor, then A and B will be realigned in parallel. If one meant to say that A followed by B is to be realigned to C, then a one-to-many anchored realignment should be used.
Formal Definition
~ed-stamp
?, (~inclusion
| (<comment>
* & (<anchor-div-ref>
*,<div-ref>
+)))
Used by: ~TAN-body-core
Caution | |
---|---|
A |
Caution | |
---|---|
Distribution must be applied to groups of equal size. |
Caution | |
---|---|
No |
Example 8.162. <realign>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"> ......... <body> <split-leaf-div-at> ......... </split-leaf-div-at> <realign> <anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/> <div-ref src="fra" ref="1 1 - 1 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/> <div-ref src="fra" ref="3 1 - 3 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/> <div-ref src="fra" ref="4 1 - 4 3"/> </realign> <realign> <anchor-div-ref src="grc" ref="5 1 1-4"/> <div-ref src="fra" ref="5 1 - 5 4"/> </realign> <realign> ......... </realign> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
The element split-leaf-div-at
creates ad hoc splits in leaf <div>
s, to facilitate alignments and realignments of textual units smaller than leaf <div>
s. Any leaf div may be split as many times as there are token, as defined by <tokenization>
s.
Each split creates a provisional segment, a textual subdivision of a leaf <div>
.
Formal Definition
~ed-stamp
?, (~inclusion
| ( {[TAN-class-2 (~source-refs
):]@src
} OR {[TAN-core (~source-refs
):] {empty}}, (<comment>
* &<tok>
+)))
Used by: ~TAN-body-core
Caution | |
---|---|
Splits may be made only at leaf divs. |
Caution | |
---|---|
No source may be split more than once in the same place. |
Caution | |
---|---|
Splits may not be made at the first token in a div. |
Example 8.163. <split-leaf-div-at>
<body> <split-leaf-div-at> <tok src="fra" ref="5 5" val="Ceci"/> <tok src="fra" ref="5 5" val="Il"/> <tok src="fra" ref="5 6" val="Si" pos="1"/> ......... </split-leaf-div-at> <realign> ......... </realign> ......... </body>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
Example 8.164. <split-leaf-div-at>
<body> ......... <equate-div-types> ......... </equate-div-types> <split-leaf-div-at src="eng-us"> <tok ref="2" pos="last-3"/> </split-leaf-div-at> </body>
Note | |
---|---|
Taken from ringoroses.div.1 |
The element TAN-A-div
specifies that the file is a div-based TAN alignment file. Root element.
Formal Definition
~TAN-root
Important | |
---|---|
Every validated TAN file will include the following message at its root. “This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See http://textalign.net for details.” |
Example 8.165. <TAN-A-div>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"> <head> ......... </head> <body claimant="lmp"> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div.claims |
Example 8.166. <TAN-A-div>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"> <head> ......... </head> <body> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
Example 8.167. <TAN-A-div>
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-TAN-A-ring02"> <head> ......... </head> <body> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ringoroses.div.1 |
The attribute seg
picks specific segments in a leaf div. There must be an appropriate number of splits declared for those leaf divs in <split-leaf-div-at>
.
Formal Definition
string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)
Used by: ~reanchor-div-ref-item
, ~simple-textual-reference
, ~claim-div-ref-item
Caution | |
---|---|
|
Caution | |
---|---|
Sequences may not include values less than 1. |
Caution | |
---|---|
Sequences may not include values greater than the maximum allowed. |
Caution | |
---|---|
Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2. |
Example 8.168. @seg
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"> ......... <body> ......... <realign> <anchor-div-ref src="grc" ref="5 1 5 - 5 1 7"/> <div-ref src="fra" ref="5 5" seg="1-3"/> </realign> <realign> <anchor-div-ref src="grc" ref="5 2 1 - 5 2 2"/> <div-ref src="fra" ref="5 6" seg="1-2"/> </realign> ......... <realign> <anchor-div-ref src="grc" ref="5 4 1 - 5 4 5"/> <div-ref src="fra" ref="5 12" seg="1-5"/> </realign> <realign> <anchor-div-ref src="grc" ref="5 4 6 - 5 4 7"/> <div-ref src="fra" ref="5 13" seg="1-2"/> </realign> ......... </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div |
The attribute work
refers to a work by means of a source ID as a proxy. The attribute will be treated as indicating all sources that share the same work as the one mentioned.
If you wish to avoid making a claim applying to all other versions of a work, use @src
instead.
The attribute work
refers to works by means of source IDs as a proxy.
Formal Definition
string (pattern \S+)
Used by: ~work-equiv
, ~simple-textual-reference
, ~complex-textual-reference-set
Caution | |
---|---|
No |
Example 8.169. @work
<TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"> ......... <body claimant="lmp"> ......... <claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"> <locus work="grc"> <tok ref="1 a 2" pos="3-4"/> </locus> </claim> <claim subject="herminus comm-omnes" verb="agrees"> <locus work="grc"> <tok ref="1 a 2" pos="3-4"/> </locus> </claim> ......... <claim subject="B" verb="replaces"> <locus work="grc"> <tok ref="1 a 5" pos="1-2"/> </locus> <object>τις ἀποδιδῷ</object> </claim> <claim subject="Λ" adverb="perhaps" verb="replaces"> <locus work="grc"> <tok ref="1 a 5" pos="1-2"/> </locus> <object>τις ἀποδιδῷ</object> </claim> <claim subject="π α φ ο" verb="agrees"> <locus work="grc"> <tok ref="1 a 5" pos="1-2"/> </locus> </claim> </body> </TAN-A-div>
Note | |
---|---|
Taken from ar.cat.tan-a-div.claims |