RE: DOCBOOK-APPS: HTML Help "Related Topics" button

[David Cramer <dcramer at broadjump dot com>]

I've been experimenting with adding related topics as well. I played with Klink, but was having trouble getting the results I wanted. The way I've done it, you add keywordsets in the *info elements for each chunk. If two chunks share a keyword, then each will appear in the other's related topics list by title. 

http://www.thingbag.net/docbook/related-topics.xsl
http://www.thingbag.net/docbook/relatedtopicstest.zip

I've tested it with help-like cases (chapters and sections, with chunk.first.sections=1 and chunk.section.depth=100) and it seems to work ok. It doesn't handle book-like chms (with chunk.first.sections=0 or chunk.section.depth=0) so well: the result is that any element with a *info/keywordset that is not chunked doesn't get a related topics button. 

I'm ok with those limitations, so I'll probably stop here, but I thought I'd post it in case anybody else is interested in using it or improving on it.

David

> -----Original Message-----
> From: Pirjo Tinat [mailto:ptinat@yahoo.com]
> Sent: Tuesday, November 12, 2002 5:45 AM
> To: Jirka Kosek
> Cc: docbook-apps@lists.oasis-open.org
> Subject: Re: DOCBOOK-APPS: HTML Help "Related Topics" button
> 
> 
> Thank you!
> 
> We used the itemized list approach:
> 
> <itemizedlist role="related">
> <title>Related Topics</title>
> <listitem><para>Label parameters</para></listitem>
> </itemizedlist>
> 
> and used XSL to get the following in HTML:
> 
> <OBJECT
>   CLASSID="clsid:ADB880A6-D8FF-11CF-9377-00AA003B7A11"
>   ID="KeywordSearch"  TYPE="application/x-oleobject">
>   <PARAM  NAME="Command"  VALUE="KLink,MENU">
>   <PARAM  NAME="Button"  VALUE="Text:Related Topics">
>   <PARAM  NAME="Font"  VALUE="MS Sans Serif,8,0,,">
>   <PARAM  NAME="Item1"  VALUE="">
>   <PARAM  NAME="Item2"  VALUE="Label parameters">
> </OBJECT>
> 
> and it worked.
> 
> Pirjo :-)
> 
>  --- Jirka Kosek <jirka@kosek.cz> wrote: > Pirjo Tinat wrote:
> > 
> > > That is why I want to use the KeywordSearch functionality of HTML
> > > Help: I know that from topic "Labels: parameter ABC" I want the
> > user
> > > to be able to access all other Label parameters, which all have
> > been
> > > given the indexterm "Label parameters". However, I cannot be sure
> > in
> > > advance which particular Label parameters will be present in the
> > > customer's application or if the application is going to include
> > new
> > 
> > OK. If you want Related Topics only in HTML Help version, I would
> > suggest using PI for marking it up:
> > 
> > <?dbhh related="Label parameters"?>
> > 
> > If you want to process this in all outputs, you can use dummy list:
> > 
> > <itemizedlist role="related">
> > <title>Related Topics</title>
> > <listitem><para>Label parameters</para></listitem>
> > </itemizedlist>
> > 
> > In any case you must customize stylesheets to turn markup into some
> > ActiveX object references for HTML Help.
> > 
> > 			Jirka
> > 
> > -- 
> > -----------------------------------------------------------------
> >   Jirka Kosek  	                     
> >   e-mail: jirka@kosek.cz
> >   http://www.kosek.cz 
> 
> __________________________________________________
> Do You Yahoo!?
> Everything you'll ever need on one web page
> from News and Sport to Email and Music Charts
> http://uk.my.yahoo.com
>