[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Bug: fragref does not allow keyref
As I've always understood these elements, they do not make sense when used to reference a fragment or synnote in another diagram. I know that the tools we use to render syntax diagrams in IBM do not allow these to reference elements in other diagrams. The DITA 1.1 langspec for fragref/@href says that the target fragment "should" be in the same diagram. I have always viewed this as a "must". The purpose of <fragment> is to break out a chunk of syntax to render on its own; it seems that fragref would be difficult to understand if it takes you out of the current diagram to syntax that is part of another set of syntax. For synnoteref, the 1.1 spec begins with "The syntax note (<synnoteref>) reference element references a syntax note element (<synnote>) that has already been defined elsewhere in the syntax diagram." The synnoteref/@href description also says that the target must be in the same diagram. Based on our existing definitions - synnoteref cannot leave the diagram, much less the topic, so keyref would not be useful. Based on my own experience, it makes even less sense to reference a fragment that is part of another diagram, so I don't view keyref as critical there. To me this is not so much a bug as an intentional way to discourage references outside the current diagram. Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit Eliot Kimber <ekimber@reallysi.com> wrote on 01/24/2010 02:47:42 PM: > Re: [dita] Bug: fragref does not allow keyref > > On 1/24/10 1:41 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote: > > > The fragref element is a specialization of topic/xref. As currently declared > > it does not allow @keyref, only @href. I can't think of any reason it > > shouldn't also allow @keyref. This looks like a bug to me. > > Ditto synnoteref, which explicitly allows referencing notes from other > syntax diagrams, which makes allowing @keyref essential. > > Cheers, > > E. > > -- > Eliot Kimber > Senior Solutions Architect > "Bringing Strategy, Content, and Technology Together" > Main: 610.631.6770 > www.reallysi.com > www.rsuitecms.com > > > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]