On 5 Dec 2008, at 12:59, Hannes Magnusson wrote:
On Fri, Dec 5, 2008 at 13:17, Anthony Bedford
<[EMAIL PROTECTED]> 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