#1004062 offline help (keys, manual, release notes, FAQ)

Package:
inkscape
Source:
inkscape
Description:
vector-based drawing program
Submitter:
"Trent W. Buck"
Date:
2022-01-20 14:09:04 UTC
Severity:
wishlist
#1004062#5
Date:
2022-01-20 06:27:00 UTC
From:
To:
Currently Inkscape's Help menu just opens URLs.

https://sources.debian.org/src/inkscape/1.1.1-2%7Ebpo11+1/src/verbs.cpp/#L2051-L2101

My disadvantaged users do not have internet access, so currently they cannot get help.
This is already fixed for Help > Tutorials (apt install inkscape-tutorials).
Can this be extended to the rest of the Help menu?

The tutorials come from this repository:

https://gitlab.com/inkscape/inkscape-docs/documentation

Help > Keys comes from that same repository.
Help > Command Line Options comes from that same repository (./man/).

Help > Manual currently points to an third-party manual that is

   * written for the wrong Inkscape version,
   * doesn't support https, and
   * cannot be distributed by Debian (non-commercial clause).

However, there is a new first-party manual which is here:

https://gitlab.com/inkscape/inkscape-docs/manuals

It is available pre-rendered here (only for latest version, not guaranteed to be for the version Debian ships):

https://inkscape-manuals.readthedocs.io/en/latest/
https://inkscape-manuals.readthedocs.io/_/downloads/en/latest/pdf/
https://inkscape-manuals.readthedocs.io/_/downloads/en/latest/htmlzip/
https://inkscape-manuals.readthedocs.io/_/downloads/en/latest/epub/



I am happy if "Help > Keys" and "Help > Manual" work offline.
However here are some notes about the other options:

Help > FAQ I think must come from here, but I can't see HOW.

https://gitlab.com/inkscape/inkscape-web/

Help > New In This Version comes from Mediawiki, so is probably annoying.
This may be auto-generated elsewhere; I haven't found evidence of this.

https://wiki.inkscape.org/wiki/Release_notes/1.1

Help > Report a Bug &
Help > Donate are not useful offline.

Help > SVG 1.1 Specification &
Help > SVG 2.0 Specification link to w3.org.
I don't know if it's worth caring about those.

Help > About Memory &
Help > About Inkscape
are already working offline, they are in-app widgets.

#1004062#8
Date:
2022-01-20 14:00:54 UTC
From:
To:
Control: forwarded -1 https://gitlab.com/inkscape/inbox/-/issues/6198
Control: notfound -1 1.1.1-2~bpo11+1
Control: found -1 1.1.1-2

It is not as trivial as you write.

I could probably cook up something, but I think this would be best
handled enterely upstream, by embedding the documentation in the final
tarball (like they do with the extensions), and adjusting the Help menu.


Please follow the upstream report linked above for updates.