Differences

This shows you the differences between two versions of the page.

--- preferences:search [2017/11/12 19:53] – external edit 127.0.0.1
+++ preferences:search [2017/12/04 08:17] – bwiernik
@@ Line 1: / Line 1: @@
-<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">We’re
+====== Search ======
-in the process of updating the documentation for
-<a href="https://www.zotero.org/blog/zotero-5-0">Zotero 5.0</a>. Some documentation
-may be outdated in the meantime. Thanks for your understanding.</p></html>
 ~~NOTOC~~
-====== Search ======
+For information on how to use Zotero's search features, see [[:searching|Searching]]. This page describes the settings in the Search pane of the Zotero preferences.
+The Sync preferences pane is used to configure and manage Zotero's [[:searching#PDF_Fulltext_Indexing|PDF Full-text Search]] feature.
+{{:preferences_search.png?nolink&w=600|}}
+==== Full-text Cache ====
+Zotero creates an index to allow the full text contents of PDF and plain-text attachments in your library to be searched with Quick Search ("Everything" option) and Advanced Search (via "Attachment Content").
-{{ :preferences:preferences-search-z3.0.png?direct&400|}}
+**Note:** At this time, only PDF full text content (and plain text files) can be indexed by Zotero. Other document types (e.g., .docx, .odt, .epub) cannot be indexed by Zotero.
-=====Full-Text Cache=====
+This section includes these options to manage your full-text index:
-Zotero creates an index of the contents of your library, including the full text of attachments, in order to facilitate searches. The Search preference pane includes buttons to clear and rebuild the index. It is also possible to set the upper limit on indexed characters per document. The default is 500,000.
+ * **Rebuild Index…:** Re-create the full-text index for all items from scratch. This option may be helpful if you use OCR text recognition on a large number of attachment files or you find that searching using "Everything" or "Attachment Content" does not return the correct results.
+   * Before using this option, verify that the item has searchable text and that the text is properly stored in the PDF (e.g., try to copy text out of the document and ensure that it is high quality).
+   * You can re-index individual PDF files in your library by right-clicking on the PDF attachment item in your library and choosing "Reindex Item".
+   * If you are still having issues after re-indexing an item, please ask a question on the [[/forum|Zotero forums]].
+ * **Clear Index…:** Delete the full-text index. Use this option if you intend to disable full-text indexing and wish to reduce the size of your Zotero database (note that the full-text index typically occupies a relatively small amount of storage space on your computer).
+ * **Maximum characters to index per file:** The number of characters to index in PDF and plain-text attachments (default: 500,000, approximately 100,000 words or 180–200 pages of content). Set this value to 0 to disable full-text indexing.
-=====PDF Indexing=====
+==== PDF Indexing ====
-Zotero uses two plugins, pdftotext and pdfinfo, to index the contents of PDF files. The “Check for Update” button will ensure that you are using the latest versions. By default, Zotero will index up to 100 pages of any text-based PDF file, but this can be increased or decreased in this section.
+Zotero uses two open-source plugins, ''pdftotext'' and ''pdfinfo'', to index the contents of PDF files. These tools are installed with Zotero. If for some reason they are not installed, click the "Install PDF Tools" button to install them. If installation fails, follow these [[:pdf_fulltext_indexing|manual installation instructions]]. If the tools are already installed, click "Check for Update".
-See [[/support/pdf_fulltext_indexing|PDF Indexing]] for more information.
+You can also set how pages of a PDF file Zotero will index (default: 100 pages).
-=====Index Statistics=====
+==== Index Statistics ====
-The Index Statistics section provides, as you might expect, details about the size of your index. Included are the total number of indexed, partially indexed and unindexed files, as well as a count of all the words in these files.
+This section provides details about the size of the full-text index in your Zotero database. Reported statistics are:
+  * **Indexed:** The total number of files that are completely indexed.
+  * **Partial:** The number of files that are partially indexed.
+  * **Unindexed:** The number of files that are not yet indexed.
+  * **Words:** The total number of words included in your Zotero library's full-text index.
 {{tag>pref}}