diff --git a/website/BUGS.txt b/website/BUGS.txt new file mode 100644 index 00000000..89f91481 --- /dev/null +++ b/website/BUGS.txt @@ -0,0 +1,55 @@ +Known bugs in current version and older versions: + +1.4.2 +- When a mime type has an external viewer defined, but the actual file is + compressed (ie: xxx.txt.gz), recoll will try to start the external viewer + on the compressed file, which will not work in most cases. + +- There are problems which have been reported indexing big mailstores + (several hundreds of thousands of messages): resulting in a very big + database and even crashes during indexation. + +1.3.3 + +- Several of the external filters did not handle path names with embedded + spaces (rcluncomp rclsoff rclps rclmedia rcldjvu). This is fixed in 1.4. + +- If your QT installation is built with the QT_NO_STL flag, Recoll will not + compile. I have a patch for this (will be fixed in the next release), + contact me if you get the problem. Typical error message: + main.cpp:160: error: no match for 'operator+=' in 'msg += reason' + +- The 'None of these words' field in the complex search does not work if + there are no other filled fields (it transforms into an ordinary + search). Workaround: enter very common term(s) in the 'any of these + words' field. + +- Indexing cannot currently be conveniently and cleanly stopped when it's + started. You can kill the process, and keyboard interrupt might work, but + this may leave the database in a bad state. This is fixed in the upcoming + release, there is no current workaround. + +1.2.2 +- The preview window is supposed to scroll after loading the document so + that the first search term is visible. This does not work in many cases. +- The result list title is not shown for sorted lists + +Notes on older versions: +- Trouble compiling on some linux systems (Gentoo and Slackware?). There + existed a quite common issue where the Recoll link will fail trying to + use a libstdc++.la file. This was due to a problem with the xapian-config + program. A workaround has been included in the configure script for + recoll 1.2.2, and the problem should not occur any more. + +- Case-insensitive search should now work in most cases (used to not work + except for accented ascii). + +- All directories and files with names beginning with a dot were ignored + by the skippedNames directive in the default recoll.conf file from + older versions (no indexation of mozilla or thunderbird email !). An + upgrade will not fix this (it will not modify an existing + configuration). You need to edit recoll.conf by hand and remove the .* + from skippedNames. + + + diff --git a/website/CHANGES.txt b/website/CHANGES.txt new file mode 100644 index 00000000..97b963ad --- /dev/null +++ b/website/CHANGES.txt @@ -0,0 +1,137 @@ +CHANGES + +Updating from 1.2 to 1.3 or 1.4: +------------------------------- +From version 1.3 up, there is a new feature to search specifically for file +names (with wildcard processing). If you want to take full advantage of +this, you should perform a full reindex after installing the new version +(ie: use recollindex -z, or delete ~/.recoll/xapiandb). +Also, we now use the central copies of configuration files for default +values, and the user ones only for overrides. Your old configuration files +will still work, but, you may want to remove them if they are unmodified, +or keep only the modified parameters. + + +1.4.3 2006-05-07 + - Multiple search databases. + - Optionally auto-search when a word is entered in the simple search + field. + - Show possible term completions in simple search by typing CTRL+TAB + - Add 'more like this' option to result list right-click menu, to look for + documents related to the current result. + - Double-click in preview or result list adds the selected word to the + simple search text field. + - The simple search text entry field is now a combobox and remembers + previous searches. + - Additional OR field in complex search. + - Improved indexing cancellability (interrupting recollindex or closing + recoll with an indexing thread active), and status reporting. + - Fixed filters to handle file paths with embedded spaces. + - Misc small bug and memory leaks fixes. + - More compact result list. + - Set mode 0700 on .recoll directory by default + +1.3.3 2006-04-04 + - Implement specific search on file names with wildcard + support. Indexation can optionally process all file names or only those + with mime types supported for normal indexation. UPDATING: you need a + full re-indexation to take advantage of this. + - Use links and a right-click popup menu to replace confusing use of + mouse clicks and double-clicks inside the result list. + - The 'example' configuration files are now used as default, and are not + copied any more to the user directory during installation. Overrides can + be set in the personal files for any value that the user wishes to + modify, with unchanged formats and file names (so that the files from + previous versions remain valid, but you may wish to trim them of values + that duplicate the central ones). + - Use NLS information (LC_CTYPE, LANG) do determine default charset when + possible. + - Mp3 file indexing, either filenames only or also id3 tags if id3info is + available. c/c++ ext edit. Use gnuclient instead of xemacs for text files. + - Russian and Ukrainian translations and many improvement ideas thanks to + Michael Shigorin. + +1.2.3 2006-03-03 + - Added support for dvi (with dvips), and dvu (with DjVuLibre). + - Ensure that configure and make use the same qt version. + - Fix sorted sequence title display. + - Discriminate fatal errors and missing docs while loading a doc list. + - Improved and cleaned up way to position a preview on the first search term. +1.2.2 2006-02-02 + - Fix minor compilation glitches (FreeBSD 4, QT 3.1, xapian-config problem) +1.2.0 2006-02-01 + - Improved preview loading: don't highlight very big documents (over 1Mb), + allow cancellation while loading. + - Abstracts generated in the result list by looking at search term + contexts. This can slow down result list display for big documents, and + can be turned off in the preferences menu. + - Wrap query detail line displayed when clicking on result list header. + - Text splitting cleanup with less spurious terms should result in + slightly smaller databases. + - Sligthly improved presentation in preview, esp. line breaks. + - Color icons... + - Let the user select the html browser used for help display. + - autoconf/Makefile change: allow building UI from inside the qtgui + directory. + - autoconf/Makefile: improved search and diagnostics for qt/qmake. + - Internal code cleanup for maintainability: text splitting, user + interface. + - Added prototype kio_slave to show result inside Konqueror, doesn't seem + particularly useful. +1.1.0 2006-01-12 + - A much better user manual, which can be browsed from the help menu. + - man pages for recoll, recollindex, recoll.conf + - User/query interface configuration dialog. + - Click on result list header will display the exact boolean search which + was used. + - recollindex can be used to create stem expansion databases independantly + of a full indexing pass. + - Misc user interface improvements, like an 'all terms' checkbox for + simple search. + - Fixed case-insensitivity issues. Probably needs more testing. +1.0.16 2006-01-05 + - Minor installation tweaks for rpm compatibility +1.0.15 + - Fix problems with prefix != /usr/local + - Remove '.*' from the default list of ignored file/dir names: this + prevented mozilla/thunderbird mail indexing. + - Fix some 64 bits issues +1.0.14 + - Small changes for FreeBSD 4 compilation. +1.0.13 + - Install of recollinstall program not done or needed any more. +1.0.12 + - Fixed nasty html parsing bug introduced in 1.0.9 Html parsing failed + whenever the document charset name differed from the default only in + character case or punctuation. +1.0.11 + - Create personal configuration on first start. + - Use qt toolbars. + - Also index terms in file paths. + - Tool for sorting on dates or mime types. + - Fixed pdf filter which was broken by more recent xpdf + - Filters now installed/executed from /usr/local + +1.0.10 + - Added tool to manage the history of consulted documents. + - Try harder to convert email messages with wrongly declared charsets. + - Add option to reset the database before indexing (easier than rm -rf). + - Small gui improvements. + - Install partial french translation as a tease for future translaters... + +1.0.8->1.0.9 + - Fixed 2 really ennoying bugs in 1.0.8: wouldn't preview 2nd document + from same file + spurious db close when filter could not be executed. + +1.0.5 -> 1.0.8 + - Add support for rtf and gaim logs + - Optionally show icons to indicate mime types in result list + - Better (but imperfect) feedback during the preview loading for big files + - Remember main window geometry when closing + - Fix stem expansion in advanced search + - Some autoconf + - Option to use the system's 'file' command as a final step of + identification for suffix-less or unknown files. + - Typo had removed support for .Z compression + - Use more appropriate conjonction operators when computing the advanced + search query (OP_AND_MAYBE, OP_FILTER instead of OP_AND) \ No newline at end of file diff --git a/website/copydocs b/website/copydocs new file mode 100644 index 00000000..582e0867 --- /dev/null +++ b/website/copydocs @@ -0,0 +1,15 @@ +#!/bin/sh + +docdir=/home/dockes/projets/fulltext/recoll/src/doc/user/ + +(cd $docdir;make) || exit 1 + +test -d usermanual || mkdir usermanual || exit 1 +cd usermanual + +thisdir=`pwd` +(cd $docdir; find . -name '*.html' | cpio -p $thisdir) +cp $docdir/docbook.css . +# The freebsd tool chain generates a link to book.html in the index. Too +# lazy to check if this can be changed +cp usermanual.html book.html diff --git a/website/credits.html b/website/credits.html new file mode 100644 index 00000000..b03af7a5 --- /dev/null +++ b/website/credits.html @@ -0,0 +1,73 @@ + + + + + RECOLL: credits + + + + + + + + + + + + + + +
+ +
+ +
+ +

Credits

+ +

Recoll borrows (steals?) + heavily from the following projects. I tried to include the + relevant copyright attributions with the code. Any omission is + unintentional and will be fixed as soon as notified.

+ + + + + + +
+ + + diff --git a/website/devel.html b/website/devel.html new file mode 100644 index 00000000..f1fb5d8e --- /dev/null +++ b/website/devel.html @@ -0,0 +1,73 @@ + + + + + RECOLL: a personal text search system for + Unix/Linux + + + + + + + + + + + +
+ +
+ +
+ +

Development

+ +

If you wish to become involved in the development of Recoll, you are very much welcome, + please send me an email.

+ +

Apart from general development for additional functionality + or bug fixes, the following tasks are waiting for you:

+ + +
+ + + diff --git a/website/download.html b/website/download.html new file mode 100644 index 00000000..32e6d8d2 --- /dev/null +++ b/website/download.html @@ -0,0 +1,116 @@ + + + + + Recoll download + + + + + + + + + + + + + + +
+ +
+ +
+ +

Recoll downloads

+ +

You will probably need to have a look at the + installation manual for + building and/or installation instructions.

+ + +

Source

+ +

Current version, 1.4.3: + recoll-1.4.3.tar.gz. + See the known bugs and issues and changes. Release 1.4.3 is exactly + 1.4.2 with updated ukrainian and russian messages (thanks to + Michael Shigorin). No need to upgrade from 1.4.2 if you + do not need these.

+ +

Older recoll releases: + 1.4.2. + 1.3.3. + 1.2.3. + 1.1.0. + 1.0.16. +

+ +

RPMS

+

The executables inside the binary rpms have a static link to + xapian, there is no dependency except Qt. Of course you need + xapian-core installed to use the source rpm.

+ +

Fedora Core 4 + RPM: recoll-1.4.3-1.i386.rpm. + Source: recoll-1.4.3-1.src.rpm

+ +

Mandriva 2006 + RPM: recoll-1.4.3-0.1.20060mdk.i586.rpm. + Source: recoll-1.4.3-0.1.20060mdk.src.rpm

+ + +

Binary bundles

+ +

These are just prebuilt trees (without the source files). + The executables were built with xapian 0.9.2 or 0.9.5 and + libiconv 1.9.2 (where relevant) as static libraries. They + depend on qt 3.3. For Solaris, you should be able to find a qt + package here.

+ +

The installation instructions are there.

+ +

FreeBSD 5.5 i386: + recoll-1.4.3-FreeBSD-5.5-PRERELEASE.tgz

+ +

Linux (redhat 7.3, i386). I expect + this to also run on more recent systems. The recoll version is + a bit old but this may give you an idea + recoll-1.2.2-Linux-2.4.18-3.tgz.

+ +

Solaris 8 sparc. + + recoll-1.4.3-SunOS-5.8.tgz.

+ +

FreeBSD ports

+ +

There are ports for both xapian-core + and recoll in the standard tree, you may just need to update + your ports (cvsup), or you can get the ports from the FreeBSD + site: xapian + port recoll + port.

+ +
+ + diff --git a/website/features.html b/website/features.html new file mode 100644 index 00000000..d6286f1d --- /dev/null +++ b/website/features.html @@ -0,0 +1,137 @@ + + + + + RECOLL: a personal text search system for + Unix/Linux + + + + + + + + + + + + +
+ +
+ +
+ +

Recoll features

+ +
+
Supported systems
+
Recoll has been compiled and + tested on FreeBSD, Linux, Darwin and Solaris (versions + FreeBSD 5.3, Redhat 7.3, Fedora Core 4, Gentoo, Debian 3.1, + Solaris 8/9, but other not too distant releases should be ok + too). You can download the source code and some precompiled + packages here.
+ +
Qt versions from 3.1
+ +
Document types
+
Supports the following document types (along with their + compressed versions): + +
+
Natively
+ +
+
    +
  • text.
    • + +
  • html.
    • + +
  • OpenOffice + files.
    • + +
  • maildir and mailbox (Mozilla, Thunderbird and Evolution mail ok).
    • + +
  • gaim log files.
    • +
+
+
With external helpers
+ +
+ +
+
+
+ +
Other features
+
+
    +
  • Multiple selectable databases.
    • + +
  • Powerful query facilities, with boolean searches, + phrases, filter on file types and directory tree.
    • + +
  • Specific file name searches with wildcards.
    • + +
  • Support for multiple charsets. Internal processing and + storage uses Unicode UTF-8.
    • + +
  • Stemming performed at query time (can switch stemming + language after indexing).
    • + +
  • Easy installation. No database daemon, web server or + exotic language necessary.
    • + +
  • An indexer which runs either as a thread inside the GUI + or as an external, cron'able program.
    • +
+
+ + + +
+ + + diff --git a/website/index.html b/website/index.html new file mode 100644 index 00000000..371c3044 --- /dev/null +++ b/website/index.html @@ -0,0 +1,87 @@ + + + + + RECOLL: a personal text search system for + Unix/Linux + + + + + + + + + + + + +
+ +

+ + +

+ +
+ +
+ +

Recoll is + a personal full text search tool for Unix/Linux.

+ +

It is based on the very strong Xapian backend, for which it + provides an easy to use, feature-rich, easy administration, + QT graphical interface.

+ +

Recoll is free, open source, + and copyrighted under the GPL license. The current version is + 1.4.3

+

We borrow a lot of code + from other packages, see the Credits.

+ +

Features:

+ + + +

Support

+ +

If you have any problem with the package or its + installation, or a need for additional features, please contact us.

+ +

We also very much welcome functional suggestions or (gasp) + code, see the development page.

+ +
+ + + diff --git a/website/pics/index.html b/website/pics/index.html new file mode 100644 index 00000000..47fc0b3c --- /dev/null +++ b/website/pics/index.html @@ -0,0 +1,26 @@ + + + + Recoll Screenshots + + + + +
+ +
+ +
+

Screenshots

+ + + + + +
+ + diff --git a/website/styles/style.css b/website/styles/style.css new file mode 100644 index 00000000..4b1a1fe4 --- /dev/null +++ b/website/styles/style.css @@ -0,0 +1,90 @@ +/*--General-----------------------------------------------*/ +html { + margin 0; +} +body { + position: relative; + margin: 0; + color: black; + font-family: Verdana, Helvetica, Arial, sans-serif; +} + +a img { + border:none; + margin:0px; + padding:0px; +} + +/*- Menu---------------------------------------*/ + +div.rightlinks { + width: 130px; + float: right; + font-size: 80%; + padding-top: 4em; +} + +.rightlinks ul { + margin-left: 2px ; + padding-left: 1.5em ; + line-height: 200%; +} + +/*-Main content area-------------------------*/ +.content { + margin-top: 2em; + margin-left: 25px; + margin-right: 145px; +} + +.content img { + margin: 0.3em; +} + +.content dt { + font-weight: bold; +} + +h1, h2, h3, h4, h5, h6 { + color: #222299; +} + +h1 { + font-weight: normal; + font-size: 140%; + padding-bottom: 1em; +} +h2 { + font-weight: normal; + font-size: 120%; +} +h3 { + font-weight: normal; +} +p.indexthumb { + margin-left: 1em; +} +.guimenu, .guimenuitem, .guisubmenu, +.guilabel, .interface, .guibutton, +.shortcut, .shortcut .keycap { + background-color: #F0F0F0; + font-family: monospace; +} +.application { + font-weight: bold; +} +.command { + font-family: monospace; +} +.filename { + font-family: monospace; + color: #007a00; +} + +a.important { + background: yellow; +} +a.weak { + color: #aaaaaa; +} +