2002-02-03
0.08.00

# &kde; abisüsteemi kasutusjuhend

## &kde; abisüsteem

&kde; abisüsteemi eesmärk on muuta tavapäraste &UNIX; abisüsteemide (man ja info) ning &kde; stiilis dokumentatsiooni (&XML;) kasutamine hõlpsaks ja lihtsaks.

Kõik &kde; baasrakendused on tänu dokumentatsioonimeeskonna tööle täielikult dokumenteeritud. Kui soovid abi pakkuda, kirjuta info saamiseks dokumentatsiooni koordinaatorile Lauri Wattsile (lauri@kde.org). Selleks ei ole tegelikult vaja isegi kogemust, piisab entusiasmist ja kannatlikkusest.

Kui soovid kaasa aidata &kde; dokumentatsiooni tõlkimisele oma emakeelde, siis ootab meelsasti sinu abi tõlkekoordinaator Albert Astals Cid (aacid@kde.org). Täpsemat infot, sealhulgas tõlkemeeskondade koordinaatorid, leiad lokaliseerimise veebileheküljelt ning käesoleva dokumendi sektsioonist Ühendusevõtmine.

### Paigaldamine

&khelpcenter; on &kde; baaspaigalduse lahutamatu osa, mis paigaldatakse alati koos &kde;ga. Selle leiab paketist kdebase, samuti võib selle leida ftp-hoidlast &kde-ftp; või siis sinu operatsioonisüsteemi paketist kdebase.

## Abiteksti väljakutsumine

&khelpcenter; on võimalik välja kutsuda mitmel moel:

Menüüst Abi

  See on tõenäoliselt kõige levinum viis mingi rakenduse kasutamise puhul. Antud rakenduse abifaili kasutamiseks kasuta selle menüüd Abi Sisukord.

K menüüst

  Klõpsa paneelil suurel K-tähel ja vali sealt &khelpcenter;e kasutamiseks Abi, mis toob sind abikeskuse avaleheküljele.

Paneelilt

  Vaikimisi sisaldab &kicker;i paneel ikooni, millele klõpsamine avab &khelpcenter;e, tuues sind taas avaleheküljele.

Käsurealt

  &khelpcenter;e saab faili näitamiseks käivitada &URL;iga. Vastavad &URL;id on lisatud ka `info` ja `man` kasutamiseks. Vastavad käsud võivad olla järgmised:

  Rakenduse abifail

    `khelpcenter` `help:/kedit`

    See avab &kedit;i abifaili sisukorra.

  Kohalik &URL;

    `khelpcenter` `file:/ usr/local/src/qt/html/index.html`

  Manuaalilehekülg

    `khelpcenter` `man:/strcpy`

  Infolehekülg

    `khelpcenter` `info:/gcc`

  Käsk `khelpcenter` ilma täpsustuseta avab abikeskuse avalehekülje.

## &khelpcenter;e töökeskkond

&khelpcenter; koosneb kahest infopaneelist.

Tööriistaribade ja menüüde kasutamist seletab lähemalt .

Dokumentidel on omaette navigeerimisvahendid, mis võimaldavad liikuda erinevate dokumentide juurde, kasutates viitu Järgmine, Eelmine ja Kodu või siis hüperlinke kasutades otse vajaliku dokumendi juurde.

Viidad võivad sind viia sama dokumendi teise osa või hoopis teise dokumendi juurde. Seansi ajal kasutatud dokumentide vahel saab saab liikuda, kui kasutada tööriistaribal ikoone Tagasi (vasakule osutav nool) ja Edasi (paremale osutav nool).

Kaks paneeli näitavad vasakul abisüsteemi sisukorda ja paremal abifaile.

### Paneel Sisukord

Paneel Sisukord paikneb &khelpcenter;es akna vasakul ääres. Enesestmõistetavalt on kahe paneeli vahel liigutatav piire, mis muudab ükspuha kumba paneeli lugemise väga mugavaks.

Paneeli Sisukord jaguneb kaheks kaardiks, millest üks sisaldab menüüd, mis näitab kogu abiinfot, mida &khelpcenter; üldse pakub, ning teine &kde; mõistete sõnaraamatut.

#### Sisukorra menüü

Sisukord sisaldab järgmisi vaikekirjeid:

Sissejuhatus

  Tere tulemast &kde;sse - sissejuhatus KDE töölaua keskkonda.

Sissejuhatus &kde;sse

  &kde; kiire sissejuhatus. Sisaldab retke läbi &kde; töökeskkonna ning konkreetseid vihjeid ja nõuandeid, kuidas &kde;s tõhusamalt tööd teha.

&kde; kasutaja käsiraamat

  &kde; kasutaja käsiraamat on põhjalik ülevaade &kde;st, sisaldades osasid nii paigalduse, seadistamise, kohandamise kui kasutamise kohta.

Rakenduste käsiraamatud

  &kde; omarakenduste dokumentatsioon. Kõigi &kde; rakenduste dokumentatsioon on &XML; vormingus, mis teisendatakse HTML vormingusse, kui te seda vaatate. See sektsioon toob ära kõik &kde; rakendused, annab nende kohta lühikirjelduse ja viitab rakenduse põhjalikule dokumentatsioonile.

  Rakendused on esitatud puuna, mis vastab K menüü vaikestruktuurile, muutes nii lihtsamaks selle rakenduse leidmise, mille kohta sa infot soovisid.

&UNIX;i man-leheküljed

  &UNIX;i manuaalileheküljed on &UNIX;i süsteemide traditsiooniline dokumentatsioonivorming. Süsteemi enamikul rakendustel on olemas oma man-lehekülg. Lisaks sellele on man-lehekülgi ka mitmesuguste käskude ja failivormingute kohta.

Infoleheküljed

  TeXinfo dokumentatsiooni kasutavad paljud &GNU; rakendused, sealhulgas `gcc` (C/C++ kompilaator), `emacs` ja paljud teised.

Sissejuhatused

  Lühikesed, ülesandekesksed või informatiivsed sissejuhatused.

&kde; KKK

  Korduma kippuvad küsimused &kde; kohta - ja vastused.

&kde; veebis

  Viidad &kde;le veebis, nii &kde; ametlikule koduleheküljele kui ka teistele kasulikele lehekülgedele.

Kontaktinfo

  Info, kuidas võtta ühendust &kde; arendajatega ja kuidas liituda &kde; meililistidega.

&kde; toetamine

  Kuidas pakkuda abi ja kuidas anda oma panus.

### Man ja Info sektsioonid

Man-leheküljed on standardsed &UNIX;i manuaalileheküljed, mida on juba aastaid kasutatud paljudel operatsioonidesüsteemidel. Need on väga põhjalikud ja seetõttu parim koht, kust hankida infot &UNIX;i käskude ja rakenduste kohta. Kui öeldakse RTFM, peetakse manuaali all enamasti silmas just man-lehekülge.

Man-leheküljed ei ole küll ideaalsed. Nad on enamasti põhjalikud, aga samas väga tehnilised, sest neid on tihtipeale kirjutajad arendajad - teistele arendajatele. Mõnikord muudab see nad väga raskesti mõistetavaks või isegi täiesti mõistetamatuks nii-öelda tavakasutajale. Siiski on see parim koht, kust hankida infot enamiku käsurearakenduste kohta, ja väga tihti ka ainus.

Kui sa oled kunagi hämmastunult mõelnud, mida küll tähendab see, kui kirjas seisab näiteks man(1), siis see tähendab seda, millises manuaali sektsioonis viidatu paikneb. Ka &khelpcenter; kasutab numbreid, et jagada man-lehekülgede hiigelhulk teatud sektsioonideks, mis võimaldab lihtsamaks leida just seda infot, mida sul vaja läheb.

Kasutada saab ka infolehekülgi, mis olid mõeldud asendama man-lehekülgi. Mõnegi rakenduse hooldaja ei värskenda enam man-lehekülgi, nii et kui saadaval on nii man- kui infolehekülg, siis on infolehekülg tõenäoliselt uuem. Paljudel rakendustel on olemas mõlemad abivahendid. Kui rakendus, mille kohta sa abi otsid, on &GNU; utiliit, siis on tõenäolisem leida abi infoleheküljelt, mitte man-lehekülgedelt.

#### Liikumine infolehekülgedel

Infodokumendid on korrastatud hierarhiliselt, lehekülgi kutsutakse siin sõlmedeks. Kõigil infolehekülgedel on sõlm Top, &ie; avalehekülg. Infolehekülje "tippu" pääseb klõpsuga viidal Top.

Hierarhia samal tasemel eelmisele ja järgmisele leheküljele liikumiseks saab kasutada viitu Prev & Next.

Klõps menüüelemendil dokumendi sees viib hierarhia järgmisele astmele. Tagasi ülespoole pääseb viidaga Up.

Man-lehekülgede kasutamine on sarnane infolehekülgede kasutamisega, ka seal on sektsiooni indeks "Top" ja iga man-lehekülg asub taseme võrra allpool. Manuaalikirjed on ühe lehekülje pikkused.

### &kde; sõnaraamat

Sõnaraamat on mõeldud kiireks viitematerjaliks, kus võib leida seletuse sõna kohta, mida sa varem ei teadnud. Mõisted ulatuvad &kde; spetsiifilistest rakendustest ja tehnoloogiatest &UNIX;i üldiste terminiteni.

Vasakul paneelil on puuvaade kahe valikuga: Tähestiku järjekorras ja Teemade järgi. Mõlemad sisaldavad ühesuguseid mõisteid, mis on erinevalt korraldatud, võimaldamaks kiiresti leida huvipakkuva termini.

Liikudes vasakul esitatud puus vajaliku kohani, avaneb paremal otsitava mõiste seletus.

### Menüüd ja tööriistariba

&khelpcenter;e töökeskkond on väga lihtne, mis võimaldab abikeskuse talituspõhimõtete tundmaõppimise asemel keskenduda abi saamisele.

Tööriistaribal kasutatakse järgmisi ikoone:

#### Tööriistaribaikoonid

Tagasi

  Liigub eelmisele vaadatud leheküljele.

Edasi

  Liigub ühe lehekülje võrra edasi. Seda saab kasutada ainult siis, kui varem on kasutatud ikooni Tagasi.

Trüki

  Trükib parajasti vaadatava lehekülje sisu.

Otsi

  Otsib sõna või sõnu parajasti vaadataval leheküljel.

Suurenda fonti

  Suurendab tekstisuurust vaateleheküljel.

Vähenda fonti

  Vähendab tekstisuurust vaateleheküljel. See toimib ainult siis, kui varem on teksti suurendatud.

Menüüdes esinevad järgmised kirjed:

Fail
  Fail Trüki...

    Trükib parajasti vaadatava lehekülje sisu.

  &Ctrl;Q Fail Välju

    Sulgeb lehekülje ja väljub &khelpcenter;ist.

Redigeerimine
  &Ctrl;A Redigeerimine Vali kõik

    Valib kogu teksti aktiivsel leheküljel.

  &Ctrl;F Redigeerimine Otsi...

    Otsib sõna või sõnu parajasti nähtaval leheküljel.

Vaade
  Vaade Vaata dokumendi lähteteksti

    Esitab parajasti vaadatava lehekülje HTML-lähteteksti.

  Vaade Määra kodeering

    Muudab aktiivse lehekülje kodeeringut. Normaalselt peaks kõik vajadused rahuldama vaikeseadistus Automaatne, aga kui tekib probleeme lehekülgedega, mis ei ole kirjutatud inglise keeles, võib tekkida vajadus määrata selle menüü abil sobilik kodeering.

Liikumine Tagasi

  Liigub eelmisele vaadatud leheküljele.

Liikumine Edasi

  Kui oled varem liikunud tagasi vastava ikooni või menüükäsu abil, siis selle käsuga saad taas edasi liikuda.

Liikumine ...

  Menüü Liikumine allosas leiad ajalooloendi mõne viimase vaadatud leheküljega. Neist ühe valimine viib sind otse sellele leheküljele.

## Autorid ja litsentsid

&khelpcenter;

Originaali arendaja: &Matthias.Elter; &Matthias.Elter.mail;

Praegune hooldaja: &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

&underFDL; &underGPL;