tris/recoll
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc

Browse Source
This commit is contained in:
Jean-Francois Dockes 2012-11-18 08:28:03 +01:00
parent 4544571490
commit 86bc80d657
6 changed files with 143 additions and 157 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
website/BUGS.html
View File

@ -36,8 +36,23 @@
topmost section may also exist in older versions.</i></p>
<h2><a name="b_latest">recoll 1.18.003</a></h2>
<h2><a name="b_latest">recoll 1.18.1</a></h2>
<ul>
<li>Weird data in filter output text (e.g.: produced by some
versions of pdftotext) can cause an error which will halt
the processing of the document, which becomes
unsearchable. This is a relatively uncommon problem which
signals itself by a specific error in the indexing log, so
you can know if you are affected. Look for:
<tt>xapian add_posting error Empty termnames aren't allowed</tt>
</li>
<li>Raw indexes (not default): diacritics and case expansion
is not applied to terms containing numbers so that a
case-insensitive search does not work for them (e.g.:
searching for ds1820 will not find DS1820).</li>
<li>On systems such as Debian Stable which use Evince version
2.x (not 3.x) as PDF viewer, the default "Open" command for
PDF files will not work. You need to edit the command:

94
website/download.html
View File

@ -51,11 +51,11 @@
<h2><a>General information</a></h2>
<p>The current version is 1.17.3. <a href="release-1.17.html">
<p>The current version is 1.18.1. <a href="release-1.18.html">
Release notes</a>.</p>
<p>The download page for Recoll 1.16 is
<a href="download-1.16.html">still available</a>.</p>
<p>The download page for Recoll 1.17 is
<a href="download-1.17.html">still available</a>.</p>
<p>Recoll <a href="usermanual/rcl.install.html">
Installation / building manual</a>.</p>
@ -95,16 +95,16 @@
and moving from X.Y.Z to X.Y.Z+u should in general involve
little risk of regression. But, <em>any</em> change can bring
problems, if you are not affected by the corrected bugs (check
the <a href="CHANGES.html">changes file</a>), there is
the <a href="release-1.18.html">release file</a>), there is
probably no necessity to upgrade anyway.</p>
<h2><a name="source">Source</a></h2>
<h3>Current release distribution: 1.17.3:</h3>
<h3>Current release distribution: 1.18.1:</h3>
<!-- Attention: source packages must remain here, not in a
subdirectory, because of all the places they're referred from
(package watches) -->
<p><a href="recoll-1.17.3.tar.gz">recoll-1.17.3.tar.gz</a>.
<p><a href="recoll-1.18.1.tar.gz">recoll-1.18.1.tar.gz</a>.
</p>
<!--
@ -151,6 +151,11 @@
<li><p>Qt development files: Qt 4.4 or newer. The Recoll GUI
will not build with Qt releases older than 4.4.</p></li>
<li><p>Qt webkit development: Qt WebKit is quite often
distributed apart from the main Qt lib. It is possible to
configure Recoll not to use Qt WebKit (see
configure&nbsp;--help).</p></li>
<li>Python development package: you can avoid needing this by
configuring with --disable-python-module.</li>
@ -165,8 +170,8 @@
<h3>Older recoll releases:</h3>
<p>
<a href="recoll-1.17.2.tar.gz">1.17.2</a>.
<a href="recoll-1.17.1.tar.gz">1.17.1</a>.
<p>
<a href="recoll-1.17.3.tar.gz">1.17.3</a>.
<a href="recoll-1.16.2.tar.gz">1.16.2</a>.
<a href="recoll-1.15.9.tar.gz">1.15.9</a>.
<a href="recoll-1.14.4.tar.gz">1.14.4</a>.
@ -223,12 +228,8 @@
other releases too). Just follow the instructions for Ubuntu.</p>
<h3>RPMS</h3>
<p>Some Fedora and Mandriva packages unfortunately think that they
depend on exiftool (which is needed by the little used jpeg
info filter), due to excessive rpmbuild cleverness.
<br>You'll need to install the Xapian, Qt, and zlib development
packages if you want use the source rpms.</i></p>
<p>You'll need to install the Xapian, Qt, Qt-Webkit and zlib
development packages if you want use the source rpms.</p>
<h3>Fedora</h3>
<p>Recoll is present in the standard Fedora package
@ -256,18 +257,17 @@ I now use the OpenSUSE build service to create Recoll OpenSUSE packages.
somewhere else.</p>
</blockquote>
<h3>Mandriva</h3>
<h3>Mageia</h3>
<blockquote>
<p>Mandriva linux 2011 using Qt 4 and the Xapian version
from the Mandriva repository.:
<a href="mandriva2011/recoll-1.17.2-1-mdv2011.0.i586.rpm">
recoll-1.17.2-1-mdv2011.0.i586.rpm</a>,
<a href="recoll-debug-1.17.2-1-mdv2011.0.i586.rpm">
recoll-debug-1.17.2-1-mdv2011.0.i586.rpm</a>. <br>
<p>Mageia version 2:
<a href="mageia2/recoll-1.18.1-1.mga2.i586.rpm">
mageia2/recoll-1.18.1-1.mga2.i586.rpm,
<a href="mageia2/recoll-debug-1.18.1-1.mga2.i586.rpm">
recoll-debug-1.18.1-1.mga2.i586.rpm</a>. <br>
Source:
<a href="mandriva2011/recoll-1.17.2-1.src.rpm">
recoll-1.17.2-1.src.rpm</a>
<a href="mageia2/recoll-1.18.1-1.mga2.src.rpm">
recoll-1.18.1-1.mga2.src.rpm</a>
</p>
</blockquote>
@ -299,7 +299,7 @@ I now use the OpenSUSE build service to create Recoll OpenSUSE packages.
<h2><a name="translations">Translations</a></h2>
<p>Most of the translations for 1.17 are incomplete
<p>Most of the translations for 1.18 are incomplete
The source translation files are included in the source
release. If your language has some english messages left and
you want to take a shot at fixing the problem, you can send
@ -315,56 +315,28 @@ I now use the OpenSUSE build service to create Recoll OpenSUSE packages.
</p>
<p><a href="translations/recoll_xx.ts">recoll_xx.ts</a> is a blank
Recoll 1.17 message file, handy to work on a new translation.</p>
Recoll 1.18 message file, handy to work on a new translation.</p>
<h3>Updated 1.17 translations that became available after the
<p>A Czech translation for 1.18, thanks to Pavel
<a href="translations/recoll_cs.ts">recoll_cs.ts</a>
<a href="translations/recoll_cs.qm">recoll_cs.qm</a>
</p>
<!--
<h3>Updated 1.18 translations that became available after the
release:</h3>
<p>A Greek translation for 1.17, thanks to Dimitrios
<a href="translations/recoll_el.ts">recoll_el.ts</a>
<a href="translations/recoll_el.qm">recoll_el.qm</a>
</p>
-->
<p>Note that, if you are running an older release,
you may find updated messages by looking inside the
appropriate maintenance branch
on <a href="https://bitbucket.org/medoc/recoll/src">bitbucket</a>.</p>
<!--
<p>A new Spanish translation for 1.16.2, thanks to JCP.
<a href="translations/recoll_es.ts">recoll_es.ts</a>
<a href="translations/recoll_es.qm">recoll_es.qm</a>
</p>
<p>The following are up to date in 1.16.2, but may be useful if you
are running 1.16.1.</p>
<p>Czech, thanks to Pavel.
<a href="translations/recoll_cs.ts">recoll_cs.ts</a>
<a href="translations/recoll_cs.qm">recoll_cs.qm</a>
</p>
<p>Russian, thanks to Gleb.
<a href="translations/recoll_ru.ts">recoll_ru.ts</a>
<a href="translations/recoll_ru.qm">recoll_ru.qm</a>
</p>
<p>Lithuanian.
<a href="translations/recoll_lt.ts">recoll_lt.ts</a>
<a href="translations/recoll_lt.qm">recoll_lt.qm</a>
</p>
<p>Ukrainian.
<a href="translations/recoll_uk.ts">recoll_uk.ts</a>
<a href="translations/recoll_uk.qm">recoll_uk.qm</a>
</p>
<p><b>Italian</b>. Thanks to Mario, Christian and Giovanni for this.
<a href="translations/recoll_it.ts">recoll_it.ts</a>
<a href="translations/recoll_it.qm">recoll_it.qm</a>
</p>
<p><b>Turkish</b>. Thanks Serdar.
<a href="translations/recoll_tr.ts">recoll_tr.ts</a>
<a href="translations/recoll_tr.qm">recoll_tr.qm</a>
</p>
-->
</div>
</body>
</html>

112
website/index.html.en
View File

@ -51,8 +51,8 @@
<li><a href="features.html">Detailed features</a>.
</ul>
<p>The current <span class="application">Recoll</span> version is
<a href="download.html">1.17.3</a>
(<a href="release-1.17.html">Release notes</a>).</p>
<a href="download.html">1.18.1</a>
(<a href="release-1.18.html">Release notes</a>).</p>
<p><span class="application">Recoll</span> is based on the very
strong <a href="http://www.xapian.org">Xapian</a> search
@ -83,27 +83,43 @@
<h2>News</h2>
<div class="news">
<ul>
<dl>
<dt>2012-11-05</dt><dd>Recoll 1.18.1 is out. It has optional
character case and diacritics
sensitivity, direct access to the hit page when opening PDF
files, complex search history, and a host of other smaller
improvements. See the <a href="release-1.18.html">release
notes</a>.
<span class="important">Those of you not using <b>evince</b>
as a PDF/Postscript/DVI viewer may be surprised to see the
recoll GUI try to use this viewer anyway.</span>This is because
some of the new functions in 1.18 work better
with <b>evince</b>, but you can override the choice by
going to the GUI preferences, and removing
application/pdf, application/postscript and
application/dvi from the <tt>Exceptions</tt> list.
</dd>
<li>2012-10-30: Recoll has a brand new Firefox extension for
<dt>2012-10-30</dt> <dd>Recoll has a brand new Firefox extension for
indexing visited Web pages. This is very similar to the old
Beagle plugin, but slightly better integrated (no-fuss
installation), and with a new lease on life. See
<a href="https://sourceforge.net/projects/recollfirefox/">
Dave King's project page on sourceforge</a> and the
<a href="https://bitbucket.org/medoc/recoll/wiki/IndexWebHistory">
page about Recoll (trivial) configuration</a>.</li>
page about Recoll (trivial) configuration</a>.</dd>
<li>2012-10-30: the source for <a href="recoll-1.18.003.tar.gz">
<dt>2012-10-30</dt> <dd>The source for <a href="recoll-1.18.003.tar.gz">
recoll 1.18.003</a> is available, and this is a call to
volunteers to test it. There are binary packages on the recoll
"experimental" PPA for Ubuntu and Mint Linux users, and I can
build others. See this
<a href="http://www.freelists.org/post/recoll-user/recoll-1180-prerelease">
message</a> for more information. Mini-release 003 fixes a GUI
crash and a few other issues in 002.</li>
crash and a few other issues in 002.</dd>
</dd>
<li>2012-10-25: a problem with a simple workaround has caused
<dt>2012-10-25</dt> <dd>A problem with a simple workaround has caused
several reported <span class="important">recollindex
crashes</span> recently (for 1.17). If you store and index
Mozilla/Thunderbird email out of the standard location
@ -118,67 +134,56 @@
possibly use all the computer's memory and crash. Apart from
crashes, which only occur for very big folders, this also
causes incorrect mail indexing.
</li>
</dd>
<li>2012-10-16: <a href="filters/filters.html">new filter for
EPUB documents</a>.</li>
<li>2012-10-16: recoll 1.18 will soon be out. It will have
<dt>2012-10-16</dt><dd> <a href="filters/filters.html">new filter for
EPUB documents</a>.</dd>
optional character case and diacritics sensitivity, direct
access to hit page when opening PDF files, complex search
history, and a host of other smaller improvements. You can
already see the <a href="release-1.18.html">release
notes</a> and the snapshot currently on the
<a href="https://launchpad.net/~recoll-backports/+archive/experiments">
"experimental" Ubuntu PPA</a> is actually a release
candidate, so Ubuntu users can take an early plunge...</li>
<li>2012-09-21: an
<dt>2012-09-21</dt><dd>An
<a href="https://bitbucket.org/medoc/recoll/wiki/ElinksBeagle">easy
way</a> to extend the "Beagle queue"
Recoll web history indexing mechanism to other browsers than
Firefox (Elinks in this case).
</li>
</dd>
<li>2012-09-13: the next Recoll version will maybe acquire switchable
<dt>2012-09-13</dt> <dd>The next Recoll version will
acquire switchable
case and diacritics sensitivity. I am writing
a few pages about the
issues involved, they are referenced from my
<a href="https://plus.google.com/u/0/113262930843833486941/posts">
google+</a> profile</li>
google+</a> profile</dd>
<li>2012-09-11: a new user-contributed script for those who use
<dt>2012-09-11</dt> <dd>A new user-contributed script for those who use
real-time indexing on laptops: stop or start indexing
according to AC power status. See the details on
the <a href="https://bitbucket.org/medoc/recoll/wiki/IndexOnAc.wiki">
Wiki</a>. </li>
Wiki</a>. </dd>
<li>2012-06-19: update info. If you are not running Recoll 1.17.3,
you probably should. 1.17.2 and older versions have a bug which
<dt>2012-06-19</dt> <dd>Update info. If you are not running
Recoll 1.17.3, you probably should. 1.17.2 and older versions
have a bug which
can cause a crash of the indexing process while processing email,
under relatively common conditions.<br>
Also, if you are already running 1.17.3, you may want to install
the updated open/libre-office filter described just below.</li>
the updated open/libre-office filter described just below.</dd>
<li>2012-06-01: an
<dt>2012-06-01</dt> <dd>An
updated <a href="filters/filters.html">filter</a> for the
OpenDocument format will properly handle exported Google Docs
files.</li>
files.</dd>
<li>2012-05-25: a
new <a href="filters/filters.html">filter</a> for indexing
tar archives.</li>
<dt>2012-05-25</dt> <dd>A
new <a href="filters/filters.html">filter</a> for indexing
tar archives.</dd>
<li>2012-05-23: Release 1.17.3 mostly fixes an indexing crash that
sometimes occurred while processing email. See the
<a href="release-1.17.html">Release notes</a>.
</li>
<li>2012-04-07: we now have a Chinese user manual: Recoll现在有中文手册咯：
<dt>2012-04-07</dt><dd>We now have a Chinese user manual:
Recoll现在有中文手册咯：
<a href="http://stupidbeauty.com/Blog/2012/03/recoll%E7%94%A8%E6%88%B6%E6%89%8B%E5%86%8A%E7%BF%BB%E8%AD%AF%EF%BC%8Crecoll-user-manual-2/">
Recoll中文手册，HTML</a></li>
Recoll中文手册，HTML</a></dd>
<li>2012-03-27: Recoll gets a Ubuntu Unity Lens. If you are running
<dt>2012-03-27</dt> <dd>Recoll gets a Ubuntu Unity Lens. If
you are running
an Ubuntu release where this makes sense, you can install
the recoll-lens package from the
<a href="https://launchpad.net/~recoll-backports/+archive/recoll-1.15-on">
@ -186,26 +191,9 @@
extract and display embedded documents, which native utilities
can't reach directly. And of course you still need to run
the GUI (or the command line recollindex) to get the indexing
going !</li>
going !</dd>
<li>2012-03-24: Release 1.17 is out, see
the <a href="release-1.17.html">Release notes</a>. </li>
<li>2011-11-26: the result list glitch: ennoying and easily
worked-around: it will sometimes happen (for a yet
undetermined reason) that the result list paragraph format
stored in the Qt preferences file will get garbled,
causing result lists with no displayed paragraphs (the
counts and pages are ok, the results can be seen in table
mode, but not in list mode). The workaround is to go to
<blockquote>
Preferences->Query configuration->User interface
</blockquote> and erase the result paragraph format string
(^A DEL in the text area), this will reset the string to the
default value.</li>
</ul>
</dl>
</div>
<h2>Thanks</h2>

36
website/index.html.fr
View File

@ -47,8 +47,8 @@
<p><span class="application">Recoll</span> est un logiciel libre
gratuit, dont le code source est disponible sous licence GPL.
La dernière version est
<a class="important" href="download.html">1.17.3</a>
(<a href="release-1.17.html">notes sur la version, en
<a class="important" href="download.html">1.18.1</a>
(<a href="release-1.18.html">notes sur la version, en
anglais</a>)</p>
<p>L'interface utilisateur de
@ -98,9 +98,23 @@
des questions fréquentes et trucs divers</a> sur bitbucket.org</p>
<h2>Nouvelles: </h2>
<ul>
<dl>
<li>2012-10-25: Un problème avec une solution simple peut provoquer
<dt>2012-11-05</dt><dd>Recoll 1.18.1 est disponible. Cette
version peut faire des recherches sensibles aux majuscules et
aux accents, donner un accès direct à la bonne page pour les
documents PDF (uniquement avec <b>evince</b>), elle a un
historique des recherches complexes, et plein d'autres
petites améliorations. Les <a href="release-1.18.html">notes
de version</a> (en anglais). <span class="important">Cette
version utilise <b>evince</b> par défaut comme visualiseur
PDF même si recoll est configuré pour utiliser les
préférences du bureau. Vous pouvez retrouver le
comportement antérieur en éditant la liste "exceptions"
dans la configuration GUI.</span>
</dd>
<dt>2012-10-25</dt><dd> Un problème avec une solution simple peut provoquer
des <span class="important">plantages de
recollindex</span>.
Si vous indexez des messages mail Mozilla/Thunderbird
@ -117,21 +131,21 @@
et à se planter. Dans les cas moins graves (avec des
fichiers de taille "raisonnable"), cela provoque aussi une
indexation incorrecte des messages.
</li>
</dd>
<li>2012-10-16: <a href="filters/filters.html">un nouveau filtre
pour les documents EPUB</a>.</li>
<li>2012-05-24: Sortie de la
<dt>2012-10-16</dt><dd> <a href="filters/filters.html">un nouveau filtre
pour les documents EPUB</a>.</dd>
<dt>2012-05-24</dt><dd> Sortie de la
version <a href="download.html#source">1.17.3</a>. Voir
les <a href="release-1.17.html">les notes</a>. Cette version
corrige un "arrêt imprévu" de l'indexation qui se produisait
parfois en traitant certains messages mail.
</li>
</dd>
<li>2010-11-20 : un petit script pour activer/cacher recoll sur un
<dt>2010-11-20 : un petit script pour activer/cacher recoll sur un
bureau gnome d'un seul coup de clavier:
<a href="http://bitbucket.org/medoc/recoll/wiki/HotRecoll">
recette d'installation</a>.</li>
recette d'installation</a>.</dd>
</ul>

38
website/release-1.18.html
View File

@ -39,15 +39,15 @@
character case and diacritics sensitivity, and it will be
advisable to reset the index in most cases. This will be best
done by destroying the index directory (<tt>rm -rf
~/.recoll/xapiandb</tt>).</p>
<p><em>If</em> the 1.18 index is not configured for case and
~/.recoll/xapiandb</tt>).<br>
<em>If</em> 1.18 is not configured for case and
diacritics sensitivity, it is mostly compatible with 1.17
indexes though.</p>
indexes.</p>
<p>Case/diacritics sensitivity is off by default for this
release. It can be turned on <em>only</em> by editing recoll.conf
(see the manual). If you do so, you must then reset the index.</p>
(<a href="usermanual/usermanual.html#RCL.INDEXING.CONFIG.SENS">
see the manual</a>). If you do so, you must then reset the index.</p>
<p>Always reset the index if installing over an even older
version (1.16 and older). The simplest way to do this is to
@ -55,7 +55,7 @@
(<span class="literal">rm&nbsp;-rf&nbsp;~/.recoll/xapiandb</span>),
then start recoll or
recollindex. <span class="literal">recollindex&nbsp;-z</span>
will do the same in most, but not all, cases.</p>
&nbsp;will do the same in most, but not all, cases.</p>
<p>The subdirectories of xapiandb which were previously used to
store the stem expansion database (stem_english,
@ -85,8 +85,6 @@
which is the ability to search for exact matches of character case
and diacritics.</p>
<p>Recoll 1.18.0 changes:</p>
<ul>
<li>The index can now be configured for case and diacritics
@ -103,13 +101,20 @@
behave like they did in 1.17. Sensitivity must be
explicitely requested in most cases.</li>
<li>The advanced search screen now has a history
function. While the focus is in this window, you
can walk the history of searches using the up and down
arrows.</li>
<li>Recoll has a new capacity to store page break locations
and use them when opening a document at the location for a
given match. This currently works with PDF, Postscript and DVI
documents, and the <b>evince</b> viewer.</li>
given match. It will also pass a search string to the viewer
application. This currently works with PDF, Postscript and DVI
documents, and, optimally, the <b>evince</b> viewer.</li>
<li>Recoll can now also pass a search string to the native
application (again, works with <b>evince</b>).</li>
<li>The GUI result list has a new "snippets" window for
documents with page numbers, which let the user choose a
snippet and open the document at the appropriate page.</li>
<li>There is a list of MIME types that should be opened with
the locally configured application even when <em>Use
@ -123,15 +128,6 @@
be done from the <em>Preferences->Gui Configuration</em>
menu.</li>
<li>The GUI result list has a new "snippets" window for
documents with page numbers, which let the user choose a
snippet and open the document at the appropriate page.</li>
<li>The advanced search screen now has a history
function. While the focus is in this window, you
can walk the history of searches using the up and down
arrows.</li>
<li>We now allow multiple directory specifications in the query
language, as in: <i>dir:/home/me -dir:tmp</i></li>

3
website/styles/style.css
View File

@ -83,7 +83,8 @@ p.remark {
margin-right: 4em;
}
div.news {
font-size: 80%;
font-size: 90%;
margin-right: 5em;
}
.application {
font-weight: bold;