Re: how to view newly processed help files
On Wednesday, October 27, 2021 4:31:11 PM CDT Jack Ostroff wrote: > Can anyone suggest where to start looking for relevant config > differences between users? I haven't yet figured out the configuration angle. But I did a little bit of reverse engineering, and I have figured out how to make khelpcenter play nice with a test version of a Handbook. Here's what I did. -- The README.metadata file in the khelpcenter source code explains how the "Application Manuals" section of the table of contents is organized. Briefly, there is a "desktop" file for each application program in the system. Khelpcenter uses that metadata to build the list of application manuals. -- On Gentoo, at least, the relevant .desktop files are found in /usr/share/applications/. KDE apps are all called org.kde.applicationname.desktop. -- I created a dummy desktop file "org.kde.testing.desktop" in the /usr/share/applications/ directory. A copy of that file is attached to this message. Some of the lines in that file may be unnecessary. This version works for me. Oh -- I see that "Testing" now shows up on the KDE start menu. I may be able to clean up the .desktop file to avoid that. Not sure if that can be done. -- I also created a new "Testing" directory in /usr/share/help/en/. This is where a working copy of the new documentation files will go. -- In the working directory where I'm editing a new Handbook I entered these commands: meinproc5 --check --cache index.cache index.docbook bzip2 index.cache This generated a compressed html file named "index.cache.bz2". -- Finally, I copied everything from my working directory on ~/ to /usr/share/help/en/ Testing/. After all this was done I started khelpcenter from the KDE start menu, and selected "Testing" from the "System" category. (In the .desktop file, attached, note the two lines "X- DocPath=Testing/index.html" and "Categories=Qt;KDE;System;".) Voila! My modified version of KOrganizer documentation appeared. All the links work. Etc. I suppose I can switch from using a working directory on ~/ and run meinproc5 directly against my root device. I haven't actually tried that, yet. It might create ownership problems later, when I run git push. I thought I might be able to use a symlink instead of copying everything into the /usr/ share/help/en/Testing/ directory. But I couldn't get that to work. Jack, I hope this is helpful. A bit cumbersome, but it works. -- David Bryant Canyon Lake, Texas org.kde.testing.desktop Description: application/desktop signature.asc Description: This is a digitally signed message part.
Re: how to view newly processed help files
On Wednesday, October 27, 2021 4:31:11 PM CDT Jack Ostroff wrote: > Can anyone suggest where to start looking for relevant config > differences between users? I've been playing around with this, and stumbled across a very inelegant, yet simple, solution. For me, at least, running khelpcenter as root makes everything work OK. There are several ways to do this ... the easiest one (for me) on Gentoo is to issue some terminal commands. /bin/su - root (enter password at prompt) cd /home/docfolder (wherever I've used meinproc5 to build new documentation) dbus-launch khelpcenter index.html Maybe we can eventually track down the bug. For now, this workaround should work for some of you. (In my experience, some Linux platforms -- notably Arch Linux -- won't let me do this. I suppose it might work with "sudo". Maybe I'll try that sometime, when I have one of my alternate OS setups booted up.) -- David Bryant Canyon Lake, Texas signature.asc Description: This is a digitally signed message part.
Re: how to view newly processed help files
On Wednesday, October 27, 2021 4:31:11 PM CDT Jack Ostroff wrote: > Can anyone suggest where to start looking for relevant config > differences between users? I suppose ~/.config/konquerorrc is as good a place as any. I'll poke around some more, but that's where I'd start. On my old ID it's 1.3 KB. For my new user it's only 0.8 KB. Looks promising, at first blush. -- David Bryant Canyon Lake, Texas signature.asc Description: This is a digitally signed message part.
Re: how to view newly processed help files
On 2021.10.27 16:57, David Bryant wrote: On Tuesday, October 26, 2021 6:31:51 PM CDT Jack wrote: > I currently have khelpcenter-5.7.6.21043, meinproc5 5.0, frameworkd > 5.85.0, plasma 5.22.5, and kde applications 21.04.3 (generally Gentoo > stable versions). > > What am I missing or forgetting, or has something really changed here? Just a few notes. Something definitely has changed. I suspect the "kio slaves", but I can't prove which one. As I pointed out in this bug report (https://bugs.kde.org/show_bug.cgi? id=443259), I can force khelpcenter to open pieces of a multi-segment handbook that were generated by meinproc5. I now know that part of this problem is caused by a configuration file somewhere in my ~/ directory. On my main account ("david"), when I open an html file in Konqueror, it gets handed off to Firefox instead. I have created a second user account ("davidb"). If I log in as "davidb", I can still open html files with Konqueror. And it doesn't invoke Firefox. Not as good as using khelpcenter, but good enough for proofreading, etc. I imagine it might be possible to figure out what the difference is by comparing a lot of configuration files. But I'm too lazyto do that right now. I'm happy enough being two users. At least it works, after a fashion. I confirm this. It does not work for myself or my already existing test user. It DOES work for root, and for a brand new user I just created. I suspect it might be at least partly due to file associations, depending on the relative position of Firefox and Konqueror for .html files, but I also think there may be something more directly related to kio and/or klauncher. Can anyone suggest where to start looking for relevant config differences between users? Jack
Re: how to view newly processed help files
On Tuesday, October 26, 2021 6:31:51 PM CDT Jack wrote: > I currently have khelpcenter-5.7.6.21043, meinproc5 5.0, frameworkd > 5.85.0, plasma 5.22.5, and kde applications 21.04.3 (generally Gentoo > stable versions). > > What am I missing or forgetting, or has something really changed here? Just a few notes. Something definitely has changed. I suspect the "kio slaves", but I can't prove which one. As I pointed out in this bug report (https://bugs.kde.org/show_bug.cgi? id=443259), I can force khelpcenter to open pieces of a multi-segment handbook that were generated by meinproc5. I now know that part of this problem is caused by a configuration file somewhere in my ~/ directory. On my main account ("david"), when I open an html file in Konqueror, it gets handed off to Firefox instead. I have created a second user account ("davidb"). If I log in as "davidb", I can still open html files with Konqueror. And it doesn't invoke Firefox. Not as good as using khelpcenter, but good enough for proofreading, etc. I imagine it might be possible to figure out what the difference is by comparing a lot of configuration files. But I'm too lazyto do that right now. I'm happy enough being two users. At least it works, after a fashion. -- David Bryant Canyon Lake, Texas signature.asc Description: This is a digitally signed message part.
Re: how to view newly processed help files
On 2021.10.26 19:35, Luigi Toscano wrote: Jack ha scritto: > I think this might be a new twist on an old issue. When editing docbooks, I > set up a separate folder outside the source tree, and from there I run > "meinproc5 path/to/index.docbook" and separately copy over the necessary png > files. I just did this, and typed "khelpcenter index.html" and was surprised > that khelpcenter did open, but the manual opened not in khelpcenter, but in > firefox. I even tried "konqueror index.html" and the same thing happened. I > recall discussions that meinproc5, without using explicit stylesheets, > produced html best viewed in a KDE browser, such as khelpcenter or konqueror, > which is what I always recall doing. It's been a while since I've tried this, > so I have no idea how many different components have been upgraded in the > meantime. I can imagine file associations controlling what application is > used if you click on a file in a file manager, but don't think I've ever seen > it override an explicit invocation of an application and file. > > I currently have khelpcenter-5.7.6.21043, meinproc5 5.0, frameworkd 5.85.0, > plasma 5.22.5, and kde applications 21.04.3 (generally Gentoo stable versions). > > What am I missing or forgetting, or has something really changed here? I believe something happened there, but I also think the argument of khelpcenter should be an help:/ URI, where kio_help should read the files from an appropriate directory (either the global ones or the local under ~/.local/share). Didn't we discuss this some time ago here? https://bugs.kde.org/show_bug.cgi?id=443259 That bug is certainly relevant, but I don't get any error from khelpcenter, probably because it IS able to launch firefox. Trying to open index.docbook doesn't open anything, but otherwise behaves the same. Some use of help:// opened a page at help.com. Most have khelpcenter show me the page not found message. khelpcenter file://index.html gives me a popup "Unable to dcreate io-slave. klauncher siad: Unknown protocol 'smb', which makes no sense at all, since I have absolutely no use of smb on my PC. It really does appear that some change in kio behavior is involved here. I do not ever remember opening docbook files directly in khelpcenter, but I definitely remember opening the index.html produced by meinproc5. However, also reading that bug again, more carefully, renaming index.html to index.cache does allow "khelpcenter index.cache" to open it with no problem. I agree with David that there is a bug somewhere, but I don't really know what to blame. What I might ask now is what is the recommended method of viewing the results of meinproc5 when editing docbook files. Khelpcenter does not open the docbook files for me (I have not tried renaming) and having to rename index.html to index.cache every time (or using a symlink) doesn't seem like it should be necessary. Is anyone other than David and mysef affected by this? Jack
Re: how to view newly processed help files
Jack ha scritto: > I think this might be a new twist on an old issue. When editing docbooks, I > set up a separate folder outside the source tree, and from there I run > "meinproc5 path/to/index.docbook" and separately copy over the necessary png > files. I just did this, and typed "khelpcenter index.html" and was surprised > that khelpcenter did open, but the manual opened not in khelpcenter, but in > firefox. I even tried "konqueror index.html" and the same thing happened. I > recall discussions that meinproc5, without using explicit stylesheets, > produced html best viewed in a KDE browser, such as khelpcenter or konqueror, > which is what I always recall doing. It's been a while since I've tried this, > so I have no idea how many different components have been upgraded in the > meantime. I can imagine file associations controlling what application is > used if you click on a file in a file manager, but don't think I've ever seen > it override an explicit invocation of an application and file. > > I currently have khelpcenter-5.7.6.21043, meinproc5 5.0, frameworkd 5.85.0, > plasma 5.22.5, and kde applications 21.04.3 (generally Gentoo stable > versions). > > What am I missing or forgetting, or has something really changed here? I believe something happened there, but I also think the argument of khelpcenter should be an help:/ URI, where kio_help should read the files from an appropriate directory (either the global ones or the local under ~/.local/share). Didn't we discuss this some time ago here? https://bugs.kde.org/show_bug.cgi?id=443259 -- Luigi