On 30 April 2013 16:04, Petr Kovar <pk...@volny.cz> wrote: > Hey Luc, >
Hey Petr, On Mon, 29 Apr 2013 18:19:35 +0300 > Luc Pionchon <pionchon....@gmail.com> wrote: > > > Hello, > > > > I am wondering how to install a local help page so that it integrates > with > > the system help. Especially in the context of user plugin help page. But > > this could be for any user help page with links to/from the system help. > > If you only need to link to a page in gnome-help (if that's what you mean > by system help) from your standalone docs, prefix the ID of the page you > want to link to with "help:gnome-help/", for example: > > <link xref="help:gnome-help/index">link to gnome-help index page</link> > Yes, the link works in this direction. With one detail though, if you set your link with no value <link xref="help:gnome-help/index"/>, then yelp does not get the label from the referenced page, it just uses "help:gnome-help/index". How to get the referenced title on the link? (Another issue, is that "help:gnome-help/index" is a magic value. You have to look at the source code of the page to get the value. But lets assume that this one is acceptable for now.) This will not work for all links in Mallard however, so if you want your > pages to be part of gnome-help so that you can use automatic linking, for > Yes, I want it to work also in that direction. example, you need to install your pages into the gnome-help installation > directory (which is /usr/share/help/C/gnome-help/ for C locale on Fedora, > and other distros will likely use similar paths). That's what we do with > Getting Started, which is basically a plugin for gnome-help. > I want it to work for a user who does not have administrator rights. To rephrase the use case, it is for a user plugin help page (*). The page is (somewhere) in $HOME. It is certainly needed to register this page to the help system. Then the page must show in the Application help, under the specified page/section. (*) it could be generalized to any complementary help page that a user feel needed. Either as a topic of an existing guide, either as a new guide. How should I proceed? Luc
_______________________________________________ gnome-i18n mailing list gnome-i18n@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-i18n
