GNOME Bugzilla – Bug 706223
Yelp cannot display local manuals from a path using help: but it works with ghelp:
Last modified: 2013-08-18 15:55:33 UTC
As discovered in bug #687563, ---------- "yelp uses file:// urls for local files and help:app_id urls for installed help packages. this command does not work: yelp help:///home/bmonkey/workspace/ges/pitivi/help/C/ but this does: yelp file:///home/bmonkey/workspace/ges/pitivi/help/C/ Pitivi uses Gtk.show_uri to open the file. The file url would open the directory in nautilus. When index.page would be chosen, it would open either a web browser or a text editor, depending on which mime type was recognized and which application is associated with it. Yelp does not install a mime type for *.page files, could be something like x-mallard. So this won't work. But this still works: yelp ghelp:///home/bmonkey/workspace/ges/pitivi/help/C/ " ------------ TL;DR: "help:" URIs don't work like "ghelp:" URIs used to for local files. We can't move to them in Pitivi until they do...
This is how the help: URI scheme was designed. If you need to load help from an arbitrary location, use a file: URI (but note that you need to handle loading the right translation yourself). If you're just installing to a non-standard prefix, then set XDG_DATA_DIRS.\ The help: URI scheme is for locating resources, not overriding MIME types. And using it with a full path like that would break compatibility with the legacy KDE scheme, which it was designed to coexist with.