Sistemul de ajutor KDE

Sistemul de ajutor KDE este proiectat să simplifice accesul la sistemul de ajutor obișnuit dintr-un sistem UNIX (man și info), dar și la documentația nativă a KDE (HTML).

Invocarea Sistemului de ajutor KDE

Sistemul de ajutor poate fi pornit utilizînd un URL pentru a afișa un fișier, de exemplu:
	kdehelp file:/usr/local/src/qt/html/index.html

Au fost adăugate URL-uri pentru info și man. De exemplu:

	kdehelp info:"(gcc)G++ and GCC"
	kdehelp man:strcpy

Dacă nu este dat nici un parametru în linia de comandă, este afișat un index (în mod curent are legături la directoarele man și info, dar poate avea și legături la aplicații KDE instalate în viitor). Alternativ, un fișier sau un URL poate fi deschis utilizînd meniuri sau trăgîndu-l din managerul de fișiere KDE, kfm.

Navigarea prin Sistemul de ajutor

Navigarea prin Sistemul de ajutor se face dînd click pe link-urile din documente și folosind comanda Du-te la, disponibilă în meniu și în bara de unelte.

Cuprins

Dacă sistemul de ajutor este pornit fără a preciza o locație în linia de comandă, este afișat Cuprinsul. Prima secțiune face referire la documentațiile specifce aplicațiilor și comenzilor. Documentația aplicațiilor și a sistemului este împărțită în trei secțiuni:

Indexul aplicațiilor KDE
Documentația KDE nativă. Toate aplicațiile KDE au documentația în format HTML. Această secțiune listează toate aplicațiile KDE cu o scurtă descriere și o legătură către documentația propriu-zisă a aplicației.
System Manual Pages
Paginile de manual UNIX sînt documentația on-line tradițională pentru sistemele Unix. Majoritatea programelor din sistemul dumneavoastră au pagini de manual. În plus, există pagini de manual pentru formatele de fișiere și funcții de bibliotecă din diferite limbajele de programare.
Directorul sistem Info
Documentația TeXinfo este utilizată de multe aplicații GNU, incluzînd gcc (compilatorul C/C++), emacs și multe altele.

În orice moment vă puteți întoarce la Cuprins selectînd Cuprins din meniul Du-te la sau din bara de unelte.

Înapoi și Înainte

Acestea sînt comenzi de istoric. Înapoi vă mută înapoi la pagina precedentă pe care ați vizitat-o, iar Înainte vă duce la pagina următoare pe care ați vizitat-o. Lista instorică are, în mod curent, 50 de locații adîncime, totuși acest lucru va fi probabil configurabil în versiunile viitoare.

Prev, Next, Up, Top

Veți recunoaște aceste comenzi dacă ați mai utilizat sistemul info. Documentația Info este aranjată ierarhic iar fiecare pagină se numește nod. Fiecare pagina info are un nod Top, adică pagina principală. Puteți să vă întoarceți la nodul Top dintr-un document info prin simpla apăsare a legăturii Top.

Prev și Next sînt utilizate pentru navigare înapoi și înainte la nivelul curent din ierarhie.

Dînd clic pe un item de meniu din document vă va muta într-un nivel inferior în ierarhia documentului. Puteți să vă duceți la un nivel ierarhic superior prin apăsarea legăturii Up.

Sistemul de manuale man este tratat în mod similar cu sistemul info, cu secțiunea index fiind nodul Top și fiecare pagină de manual la un nivel mai jos.

Căutarea

Puteți căuta un șir prin paginile de manual selectînd Caută... din meniul Fișier. Odată selectat, apare pagina de căutare care vă invită să introduceți textul de căutat. Puteți alege să căutați în cele trei sisteme de ajutor: KDE, man sau info. Apăsînd butonul Submit Search va fi afișată o listă de potriviri din fiecare categorie pe care ați selectat-o. Potrivirile KDE sînt listate în ordinea celei mai bune potriviri Paginile de manual sînt listate așa cum au fost raportate de comanda apropos.

Căutarea prin documentele info nu a fost încă implementată.