Page MenuHome GnuPG

Kleopatra: Add additional info to Help menu
Testing, NormalPublic

Description

Edited on 2024-11-21: see new scope here: https://dev.gnupg.org/T7064#189909

At least in VSD an entry in the Help menu should link to the FAQ on the relaunched gnupg.com website.

And to be discussed:
Should we add further info? I suggest we should create a glossary page on the website and link to that, too.
To mitigate confusion between "key", "certificate" and "password" (or passphrase). (The latter one is also referred to by some people as "key", especially in the context of symmetric encryption.)

Revisions and Commits

Event Timeline

aheinecke triaged this task as Normal priority.
aheinecke added a subscriber: aheinecke.

Tobias can you add this please and extend libkleos DocAction so that it handles a web URL as an alternative to a file?. And takes an optional additional paramter for "show" which then depends not on weather or not the file exists but on something like "is_vsd()"

The API should both accept a file an an URL. e.g. for the GnuPG Manual. We ship that ib the matching version in VSD but not in Gpg4win,. So in Gpg4win it could link to https://gnupg.org/documentation/manuals/gnupg/ if the pdf file is not found.

I just want to remind you that we have added the possibility to explicitly disable opening of any URLs in Kleopatra. Don't introduce a new way to open a URL which cannot be disabled via the same setting.

Can you clarify on what the show parameter is intended to do? I don't yet see how it would be useful, as the distinction between VSD and gpg4win is already made by whether the respective file is present or not

TobiasFella moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.Apr 3 2024, 10:15 AM

Can you clarify on what the show parameter is intended to do? I don't yet see how it would be useful, as the distinction between VSD and gpg4win is already made by whether the respective file is present or not

For the FAQ link we do not want to ship a file but only use an online link but it should only be shown in VS-D mode. MMh thinking about this some more we also want to sow it in GnuPG Desktop (the not VS version) I am unsure yet how to detect this. Maybe with about data infos?

I think the DocAction idea doesn't really work well because it leads to empty submenus and bogus actions in the toolbar configuration and the keyboard shortcut configuration in builds that don't include the PDFs. And now, it seems, checking whether a file exists isn't enough anymore.

I think we need to rethink the way custom actions are added to the different gpg4win builds. Maybe the help menu actions should be created dynamically on runtime from information in some file that exists only in gpg4win instead of being created hard-coded and unconditionally as DocActions and then just hidden.

TobiasFella changed the task status from Open to Testing.Aug 8 2024, 10:56 AM

As there was some discussion in the ticket: what has been implemented? How can it be tested?

Help -> Additional Documentation -> GnuPG Commandline now brings up the GnuPG Manual in the browser for Gpg4win. This solves the issue that this menu entry (Additional Documentation) existed in Gpg4win and Kleopatra on general Linux but was empty. And the API does exist now to add more entries easily if suggested. I just checked on Linux in master and it worked for me.

ebo moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.Oct 1 2024, 3:55 PM
ebo moved this task from Restricted Project Column to Restricted Project Column on the Restricted Project board.