<locus>

<locus> defines a location within a manuscript or manuscript part, usually as a (possibly discontinuous) sequence of folio references. [10.3.5 References to Locations within a Manuscript]
Modulemsdescription — Manuscript Description
Attributesatt.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) att.pointing (@targetLang, @target, @evaluate)
schemeidentifies the foliation scheme in terms of which the location is being specified by pointing to some foliation element defining it, or to some other equivalent resource.
Status Optional
Datatype 

<rng:ref name="data.pointer"/>
data.pointer
fromspecifies the starting point of the location in a normalized form, typically a page number.
Status Optional
Datatype 

<rng:ref name="data.word"/>
data.word
tospecifies the end-point of the location in a normalized form, typically as a page number.
Status Optional
Datatype 

<rng:ref name="data.word"/>
data.word
Member of
model.pPart.msdesc
Contained by
analysis: cl phr s span
core: abbr add addrLine author biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure meeting mentioned name note num orig p pubPlace publisher q quote ref reg resp rs said sic soCalled speaker stage street term textLang time title unclear
corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose
dictionaries: case colloc def dictScrap entryFree etym form gen gram gramGrp hyph iType lang lbl mood number orth per pos pron re sense stress subc syll tns usg xr
drama: actor camera caption castItem role roleDesc sound tech view
figures: cell figDesc
header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage typeNote
iso-fs: fDescr fsDescr
linking: ab seg
msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout locusGrp material msItem msItemStruct musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates watermark
namesdates: addName affiliation age birth bloc country death district education faith floruit forename genName geogFeat geogName langKnown nameLink nationality occupation offset orgName persName placeName region residence roleName settlement sex socecStatus surname
spoken: u writing
tagdocs: eg valDesc
textcrit: lem rdg wit witDetail witness
textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer
transcr: damage fw metamark mod restore retrace secl supplied surplus
verse: metSym rhyme
May contain
gaiji: g
Declaration

<rng:element name="locus">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.pointing.attributes"/>
 <rng:optional>
  <rng:attribute name="scheme">
   <rng:ref name="data.pointer"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="from">
   <rng:ref name="data.word"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="to">
   <rng:ref name="data.word"/>
  </rng:attribute>
 </rng:optional>
 <rng:ref name="macro.xtext"/>
</rng:element>
element locus
{
   att.global.attributes,
   att.global.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.global.responsibility.attributes,
   att.pointing.attributes,
   attribute scheme { data.pointer }?,
   attribute from { data.word }?,
   attribute to { data.word }?,
   macro.xtext
}
Example

<!-- within ms description --><msItem n="1">
 <locus target="#F1r #F1v #F2r" from="1r"
  to="2r">ff. 1r-2r</locus>
 <author>Ben Jonson</author>
 <title>Ode to himself</title>
 <rubric rend="italics"> An Ode<lb/> to him selfe.</rubric>
 <incipit>Com leaue the loathed stage</incipit>
 <explicit>And see his chariot triumph ore his wayne.</explicit>
 <bibl>
  <name>Beal</name>, <title>Index 1450-1625</title>, JnB 380</bibl>
</msItem>
<!-- within transcription ... -->
<pb xml:id="F1r"/>
<!-- ... -->
<pb xml:id="F1v"/>
<!-- ... -->
<pb xml:id="F2r"/>
<!-- ... -->
Example

The facs attribute is available globally when the transcr module is included in a schema. It may be used to point directly to an image file, as in the following example:

<msItem>
 <locus facs="images/08v.jpg images/09r.jpg images/09v.jpg images/10r.jpg images/10v.jpg">fols. 8v-10v</locus>
 <title>Birds Praise of Love</title>
 <bibl>
  <title>IMEV</title>
  <biblScope>1506</biblScope>
 </bibl>
</msItem>
Note

The target attribute should only be used to point to elements that contain or indicate a transcription of the locus being described, as in the first example above. To associate a locus element with a page image or other comparable representation, the global facs attribute should be used instead, as shown in the second example. Use of the target attribute to indicate an image is strongly deprecated. The facs attribute may be used to indicate one or more image files, as above, or alternatively it may point to one or more appropriate XML elements, such as the surface, zone element, graphic, or binaryObject elements.

Note

When the location being defined consists of a single page, use the from and to attributes with an identical value. When no clear endpoint is given the from attribute should be used without to. For example, if the manuscript description being transcribed has ‘p. 3ff’ as the locus.