Re: [Scrollkeeper-devel] question re: marking index terms

[Pat Costello <Patrick Costello Sun COM>]

All, 

I'm a real beginner with Scrollkeeper. I have very little idea how Scrollkeeper 
is going to pull index detail out of a document. If Scrollkeeper uses ids, then 
does that mean the ids appear in the index? Many ids are just not meaningful to 
anyone but the original author. 

I have a series of questions about Scrollkeeper, so it probably wouldn't be a 
good idea to discuss them all in mail. What I need is a succint document that 
explains: 

- What Scrollkeeper is. 
- What Scrollkeeper does. 
- How Scrollkeeper works. 
- What writers need to do to their documents to make sure Scrollkeeper works. 
- What the role of the OMF file is for a) a whole book b) chapters in the book. 
- How writers create the OMF file. 

Would such a document exist? 

Thanks, 

Pat

> Delivered-To: gnome-doc-list gnome org
> To: gnome-doc-list gnome org
> Subject: Re: [Scrollkeeper-devel] question re: marking index terms
> Mail-Followup-To: gnome-doc-list gnome org
> Mime-Version: 1.0
> X-BeenThere: gnome-doc-list gnome org
> X-Loop: gnome-doc-list gnome org
> X-Mailman-Version: 2.0beta5
> List-Id: GNOME documentation issues <gnome-doc-list.gnome.org>
> 
> On Wed, Mar 28, 2001 at 09:35:46AM -0800, Gregory Leblanc wrote:
> 
> > What I'm really having a problem understanding is how we make the help
> > browser and scrollkeeper talk together for this index.  Looking at the
> > first markup that Mary gave an example of, there is no "id" tag for
> > these index terms.  Without an id tag, I'm not sure how the help browser
> > would know which occurance of the indexterm to link to. 
> 
> I think the ScrollKeeper indexing must be able to support this type of
> index markup, by keeping track of the id of the enclosing block (sect or
> whatever). It's important that we have a tool that is general, and can
> be applied to all valid DocBook, rather than trying to force our
> writers to use a subset.
> 
> 
> -- 
> John Fleck
> jfleck swcp com (h)
> jfleck abqjournal com (w)
> http://www.abqjournal.com/scitech/
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list