docbook: Thread: Xref & Link

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 &amp; 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

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 &amp; 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)

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 &amp; 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)
>
>
>

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 &amp; 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)

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 &amp; 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/
>
>