Skip to content

<locus>

locus

defines a location within a manuscript, manuscript part, or other object typically as a (possibly discontinuous) sequence of folio references.

Module msdescriptionmsloc

Attributes

Global and inherited attributes:
att.global @xml:id@n@xml:lang@xml:base@xml:space
att.global.analytic @ana
att.global.change @change
att.global.facs @facs
att.global.linking @corresp@synch@sameAs@copyOf@next@prev@exclude@select
att.global.rendition @rend@style@rendition
att.global.responsibility @cert@resp
att.global.source @source
att.pointing @targetLang@target@evaluate
att.typed @type@subtype
@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
Datatype
teidata.pointer
@fromspecifies the starting point of the location in a normalized form, typically a page number.
Status
Datatype
teidata.word
@tospecifies the end-point of the location in a normalized form, typically as a page number.
Status
Datatype
teidata.word

Classes and content

Member of
model.pPart.msdesc
May contain

core

gaiji

msdescription

Character data

  • character data
Contained by

analysis

cmc

core

corpus

dictionaries

drama

figures

header

iso-fs

linking

msdescription

namesdates

spoken

tagdocs

textcrit

textstructure

transcr

verse

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 Ben Jonson example.

To associate a locus element with a page image or other comparable representation, the global @facs attribute should be used, as shown in the Birds Praise of Love example. The @facs attribute may be used to indicate one or more image files, as in that example, or alternatively it may point to one or more appropriate XML elements, such as the surface, zone, graphic, or binaryObject elements.

When a single page is being cited, use the @from and @to attributes with an identical value. When no clear endpoint is provided, the @from attribute may be used without @to; for example a citation such as p. 3ff might be encoded <locus from="3">p. 3ff</locus>.

Examples

<!-- 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"/>
<!-- ... -->

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>

Content model

<content>
   <alternate minOccurs="0" maxOccurs="unbounded">
    <textNode/>
    <classRef key="model.gLike"/>
    <elementRef key="hi"/>
    <elementRef key="locus"/>
   </alternate>
  </content>