docbook-apps

Scenario

docbook book. v5
Each chapter and appendix is a seperate file xincluded into the main
book.xml


I want to link to a glossterm, in appendix A, from chapter 4.

My processing model is to expand xincludes, validate with Jing
then transform the 'included' version using docbook.

hot text works

xlink:href='glossary.html#gloss.validation.candidate'>candidates
works (but seems brittle)

I'm guessing olink works too.

but I guess we are getting to the point where
we have quite a few ways of linking between 'chunks' now.




regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

Hi,

On Montag, 26. Mai 2008, Dave Pawson wrote:
> Scenario
>
> docbook book. v5
> Each chapter and appendix is a seperate file xincluded into the main
> book.xml
>
>
> I want to link to a glossterm, in appendix A, from chapter 4.
>
> My processing model is to expand xincludes, validate with Jing
> then transform the 'included' version using docbook.
>
> hot text works

This should work, although it's a bit unusual in my opinion. Why not using
xrefs? :)


> > xlink:href='glossary.html#gloss.validation.candidate'>candidates
> works (but seems brittle)

Yes, but I can not recommend it (it is dangerous, because when
glossary.html disappears or renamed, you'll have a problem).


> I'm guessing olink works too.

IMHO this is only worth the hassle if you want your xincluded documents
validate independently from your main document.


> but I guess we are getting to the point where
> we have quite a few ways of linking between 'chunks' now.

Maybe. :)

Have you tried glossterm as an inline element? In [1] there is a helpful
example.

Good luck!


Hope that helps,
Tom

----
[1] http://www.sagehill.net/docbookxsl/LinkToGlossary.html

--
Thomas Schraitle

Hi,

On Montag, 26. Mai 2008, Thomas Schraitle wrote:
> [...]
> > hot text works
>
> This should work, although it's a bit unusual in my opinion. Why not
> using xrefs? :)

Arg, I have to correct myself: xref can not work as there is no title in a
glossary entry. I'm so used to it, that I almost naturally answer with
xref. :)


Tom

--
Thomas Schraitle

Hi Thomas

Thomas Schraitle wrote:
> Hi,
>
> On Montag, 26. Mai 2008, Dave Pawson wrote:
>> Scenario

>> I want to link to a glossterm, in appendix A, from chapter 4.
>>
>> My processing model is to expand xincludes, validate with Jing
>> then transform the 'included' version using docbook.
>>
>> hot text works
>
> This should work, although it's a bit unusual in my opinion. Why not using
> xrefs? :)

I thought (clearly wrongly) that xrefs were within a single file
and I have used them in that scenario. The benefit of xref is that
we are warned when we mess up!
One more to add to the list




>> but I guess we are getting to the point where
>> we have quite a few ways of linking between 'chunks' now.
>
> Maybe. :)
>
> Have you tried glossterm as an inline element? In [1] there is a helpful
> example.

> [1] http://www.sagehill.net/docbookxsl/LinkToGlossary.html


No, I don't often use glossaries.
I note the caution there though. This too seems a little 'brittle'.

Or perhaps we are getting to the point where we could do with
more 'validation', perhaps Schematron checking of links.

What else could Schematron do for us? Or are there just too
many link options?


regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

In a similar scenario, I used XRef and Xreflabel attribute to set the
displayed text for the xref linkend.
However, the problem was that XRef resolved with (on page xx) attached to
the displayed text. (DocBook 4)

Akagi


Dave Pawson wrote:
>
> Scenario
>
> docbook book. v5
> Each chapter and appendix is a seperate file xincluded into the main
> book.xml
>
>
> I want to link to a glossterm, in appendix A, from chapter 4.
>
> My processing model is to expand xincludes, validate with Jing
> then transform the 'included' version using docbook.
>
> hot text works
>
> > xlink:href='glossary.html#gloss.validation.candidate'>candidates
> works (but seems brittle)
>
> I'm guessing olink works too.
>
> but I guess we are getting to the point where
> we have quite a few ways of linking between 'chunks' now.
>
>
>
>
> regards
>
> --
> Dave Pawson
> XSLT XSL-FO FAQ.
> http://www.dpawson.co.uk
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>

--
View this message in context: http://www.nabble.com/link-linkend-xlink%3Ahref-olink-and-xinclude%2C-v5-tp17470400p17494055.html
Sent from the docbook apps mailing list archive at Nabble.com.