Subject:
Re: Xref & Link
From:
"Jacob C" ####@####.####
Date:
17 Jan 2003 05:00:39 -0000
Message-Id: <005601c2bde5$5f6cc700$0300a8c0@tdak.com>
Well, it's still not perfect but it will have to do. After I tried some
suggestions Greg had made regarding doing a re-export of SGML_CATALOG_FILES
and after downloading the 4.2 catalog files (using ldp.dsl still bugs out on
me so I kept using docbook.dsl), I then made the changes Tabatha suggested.
Combined I still receive errors (which I think I can fix) BUT I also get all
the HTML outputted with the needed xref tags working and everything else
looks fine too!
It seems a little unintuitive to have to add the 'tittleabbrev' element and
it's never made clear in any documentation I've read. I guess that is just
the way it goes =0
Thanks for the help!
Jacob
----- Original Message -----
From: "Tabatha Persad" ####@####.####
To: "Jacob C" ####@####.####
Cc: ####@####.####
Sent: Thursday, January 16, 2003 9:16 PM
Subject: Re: Xref & Link
> 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)
>
>
> ______________________
> http://lists.tldp.org/
>
>
