This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: keyword in index of htmlhelp
- From: Pirjo Tinat <ptinat at yahoo dot com>
- To: abx at abx dot art dot pl, docbook-apps at lists dot oasis-open dot org
- Date: Thu, 28 Nov 2002 12:34:53 +0000 (GMT)
- Subject: Re: DOCBOOK-APPS: keyword in index of htmlhelp
- Reply-to: pirjo dot tinat at donesolutions dot com
I think the hhk generation is based on <indexterm>. You can then use
<primary> and <secondary> to define whether it is a keyword or a
sub-keyword.
Make sure that the reference will be to the topic level (.html), not
to an anchor (.html#anchorid), as that created some unexpected
problems in chm.
HTH,
Pirjo :-)
--- Wlodzimierz Skiba <abx@abx.art.pl> wrote: >
> I've created HHK with
> <xsl:param name="generate.index">1</xsl:param>
> <xsl:param name="htmlhelp.use.hhk">1</xsl:param>
> and it is included in *chm corectly but empty. I have no idea how
> to insert
> elements there and can't find any description in attached doc.
> Reading DocBook
> I guessed that <keyword>MyKeyword</keyword> could be good place to
> define
> entries for index of CHM file. But it not works and I can't
> recognize in
> template "hhk" what is included in HHK as entries (I don't know XSL
> well yet).
>
> But going further I think keyword could be used for nice automated
> index.
> Keywords appear in <*info> areas and every <*info> has own well
> known parent.
> So it makes ready entry for index. Imagine such document:
>
> <chapter>
> <chapterinfo>
> <keywordset>
> <keyword>MyKeyword 1</keyword>
> </keywordset>
> </chapterinfo>
> :
> <section>
> <sectioninfo>
> <keywordset>
> <keyword>MyKeyword 2</keyword>
> </keywordset>
> </sectioninfo>
> :
> </section>
> :
> </chapter>
>
> let's say chapter is rendered on pages 7-13 and section is on page
> 10 then it
> could automatically create index during render:
>
> Index
> MyKeyword 1
> 7-13
> MyKeyword 2
> 10, ... (other pages where this keyword appears)
>
> (Sorry if there is already some automation in this metter, I don't
> know all
> possibilities of DocBook XSL and can't find any other reference
> than this
> attached to stylesheets).
>
> Wlodzimierz Skiba
=====
Pirjo Tinat
Documentation Specialist, Team Manager
Done Information Oy
Tukholmankatu 2, 00250 Helsinki
tel. +358-(0)20 525 3380
mobile +358-(0)40 830 5171
pirjo.tinat@donesolutions.com
__________________________________________________
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