&Mike.McBride; &Mike.McBride.mail;
&Jost.Schenck; &Jost.Schenck.mail;
Екатерина Пыжова

    haleth@yandex.ru

Перевод на русский
2002-10-17
3.1
KDE Центр настройки Индекс справки Индекс

## Индекс справки

На момент написания этого руководства, в большинстве установок &kde; механизм поиска в &khelpcenter; был полностью недоступен, и настройки, сделанные в модуле &kcontrol; не играли никакой роли. Мы надеемся, что в будущих версиях это изменится.

В &kde; входит большое количество документации для приложений и компонентов. Хотя вы можете просто просматривать руководства в поисках нужной информации, это займёт много времени. Чтобы облегчить этот процесс, &kde; предлагает полнотекстовый поиск с помощью программы ht://dig. Принцип поиска схож с аналогичными механизмами в Интернете, фактически некоторые поисковые машины могут использовать именно его. Перейдите во вкладку Поиск в &khelpcenter;, введите нужное слово, нажмите Enter и получите результаты!

Однако, чтобы использовать эту возможность, необходимо установить ht://dig и &kde; должен быть настроен для этого. Настройку ht://dig и позволяет сделать этот модуль. Если вы не установили ht://dig и он не входит в состав вашего дистрибутива, вам придётся получить его самостоятельно. Загляните на домашнюю страницу ht://dig за подробной информацией по скачиванию и установке.

При обычном запуске, вы находитесь в режиме просмотра. Чтобы изменить настройки, нажмите на кнопку Режим администратора. Если вы вошли в систему как root, вы попадёте непосредственно в окно настройки. Иначе &kde; попросит пароль суперпользователя.

### Использование

&kde; необходимо знать ответы на два важных вопроса, прежде чем запускать механизм полнотекстового поиска:

- где найти программы ht://dig для полнотекстового поиска;

- где искать.

#### Программы ht://dig

&kde; требует три программы, входящие в ht://dig: `htdig`, `htsearch` и `htmerge`. Для каждой программы необходимо указать полный путь, включая её название, например `/usr/bin/htdig`.

Где в точности установлены эти программы, зависит от вашей операционной системы и дистрибутива. Хотя есть несколько наиболее вероятных вариантов:

- `htdig` и `htmerge` обычно находятся в `/usr/bin/` или в `/usr/local/www/htdig/bin/`.

- `htsearch` можно найти в каталоге `cgi-bin`, то есть, например в `/usr/local/httpd/cgi-bin/`.

Чтобы узнать, где установлена, например, `htdig`, можно набрать в консоли `whereis htdig`. `whereis` ищет указанную команду в каталогах стандартных путей. Хотя каталоги вида `cgi-bin` обычно не входят в стандартные пути поиска.

#### Области и пути поиска

В этом разделе можно выбрать, какие источники помощи должны индексироваться, &ie; должны быть доступными для механизма поиска.

В разделе Области можно выбрать некоторые типичные источники для индексирования, &ie; файлы помощи &kde; и информацию, предоставляемую командами `man` и `info`. Заметьте, что если некоторые из них пока не доступны, значит, поддержка для них ещё не добавлена.

Возможно, у вас есть дополнительные файлы, для которых вы хотите использовать механизм полнотекстового поиска &khelpcenter;. Например, у вас есть HTML-документация, установленная в `/home/jdoe/docs/selfhtml`. Добавив этот путь в список дополнительных путей поиска, вы сделаете эту документацию доступной для полнотекстового поиска. Нажмите кнопку Добавить и в появившемся окне выберите дополнительный каталог для поиска (`/home/jdoe/docs/selfhtml`) и нажмите OK. Чтобы удалить дополнительный путь поиска, выберите его и нажмите Удалить.

Ваши изменения области и дополнительных путей поиска не принесут результата до тех пор, пока вы не нажмёте кнопку Создать индекс поиска.