Use this module to perform Recoll searches from any program with a KIO interface.
The module can work in two modes:
The module is still in its infancy. You will undoubtedly obtain strange effects from time to time. If you have any remarks or ideas about improving kio_recoll, or observe an interesting and reproducible sequence, please report it.
kio_recoll is primarily designed and tested with konqueror, and you will undoubtedly get even more surprising effects with other tools.
The Html interface is currently much more usable. The directory interface is extremely quirky.
The module is particularly unhelpful with search hits inside email folders, which Konqueror has no way to access.
This works more or less like the Recoll QT GUI, much simplified. The Recoll manual describes the queries that can be performed.
Most pages in the interface should quite self-explanatory.
You normally enter this interface by entering "recoll:" or
"recoll:/" in the Konqueror URL entry, and following the "search"
link. You can also directly enter "recoll:/search.html".
In most circumstances, entering a link like
recoll:/john smith will also
yield an HTML result list.
Compared to QT Recoll, the nice point is that you can click or drag/drop the icons to access the results in the standard desktop way.
The path part of the URI is taken as a Recoll query language string and executed. The results are displayed as directory entries.
There are several ways to enter this interface:
recoll:/red apples ext:html/
RECOLL_KIO_ALWAYS_DIR
environment
variable or the kio_always_dir
recoll.conf variable
to 1. The HTML interface will then only be accessible
through the search link in the top "recoll:" view.No search result details (samples, relevance etc.) are available, but this interface allows multiple selections and copies, usage inside any KDE open dialog, etc.
To avoid swamping the interface with thousands of results, the
result count is limited to 100 by default. You can change this value
by setting the kio_max_direntries
parameter in your recoll
configuration file (typically ~/.recoll/recoll.conf)
Because of limitations in the current KIO slave usage, the actual entry names are not those displayed but synthetic ones like "recollResultxxx". This has unfortunate side-effects when dragging/dropping the entries to some other application, or when using an open dialog (the opened file doesn't have the correct path to the original file).