[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita] conref.dita editorial review
> -----Original Message----- > From: Eliot Kimber [mailto:ekimber@reallysi.com] > Sent: Tuesday, November 24, 2009 11:53 AM > To: Michael Priestley; Bruce Nevin (bnevin) > Cc: dita > Subject: Re: [dita] conref.dita editorial review > > On 11/24/09 10:37 AM, "Michael Priestley" <mpriestl@ca.ibm.com> wrote: > > > for 2: > > > > 2. The question embedded within the following paragraph: > > > > A key is bound to the resource addressed by the > topicref or keyref > > in which it is defined, if it is provided. > > <!--What happens if none is provided? It can't be > resolved? --> > > The resource to which a key is bound may be a DITA > map or topic, > > or it > > may be a non-DITA resource such as a graphic or an > object specified > > by an external URI. > > > > A key is bound to the resource addressed by the topicref in > which it > > is defined. If no address is provided, the key is bound to the > > information provided by the topicref, such as a title and metadata. > > This wording implies that the resource/subelement binding is > exclusive, but in fact it's both. I'm not sure how to express > that crisply--every time I've tried it comes out convoluted. > > That is, a key binds to any resource addressed by the > topicref as well as to any applicable subelements of the > topicref's topicmeta child. I think you're right, we'll tie ourselves in knots if we try to pack all that into one sentence. Currently, the paragraph that follows immediately after this one talks about topicmeta. A key may also be bound to an element within the <topicmeta> of the key-defining <keydef> or <topicref>. The content of that element is rendered as the content of the referenced element. A referenced element thus bound can therefore be used as a variable, and the content of the bound element in the definition provides a way to set the variable's value in the map. Is that sufficient? Would this be better if we began that paragraph by saying "in addition to the resource addressed by <keydef> or <topicref>"? Note that the lang ref topic on <topicmeta> says nothing about this. The closest it comes is this: In addition, it can be used to add index entries to referenced content using the <keywords> element.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]