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] proposal: add relatedlink element to topic


Putting relatedlink elements in info is fine with me.  Should we create a 
relatedlinks wrapper for them, or allow a random scattering of relatedlink 
elements in info?

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Scott Hudson" <scott.hudson@flatironssolutions.com>
To: "Norman Walsh" <ndw@nwalsh.com>
Cc: <docbook-tc@lists.oasis-open.org>
Sent: Monday, November 23, 2009 8:03 AM
Subject: Re: [docbook-tc] proposal: add relatedlink element to topic


>I like Norm's suggestion. Related links "feels" more like metadata than 
>inline content, and as the documentation states: "Many of the elements in 
>this wrapper may be used in presentation..."
>
> Best regards,
>
> --Scott
>
> Scott Hudson
> Senior XML Architect
> +1 (303) 542-2146  |  Office
> +1 (720) 663-SCOT [7268]  |  Gvoice
> Scott.Hudson@flatironssolutions.com
> http://www.flatironssolutions.com
>
>
>
>
>
>
> Norman Walsh wrote:
>> "Bob Stayton" <bobs@sagehill.net> writes:
>>
>>> A relatedlink element provides a solution to this problem. Instead of
>>> an explicit cross reference, an author can insert a relatedlink
>>> element at any point in a topic element like an indexterm.
>>>
>>
>> Index terms have to be located inline because their location
>> identifies a target for a cross-reference. In the case of relatedlink,
>> it sounds like the relationship is from (some parent of) the
>> relatedlink element to some other place.
>>
>> If a relatedlink element appears in a para in a section in a chapter
>> in a part in a book in a set, what determines the granularity of the
>> link source?
>>
>> It sounds to me like perhaps relatedlink should be allowed inside an
>> info wrapper and not in inline content.
>>
>>
>>> Allowing relatedlink elements to appear inline permits them to be kept
>>> close to the text they are related to. Then if the text is deleted, so
>>> is the relatedlink. If the text is modified, then the relatedlink can
>>> be evaluated by the author to see if it is still relevant.
>>>
>>
>> Can you give a concrete example of a relatedlink element?
>>
>>                                         Be seeing you,
>>                                           norm
>>
>>
>
> ---------------------------------------------------------------------
> 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]