This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
RE: HTML Help "Related Topics" button
- From: David Cramer <dcramer at broadjump dot com>
- To: pirjo dot tinat at donesolutions dot com, Jirka Kosek <jirka at kosek dot cz>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Sat, 04 Jan 2003 15:54:05 -0600
- Subject: RE: DOCBOOK-APPS: HTML Help "Related Topics" button
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
>