OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-tc] resource fragments

"Grosso, Paul" <pgrosso@ptc.com> writes:

> fwiw, I note that xinclude uses the two attribute approach:
> an href attribute that is a URI reference without a fragment 
> identifier and an xpointer attribute that gives just the
> fragment identifier.

Yeah, and I think that's probably the way to go.

>> -----Original Message-----
>> From: Bob Stayton [mailto:bobs@sagehill.net]
>> Sent: Tuesday, 2010 February 16 13:08
>> To: DocBook Technical Committee
>> Subject: [docbook-tc] resource fragments
>> I have a question regarding referencing fragments of a resource.  It
>> seems there could
>> be two ways to include a fragment of a resource in your document:
>> 1.  Define the resource element as a fragment, as in this example from
>> Larry's sample:
>>    <resource xml:id="svn.properties"
>>       fileref="subversion/properties.xml#using.properties"/>

This is going to lead to:

    <resource xml:id="svn.properties"
    <resource xml:id="svn.builtins"
    <resource xml:id="svn.xyzzy"

which seems awfully redundant.

>> 2.  Reference a fragment of a whole resource from a module:
>>    <resource xml:id="svn.properties"
>>       fileref="subversion/properties.xml"/>
>>    ...
>>    <module resourceref="svn.properties#using.properties"/>

Yuck. Do not like. :-)

>> Perhaps a different syntax might work better:
>> 3.  Reference a fragment of a whole resource from a module using
>> another attribute:
>>    <resource xml:id="svn.properties"
>>       fileref="subversion/properties.xml"/>
>>    ...
>>    <module resourceref="svn.properties" fragment="using.properties"/>

For consistency with XInclude, I propose we name the second attribute

                                        Be seeing you,

Norman Walsh <ndw@nwalsh.com>      | A proof tells us where to
http://www.oasis-open.org/docbook/ | concentrate our doubts.-- Anonymous
Chair, DocBook Technical Committee |

PGP signature

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]