messages updates and doc
This commit is contained in:
Jean-Francois Dockes
+34
-7
@@ -79,6 +79,7 @@ a:hover .PZ3cap { padding:3px 5px; }
|
||||
|
||||
<div class="content">
|
||||
|
||||
<h1>Recoll result list customising exemples</h1>
|
||||
<p>The Recoll result list is actually made of html text
|
||||
displayed inside a Qt Widget. In all Recoll versions, you
|
||||
can specify the format for the list entries: what data is
|
||||
@@ -86,19 +87,46 @@ a:hover .PZ3cap { padding:3px 5px; }
|
||||
"almost full" support for HTML capabilities, with a few
|
||||
restrictions due to the Qt QTextBrowser object.</p>
|
||||
|
||||
<p>As of Recoll 1.17, the result list can be built as a WebKit
|
||||
<p>As of Recoll 1.17, the result list is by default a WebKit
|
||||
object (WebKit is the basis for several major browsers), which
|
||||
yields full CSS and even Javascript support. </p>
|
||||
yields full CSS and even Javascript support. For these
|
||||
versions you can specify both the individual result format and
|
||||
code to be included in the html header (ie: CSS or
|
||||
Javascript).</p>
|
||||
|
||||
<h2>New in Recoll 1.17: the WebKit result list</h2>
|
||||
|
||||
<p>With WebKit, things that used to not work are now possible.</p>
|
||||
<p>With WebKit, things that used to not work are now
|
||||
possible. The exemple which follow are probably not generally
|
||||
very useful (else they'd be included in the standard Recoll),
|
||||
but they provide samples of what can be done, and may be of use
|
||||
anyway.</p>
|
||||
|
||||
<p>For example, you can make the list icons links that activate the
|
||||
<p>You can now make the list icons links that activate the
|
||||
preview or open action (or the document url which you can then
|
||||
drag/drop to other windows).</p>
|
||||
drag/drop to other windows) (turning images into links did
|
||||
not work with QTextBrowser).</p>
|
||||
|
||||
<p>A more interesting example: recoll 1.17 will display document
|
||||
<h3>Zooming the paragraph font size</h3>
|
||||
<p>If you are using a format with small fonts, it may be useful
|
||||
to be able to zoom the text when the mouse hovers over it. A
|
||||
very basic way to do this -<em>with the standard paragraph
|
||||
format, which is a table</em>- would be to include the following
|
||||
code in the header:</p>
|
||||
<pre>
|
||||
<STYLE type="text/css">
|
||||
table:hover {font-size: 130%;}
|
||||
</STYLE>
|
||||
</pre>
|
||||
|
||||
<p>Of course, the selector should be adapted to your own
|
||||
result format. You should know that every result will be
|
||||
enclosed by Recoll inside a <tt><div
|
||||
class="rclresult" rcldocnum="nn"></tt> element.</p>
|
||||
|
||||
<h3>Zooming the thumbnails</h3>
|
||||
|
||||
<p>Recoll 1.17 and newer will display document
|
||||
thumbnails instead of the type icon if the thumbnail exists in
|
||||
the standard Freedesktop location. The icons/thumbnails are
|
||||
64x64 pixels in size, which is a bit small. The standard
|
||||
@@ -153,7 +181,6 @@ a:hover .PZ3cap { padding:3px 5px; }
|
||||
|
||||
|
||||
|
||||
|
||||
<h2>Result list paragraph format samples</h2>
|
||||
|
||||
<p>The format for paragraphs inside the Recoll GUI result list is
|
||||
|
||||
+79
-61
@@ -45,31 +45,63 @@
|
||||
recollindex. <span class="literal">recollindex -z</span>
|
||||
will do the same in most cases.</p>
|
||||
|
||||
<p>Also, using the anchored search feature on an 1.15 index
|
||||
requires a full reindex.</p>
|
||||
<p>Some new, auxiliary, features do require a full reindex to work:</p>
|
||||
<ul>
|
||||
<li>The file size filtering functions.</li>
|
||||
<li>The anchored search feature if the index was created by
|
||||
release 1.15 or older.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
<h2>Changes</h2>
|
||||
|
||||
<p>Recoll 1.17 is an incremental improvements release over 1.16, no
|
||||
really major function was introduced or modified.</p>
|
||||
<p>Recoll 1.17 is an incremental improvements release over 1.16,
|
||||
with quite a few changes under the hood (like the introduction
|
||||
of a webkit-based result list), but relatively few obvious
|
||||
changes for the casual user.</p>
|
||||
|
||||
<ul>
|
||||
|
||||
<li>Recoll now supports filtering on file sizes. This is accessible
|
||||
from the advanced search panel, or from the query langage
|
||||
(ie: "size>10k size<1m"). For documents stored
|
||||
inside archives, the file size stored in the index is now
|
||||
the actual one, not the archive's as was previously the
|
||||
case.</li>
|
||||
|
||||
<li>Query language: tilde is now expanded inside a "dir:"
|
||||
clause.</li>
|
||||
<li>Search: Recoll now supports filtering on file sizes. This
|
||||
is accessible from the advanced search panel, or from the
|
||||
query langage (ie: "size>10k size<1m"). For
|
||||
documents stored inside archives, the file size stored in
|
||||
the index is now the actual one, not the archive's as was
|
||||
previously the case. Because of this, you will need a full
|
||||
reindex to completely enable this feature.</li>
|
||||
|
||||
<li>Query language: the "dir:" directive now accepts
|
||||
non-absolute paths. For example dir:dir1/dir2 will select
|
||||
any file the path of which includes "dir1/dir2".</li>
|
||||
|
||||
<li>Query language: tilde is now expanded inside a "dir:"
|
||||
clause.</li>
|
||||
|
||||
<li>GUI: it is now possible to cancel a query that takes too
|
||||
long. Because of limitations in Xapian, this forces a program
|
||||
exit, but it's probably better than staring at a hung
|
||||
Recoll.</li>
|
||||
|
||||
<li>GUI/config: new set of dialogs to set up the indexing
|
||||
schedule, either as automatic real time indexing started
|
||||
with the user session or as discrete cron entries. This
|
||||
will take care of the details of autostart files or crontab
|
||||
editing.</li>
|
||||
|
||||
<li>GUI: use Shift+PageUp instead of Shift+Home to rewind the
|
||||
result list to the first page. Shift+Home is useful in the
|
||||
search entry.</li>
|
||||
|
||||
<li>GUI: the preview function will now check that the index is
|
||||
up to date before fetching the preview data, and propose to
|
||||
update the index if necessary. This is especially important
|
||||
for mail folders. It was previously possible that the
|
||||
preview would display a message unrelated to the current
|
||||
result.</li>
|
||||
|
||||
<li>GUI: it is now possible to control the date format
|
||||
displayed by the results (go to Query Preferences).</li>
|
||||
|
||||
<li>GUI: when a search fails to retrieve results, the spelling
|
||||
suggestions are now presented as links inside the result list
|
||||
area. Clicking a link will replace the appropriate word inside
|
||||
@@ -77,79 +109,65 @@
|
||||
|
||||
<li>GUI: thumbnails will be displayed in the result list if
|
||||
found in the standard freedesktop thumbnails directory
|
||||
(previously created by gimp or some file manager). Recoll
|
||||
will not create thumbnails (this would slow the results display
|
||||
too much).</li>
|
||||
|
||||
<li>GUI: it is now possible to control the date format used to
|
||||
display the results (go to Query Preferences).</li>
|
||||
(previously created by gimp or some file manager). This Recoll
|
||||
release will not create thumbnails.</li>
|
||||
|
||||
<li>GUI: it is now possible to Copy/Paste from the term explorer
|
||||
result list.</li>
|
||||
|
||||
<li>GUI: what used to be the document category filters
|
||||
(media/text/etc.) are now defined as query language
|
||||
fragments
|
||||
inside <span class="filename">mimeconf</span>. This means
|
||||
that you can redefine them freely (see the comments for the
|
||||
<tt>[guifilters]</tt> section in the
|
||||
default <span class="filename">mimeconf</span>).</li>
|
||||
|
||||
<li>GUI: it is now possible to use a Qt style sheet to modify
|
||||
many aspects of Recoll appearance. A style sheet file can be
|
||||
selected from the GUI query configuration dialog. A sample
|
||||
skeleton style sheet is to be found in the
|
||||
share/recoll/examples directory.</li>
|
||||
|
||||
<li>GUI: the result list is now based on the WebKit widget
|
||||
instead of QTextBrowser. This means better HTML/CSS support,
|
||||
and even Javascript ... You can force the use the old
|
||||
QTextBrowser instead by using
|
||||
configure --disable-webkit. See a few CSS examples in
|
||||
the <a href="custom.html">result list customisation
|
||||
examples page</a></li>
|
||||
|
||||
<li>GUI: added menu entry to show all the mime types actually
|
||||
indexed.</li>
|
||||
|
||||
<li>GUI: the result list is now based on the WebKit widget
|
||||
instead of QTextBrowser. This means better html/css support,
|
||||
and even Javascript ... You can force the use the old
|
||||
QTextBrowser instead by using configure --disable-webkit.</li>
|
||||
<li>GUI/indexing: the indexing thread has been removed. All
|
||||
indexing is now performed by a separate recollindex
|
||||
process. This has multiple advantages, the thread was just a
|
||||
very bad idea. Among others, exiting the GUI has no
|
||||
influence on an ongoing indexing.</li>
|
||||
|
||||
<li>GUI: use Shift+PageUp instead of Shift+Home to rewind the
|
||||
result list to the first page. Shift+Home is useful in the
|
||||
search entry.</li>
|
||||
|
||||
<li>The GUI now has a set of dialogs to set up the indexing
|
||||
schedule, either as automatic real time indexing started
|
||||
with the user session or as discrete cron entries. This
|
||||
will take care of the details of autostart files or crontab
|
||||
editing.</li>
|
||||
<li>GUI/indexing: new menu entry to force a full reindex.</li>
|
||||
|
||||
<li>The GUI indexing thread has been removed. All indexing is
|
||||
now performed by a separate recollindex process. This has
|
||||
multiple advantages, the thread was just a very bad
|
||||
idea. Among others, exiting the GUI has no influence on an
|
||||
ongoing indexing.</li>
|
||||
<li>GUI/config: the indexing configuration now only shows the
|
||||
directories customized by the user, not those which come
|
||||
from the standard configuration (ie:
|
||||
~/.thunderbird). Showing the standard directories was more
|
||||
often confusing than useful.</li>
|
||||
|
||||
<li>The GUI now has a menu entry to force a full reindex.</li>
|
||||
|
||||
<li>The GUI indexing configuration now only shows the directories
|
||||
customized by the user, not those which come from the
|
||||
standard configuration (ie: ~/.thunderbird). Showing the
|
||||
standard directories was more often confusing than
|
||||
useful.</li>
|
||||
|
||||
<li>GUI: the default reslist paragraph now displays the ipath:
|
||||
<li>GUI: the default result list paragraph now displays the ipath:
|
||||
this is very useful for archive members and not too
|
||||
disturbing for other kinds.</li>
|
||||
|
||||
<li>GUI: it is now possible to cancel a query that takes too
|
||||
long. Because of limitations in Xapian, this forces a program
|
||||
exit, but it's probably better than staring at a hung
|
||||
Recoll.</li>
|
||||
|
||||
<li>GUI: what used to be the document category filters
|
||||
(media/text/etc.) are now defined as query language
|
||||
fragments inside mimeconf. This means that you can redefine
|
||||
them freely (see the comments for the [guifilters] section
|
||||
in the default mimeconf).</li>
|
||||
|
||||
<li>Command line query: can now select a result slice
|
||||
(first result rank and count of results).</li>
|
||||
(first result rank and count of results). New option for
|
||||
easy parsing of results by another program.</li>
|
||||
|
||||
<li>Indexer: handle the html5 <tt>charset</tt> meta tag.</li>
|
||||
<li>Indexing: handle the html5 <tt>charset</tt> meta tag.</li>
|
||||
<li>Indexing: added support for Okular notes and Gnumeric.</li>
|
||||
|
||||
<li>Real time indexer: restart automatically when the
|
||||
configuration changes.</li>
|
||||
|
||||
<li>Indexer: Added okular notes and gnumeric filters.</li>
|
||||
|
||||
|
||||
<li>Fixed bugs:
|
||||
<ul>
|
||||
|
||||
Reference in New Issue
Block a user