
<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=UTF-8">

</head>

<body><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">On Wednesday, October 27, 2021 4:31:11 PM CDT Jack Ostroff wrote:</p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">> Can anyone suggest where to start looking for relevant config</p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">> differences between users?</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- 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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- On Gentoo, at least, the relevant .desktop files are found in /usr/share/applications/. KDE apps are all called org.kde.applicationname.desktop.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- 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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- 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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- In the working directory where I'm editing a new Handbook I entered these commands:</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">meinproc5 --check --cache index.cache index.docbook</p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">bzip2 index.cache</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">This generated a compressed html file named "index.cache.bz2".</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- Finally, I copied everything from my working directory on ~/ to /usr/share/help/en/Testing/.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">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.</p>

<br /><p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">Jack, I hope this is helpful. A bit cumbersome, but it works.</p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">-- </p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">David Bryant</p>

<p style="margin-top:0;margin-bottom:0;margin-left:0;margin-right:0;">Canyon Lake, Texas</p>

</body>

</html>