join

首頁 | 內容
C 元素

<join>

<join> identifies a possibly fragmented segment of text, by pointing at the possibly discontiguous elements which compose it. 16.7 Aggregation

組件 linking — 16 Linking, Segmentation, and Alignment

屬性

att.pointing (@type, @evaluate)

targets

specifies the identifiers of the elements or passages to be joined into a virtual element.

狀態	必備的
資料類型	2–∞ occurrences of <rng:ref name="data.pointer"/> data.pointer 以空白鍵隔開
值	two or more pointers (URIs), separated by whitespace

result

specifies the name of an element which this aggregation may be understood to represent.

狀態	非必備的
資料類型	<rng:ref name="data.name"/> data.name
值	The generic identifier of an element in the current DTD.

scope

indicates whether the targets to be joined include the entire element indicated (the entire subtree including its root), or just the children of the target (the branches of the subtree).

狀態	推薦的
合法的值是:	root the rooted subtrees indicated by the targets attribute are joined, each subtree become a child of the virtual element created by the join [預設值] branches the children of the subtrees indicated by the targets attribute become the children of the virtual element (i.e. the roots of the subtrees are discarded)

屬於 joinGrp model.global.meta

可包含

core: desc gloss

tagdocs: altIdent equiv

宣告


<rng:element name="join">
<rng:ref name="att.global.attributes"/>
<rng:ref name="att.pointing.attributes"/>
<rng:attribute name="targets">
 <rng:list>
  <rng:ref name="data.pointer"/>
  <rng:oneOrMore>
   <rng:ref name="data.pointer"/>
  </rng:oneOrMore>
 </rng:list>
</rng:attribute>
<rng:optional>
 <rng:attribute name="result">
  <rng:ref name="data.name"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="scope" a:defaultValue="root">
  <rng:choice>
   <rng:value>root</rng:value>
   <rng:value>branches</rng:value>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:zeroOrMore>
 <rng:ref name="model.glossLike"/>
</rng:zeroOrMore>
</rng:element>

element join
{
   att.global.attributes,
   att.pointing.attributes,
   attribute targets { list { data.pointer, data.pointer+ } },
   attribute result { data.name }?,
   attribute scope { "root" | "branches" }?,
   model.glossLike*
}

例子

The following example is discussed in section 16.7 Aggregation:

<sp>
<speaker>Hughie</speaker>
How does it go?
<q>
 <l xml:id="frog_x1">da-da-da</l>
 <l xml:id="frog_l2">gets a new frog</l>
 <l>...</l>
 </q>

</sp>
<sp>
<speaker>Louie</speaker>

 <q>
 <l xml:id="frog_l1">When the old pond</l>
 <l>...</l>
 </q>

</sp>
<sp>
<speaker>Dewey</speaker>

 <q>...
 <l xml:id="frog_l3">It's a new pond.</l>
 </q>

<join targets="#frog_l1 #frog_l2 #frog_l3" result="lg" scope="root"/>
</sp>

The <join> element here identifies a linegroup (<lg>) comprising the three lines indicated by the targets attribute. The value root for the scope attribute indicates that the resulting virtual element contains the three <l> elements linked to at #frog_l1 #frog_l2 #frog_l3, rather than their character data content.

例子

In this example, the attribute scope is specified with the value of branches to indicate that the virtual list being constructed is to be made by taking the lists indicated by the targets attribute of the <join> element, discarding the <list> tags which enclose them, and combining the items contained within the lists into a single virtual list:

Southern dialect (my own variety, at least) has only
<list xml:id="LP1">
 <item>
 <s>I done gone</s>
 </item>
 <item>
 <s>I done went</s>
 </item>
</list> whereas Negro Non-Standard basilect has both these and
<list xml:id="LP2">
 <item>
 <s>I done go</s>
 </item>
</list>.
White Southern dialect also has
<list xml:id="LP3">
 <item>
 <s>I've done gone</s>
 </item>
 <item>
 <s>I've done went</s>
 </item>
</list> which, when they occur in Negro dialect, should probably
be considered as borrowings from other varieties of
English.
<join
 result="list"
 xml:id="LST1"
 targets="#LP1 #LP2 #LP3"
 scope="branches">
<desc>Sample sentences in Southern speech</desc>
</join>

P5: TEI指引

<join>