Re: DOCBOOK-APPS: XSL-Style: Referencing links

[Bob Stayton <bobs@caldera.com>]

On Sun, Nov 03, 2002 at 07:31:14AM +0100, Stephan Wiesner wrote:
> Good Morning list,
> Can I reference a link? Like, I have a section with resources and want
> to reference a link of it in the text.
>    The source can be aquired here: <xref linkend="link_SW"/>.
> 
> And below, in my bibliography section:
> 
>  <biblioentry id="bib_sw">
>   <abbrev>SW</abbrev>
>     <title>My Own Home Page</title>
>     <bibliosource id="link_SW">
>        <ulink url="http://www.stephanwiesner.de/java";>
>          http://www.stephanwiesner.de/java 
>        </ulink>
>     </bibliosource>
>  </biblioentry>
> 
> 
> Neither HTML nor PDF style can render this.
> I could use the ID of the biblioentry, but this would not give me just
> the link.

Actually, there is a larger problem here, which is that
the bibliosource element is not supported at all in
the XSL stylesheets.  You should file a bug report on that.

In general, the generated text for an xref to an element is
that element's title text. For elements that don't have a
title (such as a bibliosource), you can use the 'endterm'
attribute.  The 'endterm' is an IDREF to the ID of the
element whose text you want to use for the generated text.
In this case, it is the same element.  For example:

<xref  linkend="link_SW"  endterm="link_SW" />

This will basically reproduce the bibliosource element's
output (when that bug is fixed) as the generated text of the xref.

You have to be careful with endterm, because it will include
all the text of the element pointed to.  If that element
happens to be a chapter by mistake, then the generated text for
the xref is all the text in the chapter.  Any element that
is not rendered as just inline  text will probably produce odd
formatting in the xref.  

-- 

Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
Caldera International, Inc.                 fax:   (831) 429-1887
                                            email: bobs@caldera.com