# Вступ

DocFetcher є відкрито джерельним настільним застосунком пошуку: Він дозволяє вам шукати вміст файлів на вашому комп'ютері. - Ви можете думати про нього, як про Google для ваших локальних файлів.

Пошук на основі індексу: Оскільки шукання у документах безпосередньо може бути непрактично тривалим для великої кількості документів DocFetcher вимагає, щоб ви створили індекси для тек, в яких ви хочете шукати. Ці індекси дозволяють DocFetcher'у швидко шукати файли за ключовими словами, подібно до того, як ви використовуєте покажчик у кінці книги. Створення індексу може займати деякий час, залежно від кількості та розміру індексованих файлів. Проте, це необхідно зробити лише один раз для кожної теки; опісля ви зможете шукати в індексованих теках стільки разів, скільки захочете.

Створення індексу: Для створення індексу клацніть ПКМ на зоні `Область пошуку` зліва та виберіть `Створити індекс з > Тека`. Тепер виберіть теку для індексування. Для початківців, це має бути маленька тека з не надто багатьма файлами в ній, скажімо, 50? Після вибору папки з'явиться спливне вікно конфігурації. Стандартної конфігурації має бути достатньо, а тому просто клацніть на кнопці `Пуск` та зачекайте, поки DocFetcher не завершить індексування документів. (Альтернативним способом створення індексу є вставлення каталогу з буфера обміну даними у зону `Область пошуку`. Однак, це працює тільки для звичайних каталогів, а не для файлів PST.)

Шукання: Уведіть одне чи кілька слів для пошуку у текстове поле над панеллю результатів (таблиця з іменованими стовпцями) та натисніть клавішу `Enter`. Результати пошуку будуть показані у цій панелі результатів, відсортовані у спадному порядку.

Якщо ви читаєте цей підручник всередині DocFetcher, дотримання інструкцій у наступному абзаці може змусити підручник зникнути. Для відновлення його показу клацніть на кнопці `'?'` у верхньому правому кутку. Ви можете також відкрити цей підручник у вашому стандартному веб браузері, клацнувши на кнопці `Відкрити у зовнішньому браузері` безпосередньо над цією панеллю.

Панель результатів та панель передогляду: Нижче панелі результатів (або справа від неї, залежно від поточно розстави) ви можете знайти панель передогляду. Якщо ви виберете файл на панелі результатів, то панель передогляду покаже лише текстовий передогляд вмісту цього файлу. Можливості мічення:

- Підсвічування: Стандартно, шукані слова, які ви уводите, будуть підсвічуватися, і ви зможете переходити з поточного трапляння до попереднього або наступного, використовуючи кнопки уверх та вниз.
- Вбудований веб браузер: У випадку файлів HTML, ви можете перемикатися між оглядом лише тексту та прости вбудованим веб браузером. (Примітка: Останнє є не доступним на деяких варіантах Linux.)

Одне скорочення ви можете виявити корисним: Натискайте `Ctrl+F` або `Alt+F` для переносу фокусу назад на поле пошуку. Для відкриття файлу у зовнішній програмі, двічі клацніть на панелі результатів.

Сортування: Ви можете змінювати сортування результатів, клацнувши на будь-який із заголовків стовпців панелі результатів. Наприклад, для сортування результатів за іменем файлу, клацніть на заголовок `Ім'я файлу`. Клацання на одному і тому ж заголовку двічі буде сортувати за відповідним критерієм у зворотному порядку. Ви можете також змінювати порядок стовпців шляхом перетягування: наприклад, якщо ви хочете, щоб `Ім'я файлу` було першим стовпцем, то просто потягніть за заголовок цього стовпця вліво.

Фільтрування: Зліва в інтерфейсі ви можете бачити кілька керувальників для фільтрування результатів: (1) Ви можете визначати мінімум та/або максимум розміру файла у керувальнику `Мінімум / Максимум розміру файла`. (2) Список `Типи документів` дозволяє вам фільтрувати результати за типом. (3) Позначаючи записи в `Області пошуку`, ви можете фільтрувати результати за розміщенням.

Оновлення індексу: Якщо додаються, вилучаються або модифікуються файли в індексованих теках, то відповідні індекси мають бути оновлені, інакше ваші результати пошуку можуть бути не актуальними. На щастя, оновлення індексу є практично завжди набагато швидшим, ніж створення його з нуля, оскільки обробляються лише зміни. Також, DocFetcher може оновлювати свої індекси автоматично двома способами:

1. Сам DocFetcher: Якщо DocFetcher виконується і увімкнено відстеження теки для модифікованої теки, то DocFetcher виявляє ці зміни та оновлює її індекси автоматично.
2. Демон DocFetcher'а: Якщо DocFetcher не виконується, то зміни записуються маленькою програмою демоном, що працює у фоні; задіяні індекси будуть оновлені наступного разу після запуску DocFetcher. (Примітка: Цей демон поточно не доступний на Mac OS X, на жаль.)

Деякі застереження: Якщо ви використовуєте портативну версію DocFetcher'а та хочете, щоб демон виконувався, ви повинні встановити його вручну, додавши виконуваний його файл у список програм автозапуску для вашої операційної системи. Також, ні DocFetcher, ні демон не може виявляти зміни у мережевих теках.
Тому, у цих випадках, коли індекси не можуть бути оновлені автоматично, ви маєте це зробити самі: в зоні `Область пошуку` виберіть один чи кілька індексів для оновлення, а далі натисніть `Оновлення індексу` у контекстному меню зони `Область пошуку` або натисніть клавішу `F5`.

# Просунуте використання

Синтаксис запиту: За допомогою DocFetcher ви можете робити набагато більше, ніж простий пошук слова. Наприклад, ви можете використати підставні символи для пошуку слів, що однаково починаються, на кшталт, `wiki*`. Для пошуку певної фрази (тобто, послідовності слів у певному порядку), оточіть цю фразу лапками: `"the quick brown fox"`. Але це лише початок. Огляд усіх підтримуваних конструкцій дивіться query syntax section.

Уподобання: У верхній правій частині інтерфейсу користувача, ви знайдете іконку, що зображує два шестірні. Клацніть на ній для відкриття діалогу Уподобань. Додаткові устави для більшості просунутого використання доступні через посилання "Просунуті устави" знизу зліва діалогу Уподобань.

Портативний репозиторій документів: Портативна версія DocFetcher'а дозволяє вам створювати пакунок, що містить сам DocFetcher, ваші документи та асоційовані індекси, і далі переміщувати цей пакунок — навіть з однієї операційної системи на іншу, наприклад, з Windows на Linux і навпаки. Важливо, мати на увазі, коли використовується портативна версія, що індекси повинні створюватися з відносними шляхами. Клацніть тут для деталей щодо портативних репозиторіїв документів. У будь-якому разі, якщо ви ще використовуєте DocFetcher 1.0.3 та старіше, зауважте, що ви не повинні класти ваші документи у теку DocFetcher.

Опції конфігурації індексування: Щодо детального обговорення всіх цих опцій у вікні конфігурації індексування клацніть тут. Ви можете також дістатися цієї сторінки підручника прямо з вікна конфігурації, клацнувши на кнопці `Довідка` у цьому вікні. Мабуть, найбільш цікавими опціями конфігурації є:

- Налаштовувані розширення файлів: Розширення файлів для файлів звичайного тексту та архівів zip є повністю налаштовуваними. Це особливо корисно для індексування файлів з джерельним кодом.
- Виключення файлів: Ви можете виключати певні файли з індексування на основі регулярних виразів.
- Виявлення типу mime: Без виявлення типу mime, DocFetcher буде дивитися на розширення файлу (наприклад, `'.doc'`) для визначення його типу файлу. З виявленням типу mime, DocFetcher буде також заглядати у вміст файлу, щоб бачити, чи може знайти будь-яку кращу інформацію про тип. Це повільніше, ніж просто перевірка за розширенням файлу, але це корисно для файлів, що мають неправильне розширення.
- Парування HTML: Стандартно, DocFetcher обробляє файл HTML та асоційовану з ним теку (наприклад, файл `foo.html` та теку `foo_files`) як єдиний документ. Головне призначення цього змусити все "безладдя" всередині тек HTML зникнути з результатів пошуку.

Регулярні вирази: Обидва, виключення файлів та виявлення типу mime покладаються на так звані регулярні вирази. Це визначені користувачем патерни, за якими DocFetcher шукає відповідності в іменах файлів або шляхах файлів. Наприклад, для виключення усіх файлів, що починаються зі слова "journal", ви можете використати такий регулярний вираз: `journal.*`. Зауважте, що це трохи відрізняється від синтаксису запиту для DocFetcher'а, де ви пропускаєте крапку: `journal*`. Якщо ви хочете дізнатися більше про регулярні вирази, прочитайте цей короткий вступ.

Повідомлення щодо випуску: DocFetcher автоматично не (і не повинен?) перевірятися на оновлення. Якщо ви дуже бажаєте бути повідомлені про нові випуски, ось кілька способів для цього.

# Застереження та поширені глюки

Підвищення ліміту пам'яті: DocFetcher, як усі програми Java, має фіксований ліміт того, скільки пам'яті дозволено йому використовувати, відомий як розмір накопичення Java. Цей ліміт пам'яті повинен бути заданий при запуску, а поточно DocFetcher вибирає стандартне значення 256 MB. Якщо ви намагаєтеся індексувати дуже, дуже велику кількість файлів, та/або якщо деякі з індексованих файлів є реального величезними (що є непоширеним з файлами PDF), то є шанси, що DocFetcher потрапить у такий ліміт пам'яті. Якщо це коли-небудь трапиться, то ви можете схотіти підвищити цей ліміт пам'яті.

Не індексуйте системні теки: На відміну від інших настільних застосунків пошуку, DocFetcher не було розроблено для індексування системних тек, як `C:` або `C:\Windows`. Це не рекомендується з таких причин:

1. Уповільнення: Файли у системних теках тяжіють бути модифікованими дуже часто. Якщо увімкнене відстеження такої теки, то це спричинить, що DocFetcher буде постійно оновлювати її індекси, уповільнюючи ваш комп'ютер.
2. Проблеми пам'яті: DocFetcher потребує зберігати крихітні представлення ваших файлів у пам'яті, Через це і оскільки системні теки зазвичай містять дуже велику кількість файлів, DocFetcher'у, скоріш за все, буде не вистачати пам'яті, якщо ви індексуйте системні теки.
3. Зайві витрати ресурсів, гірші результати пошуку: Окрім, як через ці технічні причини, індексування системних тек здебільшого марно витрачає час на індексування та дисковий простір, і це також буде захаращувати ваші результати пошуку непотрібними системними файлами. Тому, для найкращих результатів при якомога меншому обсязі часу, просто індексуйте лише те, що потрібно.

Підтримка Unicode: DocFetcher має повну підтримку Unicode для всіх форматів документів. У разі з файлами звичайного тексту, DocFetcher має для використання певну евристику, щоб вгадати правильне кодування, оскільки звичайні текстові файли не містять явної інформації про кодування.

Підтримка архівів: DocFetcher поточно підтримує наступні формати архівів: zip та похідні формати, 7z, rar та все сімейство tar.*. Додатково, виконувані архіви zip та 7z підтримуються також, але не виконувані архіви rar. DocFetcher буде обробляти всі архіви, ніби вони були звичайними теками, і він може також обробляти довільну глибину вкладення архівів (наприклад, архів zip містить у собі архів 7z, котрий у собі містить архів rar...).
Разом з цим, слід зазначити, що підтримка для архівів zip та 7z є найкращою з боку надійності і швидкості. З іншого боку, індексування tar.gz, tar.bz2 та подібний форматів тяжіє бути менш ефективним. Через це такі формати не мають внутрішнього "сумарного" вмісту архіву, що змушує DocFetcher розпаковувати увесь архів, а не окремі його елементи. Підсумок: якщо ви маєте вибір, то стискайте ваші файли в архіви zip або 7z для максимальної сумісності з DocFetcher.

Демон DocFetcher'а є нешкідливим: Якщо ви підозрюєте, що демон DocFetcher'а уповільнює ваш комп'ютер або спричиняє збої, ви ймовірно неправі. Власне кажучи, демон є дуже простою програмою з низьким споживанням пам'яті та використанням CPU, і не робить особливо нічого іншого, окрім відстеження тек. Якщо ви все ще не переконані, просто перейменуйте виконуваний файл демона, щоб він не запускався автоматично, або спробуйте портативну версію DocFetcher, де цей демон є деактивованим стандартно.

# Підсторінки підручника

- Синтаксис запиту
- Портативні репозиторії документів
- Опції індексування
- Регулярні вирази
- Повідомлення щодо випуску
- Як підвищити ліміт пам'яті
- Як підвищити ліміт відстеження теки (Linux)
- Уподобання

# Додаткові інформація

Для додаткової інформації дивіться нашу wiki. Якщо ви маєте будь-які питання, відвідайте наш форум. Звіти про вади можна подати на наш bug tracker.