scribus-doc puts docs in wrong place

[Ian Bruntlett]

the issue is that scribus does not use a standard location for
its docs ... typically deb packages ship their docs in
/usr/share/doc/<packagename> while scribus ships them in
/usr/share/<packagename>/doc ...

This is important because the Firefox snap only has permissions to access files in the standard location.

ProblemType: Bug
DistroRelease: Ubuntu 22.04
Package: scribus 1.5.8+dfsg-2
ProcVersionSignature: Ubuntu 6.5.0-26.26~22.04.1-generic 6.5.13
Uname: Linux 6.5.0-26-generic x86_64
ApportVersion: 2.20.11-0ubuntu82.5
Architecture: amd64
CasperMD5CheckResult: unknown
CurrentDesktop: ubuntu:GNOME
Date: Thu Mar 21 10:32:17 2024
InstallationDate: Installed on 2020-08-07 (1321 days ago)
InstallationMedia: Ubuntu 20.04.1 LTS "Focal Fossa" - Release amd64 (20200731)
SourcePackage: scribus
UpgradeStatus: Upgraded to jammy on 2022-08-15 (584 days ago)

[Mattia Rizzolo (mapreri)]

You are right that scribus needs them in what is the "wrong" location for the Debian policy, but I remember doing things so that it would work for both.

The package ships everything in /usr/share/scribus/doc and then sets up symlinks from e.g. /usr/share/doc/scribus/de to ../../scribus/doc/de (i.e. /usr/share/scribus/doc/de).

What is not working for you?

[Ian Bruntlett (ian-bruntlett)]

Hi Mattia,

On Sat, 23 Mar 2024 at 20:30, Mattia Rizzolo <email address hidden>
wrote:

> You are right that scribus needs them in what is the "wrong" location
> for the Debian policy, but I remember doing things so that it would work
> for both.
>
> The package ships everything in /usr/share/scribus/doc and then sets up
> symlinks from e.g. /usr/share/doc/scribus/de to ../../scribus/doc/de
> (i.e. /usr/share/scribus/doc/de).
>
> What is not working for you?
>

Well, Firefox (as a snap), for some reason or another, can't access the
files.

/usr/share/doc/scribus/en$ xdg-open index.html
Yields this error page in Firefox:

*File not foundFirefox can’t find the file at
/usr/share/doc/scribus/en/index.html. Check the file name for
capitalisation or other typing errors. Check to see if the file was
moved, renamed or deleted.*

/usr/share/scribus/doc/en$ xdg-open index.html
Yields this error page in Firefox:

*File not foundFirefox can’t find the file at
/usr/share/scribus/doc/en/index.html. Check the file name for
capitalisation or other typing errors. Check to see if the file was
moved, renamed or deleted.*
Is it possible that the snap system does not like the symlink approach?

Do you have Firefox installed as a snap? Do you have scribus-doc installed?
That way, you should be able to experience this problem, too.

BW,

Ian

--
-- ACCU - Professionalism in programming - http://www.accu.org
-- My writing - https://sites.google.com/site/ianbruntlett/
-- Free Software page -
https://github.com/ian-bruntlett/TECH-Manuals/blob/main/tm-free-software.md

[Mattia Rizzolo (mapreri)]

I see what's happening there... That's due to snap's containerization
efforts, which blocks loading of files from /usr/share/scribus. If you use
any other non-snap browser it should just work.

I don't use snaps, no, so I'm having no good ideas on how to fix that. And
ISTR I had a good reason to have the symlinks that way instead of
installing in usr/share/doc amd symlinking on usr/share/scribus, but i
could always try again, as that's likely the easier workaround to those
blocks.

On Sat, 23 Mar 2024, 9:50 pm Ian Bruntlett, <email address hidden>
wrote:

> Hi Mattia,
>
> On Sat, 23 Mar 2024 at 20:30, Mattia Rizzolo <email address hidden>
> wrote:
>
> > You are right that scribus needs them in what is the "wrong" location
> > for the Debian policy, but I remember doing things so that it would work
> > for both.
> >
> > The package ships everything in /usr/share/scribus/doc and then sets up
> > symlinks from e.g. /usr/share/doc/scribus/de to ../../scribus/doc/de
> > (i.e. /usr/share/scribus/doc/de).
> >
> > What is not working for you?
> >
>
> Well, Firefox (as a snap), for some reason or another, can't access the
> files.
>
> /usr/share/doc/scribus/en$ xdg-open index.html
> Yields this error page in Firefox:
>
>
>
>
> *File not foundFirefox can’t find the file at
> /usr/share/doc/scribus/en/index.html. Check the file name for
> capitalisation or other typing errors. Check to see if the file was
> moved, renamed or deleted.*
>
> /usr/share/scribus/doc/en$ xdg-open index.html
> Yields this error page in Firefox:
>
>
>
>
> *File not foundFirefox can’t find the file at
> /usr/share/scribus/doc/en/index.html. Check the file name for
> capitalisation or other typing errors. Check to see if the file was
> moved, renamed or deleted.*
> Is it possible that the snap system does not like the symlink approach?
>
> Do you have Firefox installed as a snap? Do you have scribus-doc installed?
> That way, you should be able to experience this problem, too.
>
> BW,
>
>
> Ian
>
> --
> -- ACCU - Professionalism in programming - http://www.accu.org
> -- My writing - https://sites.google.com/site/ianbruntlett/
> -- Free Software page -
> https://github.com/ian-bruntlett/TECH-Manuals/blob/main/tm-free-software.md
>
> --
> You received this bug notification because you are subscribed to
> scribus-doc in Ubuntu.
> https://bugs.launchpad.net/bugs/2058634
>
> Title:
> scribus-doc puts docs in wrong place
>
> Status in scribus-doc package in Ubuntu:
> Incomplete
>
> Bug description:
> the issue is that scribus does not use a standard location for
> its docs ... typically deb packages ship their docs in
> /usr/share/doc/<packagename> while scribus ships them in
> /usr/share/<packagename>/doc ...
>
> This is important because the Firefox snap only has permissions to
> access files in the standard location.
>
> ProblemType: Bug
> DistroRelease: Ubuntu 22.04
> Package: scribus 1.5.8+dfsg-2
> ProcVersionSignature: Ubuntu 6.5.0-26.26~22.04.1-generic 6.5.13
> Uname: Linux 6.5.0-26-generic x86_64
> ApportVersion: 2.20.11-0ubuntu82.5
> Architecture: amd64
> CasperMD5CheckResult: unknown
> CurrentDesktop: ubuntu:GNOME
...

[Ian Bruntlett (ian-bruntlett)]

Hi Mattia,

On Sat, 23 Mar 2024 at 21:30, Mattia Rizzolo <email address hidden>
wrote:

> I see what's happening there... That's due to snap's containerization
> efforts, which blocks loading of files from /usr/share/scribus. If you use
> any other non-snap browser it should just work.
>
>
> I don't use snaps, no, so I'm having no good ideas on how to fix that. And
> ISTR I had a good reason to have the symlinks that way instead of
> installing in usr/share/doc amd symlinking on usr/share/scribus, but i
> could always try again, as that's likely the easier workaround to those
> blocks.
>

You might want to contact Oliver Grawert (<email address hidden>) as he diagnosed
the snap issue. He might be able to give you some ideas.

BW,

Ian

--
-- ACCU - Professionalism in programming - http://www.accu.org
-- My writing - https://sites.google.com/site/ianbruntlett/
-- Free Software page -
https://github.com/ian-bruntlett/TECH-Manuals/blob/main/tm-free-software.md