RE: [docbook] Referring to Appendices from within a chapter

["Peter Desjardins" <pdesjardins@supplyscape.com>]

I often use olinks instead of xref even when xref would work.  That way
if I later decide to split files or to include the referencing content
in another document, the cross-reference remains valid.

Of course, if you haven't already set up olinking, that might be an
expensive precaution to take. 

Peter Desjardins

> -----Original Message-----
> From: Bob Stayton [mailto:bobs@sagehill.net] 
> Sent: Tuesday, July 24, 2007 23:49
> To: Jeff Powanda; Stuart J. Browne
> Cc: docbook@lists.oasis-open.org
> Subject: Re: [docbook] Referring to Appendices from within a chapter
> 
> Well, olinks may not be necessary in this case.  Is the 
> appendix in the 
> same document as the text referencing the appendix?  If so, 
> then you can 
> use an xref element with a linkend attribute matching the id 
> value of the 
> appendix:
> 
> <xref linkend="name"/>
> 
> Then the stylesheet will generate the cross reference text 
> and make it a 
> hot link.
> 
> Bob Stayton
> Sagehill Enterprises
> DocBook Consulting
> bobs@sagehill.net
> 
> 
> ----- Original Message ----- 
> From: "Jeff Powanda" <jpowanda@vocera.com>
> To: "Stuart J. Browne" <sjbrowne@bluebottle.com>
> Cc: <docbook@lists.oasis-open.org>
> Sent: Tuesday, July 24, 2007 6:54 PM
> Subject: RE: [docbook] Referring to Appendices from within a chapter
> 
> 
> 
> I recommend using Olinks. See Bob Stayton's chapter from DocBook XSL:
> The Definitive Guide: http://www.sagehill.net/docbookxsl/Olinking.html
> 
> Regards,
> Jeff Powanda
> 
> -----Original Message-----
> From: Stuart J. Browne [mailto:sjbrowne@bluebottle.com]
> Sent: Tuesday, July 24, 2007 6:00 PM
> To: docbook@lists.oasis-open.org
> Subject: [docbook] Referring to Appendices from within a chapter
> 
> Hi,
> 
> I'm new to docbook (literally started with it yesterday), and 
> am writing
> up
> some system documentation using a book/chapter model.
> 
> I've created a few appendices, and was wondering how to refer 
> (link) to
> them
> using the '<appendix id="name">' they were created with 
> instead of doing
> a
> <link> to an <xref>, or whether that is the right approach to take at
> all.
> 
> Thanks
> 
> Stuart J. Browne
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
> 
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
>