how to view newly processed help files

Jack ostroffjh at users.sourceforge.net
Wed Oct 27 01:30:13 BST 2021


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


More information about the kde-doc-english mailing list