Mike
McBride
Jost
Schenck
Ondřej
Šotek
ondrej.sotek@seznam.cz
Translation
2000-10-21
1.00.00
KDE
KControl
Rejstřík nápovědy
Rejstřík

# Rejstřík nápovědy

## Úvod

Pro rozhraní KDE 2.0 existuje velké množství dokumentace a nápovědy jak pro aplikace, tak i pro jednotlivé komponenty tohoto rozhraní. Je samozřejmě možné procházet veškerou dokumentaci ručně, čas strávený takovýmto vyhledáváním však může být velice dlouhý. Proto KDE nabízí fulltextové vyhledávání prostřednictvím programu ht://dig. Tento program pracuje obdobně jako internetové vyhledávače (některé vyhledávače ho dokonce používají). Postup při hledání je jednoduchý: V Nápovědě klikněte na panel "Hledat", zadejte hledané slovo a klikněte na tlačítko Hledat.

Aby vše takto jednoduše fungovalo, je potřeba mít nainstalován program ht://dig a správně nakonfigurováno prostředí KDE (K tomu slouží právě tento modul). Pokud nemáte ht://dig nainstalován a nebyl dodán společně s Vaším operačním systémem, můžete si ho stáhnout a nainstalovat z internetu. Na domovské stránce ht://dig naleznete kromě samotného programu také všechny potřebné instrukce k jeho nainstalování.

## Použití

KDE potřebuje znát dva základní údaje pro použití fulltextového vyhledávače:

- umístění vyhledávacího systému ht://dig

- umístění dokumentace

### Programy vyhledávacího systému ht://dig

Pro fulltextové vyhledávání jsou potřeba tři programy dodávané v ht://dig: `htdig`, `htsearch` a `htmerge`. Pro každý z těchto programů musíte zadat celou cestu včetně názvu programu, např. `/usr/bin/htdig`.

Přesné umístění těchto programů závisí na operačním systému nebo distribuci. Při jejich hledání je vhodné vyzkoušet následující:

- `htdig` a `htmerge` jsou často umístěny v adresáři `/usr/bin/` nebo někde v `/usr/local/www/htdig/bin/`.

- `htsearch` bývá umístěn v podadresáři `cgi-bin`, např. `/usr/local/httpd/cgi-bin/`.

K vyhledání např. programu `htdig` můžete zadat na příkazové řádce příkaz `whereis htdig`. `whereis` hledá zadaný příkaz v adresářích určených pro umístění aplikací. Adresáře jako `cgi-bin` ale v těchto cestách obvykle nejsou.

### Rozsah a prohledávané cesty

Tato sekce slouží pro zadání zdrojů nápovědy, které budou zahrnuty do databáze vyhledávacího systému.

V části Rozsah můžete vybrat typ zdroje, který má být indexován, tzn. nápovědné soubory KDE a informace získané prostřednictvím příkazů `man` a `info`. Je možné, že některé volby budou nepřístupné, protože zatím nejsou podporovány.

Do fulltextového vyhledávání je možné zahrnout další zdroje. Jako příklad uveďme dokumentaci v HTML umístěnou do adresáře `/home/jdoe/docs/selfhtml`. Přidáním této cesty do seznamu dalších prohledávaných cest zpřístupníte tuto dokumentaci prostřednictvím fulltextového vyhledávání KDE. Stačí kliknout na tlačítko Přidat, které zobrazí dialog pro zadání adresáře určeného k prohledávání. Vyberte `/home/jdoe/docs/selfhtml` a klikněte na OK. Pro vymazaní zadané cesty tuto cestu vyberte a poté klikněte na Smazat.

Změny provedené v rozsahu nebo prohledávaných cestách se projeví až po kliknutí na tlačítko Vytvořit index ...

### Výběr jazyka

Výběr jazyka provede zvolením požadovaného jazyka z kombinovaného seznamu Výběr jazyka.

## Autoři oddílu

Tento oddíl napsal: Jost Schenck jost@schenck.de

Dílčí úpravy: Mike McBride mpmcbride7@yahoo.com