<locus>

<locus> 定義一個手稿或手稿部分裡的位置,通常是用一系列的 (可能不連續的) 頁面參照。 10.3.5 References to Locations within a Manuscript
組件msdescription — 10 Manuscript Description
屬性
scheme說明所指出位置的編頁架構。
狀態 非必備的
資料類型

<rng:ref name="data.pointer"/>
data.pointer
A pointer to some foliation element which defines the foliation scheme used, or an external link to some equivalent resource.
from用正規格式指明該位置的起始點。
狀態 非必備的
資料類型

<rng:ref name="data.word"/>
data.word
typically this will be a page number
to用正規格式指明該位置的結束點。
狀態 非必備的
資料類型

<rng:ref name="data.word"/>
data.word
typically this will be a page number
targetsupplies a link to one or more transcriptions of the specified range of folios.
狀態 非必備的
資料類型 1–∞ occurrences of

<rng:ref name="data.pointer"/>
data.pointer
以空白鍵隔開
屬於msItem msItemStruct model.pPart.msdesc
可包含
gaiji: g
宣告

<rng:element name="locus">
<rng:ref name="att.global.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:optional>
 <rng:attribute name="target">
  <rng:list>
   <rng:oneOrMore>
    <rng:ref name="data.pointer"/>
   </rng:oneOrMore>
  </rng:list>
 </rng:attribute>
</rng:optional>
<rng:ref name="macro.xtext"/>
</rng:element>
element locus
{
   att.global.attributes,
   attribute scheme { data.pointer }?,
   attribute from { data.word }?,
   attribute to { data.word }?,
   attribute target { list { data.pointer+ } }?,
   macro.xtext
}
例子

<!-- within ms description --><msItem n="1">
 <locus target="#F1r #F1v #F2r">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>
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.