Re: [docbook] Best Practise of Referencing Between Modules in Assemblies?

["Bob Stayton" <bobs@sagehill.net>]

The stylesheets do not currently support such XLink syntax.  The current assembly 
stylesheet would first need to preserve the xml filenames in xml:base attributes when 
assembling resources into a single DocBook document for processing.  That should be 
done anyway to preserve relative paths to images and such.

You can use olinks right now.  One of the most frequent uses of olinks is for linking 
between modular content. Olinks let you avoid hard coding filenames in your links, 
which can be troublesome to maintain if you rename or move files.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Jirka Kosek" <jirka@kosek.cz>
To: "Thomas Schraitle" <tom_schr@web.de>
Cc: <docbook@lists.oasis-open.org>
Sent: Friday, May 18, 2012 3:38 AM
Subject: Re: [docbook] Best Practise of Referencing Between Modules in Assemblies?

On 17.5.2012 19:32, Thomas Schraitle wrote:

> as I'm currently playing with DocBook assemblies, I'm wondering about the
> "best practise" of referencing from one module into another.
...
> What do you think? Do you have used assemblies already and how do you deal
> with referencing? Do I miss anything?

First, it's good that someone is using assemblies -- it would be very
hard to develop them without feedback from users. Regarding links, I
think that proper way of linking is to use XLink pointing to source XML
file of module and optionally to ID withing this fragment. E.g.:

<xref xlink:href="installation.xml#system.requirements"/>

However I'm not sure that stylesheets are already supporting this mechanism.