From 2c9187584a383dc0623ea7dba02b0612e0a1e3b4 Mon Sep 17 00:00:00 2001 From: bobsmith Date: Thu, 15 Sep 2022 10:15:08 -0500 Subject: [PATCH] Change libkonq/PLUGINS and libkonq/SERVICEMENUS to Markdown format. This resolves issue #290. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: bobsmith Signed-off-by: Slávek Banko --- libkonq/{PLUGINS => PLUGINS.md} | 17 +++++++--- libkonq/SERVICEMENUS | 52 ------------------------------- libkonq/SERVICEMENUS.md | 55 +++++++++++++++++++++++++++++++++ 3 files changed, 67 insertions(+), 57 deletions(-) rename libkonq/{PLUGINS => PLUGINS.md} (64%) delete mode 100644 libkonq/SERVICEMENUS create mode 100644 libkonq/SERVICEMENUS.md diff --git a/libkonq/PLUGINS b/libkonq/PLUGINS.md similarity index 64% rename from libkonq/PLUGINS rename to libkonq/PLUGINS.md index 4eb535a59..f89ca70ef 100644 --- a/libkonq/PLUGINS +++ b/libkonq/PLUGINS.md @@ -1,13 +1,20 @@ +Menu Plugins +============ + Thus file explains how to add plugins into the konqpopupmenu used by konqueror and kdesktop. -Why? +Why +--- + Why do we need this kind of functionality? We do have SERVICEMENUS. A plugin can be much more dynamic. If you want to add features that are runtime specific or need some interaction with different things -a plugin comes in handy +a plugin comes in handy. + +How +--- -How? -Please look at ?no_location? to get the latest plugin template +Please look at *no_location* to get the latest plugin template. -Holger Freyther 30th October 2001 \ No newline at end of file +Holger Freyther 30th October 2001 diff --git a/libkonq/SERVICEMENUS b/libkonq/SERVICEMENUS deleted file mode 100644 index 12035388c..000000000 --- a/libkonq/SERVICEMENUS +++ /dev/null @@ -1,52 +0,0 @@ -This file explains how to add an item in the popupmenu (for both -konqueror and kdesktop), without using the file associations. - -Why -=== -One reason for doing this is being able to associate -some action with all files without this action becoming a default handler -(called on left click). -Another is that for text-based programs and tools (e.g. gzip) it's faster -than defining a desktop file for the application, making it hidden, and -associate it with the relevant file types. - -How -=== -Create a file ~/.trinity/share/apps/konqueror/servicemenus/something.desktop -and write into it something like (without the comments) : - -[Desktop Entry] -ServiceTypes=text/html,text/plain # use all/all for all entries - # all/allfiles for files only - # and use inode/directory for dirs only - # you can also do things like image/* for all - # image mimetypes -Actions=gzip;mail # those are ';' separated, per the standard ! -X-TDE-Submenu=Menuname # this optional entry allows grouping the - # entries in this servicemenu file into a - # common submenu, in this case "Menuname" -TryExec=gzip # Find if executable exist, if it doesn't exist - # menu entry is not displaying -ExcludeServiceTypes=application/x-zip # This entry is used to avoid to display menu - # when it's a specific servicetype - # for exemple when we use all/allfiles and zip - # them, we don't want to zip a zip file - - -[Desktop Action gzip] # One "Desktop Action " group per Action -Name=GZip this file -Name[fr]=... -Icon=tgz -Exec=gzip %f - -[Desktop Action mail] -Name=Mail this file -Name[fr]=... -Icon=kmail -Exec=kmail --there-is-no-such-option-yet %f - - -See also the "desktop entry standard", which defines more formally the same -concept of actions but for desktop files (e.g. eject on a device desktop file, -etc.) - diff --git a/libkonq/SERVICEMENUS.md b/libkonq/SERVICEMENUS.md new file mode 100644 index 000000000..bcd7ae1f7 --- /dev/null +++ b/libkonq/SERVICEMENUS.md @@ -0,0 +1,55 @@ +Service Menus +============= + +This file explains how to add an item in the popupmenu (for both +konqueror and kdesktop), without using the file associations. + +Why +--- + +One reason for doing this is being able to associate +some action with all files without this action becoming a default handler +(called on left click). + +Another is that for text-based programs and tools (e.g. gzip) it's faster +than defining a desktop file for the application, making it hidden, and +associate it with the relevant file types. + +How +--- + +Create a file `~/.trinity/share/apps/konqueror/servicemenus/something.desktop` +and write into it something like (without the comments): + + [Desktop Entry] + ServiceTypes=text/html,text/plain # use all/all for all entries + # all/allfiles for files only + # and use inode/directory for dirs only + # you can also do things like image/* for all + # image mimetypes + Actions=gzip;mail # those are ';' separated, per the standard ! + X-TDE-Submenu=Menuname # this optional entry allows grouping the + # entries in this servicemenu file into a + # common submenu, in this case "Menuname" + TryExec=gzip # Find if executable exist, if it doesn't exist + # menu entry is not displaying + ExcludeServiceTypes=application/x-zip # This entry is used to avoid to display menu + # when it's a specific servicetype + # for exemple when we use all/allfiles and zip + # them, we don't want to zip a zip file + + [Desktop Action gzip] # One "Desktop Action " group per Action + Name=GZip this file + Name[fr]=... + Icon=tgz + Exec=gzip %f + + [Desktop Action mail] + Name=Mail this file + Name[fr]=... + Icon=kmail + Exec=kmail --there-is-no-such-option-yet %f + +See also the *desktop entry standard*, which defines more formally the same +concept of actions but for desktop files (e.g. eject on a device desktop file, +etc.).