It is possible to create tools without using the Preferences dialog,
they can be stored in files in tools
subfolder of the medit data
folders (or tools-context
for tools which appear in the document context
menu). In particular, on Unix systems you can place files into $HOME/.local/share/medit/tools/
folder.
Names of the files in the tools
folder are used as their menu item
labels, after stripping first two characters, so you can use two-character prefix to affect
the order of the menu items, e.g. you can have 00Do Something
,
01Another tool
files to have them in that order in the menu. The files
may be of three types: files with extension ".py
", they will be used
as Python scripts; files with extension ".lua
", they will be used
as Lua scripts; and executable files, they will be executed in the same way as shell commands.
To set parameters for a tool, place them on the first or the second line of the file in the following format:
!! key=value; key=value; ... !!
key may be one of the following:
position
: it can be start
or end
,
and defines whether the menu item will be located at the start or at the end of the menu.
id
: the tool identificator.
name
: the tool name, i.e. the label used in the menu item. It will override
the file name.
os
: windows
or unix
. If specified,
then the tool will not be used when medit is running on a different operating system.
accel
: default keyboard accelerator used to invoke this tool.
menu
: the menu to place this tool into. By default the tools are
located in the Tools menu, but they can be as well put into any other menu.
langs
: comma-separated list of languages for which this tool will
be enabled.
file-filter
: defines for which files this tool
will be enabled. The value has the same format as in the Preferences dialog.
options
: same as the Options entry content
in the Preferences dialog.
In addition to these, you can set input and output options for executable files:
input
: can be none
, lines
,
selection
, or doc
.
output
: can be none
, async
,
pane
, insert
, or new-doc
.
filter
: the output filter name.