這篇文檔介紹全文搜索概念，并講解Recoll 程序的安裝和使用。它當前針對的是Recoll 1.16。

內容目錄

Recoll是一個全文搜索程序。全文搜索程序讓妳能夠通過內容來找到妳的數據，而不是通過外部屬性（比如文件名）來找。再細致點說，它們使得妳能夠指定哪些詞語應當出現在妳要找的文件中，哪些詞語不應當出現，然後返回一組符合條件的文檔，最相關 的文檔會出現在最前面。

妳不需要記住妳的某個重要信息是保存在哪封郵件或者哪個文件裏。妳只需要提供一些相關詞語，這個工具會按照這些詞語在文檔中的重要性來返回一組文檔，就像互聯網搜索引擎那樣。

搜索程序會努力計算出哪些文檔與妳提供的搜索詞語最相關。用來計算相關性的電腦算法都非常復雜，而且跟人腦那迅速確定相關性的能力相比，普遍差遠咯。對于相關性的猜測的准確度可能是評估一個搜索程序的最重要因素咯。

好多情形中，妳都是要尋找一個單詞的所有時態，而不只是自己輸入的指定時態。這些不同時態可以包括：復數、動詞的不同時態、從相同的詞根派生的詞語（比如：floor、floors、floored、flooring...）。搜索程序通常會將查詢條件擴展到所有這些相關詞語（經過縮減之後得到相同的詞根）上，并且還提供一個功能讓妳能夠關掉這種擴展，以讓妳搜索某個確定的單詞。

詞根計算過程本身不會與拼寫檢查或語音搜索技術相配合。Recoll 通過一個特殊工具( 單詞探索器 )來支持這些特性，它使得妳可以按照不同模式來探索已索引的單詞集合。

索引就是對文檔進行分析并且將數據保存到數據庫中去的過程。Recoll 的索引過程通常是增量的：文檔只有在被修改過之後才會被處理。當然，在第一次執行的時候，所有的文檔都需要處理。以後仍然可以通過向索引命令指定某個參數（recollindex -z）來強制讓它重新進行完整的索引。

Recoll 索引可用兩種方法來進行：

默認的索引數據存儲位置就是Recoll 配置文件目錄的xapiandb 子目錄，一般是$HOME/.recoll/xapiandb/。可通過兩種方式（目的也不同）改變這一點：

如果妳第一次安裝的Recoll 是1.9.0 版本或更新的版本，那麽妳可以無視這一小節。（無視）

Recoll 索引中不會保存被索引的文檔的復件。但是它保存咯足夠的數據，幾乎能夠原樣重構原文檔。如果要索引機密數據，那麽應當限制對數據庫目錄的訪問權限。

從1.4 版本開始，Recoll 會在創建配置文件目錄時使用 0700 權限模式（只允許擁有者訪問）。由于在默認情況下索引數據目錄是配置文件目錄的一個子目錄，所以能夠得到保護。

如果妳采用其它的配置情況，那麽妳應當考慮一下對妳的索引數據的保護，正確設置目錄和文件的訪問權限，另外在更新索引的時候可能還需要調整 權限掩碼 。

針對某個指定的配置文件的大部分參數都可以在按照這個配置文件運行（或者是默認情況，或者是設置RECOLL_CONFDIR 或-c選項。）的recoll 圖形界面中設置。

這個界面是用菜 Preferences 單啟動的。它有兩個主要的面板。第一個面板用來設置全局變量，比如說頂級目錄的列表或者要跳過的路徑的列表。第二個面板用來設置那些針對子目錄的變量。第二個面板裏的自定義目錄列表默認是空的，妳可以自由添加。然後那些變量會針對當前選中的目錄（或者，如果選中的是空白行，則是針對頂級目錄）而設置。

可用兩種方式來執行索引：recollindex 程序，或recoll 程序中的索引線程（使用File 菜單）。兩個程序都會使用RECOLL_CONFDIR 變量或接受-c 配置文件目錄 選項來指定一個非默認的配置文件目錄。

選擇是要使用索引線程還是recollindex 命令的理由：

• •.啟動索引線程更方便，只需要點擊一下鼠標。

• •. recollindex 命令有更多選項，尤其是用來重置索引的選項（-z）。

• •. recollindex 命令如果崩潰的話，不會影響到妳的圖形界面（很罕見的情況，但是誰能保証不會發生勒...）

• •. recollindex 命令使用setpriority/nice 來降低自己在索引時的優先級(當ionice 普及時，它也會使用這個)，線程無法做這一點，否則它也會使用戶界面變慢。

請讀者自行決定吧...

如果recoll 程序在啟動時沒有發現索引，那麽它會自動開始索引（除非被取消）。

recollindex 索引進程可通過發送一個中斷（^C, SIGINT）或終止（SIGTERM）信號來中斷。在進程退出之前可能會需要一些時間，因為它需要保存并關閉索引。索引線程也可從菜單中終止。

在這樣中斷之後，索引會有一定程度的損壞，因為那些通常在索引過程的最後時間做的操作會被跳過（比如，詞根和拼寫數據庫會不完整，或者過時）。妳只需要稍後重新啟動索引過程，便可以修復。索引會在中斷的位置繼續（整個文件樹會被遍歷，但是在中斷之前便已經索引過并且目前仍為最新狀態的那些文件不需重新索引）。

recollindex 還有一些其它的選項，在它的man 頁面說明。

妳可能會對-i和-f選項感興趣。-i 允許對一個明確給出（以命令行參數給出或從標准輸入讀取）的文件列表進行索引。-f 使得recollindex 無視配置文件中指定的文件選擇參數。將這兩個選項結合，就可以實現一個自定義的文件選擇過程，只處理文件系統中的某些區域：將頂級目錄添加到skippedPaths 列表中，再采用一個適當的文件選擇方法來構造文件列表，提供給recollindex -if。

recollindex -i 不會跟進到參數中的目錄裏面，只會將那些目錄添加到索引條目中。構造完整文件列表的事情是由外部的文件選擇方法來負責的。

通過recollindex -m 命令來實現實時的監視/索引。使用這個選項之後，recollindex 會脫離終端，成為一個守護進程，持久地監視文件的變化并且更新索引。

當采用實時監視時，可能會發生這樣的事：某些文件需要索引，而它們又變動得太頻繁，以致于給系統造成過重的負擔。

recoll 程序提供咯用來進行搜索的主要用戶界面。它是基于Qt 庫的。

recoll 有兩種搜索模式：

• •.簡單搜索（默認方式，位于主屏幕），擁有一個輸入條目，其中可輸入多個詞語。

• •.高端搜索（一個面板，通過Tools 菜單或工具條圖標來調出），擁有多個輸入條目，妳可用來構造一個邏輯條件，另外還可以過濾文件類型及文件位置。

大部分情況下，妳可以輸入妳想到的詞語，甚至可以在其中包含一些標點符號或非文本的字符。比如，Recoll 可以處理這些東西：郵件地址、從其它文本窗口復制過來的東西、標點。

那種妳需要將文字按照與平常打印時不同的方式來輸入的情形，主要是針對東亞語言的（中文）。在這種情況下，由多個字組成的詞語應當拆開，每兩個字之間用空格隔開（一般在打印時不會用空格隔開）。

1. 1.啟動 recoll 程序。

2. 2.自行決定是否要選擇一下搜索模式：Any term、All terms、File name或Query language。

3. 3.在窗口頂部的文本輸入框中輸入搜索單詞。

4. 4.點擊Search 按鈕，或者按 回車 鍵，以開始搜索。

初始的默認搜索模式是Query language。如果沒有特殊指令的話，這個模式會查找那些包含所有搜索詞語的文檔（含有的詞語越多，得分越高），就像All terms 模式一樣，不過那個模式會無視這些指令。Any term模式會查找那些至少包含其中一個詞語的文檔。

在搜索之後，會馬上有一個結果列表顯示在主列表窗口中。

除咯預覽和打開鏈接之外，妳還可以在結果列表中的任一段落上單擊右鍵來顯示一個彈出菜單。這個菜單有以下條目：

• •.Preview

• •.Open

• •.Copy File Name

• •.Copy Url

• •.Save to File

• •.Find similar

• •.Preview Parent document

• •.Open Parent document

Preview 和Open 條目所做的事與對應的鏈接相同。

Copy File Name 和 Copy Url 會將相關的數據復制到剪切板，以便稍後粘貼。

Save to File允許將一個結果文檔的內容保存到某個文件裏。這個條目只在當前文檔不是一個單獨文件，而是某個文件中的子文檔（也就是說：一個郵件附件）的情況下出現。這很有用，可在沒有對應編輯器的情況下提取附件。

Find similar條目會從當前文檔中選擇一些相關的詞語，將它們加入到簡單查詢輸入框。然後妳可以進行一次簡單查詢，這樣有機會找到與當前結果相關的文檔。

Parent document條目會針對那些本身并不是文件，而是一個更高級別的文件的一部分或是附件的文檔出現。這個條目主要是針對郵件附件的，允許查看當前文檔被附著于其上的那封郵件。注意，對于位于某個郵件文件夾文件中的郵件，這個條目也會出現，但是并不能打開那個文件夾（如果妳試著打開，將會出現一個錯誤對話框）。Recoll 還不夠智能，無法在這種情況下禁用這個條目。

從Recoll 1.15 開始，結果可按照一個表格形式來顯示。妳可以在工具條中點擊那個像表格一樣的圖標，來切換到這種呈現方式（這是一個開關式按鈕，再點擊一次就恢復列表形式）。

點擊某列的表頭可針對該列的值進行排序。妳可以再點擊一次，以使用反序，還可以通過表頭的右鍵菜單來重置排序規則為默認的按相關性排序（還可以使用按日期排序箭頭）。

列表和表格顯示的結果是一樣的。為表格設置的排序條件在妳切換回列表模式之後仍然有效。妳可以在一個日期排序箭頭上點擊再次以將它重置。

通過表頭的右鍵菜單可以增加或刪除列。那些列可以調整大小，它們的順序可以改變（拖放）。當妳退出recoll時，所有的改變都會被記錄。

將鼠標懸停在表格的某一行上時，會更新窗口底部的細節區域。妳可以點擊那一行來將下面顯示的東西固定。底部區域與一個經典的結果列表段落是等價的，其中帶有可以預覽及打開本地程序的鏈接，還有一個等價的右鍵菜單。按 Esc 鍵會將下面的顯示重新切換成變化狀態。

當妳第一次在結果列表中點擊一個Preview 鏈接時，會打開預覽窗口。

隨後在該搜索中再請求預覽時，會在已有的窗口中打開新標簽頁（除非妳在點擊時按住Shift 鍵，這樣會打開一個新窗口，以便進行比較）。

開始另一個搜索，并且要求預覽的話，會創建一個新的預覽窗口。舊的窗口會保持打開，除非妳關掉。

妳可以在預覽窗口中按^W (Ctrl + W)來關掉一個預覽標簽頁。關掉窗口的最後一個標簽頁時，窗口也會關閉。

當然，妳還可以通過窗口框架上由窗口管理器提供的按鈕來關掉預覽窗口。

妳可以在預覽標簽頁中按Shift+下或Shift+上 （ 下 和 上 是箭頭按鍵）來顯示結果列表中的下一個或上一個文檔。

預覽標簽頁有一個內部的增量搜索功能。妳可用以下方法來進行搜索：在文字區域按/（斜杠）或CTL-F，或點擊Search for:輸入條，再輸入搜索字符串。然後，妳可以使用Next 和Previous 按鈕來尋找下一個/上一個。妳還可以按F3 來定位到下一個。

如果妳輸入過搜索字符串，再用^Up/^Down來瀏覽結果的話，則後續的每個文檔中都會對搜索字符串進行搜索。如果字符串被找到，則光標會被定位到它首次出現的地方。

在文本區域單擊右鍵的話，可以將顯示的內容在主文字和相關的字段（也就是說：作者、摘要……）之間切換。這是特別有用的，有些時候匹配的字符串不是位于主文字中，而是位于相關字段中。

妳可按^P (Ctrl + P)，以便打印當前預覽窗口中的內容。

高端搜索對話框幫助妳進行更復雜的搜索，而且還不用記語法。它可通過Tools 菜單或主工具條來開啟。

這個對話框有三個部分：

• •.頂部允許通過組合多個不同類型的語句來構造一個查詢條件。每個條目都可以按照以下模式來配置：

  • •.All terms.

  • •.Any term.

  • •.None of the terms.

  • •.Phrase (在一個可調整的窗口內，精確的詞語，其順序固定)。

  • •.Proximity (在一個可調整的窗口內，任意順序的詞語)。

  • •.Filename search.

  可點擊Add clause 按鈕來創建更多的條目。

  在搜索時，取決于左邊的選項（All clauses或Any clause），那些非空白的條件會按照邏輯與或邏輯或來組合。

  除"Phrase"和"Near"以外任何類型的條目都接受單個詞語的組合以及用雙引號引用的詞組。詞根和通配符會像簡單查詢中一樣地被擴展。

• •.下一部分允許按照文件類型來過濾結果。

  文件類型選項的狀態可被保存為默認值（文件類型過濾器不會在程序啟動時便激活，但其中的列表會被恢復）。

• •.底部區域允許將搜索結果限制在索引區域中的一個子目錄樹中。妳可以使用Invert 復選框來使程序搜索那些不在這個子目錄樹中的文件。如果妳經常在文件系統中的大型子目錄樹上使用目錄過濾器的話，那麽妳可以考慮一下使用多個索引，那樣性能會好一些。

Phrases 和 Proximity 搜索 。這兩種模式非常相似，只有一點不同，proximity 搜索不會要求詞語按指定順序出現。在兩種模式下，在搜索詞語之間允許出現一定數量（模糊度）（使用左邊的計數器來調整其數量）的不匹配的詞語。對于 phrases ，默認數量是0（精確匹配）。對于 proximity ，其數量是 10 （意味著，如果兩個搜索詞語在一個由 12 個詞語組成的窗口中出現，則認定為匹配）。示例：以 phrase 模式搜索 quick fox ，模糊度為0，則會匹配quick fox ，不匹配quick brown fox。模糊度為1，則會匹配後者，但不匹配fox quick。以proximity 模式搜索quick fox，并且使用默認的模糊度，則會匹配後者，還會匹配 a fox is a cunning and quick animal。

在高端搜索對話框中點擊Start Search 按鈕，或者在任意一個文本框中按回車鍵，都能啟動搜索。主窗口中的按鈕啟動的一直是簡單搜索。

點擊結果頁面頂部的Show query details 鏈接來查看最終執行的查詢。

Recoll 自動處理單詞的時態變化等情況（也就是說：復數/單數、動詞形態）。但還存在一些情況，用戶是不知道要搜索的准確詞語的。比如，妳可能不記得某個詞語怎麽拼寫咯，或者只記得前面一部分。

詞語探索工具（從工具條圖標啟動或從Tools 菜單的Term explorer 條目啟動）可用來搜索整個索引詞語列表。它有三種模式：

Wildcard

可使用多個配置文件目錄來創建多個 Recoll 數據庫或索引，這通常是用來對文件系統的不同區域進行索引的。可使用RECOLL_CONFDIR 環境變量，或對recoll 和recollindex 使用-c選項，來選中一個特定的索引，對其進行更新或搜索。

一個recollindex 進程只能更新一個特定的索引。

一個recoll 進程同樣會與一個特定的索引關聯起來，那個索引會被它的索引線程更新，但它可以使用多個Recoll 索引來進行搜索。外部索引可通過配置對話框的external indexes 標簽頁來選擇。

索引的選擇是分兩步走的。首先要定義所有可用的索引，然後選擇要用來進行搜索的索引的子集。當然，這些參數是在程序每次執行時都會讀取的（它們是針對每個Recoll 配置單獨保存的）。所有索引的集合通常是固定不變的，但是活躍索引可能會經常被調整。

主索引（由RECOLL_CONFDIR定義）是永遠活躍的。如果妳不接受這一點，那麽請另外設置一個配置目錄，讓它索引一個空的目錄。

通過用戶界面來構造全部索引的集合可能會是相當冗長乏味的，所以妳可以使用RECOLL_EXTRA_DBS 環境變量來提供一個初始集合。這個東西一般會由系統管理員來設置，這樣就不用所有用戶親自設置咯。這個變量中的索引目錄之間應當用冒號隔開，也就是說：

export RECOLL_EXTRA_DBS=/某個/地方/xapiandb:/另/一個/db

多個索引的一個典型用法就是：系統管理員建立一個中央的索引，用來搜索共享數據，妳可以選擇是否將它與妳自己的數據一起搜索。當然，還有其它可能性。有很多情況，妳知道應當搜索哪一組文件，這樣能夠縮小搜索範圍，因此而提高搜索效率。妳可以在高端搜索中使用目錄過濾功能來實現幾乎相同的效果，但是多個索引的效率好得多，所以值得一搞。

妳實際查看（使用內部預覽窗口或外部工具）過的文檔會被記錄到文檔歷史中。

妳可以使用Tools/Doc History 菜單條目來顯示歷史列表。

妳可以使用File 菜單中的Erase document history 條目來刪除文檔歷史。

結果列表中的文檔通常是按照相關性排序的。

還可以在結果列表中隱藏重復條目（與顯示的那個文檔有著完全相同的內容的文檔）。相同性的檢測是基于對整個文檔的MD5 散列進行的，而不僅僅基于文字內容（所以，對于一個文本文檔，當妳給它加上一張圖片時，它便與原來的文檔不同咯）。對重復條目的隱藏是由Query configuration 對話框中的一個條目來控制的，默認是關閉的。

從結果或預覽文字中拾取新的詞語 。在結果列表或一個預覽窗口中雙擊一個詞語，會將它加入簡單搜索輸入框。

詞組和近似條件搜索 。可將詞組放在雙引號裏。例如： "user manual"只會搜索那種user 後面緊接著manual 的情況。妳可以在高端搜索對話框中使用 This phrase 字段來達到同樣的效果。詞組可在所有的簡單或高端搜索輸入框裏與簡單詞語一起輸入（除咯This exact phrase 之外）。

自動組成詞組 。這個選項可在配置對話框中設置。如果被啟用，則在搜索 Any terms 時，會自動構建詞組并且添加到簡單搜索中。這不會完全改變搜索結果，但是會為那些含有此詞組的結果賦予更高的 相關性。也就是說：搜索 virtual reality 時，所有包含 virtual 或 reality 或兩者都出現的文檔都會被命中，但是那些包含 virtual reality 的文檔會排在更前面。

妳可以使用Preferences 菜單中的Query configuration 條目來對搜索界面的某些方面進行自定義。

對話框中有好幾個標簽頁，分別處理的是：界面自身、用來進行搜索和返回結果的參數、要搜索哪些索引。

一旦輸入，那些索引就是出現在External indexes 列表中，然後妳可以在任何時候選中或不選中某些條目，以選擇妳要使用哪些索引。

妳的主数据库（当前配置文件对其进行索引的那个数据库）是一直活跃的。如果妳不希望這樣，則妳可以設置一個配置文件，使之對一個空的目錄進行索引。另外，對于一個替代的索引器來說，它需要實現一種從過期的數據裏刪除索引內容的機制。

可在Query configuration 的User Interface 標簽頁中設置結果列表段落格式，以便對結果列表中的每個結果的顯示情況進行自定義。

這是一個Qt HTML 字符串，其中帶有%的部分會按照下面的規則進行替換：

• •. %A. 摘要

• •. %D. 日期

• •. %I. 圖標文件名

• •. %K. 關鍵字（如果有的話）

• •. %L. Preview和Edit鏈接

• •. %M. 多媒體類型

• •. %N. 結果編號

• •. %R. 相關度

• •. %S. 文件尺寸

• •. %T. 標題

• •. %U. 路徑

Preview 和Edit 鏈接的格式是<a href="P%N">和<a href="E%N">，其中 docnum (%N) 會被替換成當前文檔在結果列表中的編號。

有多種方法可在不啟動圖形界面的情況下以文本流的方式獲取搜索結果：

• •.帶-t參數運行recoll 程序。

• •.運行recollq 程序。

要執行的查詢語句是以命令行參數的方式傳遞的。

默認情況下不會編譯recollq。妳可使用query 目錄中的Makefile 來編譯它。這是一個非常簡單的程序，如果妳會寫c++程序的話，那麽妳可以利用它來將輸出格式變成妳想要的。

recollq有一個手冊頁（默認情況下不會安裝，請到doc/man目錄中去找）。用法：

recollq [-o|-a|-f] <查詢字符串>

運行一個recoll 查詢，并顯示結果。

默認： 會將參數解釋成一個查詢語言字符串

-o 模仿圖形界面中簡單查詢的ANY TERM 模式

-a 模仿圖形界面中簡單查詢的ALL TERMS模式

-f 模仿圖形界面中簡單查詢的filename模式

通用選項：

-c <配置目錄> : 指定 一個配置目錄，將會替代 $RECOLL_CONFDIR

-d 同時輸出文件內容

-n <個數> 限制結果的個數(0->無限制，默認為2000)

-b : 基本內容。僅輸出路徑，不輸出文件類型及標題

-m : 輸出文檔的整個meta[]數組

-S 字段 : 按指定字段排序

-D : 反向排序

示例：

recollq 'ilur -nautique mime:text/html'

Recoll query: ((((ilur:(wqf=11) OR ilurs) AND_NOT (nautique:(wqf=11)

OR nautiques OR nautiqu OR nautiquement)) FILTER Ttext/html))

4 results

text/html [file:///Users/uncrypted-dockes/projets/bateaux/ilur/comptes.html] [comptes.html] 18593 bytes

text/html [file:///Users/uncrypted-dockes/projets/nautique/webnautique/articles/ilur1/index.html] [Constructio...

text/html [file:///Users/uncrypted-dockes/projets/pagepers/index.html] [psxtcl/writemime/recoll]...

text/html [file:///Users/uncrypted-dockes/projets/bateaux/ilur/factEtCie/recu-chasse-maree....

在圖形界面中，當把搜索模式設置成Query Language 時，簡單查詢輸入框中的查詢語言處理器會被激活。概括來說，它與圖形界面中的高端搜索界面擁有相同的功能。

當某些字符出現在詞組的雙引號後面時，會被識別成搜索修飾詞，其形式是 "某個詞語"修飾詞 。當然，實際的“詞組”可以是一個單個的詞語。支持的修飾詞：

• •. l，關閉詞根擴展（主要對p 有意義，因為在默認情況下詞組的詞根擴展是關閉的）。

• •. o，在詞組和近似搜索中指定“空缺”：指定的詞語之間可以出現的額外詞語的個數。如果o後面跟的是一個整數，則它就是空缺值，否則默認值是10。

• •. p，將默認的詞組搜索變成近似搜索（無序）。示例："order any in"p

• •.可為查詢元素指定權重，在修飾詞的開始處指定一個十進制數就可以咯。示例："Important"2.5。

搜索字符串中的某些特殊字符會被Recoll 解釋成特定的意思，用來擴展或限制搜索條件。通配符會以可控的方式來擴展詞語。定位字符可用來限制搜索條件，僅當匹配的詞語是在文檔的開關或開關附近或在某個字段中時才繼續搜索。

在Recoll 搜索輸入框中輸入的所有詞語都會在最終執行請求之前按照通配符擴展。

通配符字符包括：

• •. * 匹配0 個或更多字符。

• •. ? 匹配單個字符。

• •. [] 可定義要匹配的字符的集合（例如：[ abc ] 匹配單個的字符，可能是'a'或'b'或'c'，[ 0-9 ]匹配任意數字）。

在使用通配符之前，先要了解一些東西。

有兩個字符用來指定搜索過程中應當在文字的開頭還是末尾匹配。在一個詞語或詞組開頭的^表示要在開頭處進行搜索，在末尾的$表示要在末尾處進行搜索。

由于這個功能是以詞組搜索的形式來實現的，所以可以為匹配情況指定一個最大距離，這一點可通過高端搜索面板的控件來設置，或者通過查詢語言來設置。比如，下面這一個:

"^someterm"o10

會強制在距文字開頭的10 個詞語中搜索someterm。這一點可與字段搜索組合，例如somefield:"^someterm"o10 或somefield:someterm$。

這個特性還可以與真正的詞組搜索組合起來，但是，在那種情況下，距離會對詞組和定位符同時起作用，所以勒，在文字開頭處出現的bla bla my unexpected term 會被"^my term"o5匹配。

Recoll 使用外部程序來對某些類型的文件進行索引。對于妳想要索引的文件類型，需要安裝對應的程序（這些都是運行時的依賴項。在編譯Recoll 時不需要這些東西。除非要對相應的文件類型進行索引，否則在運行時也不需要這些東西）。

在進行一遍索引之後，可通過recoll File 菜單來查看還缺少哪些命令。這個列表儲存在配置文件目錄的missing 文件裏。

以下是需要外部命令的文件類型的列表。很多過濾器都需要iconv 命令，這個東西不一定會被列成依賴項。

C++編譯器。

在源代碼樹的頂級目錄中執行make install 或recollinstall 前綴 。這樣將會把命令復制到 前綴 /bin，將示例配置文件、腳本和其它共享數據復制到 前綴 /share/recoll。

如果傳遞給recollinstall 的安裝前綴與系統默認值和執行configure 時指定的值（configure --prefix /某個/路徑）都不同，那麽，妳需要設置RECOLL_DATADIR 環境變量，以指明要將共享數據儲存在哪裏（例如，針對(ba)sh: export RECOLL_DATADIR=/some/path/share/recoll）。

Recoll 的索引選項是在一個配置文件目錄中的文本配置文件裏設置的。可以有多個這樣的配置文件目錄，每個都對應著一個索引。

配置文件可手動編輯，也可通過Indexing configuration 對話框（Preferences菜單）來編輯。圖形界面的工具會盡可能地保留妳的格式和注釋，所以妳可以同時使用兩種方式來編輯。

配置參數的最准確文檔位于默認文件的注釋中，所以在這裏我們只給出一個概述。

對于這個索引，都有兩組配置文件。系統級的配置文件是在一個像這/usr/[local/]share/recoll/examples樣的目錄中，它們定義默認值，由所有索引共享。對于每個索引，都有一組同樣的文件，它們會包含那些自定義的參數。

配置文件的默認位置是妳的家目錄中的.recoll目錄。大部分人都會使用這個目錄。

這個位置可以修改，或者還可以添加其它位置，只需使用RECOLL_CONFDIR 環境變量，或者對recoll 和recollindex 使用-c參數。

如果在recoll 或recollindex 啟動時.recoll目錄不存在，則它會被自動創建，其中會有一組空白的配置文件。recoll 會在開始索引之前給妳一個機會來編輯配置文件。recollindex 會立即開始索引。為咯避免錯誤，只會在針對默認位置時才自動創建目錄，而當妳使用-c或RECOLL_CONFDIR 時不會創建目錄（那種情況下，妳需要自己創建對應的目錄）。

所有的配置文件的格式都是一樣的。例如，主配置文件大致是這樣的：

# 要索引的目錄列表，用空格隔開。

topdirs = ~/docs /usr/share/doc

[~/某個含有utf8編碼的文本文件的目錄]

defaultcharset = utf-8

有三種文本行：

• •.注釋（以#開頭）或空白行。

• •.參數修改（名字 = 值）。

• •.小節定義（[某個目錄名]）。

取決于配置文件的類型，小節定義會有兩種不同的作用：分隔不同組別的參數，或者針對某個子目錄樹重新定義某些參數。直到下個小節定義出現，或者是達到文件末尾，它們都會保持有效。某些索引參數會從當前目錄位置開始向上查找。并不是所有的參數都能被重定義，這一點在下一小節中有說明。

當波浪號（~）出現在文件路徑的開頭時，會被解釋成用戶的家目錄，這一點與終端的行為一致。

在列表中使用空格來分隔。列表中本身包含有空格的元素可使用雙引號引用起來。

recoll.conf 是主配置文件。它定義的是：要索引什麽（頂級目錄及要略過的文件），以及對于未指明字符集的文檔類型要使用的默認字符集。

默認的配置情況會對妳的家目錄進行索引。

以下參數中的大部分都可以在recoll 界面的Index Configuration 菜單中修改。某些參數只能通過編輯配置文件來修改。

指定要索引的目錄或文件（針對目錄是遞歸的）。可以使用符號鏈接。參考followLinks 參數，以了解對于頂級目錄以下的符號鏈接進行跟蹤的設置（默認情況不跟蹤）。

skippedNames

要略過的文件或目錄的名字的模式列表，用空格分隔。默認文件中定義的列表是：

skippedNames = #* bin CVS Cache cache* caughtspam tmp .thumbnails .svn \

*~ .beagle .git .hg .bzr loop.ps .xsession-errors \

.recoll* xapiandb recollrc recoll.conf

這個列表可針對索引區域中的任意子目錄進行重定義。

頂級目錄不會受這個列表的影響（意思是說，topdirs 中的目錄即使與這個列表中的元素匹配，仍然會被索引）。

默認配置文件中的列表不會排除隱藏目錄（以點開頭的目錄名），這就意味著它可能會索引一些妳不感興趣的東西。另一方面，某些郵件客戶端，例如thunderbird，通常會將郵件保存在隱藏目錄裏，這又可能是妳想要索引的東西。一種解決方案就是將.*放到skippedNames 中，再將~/.thunderbird或~/.evolution放到topdirs 中。

不僅僅可以根據文件名來確定哪些文件不被索引。參考mimemap 中的recoll_noindex 變量，以了解另外一種排除文件的方式。

skippedPaths 和daemSkippedPaths

應當排除的文件或目錄的路徑的模式，以空格隔開。示例配置文件裏沒有默認值，但是程序的代碼會讀取那裏寫的內容。

skippedPaths 被用于批量和實時索引模式。daemSkippedPaths 可用來指定那些在初始化過程中進行索引，而不對其進行監視的文件。

示例，在某個目錄中略過文本文件：

skippedPaths = ~/某個目錄/∗.txt

在索引程序遍歷文件樹時，是否要跟蹤符號鏈接。默認值是無視符號鏈接，以避免對鏈接的目標文件進行重復索引。當這個選項被設為真時，也不會去避免重復。可在小節中為topdirs 裏的每個成員單獨設置這個選項。不可在topdirs 級別以下對其進行改變。

indexedmimetypes

Recoll 一般情況下會對它知道該如何解析的任意文件進行索引。這個列表允許妳將要索引的文件類型限制指定的範圍中。如果這個變量沒有定義，或者這個列表是空的（默認情況），則所有被支持的文件類型都會被處理。

compressedfilemaxkbs

壓縮文件（.gz或.bz2）的尺寸限制。這些文件需要先解壓到一個臨時目錄中，以便進行檢測，如果存在‘不感興趣’的巨型壓縮文件，則這是非常浪費的。負數則表示無限制，0則表示不要處理任何壓縮文件。默認值是-1。

textfilemaxmbs

文本文件的最大尺寸。巨型文本文件通常是枯燥的記錄文件。設置成-1以便禁用（默認20MB）。

textfilepagekbs

如果設置成-1以外的值，則文本文件會被索引成多個文檔，每個都是指定的尺寸。如果妳想對巨型文本文件進行索引的話，這個選項可能會有用，它既能減少內存占用，也能加快預覽窗口的載入。合理的值是幾兆（默認: 1MB）。

indexallfilenames

Recoll 將文件名的索引保存在數據庫中的一個特殊區域，以支持通過通配符進行的文件名搜索。這個參數確定的是：只對那些支持全文索引的文件類型進行文件名索引，還是對所有文件都進行文件名索引而無視文件類型。

usesystemfilecommand

控制的是，我們是否將file -i 系統命令用作確定一個文件的文件類型的最終步驟（主要步驟是使用mimemap 文件中定義的後綴關聯）。這對于那些沒有後綴名的文件很有用，但是會導致對很多假的“文本”文件進行索引。

dbdir

Xapian 數據目錄的名字。當索引被初始化時，它會在必要的時候被創建。如果不是絕對路徑，則會相對于配置文件目錄進行解釋。這個值可包含空格，但開頭和末尾的空格會被去掉。此處不可使用引號。

maxfsoccuppc

在停止進行索引之前允許出現的最大磁盤空間占用率。這個值是一個百分比，對應于df 輸出的“已用”列中的值。默認值是0，表示不檢查。

mboxcachedir

用來儲存郵箱文件夾消息偏移緩存文件的目錄。通常是$RECOLL_CONFDIR/mboxcache，但是可以在多個配置之間共享同一個目錄。

mboxcacheminmbs

對其偏移進行緩存的郵箱文件夾文件的最小尺寸。針對小文件進行偏移量緩存是沒有意義的。默認是5 MB。

idxflushmb

導致我們將內存中的數據刷新到硬盤上的索引裏去的閾值（新文本數據的兆數）。設置這個值可用來控制內存使用率。如果其值為0，則表示不進行顯式的刷新，而讓Xapian 使用自身的默認配置，也就是每隔10000（或XAPIAN_FLUSH_THRESHOLD） 個文件刷新一次，這就對內存占用率的控制沒有多大作用，因為內存占用率將會取決于文檔的平均尺寸。默認值是10。

loglevel,daemloglevel

recoll 和recollindex 的輸出詳細級別。值為4 時，會輸出大量調試/提示消息。2只會輸出報錯消息。帶daem的參數只影響到索引監視守護進程。

logfilename, daemlogfilename

輸出的消息應當保存到哪裏。'stderr'可用作一個特殊值，而且也是默認值。帶daem的參數只影響到索引監視守護進程。

mondelaypatterns

這個參數允許指定一些包含通配符的路徑模式（使用fnmatch(3)處理，不帶標志），以匹配那些變動得太快的文件，在重新對那些文件進行索引之前要延遲一段時間。這個列表是用空格分隔的，每個條目由一個模式和一個秒數組成，中間用冒號隔開。如果某個路徑條目包含空格，那麽可以使用雙引號。示例：

mondelaypatterns = *.log:20 "這 個 有 空格*:10"

monixinterval

處理索引隊列時的最小時間間隔（秒）。實時監視進程不會在每個事件到來時便立即處理，而是會等待這麽長時間，讓隊列產生累積，以減小開銷，并且將針對同一個文件的多個事件聚合起來。默認為30 秒。

monauxinterval

實時監視器在必要的情況下重新生成輔助數據庫（拼寫、詞根）的時間間隔（秒）。默認是一小時。

filtermaxseconds

過濾器的最大執行時間，超時之後會被取消。某些postscript 程序會陷入循環之中...

filtersdir

在這個目錄裏放的是一些外部過濾器腳本，它們是用來對某些文件類型進行索引的。它的值不應當修改，除非妳想修改其中的默認腳本。可針對任意的子目錄進行重定義。

iconsdir

用來儲存recoll 結果列表圖標的目錄名。如果妳想使用不同的圖片，則修改這個。

idxabsmlen

Recoll 在數據庫中為每個被索引的文件儲存一個摘要。這段文字可來自文檔中實際的‘摘要’小節，也可能只是文檔的開頭部分。它被儲存在索引中，這樣在顯示結果列表時便不用對原文件進行解析。idxabsmlen 參數定義的是儲存的摘要的尺寸。默認值是250 字節。搜索界面提供咯一個選項，讓妳選擇是要顯示這個儲存的文本還是顯示用搜索詞語周圍的文本合成的摘要。如果妳只准備看合成的摘要的話，則可以減少這個值，以節約一些硬盤空間。

noaspell

如果設置咯這個參數，則不會生成aspell 字典。在以下情況有用：妳不需要這個功能；或者這個功能無效，例如aspell 在生成字典的時候崩潰。

mimemap 指定的是文件擴展名與文件類型之間的映射。

對于沒有擴展名或者其擴展名不常見的文件名，會執行系統的file -i 命令來確定其文件類型（可在主配置文件中關閉這個功能）。

映射可按照單個的子目錄樹來指定，這在某些情況下是很有用的。比如：gaim 記錄文件的擴展名是.txt，但是應當特別對待，而這些文件通常是位于同一個地方。

mimemap 也有一個recoll_noindex 變量，它是一個後綴名列表。匹配這個列表的文件會被跳過（避免不必要的解壓縮或者執行 file）。這個變量與主配置文件中的skippedNames 有一定的重復，只有幾點不同：它不會對目錄起作用，它不會寫成依賴于文件系統位置的（它只是一個配置集合級別的參數），文件名仍然會被索引（skippedNames 中那些模式對應的文件名不會被索引）。recoll_noindex 主要被用來對付那些對于某個指定Recoll 版本不可索引的文件。這個參數是為咯避免錯誤地使用那些更加面向用戶的、本地自定義的skippedName。