On Wed, 21 Jan 2004, bulia byak wrote:
> >From: Jonathan Phillips <jon@...>
> >I have not done much looking into adding the keyboard shortcuts and man
> >page to the help menu for the next release. I really want to do this
> >task, but could you use any help pointing me how to do this.
> >I wonder what the best way to accomplish this task would be? I guess we
> >could add a link to the keyboard shortcuts page to the webpage where the
> >shortcut keys are located, or we could set up a file where the keyboard
> >keys are located in the source and you could edit that file so that on
> >CVS build, all keys are updated accordingly.
> I think Inkscape should ship with its own copy of help files in HTML,
> corresponding to the release. I think I will move the shortcuts from Wiki to
> XML and set up generating HTML in makefile. So, you can assume that the
> distribution includes an HTML file; your task is to run browser on it.
> As to the best way to run browser, I'm not sure. I doubt there is a
> cross-platform reliable way to detect the default browser and run it, but I
> may be wrong - anyone?
> If we cannot access default browser, perhaps we should store a browser
> executable path in preferences. But that's ugly.
Take a look at 'ScrollKeeper': http://scrollkeeper.sourceforge.net/
ScrollKeeper is a standard way of doing documentation that both GNOME
and KDE use. When you navigate to the 'Help' area in your start menu,
on most distros, that's the scrollkeeper system.
There are a number of different browsers that can understand
Scrollkeeper documentation, including the KDE Help Center, Nautilus, and
Yelp, the standard GNOME help browser.
Documents for ScrollKeeper are written in DocBook, so the source files
can also be used to produce HTML, PDF, etc. versions. This is why we
used DocBook for the manual; once Scrollkeeper support is in Inkscape,
then the manual could be shipped with the app directly, as a help
Anyway, take a look -- from what I can tell it seems to be the accepted
standard solution for handling help file browsing.