docbook: Xref & Link
Subject:
Re: Xref & Link
From:
Tabatha Persad ####@####.####
Date:
17 Jan 2003 04:11:54 -0000
Message-Id: <1042776990.23355.21.camel@mysticchild.dbsoftware.com>
Well, lemme see if I can make any sense out of this. Your snip below
shows that you tried to create a title id, but I'm not sure that title
accepts an id. If you want to use endterm, you need to use the
titleabbrev tag after the title, and use the id in the titleabbrev tag
(as I showed in my example).
I remember having an issue with closing xrefs using the </xref> tag. I
found out the hard way that /> works fine, even in XML. I have to
wonder if that's not part of the problem, but don't know for sure.
Though your error is saying the linkend ID is missing, I think what it's
really telling you is that part of the whole xref statement is wrong
somehow.
Try using /> instead of </xref>, and if you use "endterm" in the xref
linkend, make sure you add a titleabbrev tag after the title (like I
demonstrated). This should work just fine, and I'd like to hear from
you if it doesn't! I had a lot of problems with xrefs when I got
started, and don't want to see you go through the same!
Please let me know if that helps at all!
Tab
On Thu, 2003-01-16 at 19:46, Jacob C wrote:
> Thanks Tabatha. It seems a little weird that it would be done like that. I
> will try it but isn't the problem with referencing the section id and not
> the title, or am I missing something in thinking that way?
>
> Snippet of original post:
>
> >> <xref linkend="storinglogs" endterm="storinglogs.title"></xref>
> > > <section id="storinglogs">
> > > <title id="storinglogs.title">Storing of Log Files
> (NFS)</title>
>
> The error that is produced:
>
> >> XRef LinkEnd to missing ID 'storinglogs'
>
> I also tried it w/out the period in the endterm and title is, as Greg
> suggested but it didn't seem to make a difference.
>
> Jacob
>
>
> ----- Original Message -----
> From: "Tabatha Persad" ####@####.####
> To: "Jacob C" ####@####.####
> Cc: ####@####.####
> Sent: Thursday, January 16, 2003 7:54 PM
> Subject: Re: Xref & Link
>
>
> > Hi Jacob,
> >
> > Know the feeling, still post here too when I have my blonde moments.
> >
> > Do you need to have the endterm? Try this, make your ids look like:
> > <section id="whatever">
> > <title>The Whatever Section</title>
> >
> > Then when you want to cross ref to it, insert:
> > <xref linkend="whatever" />
> >
> > This will give you the section number, rather than the name. If you
> > really must have the endterm, you have to make your section look like:
> > <section id="whatever">
> > <title>The Whatever Section</title>
> > <titleabbrev id="sect_whatever">Whatever Section</titleabbrev>
> >
> > Then when you cross ref to it, insert:
> > <xref linkend="whatever" endterm="sect_whatever" />
> >
> > This will then display what was in quotes for endterm instead of just
> > "Section 1.1" (or whatever number is designated).
> >
> > Hope that helps!
> >
> > Tabatha
> >
> >
> > On Thu, 2003-01-16 at 14:10, Jacob C wrote:
> > > Hi All,
> > >
> > > My apologies for posting so much over the past few days but I am at that
> stage in the laerning curve where it's the steepest and besides, you all
> give such great advice :-)
> > >
> > > I am having a problem with establishing links to content within a
> docbook. I have the following XML:
> > >
> > > <section>
> > > <title>Error & Parse Time Logging</title>
> > > <para>All logging in the system is file based. For further
> information on how the logs are stored see <xref linkend="storinglogs"
> endterm="storinglogs.title"></xref>.</para>
> > > </section>
> > > <section id="storinglogs">
> > > <title id="storinglogs.title">Storing of Log Files
> (NFS)</title>
> > > <para></para>
> > > </section>
> > >
> > > I also tried:
> > >
> > > <link linkend="storinglogs" endterm="storinglogs.title"></link>
> > >
> > > I receive:
> > >
> > > XRef LinkEnd to missing ID 'storinglogs'
> > >
> > > I read somewhere that the ID needs to be defined in the DTD but that
> doesn't make any sense to me.
> > >
> > > Your help is much appreciated,
> > > Jacob
> > --
> > Tabatha Persad
> > Web: www.merlinmonroe.com
> > Linux Documentation Project Review Coordinator (http://www.tldp.org)
> > Gnu Writing Movement Contributor (http://gwm.gnu.org)
> > Linux Counter Area Manager US:wa (http://counter.li.org)
> >
> >
> >
>
>
>
> ______________________
> http://lists.tldp.org/
--
Tabatha Persad
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Gnu Writing Movement Contributor (http://gwm.gnu.org)
Linux Counter Area Manager US:wa (http://counter.li.org)
