Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 671478 - app-office/libreoffice offline help broken
Summary: app-office/libreoffice offline help broken
Status: CONFIRMED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: Normal normal with 2 votes (vote)
Assignee: Gentoo Office Team
URL:
Whiteboard:
Keywords: PATCH
Depends on:
Blocks:
 
Reported: 2018-11-18 21:35 UTC by Vincent Reher
Modified: 2021-02-03 18:57 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
Patch to libreoffice-6.1.3.2.ebuild (lohelp-ebuild.patch,1.80 KB, patch)
2018-11-18 21:35 UTC, Vincent Reher
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Vincent Reher 2018-11-18 21:35:38 UTC
Created attachment 555678 [details, diff]
Patch to libreoffice-6.1.3.2.ebuild

Building Libreoffice >= 6.1 with current ebuilds results in the inability to access either offline or online help.

Invoking general or context sensitive help results in user's browser attempting to open URL 'file:///usr/lib64/libreoffice/help/index.html?swriter/.uno:HelpIndex?Language=en-US&System=UNIX&Version=6.1'. The required index.html and associated javascript files are not there, so browser gives not found' error. I think the problem may be partly due to LO's recent changes to its default help format.

After some experimentation, I was able to fix the problem by changing help-related configure parameters and removing what appeared to be obsolete workarounds pertaining to https://bugs.freedesktop.org/show_bug.cgi?id=46506. See attachment for details.

With the patched ebuild accessing help works as follows: If no offline helppack is installed, the javascript detects this and offers to access online help which it will do successfully. If an offline helppack is installed, the local HTML help files are used.
Comment 1 Vincent Reher 2018-11-20 03:28:37 UTC
To shed light on the rather counter-intuitive configure option '--without-helppack-integration' suggested in my patch: according to './configure --help', while this option "will not integrate the helppacks to the installer of the product", it does recommend to "use this switch to use the online help or separate help packages".

Also in regard to '--with-help' option: it is stated that "There is a special parameter "common" that can be used to bundle only the common part, .e.g help-specific icons". While that sounded promising, specifying '--with-help=common' results in a configure error.
Comment 2 Paul Gover 2019-01-09 13:24:09 UTC
I'm getting the same problem with 6.1.4.2
Comment 3 Mario Bachmann 2019-02-18 07:20:31 UTC
"F1" ist still not working in libreoffice 6.1.5.2. 
To open the libreoffice help system press F1 and the browser shows "404 not found". 

The patch by Reher still works with 6.1.5.2. To get detailed information simply extract the libreoffice sources and run "./configure --help"

--with-help             Enable the build of help. There is a special
                        parameter "common" that can be used to bundle only
                        the common part, .e.g help-specific icons. This is
                        useful when you build the helpcontent separately.

                        Usage:     --with-help    build the old local help
                                --without-help     no local help (default)
                                --with-help=html   build the new HTML local help
                                --with-help=online build the new HTML online help

--without-helppack-integration
                    It will not integrate the helppacks to the installer
                    of the product. Please use this switch to use the
                    online help or separate help packages.
Comment 4 Andreas Sturmlechner gentoo-dev 2019-02-18 07:39:12 UTC
Thanks to your work so far. I haven't had time yet to look into the issue, but I can confirm it at least.
Comment 5 UlvHare 2019-02-18 10:32:19 UTC
The same problem with 6.1.4.2 and 6.1.5.2
Modifying ebuilds as in V. Reher's patch solve that. Thanks!
Comment 6 Larry the Git Cow gentoo-dev 2019-03-30 09:59:53 UTC
The bug has been referenced in the following commit(s):

https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=214fb6b50b013531dc3a255492726d5e0cc3bcda

commit 214fb6b50b013531dc3a255492726d5e0cc3bcda
Author:     Andreas Sturmlechner <asturm@gentoo.org>
AuthorDate: 2019-03-28 16:05:24 +0000
Commit:     Andreas Sturmlechner <asturm@gentoo.org>
CommitDate: 2019-03-30 09:58:22 +0000

    app-office/libreoffice: Drop offlinehelp hacks, use --with-help=html
    
    Thanks-to: V. Reher <vreher@cox.net>
    Bug: https://bugs.gentoo.org/671478
    Package-Manager: Portage-2.3.62, Repoman-2.3.12
    Signed-off-by: Andreas Sturmlechner <asturm@gentoo.org>

 app-office/libreoffice/libreoffice-6.2.9999.ebuild | 28 ++--------------------
 app-office/libreoffice/libreoffice-9999.ebuild     | 28 ++--------------------
 2 files changed, 4 insertions(+), 52 deletions(-)
Comment 7 CaptainBlood 2019-10-30 09:19:12 UTC
'Help/Help F1' remains enactive here:
--------------------------------------------------------------------------------
app-office/libreoffice
     Installed versions:  6.3.3.2(06:16:54 30/10/2019)(gtk pdfimport -accessibility -bluetooth -branding -coinmp -cups -dbus -debug -eds -firebird -googledrive -gstreamer -gtk2 -java -kde -ldap -mariadb -odk -postgres -test ELIBC="-FreeBSD" LIBREOFFICE_EXTENSIONS="-nlpsolver -scripting-beanshell -scripting-javascript -wiki-publisher" PYTHON_SINGLE_TARGET="python3_6 -python2_7 -python3_5 -python3_7" PYTHON_TARGETS="python3_6 -python2_7 -python3_5 -python3_7")
--------------------------------------------------------------------------------
pp-office/libreoffice-l10n
     Available versions:  6.2.5.2^s ~6.2.8.2^s (~)6.3.3.2^s {offlinehelp L10N="af am ar as ast be bg bn bn-IN bo br brx bs ca ca-valencia cs cy da de dgo dz el en en-GB en-ZA eo es et eu fa fi fr ga gd gl gu gug he hi hr hu id is it ja ka kk km kmr-Latn kn ko kok ks lb lo lt lv mai mk ml mn mni mr my nb ne nl nn nr nso oc om or pa pl pt pt-BR ro ru rw sa sat sd si sid sk sl sq sr sr-Latn ss st sv sw-TZ ta te tg th tn tr ts tt ug uk uz ve vi xh zh-CN zh-TW zu"}
     Installed versions:  6.3.3.2^s(10:53:08 30/10/2019)(offlinehelp L10N="fr -af -am -ar -as -ast -be -bg -bn -bn-IN -bo -br -brx -bs -ca -ca-valencia -cs -cy -da -de -dgo -dz -el -en -en-GB -en-ZA -eo -es -et -eu -fa -fi -ga -gd -gl -gu -gug -he -hi -hr -hu -id -is -it -ja -ka -kk -km -kmr-Latn -kn -ko -kok -ks -lb -lo -lt -lv -mai -mk -ml -mn -mni -mr -my -nb -ne -nl -nn -nr -nso -oc -om -or -pa -pl -pt -pt-BR -ro -ru -rw -sa -sat -sd -si -sid -sk -sl -sq -sr -sr-Latn -ss -st -sv -sw-TZ -ta -te -tg -th -tn -tr -ts -tt -ug -uk -uz -ve -vi -xh -zh-CN -zh-TW -zu")
-------------------------------------------------------------------------------
locale -a
C
C.utf8
fr_FR.utf8
POSIX
-------------------------------------------------------------------------------
locale
LANG=fr_FR.utf8
LC_CTYPE="fr_FR.utf8"
LC_NUMERIC="fr_FR.utf8"
LC_TIME="fr_FR.utf8"
LC_COLLATE="fr_FR.utf8"
LC_MONETARY="fr_FR.utf8"
LC_MESSAGES="fr_FR.utf8"
LC_PAPER="fr_FR.utf8"
LC_NAME="fr_FR.utf8"
LC_ADDRESS="fr_FR.utf8"
LC_TELEPHONE="fr_FR.utf8"
LC_MEASUREMENT="fr_FR.utf8"
LC_IDENTIFICATION="fr_FR.utf8"
LC_ALL=
-------------------------------------------------------------------------------
cat /etc/X11/xorg.conf.d/30-keyboard.conf 
Section "InputClass"
	Identifier "keyboard-layout"
        MatchIsKeyboard "on"

	Option "XkbModel" "pc104"
	Option "XkbLayout" "fr"
#	Option "XkbVariant" ""

#	Option "XkbOptions" ""
EndSection
Comment 8 Vincent Reher 2019-11-04 16:07:31 UTC
CaptainBlood, you may be encountering the same issue that I did when LO first changed its help format to one that is supposed to be accessed by an external browser: The help page was being opened in a new tab in an exising browser window, possibly buried under others, and often located in another virtual desktop. This would all happen in the background as the focus was not being switched to the LO help window/tab. That was very confusing behavior on my very busy desktop!

I think LO is using xdg-open or something equivalent to locate and invoke your "default" browser, which is probably configured by default to open URLs from external applications in new tabs in existing browser windows. This behavior can be changed via browser configuration and/or customized XDG .desktop files + mimeapps.list.  In any case, this default behavior is neither a Libreoffice problem, nor a Gentoo ebuild problem.

If this does not turn out to be your issue, check to make sure that LO help truly was installed by going to /usr/lib64/libreoffice/help/index.html.
Comment 9 CaptainBlood 2019-12-24 23:43:27 UTC
Right...
~/.config/mimeapps.list updated.
Testing from librecalc:

Browser reports missing /usr/lib64/libreoffice/help/en-US/text/scalc/main0000.html?System=UNIX&DbPAR=CALC

which only exist within localized path:
/usr/lib64/libreoffice/help/fr/text/scalc/main0000.html?System=UNIX&DbPAR=CALC

Only L10N="fr" here.

Thks 4 ur attention.
Comment 10 UlvHare 2020-01-10 06:55:08 UTC
Practically the same as in CaptainBlood's situation (comment №9), but for "ru_RU.utf8" locale. Temporary workaround is manual change locale substring in browser address line every time. So for now the problem is: "Why localised Libreoffice tries to find absent en-US help ignoring present localised one?"
Comment 11 F... 2021-02-03 18:57:07 UTC
Hi.

Same problem here with LO 7.0.4.2.


I now use a workaround:

As root, in /usr/lib64/libreoffice/help/:

# ln -s fr en-US


Not the proper way I must confess, but it does the job since every link in help pages contains the localized path.