mimeview specifies which programs
are started when you click on an Open link
in a result list. E.g.: HTML is normally displayed using
firefox, but you may prefer
Konqueror, your
openoffice.org
program might be named oofice instead of
openoffice etc.
Changes to this file can be done by direct editing, or through the recoll GUI preferences dialog.
If Use desktop preferences to choose document
editor is checked in the Recoll GUI preferences, all
mimeview entries will be ignored except the
one labelled application/x-all (which is set to
use xdg-open by default).
In this case, the xallexcepts top level
variable defines a list of MIME type exceptions which
will be processed according to the local entries instead of being
passed to the desktop. This is so that specific Recoll options
such as a page number or a search string can be passed to
applications that support them, such as the
evince viewer.
As for the other configuration files, the normal usage
is to have a mimeview inside your own
configuration directory, with just the non-default entries,
which will override those from the central configuration
file.
All viewer definition entries must be placed under a
[view] section.
The keys in the file are normally MIME types. You can add an
application tag to specialize the choice for an area of the
filesystem (using a localfields specification
in mimeconf). The syntax for the key is
mimetype|tag
The nouncompforviewmts entry, (placed at
the top level, outside of the [view] section),
holds a list of MIME types that should not be uncompressed before
starting the viewer (if they are found compressed, e.g.:
mydoc.doc.gz).
The right side of each assignment holds a command to be executed for opening the file. The following substitutions are performed:
%D. Document date
%f. File name. This may be the name of a temporary file if it was necessary to create one (e.g.: to extract a subdocument from a container).
%i. Internal path, for subdocuments of containers. The format depends on the container type. If this appears in the command line, Recoll will not create a temporary file to extract the subdocument, expecting the called application (possibly a script) to be able to handle it.
%M. MIME type
%p. Page index. Only significant for a subset of document types, currently only PDF, Postscript and DVI files. If it is set, a significant term will be chosen in the query, and %p will be substituted with the first page where the term appears. Can be used to start the editor at the right page for a match or snippet.
%l. Line number. Only significant for document types with relevant line breaks, mostly text/plain and analogs. If it is set, a significant term will be chosen in the query, and %p will be substituted with the first line where the term appears.
%s. Search term. The value will only be set for documents with indexed page or line numbers and if %p or %l is also used. The value will be one of the matched search terms. It would allow pre-setting the value in the "Find" entry inside Evince for example, for easy highlighting of the term.
%u. Url.
In addition to the predefined values above, all strings like
%(fieldname) will be replaced by the value of
the field named fieldname for the
document. This could be used in combination with field
customisation to help with opening the document.
