index merging, hhk file

[Tim Arnold]

hi,
The issue of the unmerged index entries I wrote about a few days ago seems to come up even in the htmlhelp hhk file generated from the stock xsl stylesheets. The tool I've been using to create hhk files (before converting to DocBook) creates the hhk file with merged index entries (as in the second part of the example below).

If the formatting comes through, the primary entry is colored green, twice, in the current implementation, but once in the format I think should be produced.

thanks for any info on this behavior, or comments...

--Tim Arnold

For example, part of my hhk file looks like this:
<LI><OBJECT type="text/sitemap">
  <param name="Name" value="cats ">
  <param name="Name" value="Animal Kingdom">
  <param name="Local" value="0.htm">
</OBJECT></LI>
<UL>
  <LI><OBJECT type="text/sitemap">
    <param name="Name" value="definition">
    <param name="Name" value="Details">
    <param name="Local" value="1.htm">
  </OBJECT></LI>
</UL>
<LI><OBJECT type="text/sitemap">
  <param name="Name" value="cats">
  <param name="Name" value="Animal Kingdom">
  <param name="Local" value="0.htm">
</OBJECT></LI>
<UL>
  <LI><OBJECT type="text/sitemap">
    <param name="Name" value="whiskers">
    <param name="Name" value="Anatomy">
    <param name="Local" value="2.htm">
  </OBJECT></LI></UL>

It seems to me the terms should be merged like this:

<LI><OBJECT type="text/sitemap">
  <param name="Name" value="cats">
  <param name="Name" value="Animal Kingdom">
  <param name="Local" value="0.htm">
</OBJECT></LI>
<UL>
  <LI><OBJECT type="text/sitemap">
    <param name="Name" value="definition">
    <param name="Name" value="Details">
    <param name="Local" value="1.htm">
    </OBJECT></LI>
  <LI><OBJECT type="text/sitemap">
    <param name="Name" value="whiskers">
    <param name="Name" value="Anatomy">
    <param name="Local" value="2.htm">
    </OBJECT></LI>




---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@...
For additional commands, e-mail: docbook-apps-help@...

[David Cramer (Tech Pubs)]

I haven't tested this with either html help or eclipse, but they may
automatically merge the entries for you in the output. I doubt many
DocBook users use hhk files since the default embedded activex goo works
fine.

David

> -----Original Message-----
> From: Tim Arnold [mailto:Tim.Arnold@...]
> Sent: Friday, October 02, 2009 1:16 PM
> To: DocBook Apps
> Subject: [docbook-apps] index merging, hhk file
>
> hi,
> The issue of the unmerged index entries I wrote about a few
> days ago seems to come up even in the htmlhelp hhk file
> generated from the stock xsl stylesheets. The tool I've been
> using to create hhk files (before converting to DocBook)
> creates the hhk file with merged index entries (as in the
> second part of the example below).
>
> If the formatting comes through, the primary entry is colored
> green, twice, in the current implementation, but once in the
> format I think should be produced.
>
> thanks for any info on this behavior, or comments...
>
> --Tim Arnold
>
> For example, part of my hhk file looks like this:
> <LI><OBJECT type="text/sitemap">
>   <param name="Name" value="cats ">
>   <param name="Name" value="Animal Kingdom">
>   <param name="Local" value="0.htm">
> </OBJECT></LI>
> <UL>
>   <LI><OBJECT type="text/sitemap">
>     <param name="Name" value="definition">
>     <param name="Name" value="Details">
>     <param name="Local" value="1.htm">
>   </OBJECT></LI>
> </UL>
> <LI><OBJECT type="text/sitemap">
>   <param name="Name" value="cats">
>   <param name="Name" value="Animal Kingdom">
>   <param name="Local" value="0.htm">
> </OBJECT></LI>
> <UL>
>   <LI><OBJECT type="text/sitemap">
>     <param name="Name" value="whiskers">
>     <param name="Name" value="Anatomy">
>     <param name="Local" value="2.htm">
>   </OBJECT></LI></UL>
>
> It seems to me the terms should be merged like this:
>
> <LI><OBJECT type="text/sitemap">
>   <param name="Name" value="cats">
>   <param name="Name" value="Animal Kingdom">
>   <param name="Local" value="0.htm">
> </OBJECT></LI>
> <UL>
>   <LI><OBJECT type="text/sitemap">
>     <param name="Name" value="definition">
>     <param name="Name" value="Details">
>     <param name="Local" value="1.htm">
>     </OBJECT></LI>
>   <LI><OBJECT type="text/sitemap">
>     <param name="Name" value="whiskers">
>     <param name="Name" value="Anatomy">
>     <param name="Local" value="2.htm">
>     </OBJECT></LI>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@...
> For additional commands, e-mail:
> docbook-apps-help@...
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@...
For additional commands, e-mail: docbook-apps-help@...

[Tim Arnold]

hi David,
I figured people must be happy or I would have found more in my googling.
Unfortunately for me, I have to generate both the hhk and index.xml files according to an internal spec, which means I'll have to merge them myself.

Oh well, once I get the xslt working, I can offer that back to the community. Seems like a good thing for the eclipsehelp style as well.

thanks,
--Tim

> -----Original Message-----
> From: David Cramer [mailto:dcramer@...]
> Sent: Friday, October 02, 2009 2:59 PM
> To: Tim Arnold; DocBook Apps
> Subject: RE: [docbook-apps] index merging, hhk file
>
> I haven't tested this with either html help or eclipse, but they may
> automatically merge the entries for you in the output. I doubt many
> DocBook users use hhk files since the default embedded activex goo works
> fine.
>
> David
>
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold@...]
> > Sent: Friday, October 02, 2009 1:16 PM
> > To: DocBook Apps
> > Subject: [docbook-apps] index merging, hhk file
> >
> > hi,
> > The issue of the unmerged index entries I wrote about a few
> > days ago seems to come up even in the htmlhelp hhk file
> > generated from the stock xsl stylesheets. The tool I've been
> > using to create hhk files (before converting to DocBook)
> > creates the hhk file with merged index entries (as in the
> > second part of the example below).
> >
> > If the formatting comes through, the primary entry is colored
> > green, twice, in the current implementation, but once in the
> > format I think should be produced.
> >
> > thanks for any info on this behavior, or comments...
> >
> > --Tim Arnold
> >
> > For example, part of my hhk file looks like this:
> > <LI><OBJECT type="text/sitemap">
> >   <param name="Name" value="cats ">
> >   <param name="Name" value="Animal Kingdom">
> >   <param name="Local" value="0.htm">
> > </OBJECT></LI>
> > <UL>
> >   <LI><OBJECT type="text/sitemap">
> >     <param name="Name" value="definition">
> >     <param name="Name" value="Details">
> >     <param name="Local" value="1.htm">
> >   </OBJECT></LI>
> > </UL>
> > <LI><OBJECT type="text/sitemap">
> >   <param name="Name" value="cats">
> >   <param name="Name" value="Animal Kingdom">
> >   <param name="Local" value="0.htm">
> > </OBJECT></LI>
> > <UL>
> >   <LI><OBJECT type="text/sitemap">
> >     <param name="Name" value="whiskers">
> >     <param name="Name" value="Anatomy">
> >     <param name="Local" value="2.htm">
> >   </OBJECT></LI></UL>
> >
> > It seems to me the terms should be merged like this:
> >
> > <LI><OBJECT type="text/sitemap">
> >   <param name="Name" value="cats">
> >   <param name="Name" value="Animal Kingdom">
> >   <param name="Local" value="0.htm">
> > </OBJECT></LI>
> > <UL>
> >   <LI><OBJECT type="text/sitemap">
> >     <param name="Name" value="definition">
> >     <param name="Name" value="Details">
> >     <param name="Local" value="1.htm">
> >     </OBJECT></LI>
> >   <LI><OBJECT type="text/sitemap">
> >     <param name="Name" value="whiskers">
> >     <param name="Name" value="Anatomy">
> >     <param name="Local" value="2.htm">
> >     </OBJECT></LI>
> >
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docbook-apps-unsubscribe@...
> > For additional commands, e-mail:
> > docbook-apps-help@...
> >
> >

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@...
For additional commands, e-mail: docbook-apps-help@...