Re: [Scrollkeeper-devel] question re: marking index terms
- From: Laszlo Kovacs <laszlo kovacs Sun COM>
- To: gnome-doc-list gnome org
- Subject: Re: [Scrollkeeper-devel] question re: marking index terms
- Date: Wed, 28 Mar 2001 13:47:59 +0100
>
> hi
>
> I have a question on the type of index markers that scrollkeeper can support.
> Scrollkeeper needs the index marker to use an id to facilitate the "jump" from
> the index to the correct location in the document.
>
> DocBook has two kinds of index markers:
> - singular
> and
> - multiple
>
> 1. The singular index marker is inserted where the subject occurs in the text,
> eg.
> <para>
> The tiger<indexterm>
> <primary>Big Cats</primary>
> <secondary>Tigers</secondary></indexterm>
> is a very large cat indeed.
> </para>
>
> This method does not use an id.
>
> 2. There are two ways of using the multiple index marker:
> a) put index terms at start and end of a range of text, eg
>
> <para>
> The tiger<indexterm id="tiger-desc" class="startofrange">
> <primary>Big Cats</primary>
> <secondary>Tigers</secondary></indexterm>
> is a very large cat indeed…
> </para>
> ⋮
> <para>
> So much for tigers<indexterm startref="tiger-desc" class="endofrange">. Let's
> talk about
> leopards.
> </para>
>
> This method uses an id, and the indexterm markers are within context in the
> document.
>
> b) the other way to mark a range of text is to use the Zone attribute.
> This method specifies the content of an element (eg chapter, section)
> as the complete range. The index term therefore points to the id of
> the element.
> This method uses an id, but the index marks do not have to occur near the text
> being indexed.
> - this would not be of use to scrollkeeper.
> However, if the index marker was inserted at start of element it indexed then it
> could be used?
>
> Ok, those are my assumptions, I would be grateful if people could
> confirm/correct them so that I can ascertain how index markers
> should be used in scrollkeeper-compatible documents.
>
Anybody knows which of these "jumps" are supported right now by
gnome-db2html2?
Laszlo
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]