|
From: Dan M. <mu...@al...> - 2003-01-20 06:04:13
|
On Fri, 17 Jan 2003, Camille B=E9gnis wrote: > Well, this is my point. I find legitimate that a Mandrake fresh user ca= n=20 > find a "Mandrake" top level category in his help browser; moreover when= =20 > the books found under it cover a large spectrum of topics from=20 > installation to system admin, through KDE, gnome, etc. > What approach do you recommend in this case? ScrollKeeper doesn't currently provide a nice mechanism to do what you=20 want. I'm not sure whether it should or not. =20 When GNOME used Nautilus as the help browser, we had what we called "toplevel documents" which were listed in an XML file installed by Nautilus. These documents would appear at the top of the document index.= =20 This made it easy for a given distributor (such as Mandrake) to just customize one data file to get documents to appear in a prominent location. Having it done in the help browser instead of ScrollKeeper=20 meant that only the help browser could control which are the toplevel=20 documents, instead of allowing each package to tell ScrollKeeper which=20 documents it thinks should be in the toplevel. One option would be to hack the ScrollKeeper category list shipped by Mandrake and add a new category at the top called "Mandrake". That would= =20 vanish though if the user installs a non-Mandrake version of ScrollKeeper= ,=20 so I don't see that as a very nice solution. It may be a stopgap solutio= n=20 though. I prefer having a single data file installed on the system which indicate= s=20 which documents belong at the top. This could be an optional=20 configuration file for the help browser or ScrollKeeper which would not=20 get written over by upgrading either package. That would maintain the=20 top documents if the user does an upgrade. Dan |