From a1501359e3beea7e429e043aa0eac8ca9758cfb2 Mon Sep 17 00:00:00 2001 From: Jean-Francois Dockes Date: Sun, 14 Aug 2022 19:24:16 +0200 Subject: [PATCH] doc --- src/doc/user/usermanual.html | 96 +++++------------------------------- 1 file changed, 11 insertions(+), 85 deletions(-) diff --git a/src/doc/user/usermanual.html b/src/doc/user/usermanual.html index 5c8534c9..5e4ef484 100644 --- a/src/doc/user/usermanual.html +++ b/src/doc/user/usermanual.html @@ -242,15 +242,6 @@ alink="#0000FF">
3.3. Searching with the KDE KIO slave
-
-
-
3.3.1. What's this
-
3.3.2. Searchable - documents
-
-
3.4. Searching on the command line
@@ -5180,82 +5171,17 @@ fs.inotify.max_user_watches=32768 -
-
-
-
-

3.3.1. What's - this

-
-
-
-

The Recoll KIO slave - allows performing a Recoll search by entering an - appropriate URL in a KDE open dialog, or with an - HTML-based interface displayed in Konqueror.

-

The HTML-based interface is similar to the Qt-based - interface, but slightly less powerful for now. Its - advantage is that you can perform your search while - staying fully within the KDE framework: drag and drop - from the result list works normally and you have your - normal choice of applications for opening files.

-

The alternative interface uses a directory view of - search results. Due to limitations in the current KIO - slave interface, it is currently not obviously useful (to - me).

-

The interface is described in more detail inside a - help file which you can access by entering recoll:/ inside the konqueror URL line - (this works only if the recoll KIO slave has been - previously installed).

-

The instructions for building this module are located - in the source tree. See: kde/kio/recoll/00README.txt. Some Linux - distributions do package the kio-recoll module, so check - before diving into the build process, maybe it's already - out there ready for one-click installation.

-
-
-
-
-
-

3.3.2. Searchable - documents

-
-
-
-

As a sample application, the Recoll KIO slave could allow - preparing a set of HTML documents (for example a manual) - so that they become their own search interface inside - konqueror.

-

This can be done by either explicitly inserting - <a - href="recoll://..."> links around some document - areas, or automatically by adding a very small - javascript program to - the documents, like the following example, which would - initiate a search by double-clicking any term:

- 
<script language="JavaScript">
-        function recollsearch() {
-        var t = document.getSelection();
-        window.location.href = 'recoll://search/query?qtp=a&p=0&q=' +
-        encodeURIComponent(t);
-        }
-        </script>
-        ....
-        <body ondblclick="recollsearch()">
-
-
-
+

The Recoll KIO slave + allows performing a Recoll + search by entering an appropriate URL in a KDE open dialog, + or a Dolphin + URL. The results are displayed as directory entries.

+

The instructions for building this module are located in + the source tree. See: kde/kio/recoll/00README.txt. Some Linux + distributions do package the kio-recoll module, so check + before diving into the build process, maybe it's already + out there ready for one-click installation.