docs.kde.org

Mike McBride

Jost Schenck

Перевод на русский: Екатерина Пыжова
Издание 3.1 (2002-10-17)

Содержание

Индекс справки
Использование

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

Замечание

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

KDE comes with a lot of documentation for applications and components. While it is possible to just browse the manuals until you find that piece of information you're looking for, this may be a very time-consuming task. To make this easier for you, KDE offers fulltext search using a program called ht://dig. It works quite similar to search engines on the web, in fact some search engines you know might even use it. Just click on the Search tab in the KHelpCenter, enter the word you are looking for, click Search and enjoy!

However, to make use of this feature, ht://dig has to be installed on your system and KDE has to be configured to make use of it. This control module tries to help you doing the latter. If you haven't installed ht://dig and it wasn't shipped with your operating system you have to get ht://dig yourself. Have a look at the ht://dig homepage on how to download and install it.

При обычном запуске, вы находитесь в режиме просмотра. Чтобы изменить настройки, нажмите на кнопку Режим администратора. Если вы вошли в систему как 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 обычно не входят в стандартные пути поиска.

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

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

В разделе Области можно выбрать некоторые типичные источники для индексирования, i.e. файлы помощи KDE и информацию, предоставляемую командами man и info. Заметьте, что если некоторые из них пока не доступны, значит, поддержка для них еще не добавлена.

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

Важно

Your changes to the scope and additional search paths will not take effect if you don't click on the Generate index button.

 


docs.kde.org