|
a/src/README |
|
b/src/README |
|
... |
|
... |
69 |
|
69 |
|
70 |
4.1.1. Installing through a package system
|
70 |
4.1.1. Installing through a package system
|
71 |
|
71 |
|
72 |
4.1.2. Installing a prebuilt Recoll
|
72 |
4.1.2. Installing a prebuilt Recoll
|
73 |
|
73 |
|
74 |
4.2. Building from source
|
|
|
75 |
|
|
|
76 |
4.2.1. Prerequisites
|
|
|
77 |
|
|
|
78 |
4.2.2. Building
|
|
|
79 |
|
|
|
80 |
4.2.3. Installation
|
|
|
81 |
|
|
|
82 |
4.3. Packages needed for external file types
|
74 |
4.2. Packages needed for external file types
|
|
|
75 |
|
|
|
76 |
4.3. Building from source
|
|
|
77 |
|
|
|
78 |
4.3.1. Prerequisites
|
|
|
79 |
|
|
|
80 |
4.3.2. Building
|
|
|
81 |
|
|
|
82 |
4.3.3. Installation
|
83 |
|
83 |
|
84 |
4.4. Configuration overview
|
84 |
4.4. Configuration overview
|
85 |
|
85 |
|
86 |
4.4.1. Main configuration file
|
86 |
4.4.1. Main configuration file
|
87 |
|
87 |
|
|
... |
|
... |
736 |
The executable binary files are built with a static link to libxapian and
|
736 |
The executable binary files are built with a static link to libxapian and
|
737 |
libiconv, to make installation easier (no dependencies). However, this
|
737 |
libiconv, to make installation easier (no dependencies). However, this
|
738 |
also means that you cannot change the versions which are used.
|
738 |
also means that you cannot change the versions which are used.
|
739 |
|
739 |
|
740 |
After extracting the tar file, you can proceed with installation as if you
|
740 |
After extracting the tar file, you can proceed with installation as if you
|
741 |
had built the package from source.
|
741 |
had built the package from source (that is, just type make install). The
|
742 |
|
|
|
743 |
The binary trees are built for installation to /usr/local.
|
742 |
binary trees are built for installation to /usr/local.
|
744 |
|
743 |
|
745 |
----------------------------------------------------------------------
|
744 |
You may then need to install external applications to process some file
|
|
|
745 |
types that you want indexed (ie: acrobat, postscript ...). See next
|
|
|
746 |
section.
|
746 |
|
747 |
|
|
|
748 |
Finally, you may want to have a look at the configuration section.
|
|
|
749 |
|
|
|
750 |
----------------------------------------------------------------------
|
|
|
751 |
|
|
|
752 |
4.2. Packages needed for external file types
|
|
|
753 |
|
|
|
754 |
Recoll uses external applications to index some file types. You need to
|
|
|
755 |
install them for the file types that you wish to have indexed (these are
|
|
|
756 |
run-time dependencies. None is needed for building Recoll):
|
|
|
757 |
|
|
|
758 |
* PDF: pdftotext is part of the Xpdf package.
|
|
|
759 |
|
|
|
760 |
* Postscript: pstotext.
|
|
|
761 |
|
|
|
762 |
* MS Word: antiword.
|
|
|
763 |
|
|
|
764 |
* MS Excel and PowerPoint: catdoc.
|
|
|
765 |
|
|
|
766 |
* RTF: unrtf
|
|
|
767 |
|
|
|
768 |
* dvi: dvips
|
|
|
769 |
|
|
|
770 |
* djvu: DjVuLibre
|
|
|
771 |
|
|
|
772 |
* MP3: Recoll will use the id3info command from the id3lib package to
|
|
|
773 |
extract tag information. Without it, only the filenames will be
|
|
|
774 |
indexed.
|
|
|
775 |
|
|
|
776 |
Text, Html, mail folders and Openoffice files are processed internally.
|
|
|
777 |
|
|
|
778 |
----------------------------------------------------------------------
|
|
|
779 |
|
747 |
4.2. Building from source
|
780 |
4.3. Building from source
|
748 |
|
781 |
|
749 |
4.2.1. Prerequisites
|
782 |
4.3.1. Prerequisites
|
750 |
|
783 |
|
751 |
At the very least, you will need to download and install the xapian core
|
784 |
At the very least, you will need to download and install the xapian core
|
752 |
package (Recoll development currently uses version 0.9.5), and the qt
|
785 |
package (Recoll development currently uses version 0.9.5), and the qt
|
753 |
runtime and development packages (Recoll development currently uses
|
786 |
runtime and development packages (Recoll development currently uses
|
754 |
version 3.3.5, but any 3.3 version is probably ok).
|
787 |
version 3.3.5, but any 3.3 version is probably ok).
|
|
... |
|
... |
761 |
not be critical). On Linux systems, the iconv interface is part of libc
|
794 |
not be critical). On Linux systems, the iconv interface is part of libc
|
762 |
and you should not need to do anything special.
|
795 |
and you should not need to do anything special.
|
763 |
|
796 |
|
764 |
----------------------------------------------------------------------
|
797 |
----------------------------------------------------------------------
|
765 |
|
798 |
|
766 |
4.2.2. Building
|
799 |
4.3.2. Building
|
767 |
|
800 |
|
768 |
Recoll has been built on Linux (redhat7.3, mandriva 2005, Fedora Core 3),
|
801 |
Recoll has been built on Linux (redhat7.3, mandriva 2005, Fedora Core 3),
|
769 |
FreeBSD and Solaris 8. If you build on another system, I would very much
|
802 |
FreeBSD and Solaris 8. If you build on another system, I would very much
|
770 |
welcome patches.
|
803 |
welcome patches.
|
771 |
|
804 |
|
|
... |
|
... |
801 |
manually copy and modify one of the existing files (the new file name
|
834 |
manually copy and modify one of the existing files (the new file name
|
802 |
should be the output of uname -s).
|
835 |
should be the output of uname -s).
|
803 |
|
836 |
|
804 |
----------------------------------------------------------------------
|
837 |
----------------------------------------------------------------------
|
805 |
|
838 |
|
806 |
4.2.3. Installation
|
839 |
4.3.3. Installation
|
807 |
|
840 |
|
808 |
Either type make install or execute recollinstall prefix, in the root of
|
841 |
Either type make install or execute recollinstall prefix, in the root of
|
809 |
the source tree. This will copy the commands to prefix/bin and the sample
|
842 |
the source tree. This will copy the commands to prefix/bin and the sample
|
810 |
configuration files, scripts and other shared data to prefix/share/recoll.
|
843 |
configuration files, scripts and other shared data to prefix/share/recoll.
|
811 |
|
844 |
|
|
... |
|
... |
813 |
was specified when executing configure, you will have to set the
|
846 |
was specified when executing configure, you will have to set the
|
814 |
RECOLL_DATADIR environment variable to indicate where the shared data is
|
847 |
RECOLL_DATADIR environment variable to indicate where the shared data is
|
815 |
to be found.
|
848 |
to be found.
|
816 |
|
849 |
|
817 |
You can then proceed to configuration.
|
850 |
You can then proceed to configuration.
|
818 |
|
|
|
819 |
----------------------------------------------------------------------
|
|
|
820 |
|
|
|
821 |
4.3. Packages needed for external file types
|
|
|
822 |
|
|
|
823 |
Recoll uses external applications to index some file types. You need to
|
|
|
824 |
install them for the file types that you wish to have indexed (these are
|
|
|
825 |
run-time dependencies. None is needed for building Recoll):
|
|
|
826 |
|
|
|
827 |
* PDF: pdftotext is part of the Xpdf package.
|
|
|
828 |
|
|
|
829 |
* Postscript: pstotext.
|
|
|
830 |
|
|
|
831 |
* MS Word: antiword.
|
|
|
832 |
|
|
|
833 |
* MS Excel and PowerPoint: catdoc.
|
|
|
834 |
|
|
|
835 |
* RTF: unrtf
|
|
|
836 |
|
|
|
837 |
* dvi: dvips
|
|
|
838 |
|
|
|
839 |
* djvu: DjVuLibre
|
|
|
840 |
|
|
|
841 |
* MP3: Recoll will use the id3info command from the id3lib package to
|
|
|
842 |
extract tag information. Without it, only the filenames will be
|
|
|
843 |
indexed.
|
|
|
844 |
|
|
|
845 |
Text, Html, mail folders and Openoffice files are processed internally.
|
|
|
846 |
|
851 |
|
847 |
----------------------------------------------------------------------
|
852 |
----------------------------------------------------------------------
|
848 |
|
853 |
|
849 |
4.4. Configuration overview
|
854 |
4.4. Configuration overview
|
850 |
|
855 |
|