&Mike.McBride; &Mike.McBride.mail;
&Jost.Schenck; &Jost.Schenck.mail;
Marcin Bokszczanin Polskie tłumaczenie
2002-10-17
3.1
KDE KControl Indeks pomocy Indeks

## Indeks pomocy

W chwili pisania tej dokumentacji, dla większości instalacji &kde; cała funkcjonalność wyszukiwania w &khelpcenter-miejscownik; jest wyłączona i zmiany dokonane w tym module nie mają żadnego efektu. Mamy nadzieję poprawić to w kolejnym wydaniu.

&kde; jest dostarczane z dużą ilością dokumentacji do programów i składników środowiska. Choć możliwe jest przeglądanie dokumentacji aż do znalezienia odpowiedniego fragmentu, może być to czasochłonne. Aby Ci to ułatwić, &kde; oferuje wyszukiwarkę tekstową zwaną ht://dig, podobną w działaniu do wyszukiwarek internetowych, a tak prawdę powiedziawszy to niektóre z używanych przez Ciebie wyszukiwarek może z niej korzystać. Po prostu kliknij na zakładkę Szukaj w &khelpcenter;, wpisz poszukiwane słowo, wciśnij przycisk Szukaj i przejrzyj wyniki.

Jednak, by móc skorzystać z tej funkcji, musisz mieć zainstalowany program ht://dig, a &kde; musi być skonfigurowane do korzystania z niego. Ten moduł panelu sterowania stara się Ci pomóc w tym drugim. Jeśli nie masz zainstalowanego ht://dig, a nie jest on dostarczany z Twoim systemem operacyjnym, to musisz go zdobyć na własną rękę. Zajrzyj na stronę domową ht://dig w celu uzyskania informacji na ten temat.

Gdy rozpoczniesz, będziesz w trybie podglądu. By zmienić opcje, kliknij na Tryb administratora. Jeśli jesteś administratorem (użytkownikiem root), to zostanie od razu otwarte okienko zmiany ustawień, jeśli nie, to &kde; najpierw poprosi Cię o hasło administratora.

### Użycie

Istnieją dwie ważne rzeczy, które trzeba przekazać &kde; by móc skorzystać z wyszukiwarki pełnotekstowej:

- gdzie można znaleźć program ht://dig, którego &kde; używa do wyszukiwania pełnotekstowego

- gdzie szukać

#### Program ht://dig

ht://dig dysponuje trzema programami potrzebnymi &kde;: `htdig`, `htsearch` i `htmerge`. Dla każdego programu musisz podać pełną ścieżkę, włącznie z nazwą programu, na przykład: `/usr/bin/htdig`.

Dokładna lokalizacja tych programów zależy od systemu operacyjnego lub dystrybucji. Istnieje jednak kilka prawdopodobnych miejsc:

- `htdig` i `htmerge` często znajdują się w `/usr/bin/` lub w czymś w rodzaju `/usr/local/www/htdig/bin/`.

- Polecenie `htsearch` często znajduje się w podkatalogu zwanym `cgi-bin`, na przykład `/usr/local/httpd/cgi-bin/`.

Żeby sprawdzić, gdzie jest na przykład `htdig`,możesz zawsze wpisać w konsoli `whereis htdig`. `whereis` poszuka programu w standardowych katalogach z plikami wykonywalnymi. Jednak katalogi takie jak `cgi-bin` często nie są w standardowych ścieżkach plików wykonywalnych.

#### Zakres i ścieżki wyszukiwania

W tej sekcji możesz wybrać, które pliki pomocy zostaną zindeksowane, tzn. które będą dostępne wyszukiwarce.

W ramce Zakres możesz wybrać kilka typowych zasobów do zindeksowania, tzn. pliki pomocy &kde;, informacje dostępne poprzez polecenia `man` i `info`. Uwaga: niektóre z nich mogą być wyłączone, co oznacza, że ich obsługi jeszcze nie dodano.

Być może istnieją pliki, które chcesz udostępnić poprzez wyszukiwarkę pełnotekstową &khelpcenter;. Na przykład możesz mieć dokumentację HTML zainstalowaną w `/home/jdoe/docs/selfhtml`. Dodając tę ścieżkę do listy dodatkowych ścieżek wyszukiwania sprawisz, że również ta dokumentacja będzie dostępna dla wyszukiwarki &khelpcenter;. Po prostu kliknij na przycisk Dodaj i w oknie dialogowym wskaż ścieżkę dodatkowego katalogu do wyszukiwania. Wybierz `/home/jdoe/docs/selfhtml` i kliknij OK. By usunąć dodatkową ścieżkę, wybierz ją i wciśnij przycisk Usuń.

Zmiany zakresu i dodatkowych ścieżek wyszukiwania nie zostaną wprowadzone, póki nie wciśniesz przycisku Wygeneruj indeks.