Re: writing help files for gnome 2.0 programs

[Mikael Hallendal <micke codefactory se>]

lör 2002-08-24 klockan 17.42 skrev Allin Cottrell:
> On 24 Aug 2002, Mikael Hallendal wrote:
> 
> > > I'm not sure what "correctly setup" means here.  My document is a
> > > valid docbook "book" instance (it's quite long and complex).  It has a
> > > TOC alright, but this is not appearing in a left pane: it's all in one
> > > pane.
> 
> > * Top level node ("article" or "book") needs to have the id-attribute
> >   "index".
> 
> Ah, thanks, that did the trick, I have a left pane now.
> 
> As for getting my help file registered so that it appears in yelp's
> menu, I haven't yet succeeded.  I find that if I specify
> 
> <subject category="GNOME|Applications|Accessories"/>
> 
> in my .omf file (which is not right for my app, but is quoted from
> gedit-C.omf) and do scrollkeeper-rebuilddb, then my app appears under
> GNOME/Applications/Accessories.  But if I specify
> 
> <subject category="GNOME|Applications|Other"/>

That's because there is no GNOME/Applications/Other category.
ScrollKeeper has a tree of categories where you might put your
documents. Otherwise documents would end up all over the place because
someone might not like the predefined categories.

To see which categories are available you can do:

xsltproc -o categories.html \
/usr/share/scrollkeeper/stylesheets/categories.xsl \
/usr/share/scrollkeeper/Templates/C/scrollkeeper_cl.xml

where you have to replace /usr with the prefix you installed
ScrollKeeper if it is not in /usr.

Regards,
  Mikael hallendal

-- 
Mikael Hallendal                micke codefactory se
CodeFactory AB                  http://www.codefactory.se/
Office: +46 (0)8 587 583 05     Cell: +46 (0)709 718 918