|
a/src/INSTALL |
|
b/src/INSTALL |
|
... |
|
... |
| 14 |
Building from source
|
14 |
Building from source
|
| 15 |
|
15 |
|
| 16 |
Prerequisites
|
16 |
Prerequisites
|
| 17 |
|
17 |
|
| 18 |
At the very least, you will need to download and install the xapian core
|
18 |
At the very least, you will need to download and install the xapian core
|
| 19 |
package (I am currently using xapian version 0.8.5), and the qt runtime
|
19 |
package (I am currently using xapian version 0.9.2), and the qt runtime
|
| 20 |
and development packages (I am currently using qt 3.3.3).
|
20 |
and development packages (I am currently using qt 3.3.3).
|
| 21 |
|
21 |
|
| 22 |
You will most probably be able to find a binary package for qt for your
|
22 |
You will most probably be able to find a binary package for qt for your
|
| 23 |
system. You may have to compile Xapian, but this is not difficult.
|
23 |
system. You may have to compile Xapian, but this is not difficult.
|
| 24 |
|
24 |
|
|
... |
|
... |
| 70 |
After extracting the tar file, you can proceed with installation as if you
|
70 |
After extracting the tar file, you can proceed with installation as if you
|
| 71 |
had built the package from source.
|
71 |
had built the package from source.
|
| 72 |
|
72 |
|
| 73 |
Installation
|
73 |
Installation
|
| 74 |
|
74 |
|
| 75 |
Execute installrecoll targetdir, in the root of the source tree. This
|
75 |
Commands and common files
|
| 76 |
will:
|
|
|
| 77 |
|
76 |
|
| 78 |
* Only if you have write access on targetdir/bin, copy qtgui/recoll and
|
77 |
Either type make install or execute recollinstall targetdir, in the root
|
| 79 |
index/recollindex to targetdir/bin (but you could also execute them
|
78 |
of the source tree. This will copy the commands to $targetdir/bin and the
|
| 80 |
from their build directories).
|
79 |
sample configuration files to $targetdir/share/examples/recoll
|
| 81 |
* Only if you are not root check if ~/.recoll exists, and if it does
|
|
|
| 82 |
not:
|
|
|
| 83 |
* Copy all files from sampleconf/* to ~/.recoll
|
|
|
| 84 |
* Copy all files from filters/* to ~/.recoll.
|
|
|
| 85 |
|
80 |
|
| 86 |
Typically, you would execute the script once as root to install the
|
81 |
Personal configuration
|
| 87 |
programs to /usr/local, and once as yourself to create the configuration.
|
82 |
|
|
|
83 |
Either type make installme in the root of the source tree, or execute
|
|
|
84 |
recollinstall. This will copy the configuration files to the .recoll
|
|
|
85 |
directory in your home.
|
| 88 |
|
86 |
|
| 89 |
Configuration
|
87 |
Configuration
|
| 90 |
|
88 |
|
| 91 |
Recoll uses text configuration files. You will have to edit them by hand
|
89 |
Recoll uses text configuration files. You will have to edit them by hand
|
| 92 |
for now (all hope is not lost that there will be dialogs to build them
|
90 |
for now (all hope is not lost that there will be dialogs to build them
|
| 93 |
from the GUI in the future).
|
91 |
from the GUI in the future).
|
| 94 |
|
92 |
|
| 95 |
The main configuration file is named ~/.recoll/recoll.conf.
|
93 |
The main configuration file is named ~/.recoll/recoll.conf.
|
| 96 |
|
94 |
|
| 97 |
There is a commented sample in the sampleconf subdirectory, it was copied
|
95 |
A commented sample was copied to ~/.recoll by the installation. By
|
| 98 |
to ~/.recoll at the previous step, take a look and possibly edit it. By
|
|
|
| 99 |
default, it will index your home directory.
|
96 |
default, it will index your home directory.
|
| 100 |
|
97 |
|
| 101 |
Then start recollindex, and wait for indexing to complete (this may take
|
98 |
Then start recollindex, and wait for indexing to complete (this may take
|
| 102 |
some time). When it's done, you can start recoll and try a search.
|
99 |
some time). When it's done, you can start recoll and try a search. See the
|
|
|
100 |
user manual for a little more details
|
| 103 |
|
101 |
|
| 104 |
Depending on what is installed on your system, you may also want to adjust
|
102 |
Depending on what is installed on your system, you may also want to adjust
|
| 105 |
the external viewers defined in ~/.recoll/mimeconf (ie: html is either
|
103 |
the external viewers defined in ~/.recoll/mimeconf (ie: html is either
|
| 106 |
previewed internally or displayed using firefox, but you may prefer
|
104 |
previewed internally or displayed using firefox, but you may prefer
|
| 107 |
mozilla...). Look for the [view] section.
|
105 |
mozilla...). Look for the [view] section.
|