@ref

The attribute ref lists references to one or more <div>s. It consists of one or more simple references joined by commas or hyphens. A simple reference is a string value that points to a single <div>, e.g., "1 1".

Truncation is allowed. For example, 1 1 - 3 will be interpreted first as 1 1 through 1 3; if that is invalid, it will be interpeted as 1 1 through 3. Other examples: '2.4 - 7, 9', 'iv 7 - 9'

In a range with members of uneven depth, those <div>s that are closest to the shallowest member are retrieved. For example, 2 - 3 2 2 might fetch 2, 3 1, 3 2 1, 3 2 2 (and not 3 or 3 1 1).

For more, see the section called “Class 2 Data Patterns (<body>)”

Formal Definition

string (pattern (\w+([^\w\-]\w+)*)(((\s*-\s*)|(\s*,\s+))(\w+([^\w\-]\w+)*))*|.*\?\?\?.*)string (pattern (\w+([^\w\-]\w+)*)|.*\?\?\?.*)

Defined at: TAN-class-2.rng

Used by: ~simple-textual-reference, ~alt-skip, ~simple-rename, ~complex-rename, ~target-div-ref, ~div-ref-range, ~tok-ref-item, ~tok-ref-range

[Caution]Caution

Every part of a @ref must correspond to a <div> in every source.

[Important]Important

If a reference to a work is not found in some sources, a warning will be returned.

[Caution]Caution

Ranges consist of exactly two values separated by a hyphen.

[Caution]Caution

When renaming references, ranges must be predictably calculated.

[Caution]Caution

In a <rename>, the number of values in @ref and @new must be identical.

Example 8.55. @ref

<TAN-A-div TAN-version="2018" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims">
   .........
   <body claimant="lmp">
      .........
      <claim subject="dexippus porphyry">
         <claim subject="andronicus boethus" adverb="perhaps" verb="omits">
            <object src="grc">
               <tok ref="1 a 2" pos="3-4"/>
            </object>
         </claim>
      </claim>
      <claim subject="herminus comm-omnes" verb="agrees">
         <locus src="grc">
            <tok ref="1 a 2" pos="3-4"/>
         </locus>
      </claim>
      .........
      <claim subject="B" verb="replaces">
         <locus src="grc">
            <tok ref="1 a 5" pos="1-2"/>
         </locus>
         .........
      </claim>
      <claim subject="Λ" adverb="perhaps" verb="replaces">
         <locus src="grc">
            <tok ref="1 a 5" pos="1-2"/>
         </locus>
         .........
      </claim>
      <claim subject="π α φ ο" verb="agrees">
         <locus src="grc">
            <tok ref="1 a 5" pos="1-2"/>
         </locus>
      </claim>
      .........
   </body>
</TAN-A-div>


[Note]Note

Taken from ar.cat.tan-a-div.claims