Re: Linking to a paragraph from another XML document

On 5 Dec 2008, at 12:59, Hannes Magnusson wrote:

On Fri, Dec 5, 2008 at 13:17, Anthony Bedford <Anthony.Bedford@sun.com> wrote:

Hi, I need some help with getting linking to work please. I have the following in one XML document: <para xml:id="mysqli.overview.mysqlnd"> and I want to link to it from another document. I'm using: <xref linkend="mysqli.overview.mysqlnd" />

I don't think PhD would paste in the content of the paragraph, doesn't it just create an empty <a></a> element in this case? IIRC the xref implementation requires either title as the first-child of the endlink, or xreflabel on the endlink element. In phpdoc we usually use entity magic to "copy&paste" the same content again and again and again.

Yeah, I think I'm not doing it correctly then as I was doing this: <para xml:id="mysqli.overview.mysqlnd"> <emphasis role="bold">What is PHP's MySQL Native Driver?</emphasis> </para> I think it's only going to work for a section title. :) The following *does* work however: <link linkend="mysqli.overview.mysqlnd">What is PHP's MySQL Native Driver?</link> I guess I could use an entity for the link text as you say.

However, when I re-configure and rebuild what I actually get is a link to is mysqli.overview, that is the top of the document, rather than the specific paragraph I want.

Hmh. mysqli.overview is the parent chunk of the paragraph right? So the link is correct, just missing the fragment?

Not quite. Following the link takes me to the right document, but not down to the correct paragraph.

Could be a bug. I remember some issues with <link linkend="not.a.chunk"> not returning fragments.. could be similar problem now with xref..

Possibly. This may need investigating further, at least the linking side of things. Thanks, Tony