# &khelpcenter;

## &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 oma abi pakkuda, ühine postiloendiga ja kirjuta meeskonnale aadressil kde-doc-english@kde.org. Selleks ei ole tegelikult vaja isegi kogemust, piisab entusiasmist ja kannatlikkusest.

Kui soovid kaasa aidata &kde; dokumentatsiooni tõlkimisele oma emakeelde, siis leiab täpsemat infot, sealhulgas tõlkemeeskondade koordinaatorid, lokaliseerimise veebileheküljelt.

#### Paigaldamine

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

### 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 F1 Abi Rakenduse käsiraamat.

Rakenduste käivitajast Kickoff

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

Käsurealt

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

  Rakenduse abifail

- `khelpcenter` `help:/`kwrite``

  See avab &kwrite;'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 kasutajaliides

&khelpcenter; koosneb kahest infopaneelist.

Tööriistaribade ja menüüde kasutamist seletab lähemalt menu-and-toolbar-ref.

Dokumentidel on omaette navigeerimisvahendid, mis võimaldavad liikuda erinevate dokumentide juurde, kasutates viitu Järgmine, Eelmine ja Sisukord 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 vasakus ääres. Enesestmõistetavalt on kahe paneeli vahel liigutatav piire, mis muudab ükspuha kumba paneeli lugemise väga mugavaks.

Paneel 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:

Plasma käsiraamat

- &plasma; käsiraamat dokumenteerib &kde; kõige nähtavama osa, kogu töölaua tuumikliidese.

Abi internetis

- Siin leiab mitmeid võimalusi saada internetist abi ja lisateavet, mida pakub &kde; kogukond.

Rakenduste käsiraamatud

- &kde; omarakenduste dokumentatsioon. Kõigi &kde; rakenduste dokumentatsioon on &XML;-vormingus, mis teisendatakse HTML-vormingusse, kui sa seda vaatad. 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.

Juhtimiskeskuse moodulid

- Annab ülevaate erinevatest moodulitest, mida pakuvad &kde; Süsteemi seadistused.

Infokeskuse moodulid

- Sisaldab viitu erinevate KDE infokeskuse moodulite dokumentatsioonile.

KIO-moodulid

- Sisaldab viitu erinevate KIO-moodulite dokumentatsioonile.

&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.

Scrollkeeper

- Täiendav süsteemi paigaldatud &kde;-väline dokumentatsioon.

Infoleheküljed

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

#### Man ja Info sektsioonid

Man-leheküljed on standardsed &UNIX;-i manuaalileheküljed, mida on juba aastaid kasutatud paljudes operatsioonidesüsteemides. 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 info-lehekülgi, mis oma aja arvamuse kohaselt pidanuks asendama man-leheküljed. Mõningate rakenduste hooldajad ei hoolitse enam man-lehekülgede eest, nii et kui saadaval on nii info- kui ka man-leheküljed, on esimesed arvatavasti uuemad. Enamik rakendusi pakub siiski vaid ainult üht või teist, mitte mõlemat. Kui uuritav rakendus peaks olema mõni &GNU; rakendus, siis on tõenäoline, et see pakub vaid info-lehekülge, mitte man-lehekülge.

##### Liikumine info-lehekülgedel

Info-dokumendid on korrastatud hierarhiliselt, lehekülgi kutsutakse siin sõlmedeks. Kõigil info-lehekülgedel on sõlm Top, &ie; avalehekülg. Info-lehekü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 info-lehekü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ärgi ja Teema 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 kasutajaliides on väga lihtne, mis võimaldab abikeskuse talituspõhimõtete tundmaõppimise asemel keskenduda abi saamisele.

Tööriistaribal kasutatakse järgmisi ikoone:

#### Tööriistariba ikoonid

Sisukord

- Avab &abikeskus;e avalehekülje.

Tagasi

- Liigub tagasi eelmisele vaadatud leheküljele. Kui klõpsata ikoonist paremal asuvale linnukesele, ilmub nähtavale varem külastatud lehekülgede loend. Sealt mõne valimisel saab liikuda otse soovitud leheküljele.

Edasi

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

Kopeeri

- Kopeerib teksti lõikepuhvrisse, kust seda saab asetada mõnda muusse rakendusse.

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

- &Ctrl;Q Fail Välju

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

Redigeerimine

- &Ctrl;C Redigeerimine Kopeeri

- Kopeerib valitud teksti lõikepuhvrisse.

&Ctrl;A Redigeerimine Vali kõik

- Valib kogu aktiivse lehekülje teksti.

&Ctrl;F Redigeerimine Otsi...

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

Vaade

- Vaade Määra kodeering

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

Liikumine

- &Alt;Home Liikumine Sisukord

- Avab &abikeskus;e avalehekülje.

&Ctrl;PgUp Liikumine Eelmine lehekülg

- Liigub aktiivse dokumentatsiooni eelmisele leheküljele.

&Ctrl;PgDown Liikumine Järgmine lehekülg

- Liigub aktiivse dokumentatsiooni järgmisele leheküljele.

&Alt;Nool vasakule Liikumine Tagasi

- Liigub eelmisele vaadatud leheküljele.

&Alt;Nool paremale Liikumine Edasi

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

Seadistused

- Seadistused Tööriistariba näitamine

- Näitab või peidab rakenduse ülaosas asuva ikoone sisaldava tööriistariba.

Seadistused Olekuriba näitamine

- Näitab või peidab rakenduse alaosas oleva olekuriba.

Seadistused Fontide seadistamine...

- Võimaldab seadistada &khelpcenter;es kasutatavat fonti.

Seadistused Kiirklahvide seadistamine...

- Võimaldab seadistada &khelpcenter;es kasutatavaid kiirklahve.

Seadistused Tööriistaribade seadistamine...

- Võimaldab seadistada &khelpcenter;es kasutatavaid tööriistaribasid.

### Autorid ja litsentsid

&khelpcenter;

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

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

Tõlge eesti keelde: Marek Laane bald@smail.ee

&underFDL; &underGPL;