# &kmyapplication;i käsiraamat

Gary
R.
Cramblitt
garycramblitt@comcast.net
Marek
Laane

    bald@online.ee

Tõlge eesti keelde
2003
Gary R. Cramblitt
&FDLNotice;
2004-06-09
0.14

&kmyapplication; on K Töölaua Keskkonna kasutajasõbralik &irc; klient.

KDE
kdeextragear-2
Konversation
irc
interneti retranslatsioonivestlus
vestlus
side

## Sissejuhatus

&kmyapplication; on &irc; klient KDE töökeskkonnale (versioon 3.0.3 või uuem). See pakub järgmisi võimalusi:

- Kasutajasõbralik kaartidega liides.

- Kohandatavad kiirnupud sagedamini kasutatavatele käskudele.

- Automaatne taasühendumine ja taasliitumine.

- Failide saatmine ja saamine (DCC).

- Võimalus jälgida, millises olekus on &nickname;.

- Visuaalsed ja helilised märguanded paljudele sündmustele, näiteks sõnumitele, kus esineb sinu &nickname; või kui &nickname;, mis on sinu jälgitavate hüüdnimede nimekirjas, tuleb võrku või lahkub võrgust (KDE 3.2 või uuem).

- Kohandatav sõnumite esiletõstmine (aluseks &nickname;).

- Võimalus &nickname; automaatselt lõpetada.

- Kõigi &URL;-ide hankimine sõnumist ja nende salvestamine.

- Sõnumite esitamine ekraanil isegi rakenduse minimeerimisel.

- Võimalus panna &nickname; ignoreeritavate nimekirja.

- Kaitse sõnumiuputuse eest.

- Automaatne logimine ja logide haldamise võimalused.

- Ridade märkimine logifailides.

- Skriptide kasutamine.

&kmyapplication;i kohta käivaid küsimusi ja vastuseid saab esitada Konversation-Users meililistis. Palun liitu sellega, kui soovid teada saada uutest võimalustest või anda teada vigadest jne. Ainult uutest väljalasetest saab teada, kui liituda meililistiga Konversation-Announce. See on üsna väikese mahuga list, kus antakse ainult teada uutest väljalasetest või parandustest.

&kmyapplication;i arendajatega saab enamasti ühendust &irc; vahendusel irc.kde.org kanalil #konversation.

## &kmyapplication;i kasutamine

### Kui sa ei ole varem &irc;-d kasutanud...

Hästi lihtsalt öelduna on &irc; Interneti ametlike standarditega kindlaks määratud vestlusprotokoll, mis võib endale nõuda päris palju tunde sinu elust. &irc; kasutamiseks tuleb ühenduda serveriga ja seejärel kanaliga (see on umbes sama, mis jututuba) või siis alustada eravestlust.

Serveri ja kanaliga ühendumiseks ava &kmyapplication;. Ilmub Serverite nimekiri.

Serverite nimekiri. Serverite nimekiri

Klõpsa siia serveri ja kanali valimiseks.

Klõpsa siia uue serveri ja kanali määramiseks.

Klõpsa siia valitud serveri ja kanaliga ühendumiseks.

Ilmub peaaken, mis näitab serverilt kliendile saadetavaid teateid (kui &kmyapplication; serveriga ühendust ei saa, uuri osa Küsimused ja vastused). Kui serveri teated on üle ekraani jooksnud, võtab &kmyapplication; ühendust valitud kanaliga.

Peaaken. Peaaken

Seda nimetatakse sisendreaks. Sõnumi saatmiseks kõigile kanalil viibijatele kirjuta siia ona sõnum ja vajuta klahvi &Enter;. Nagu kõigil teistelgi, ilmub sinu sõnum ülal pidevalt edasiliikuvasse kanaliaknasse. Igale sõnumile eelneb selle kirjutamise aeg ja kasutaja &nickname;.

Võimalik on liituda mitme serveri ja kanaliga. Iga server, kanal, kanalite nimekiri või üldse mis tahes ekraan saab omaette kaardi. Kõigi saadaolevate kanalite nägemiseks vaata saadaolevate kanalite nimekirja. Kanaliga ühinemiseks kirjuta sisendreale ``/join` #kanalinimi` (pane tähele, et `#` on kindlasti vajalik). Käsu ``/join`` asemel võib anda ka lühema ``/j``. Kanalilt lahkumiseks kirjuta ``/part``. Mõnele muule serverile või kanalile lülitumiseks klõpsa vastavat kaarti.

Seda nimetatakse hüüdnimede paneeliks. Siin on kirjas iga kanaliga ühinenud kasutaja &nickname;, kaasa arvatud sinu enda oma.

Need olid kõige olulisemad asjad. Kui soovid rohkem teada saada, loe edasi...

### Identiteedi määramine

Enne seda, kui hakkad regulaarselt &kmyapplication;i kasutama, peaksid seadistustes kindlaks määrama, kuidas, kellena ja mismoodi sa võrgus esined.

Klõpsa Settings Button &kmyapplication;i seadistamise nupule või vali menüükäsk Seadistused Konversationi seadistamine . Ilmub dialoog Seadistused.

Seadistustedialoog. Seadistustedialoog

Klõpsa siia identiteedidialoogi avamiseks.

Sisesta siia oma pärisnimi. &irc; ei ole mõeldud sinu varjamiseks sõprade või vaenlaste eest. Pea seda meeles, kui tekib kiusatus midagi kurja ette võtta. Võltsitud "pärisnimi" võib muidugi hoida sind eemal kõikvõimalikest sulle ebameeldivatest tegelastest, aga arvuti, mille taga sa töötad, on nagunii võimalik alati üles leida, nii et päris anonüümseks ei õnnestu sul nii või teisiti jääda.

Sisesta siia nimi, mille all server sind tunneb. Tühikuid ja erimärke ei ole lubatud kasutada.

Sisesta siia oma &nickname;. See on nimi, mille all teised kasutajad sind näevad. Võib siin määrata just sellise nime, nagu soovid. Esimene märk peab olema täht, ülejäänud võivad olla tähed, numbrid või ka erimärgid `-[]\`_^{}|`.

Kuna &nickname; peab olema serveri ulatuses unikaalne, võib juhtuda, et server keeldub seda aktsepteerimast, kui kellelgi on juba samasugune &nickname; kasutusele võetud. Selleks oleks mõttekas lisada vastavatesse kastidesse alternatiivsed hüüdnimed. Kui server lükkab esimesena sisestatu tagasi, on valmis järgmine &nickname;, mida &kmyapplication; sellisel juhul serverile saadab.

RFC 2812 kohaselt võib &nickname; olla maksimaalselt üheksamärgiline, kuid tegelikult on see serveri otsustada. Serveri maksimumi selgitamiseks võta serveriga ühendust. Serveri sõnumite kaardil otsi üles sõnum `[Support]`. See võib olla näiteks selline:

`[18:51] *Eisfuchs* [21:45] [Support] Eisfuchs MODES=4 MAXCHANNELS=20 NICKLEN=16 USERLEN=10 HOSTLEN=63 TOPICLEN=450 KICKLEN=450 CHANNELLEN=30 KEYLEN=23 CHANTYPES=# PREFIX=@+ CASEMAPPING=ascii CAPAB IRCD=dancer`

`NICKLEN` määrab antud juhul, kui pikk tohib olla &nickname;.

Märgi see kast ja sisesta &nickname;, mis osutab, et oled eemal. Kui annad käsu ``/away` sõnum` mis tahes kanalil, millega oled ühinenud antud identiteeti kasutades, asub tegevusse &kmyapplication; ja sinu &nickname; asendatakse äraoleku hüüdnimega. Ühtlasi saadetakse äraoleku sõnum kõigile kanalitele, millega oled antud identiteeti kasutades liitunud. `%s` asemele pannakse `sõnum`. Kui annad käsu ``/away``, muutub sinu &nickname; taas tavaliseks ja naasmissõnum saadetakse kõigile kanalitele, millega oled antud identiteeti kasutades liitunud.

Teenus ja Parool on vajalikud siis, kui ühined sellise serveriga, mis nõuab pärast ühinemist registreerimist. Siin antud teenus ja parool tõlgendatakse käsuks ``/msg` Teenus IDENTIFY Parool`.

Klõpsa siia tehtud muudatuste rakendamiseks. Et kõik rakenduks, tuleb ühendus serveriga katkestada ja siis uuesti ühendust võtta. Lihtsaim viis selleks on väljuda &kmyapplication;ist ja see uuesti käivitada.

### Saadaolevate kanalite nimekiri

Saadaolevate kanalite nägemiseks vali menüükäsk Aknad Kanalite nimekiri . Pärast hoiatusdialoogi luuakse uus kaart nimetusega Kanalite nimekiri.

Kanalite nimekirja kaart. Kanalite nimekirja kaart.

Sisesta siia filtristring.

Kanalite nimekirja saab kärpida, kui siin määrata sellel olevate kasutajate miinimum või maksimum. 0 tühistab vastava parameetri kasutamise.

Klõpsa siia serverilt kanalite nimekirja tõmbamiseks ja filtri rakendamiseks.

Siin on näha kanalite nimekiri. Pane tähele, et kui sa ei kasuta regulaaravaldisi, näitab &kmyapplication; kõiki kanaleid, mille nimi sisaldab sisestatud filtristringi. Kanali nimi ei pea ilmtingimata algama sisestatud filtristringiga.

Vali klõpsuga kanal, millega soovid liituda. Paremklõps kanali nimel näitab kõiki kanali teemas mainitud veebiaadresse.

Klõpsa siia kanaliga liitumiseks. Kanalile luuakse uus kaart.

Võimaluse korral tuleks vältida nupu Värskenda nimekirja kasutamist. Enamikul serveritest on tuhandeid kanaleid ning selle käsu andmine paneb serverile korraliku koormuse. Pealegi kulub selleks sõltuvalt sinu internetiühenduse võimekusest päris mitu minutit. Kui klient on liiga aeglane, võib server isegi sinuga ühenduse katkestada.

Mõnikord on serveril "salajasi kanaleid", mida mõistagi kanalite nimekiri ei näita. Nendega saab siiski liituda, kui tead kanali täpset nime. Selleks kirjuta sisendreal ``/join` #kanalinimi` (`#` on kindlasti vajalik). Kanalile luuakse uus kaart. Kui liitud kanaliga ja hüüdnimede paneelil asetseb ainult sinu enda &nickname;, tähendab see, et antud kanalit ei olnud varem olemas. Server lõi selle ja sina oled sellel nüüd operaator. Sellisel juhul on usutavasti mõttekas kanal sulgeda, kirjutades käsu ``/part``.

### Peaakna tutvustus

Vaatame lähemalt, mida siis sisaldab peaaken. Alltoodud pildil on see näha avatud kanalikaardiga.

Peaaken. Peaaken

See kannab nimetust sisendrida. See on näha ainult siis, kui tegemist on kanalikaardiga. Sõnumi saatmiseks kõigile kanalil viibijatele kirjuta siia oma sõnum ja vajuta klahvi &Enter;. Nagu teiste, nii ka sinu sõnum ilmub üleval vastavalt sõnumite kirjutamisele pidevalt edasiliikuvasse aknasse. Igale sõnumile eelneb selle kirjutamise aeg ja kirjutaja &nickname;.

Teksti võib asetada ka lõikepuhvrist. Kui asetatud tekstis on enam kui üks rida (see tähendab, reavahetusi), ilmub dialoog. Redigeeri teksti, et see võtaks sulle meelepärase kuju ja klõpsa OK.

Kui asetatud tekst on pikem kui 256 sümbolit või sisaldab enam kui ühe rea, ilmub hoiatus, mis teatab, et pikad sõnumid võivad põhjustada ühenduse katkestusi ja üleujutusi. Sa võid muidugi ka sellisel juhul sõnumi teele saata, kuid see pole üldse eriti hea mõte, sest üleujutus ei meeldi kindlasti teistele kasutajatele ja pealegi võib server sinuga ühenduse katkestada. Märksa mõttekam oleks saata sõnum teele lühemate tükkidena.

A convention used in many channels is to precede messages directed at one user with their &nickname;. &kmyapplication; provides a convenient &nickname; completion feature. Start typing the user's &nickname;, then press &Tab;. &kmyapplication; will complete the rest of the user's &nickname; followed by a colon.

Siia võib ka sisestada mõne &irc; käsu, kirjutades kõigepealt ``/`` ja seejärel mõne kehtiva &irc; käsu (vaata osa Sagedamini kasutatavad &irc; käsud). Mõnel serveril võib anda käsu ``/help``, mis näitab saadaolevaid käske, või siis ``/help` käsk`, mis näitab abi konkreetse käsu kohta.

Liituda võib mitme serveri ja kanaliga. Iga server ja kanal saavad peaaknas eraldi kaardi. Kõigi kanalite nimekirja saamise kohta vaata osa Saadaolevate kanalite nimekiri. Kanaliga liitumiseks anna sisendreal käsk ``/join` #kanalinimi` (`#` on kindlasti vajalik). Kanalilt lahkumiseks anna käsk ``/part``. Kaardid on näha ka siis, kui avad kanalite nimekirja, pead privaatvestlust, avad URL püüdja või ühe või rohkem konsooli. Teisele kaardile lülitumiseks klõpsa vastava kaardi tähisele või kasuta nende vahel liikumiseks hiireratast.

Need tulukesed (&led;) hakkavad vilkuma, kui kaardil juhtub midagi, mida sa veel näinud pole. &led; vilgub aeglasemalt, kui nägemata sõnumid on kõigest käsud `join`, `part`, `quit` või on kellegi &nickname; muutunud. Nad vilguvad aga kiiremini, kui tegemist on päris sõnumiga. Värvid tähendavad järgmist:

- Kanal

- Serveri sõnumid, kanalite nimekiri või URL püüdja.

- Konsool või DCC olek.

- Privaatsõnum (päring).

Klõpsa siia kaardi sulgemiseks. Kanali kaardi sulgemisega lahkud kanalilt. Serveri sõnumite kaardi sulgemisega lahkud kõigilt kanalitelt, millega olid liitunud, sulged kõik avatud päringud antud serveril ja katkestad ühenduse serveriga.

Klõpsa sellele nupule, et võtta endale muu &nickname;. See on näha ainult siis, kui tegemist on kanalikaardiga.

Kui oled kanali operaator või kui režiim "Teemakaitse (+t)" ei ole kanalil sisse lülitatud, võid siin muuta kanali teemat.

Need nupud näitavad kanalirežiimide kehtivat olekut. Nupp on alla vajutatud, kui antud režiim on sisse lülitatud. Kui sul on selline õigus, võid nuppudele klõpsates muuta kanalirežiime.

Seda nimetatakse hüüdnimede paneeliks. Seda näidatakse alati, kui avatud on kanalikaart. Siin on kirjas iga kanaliga liitunud kasutaja &nickname;, kaasa arvatud sinu enda oma. &led; iga hüüdnime juures tähendab vastavalt värvile järgmisi asju:

- tavaline kasutaja

- häälega kasutaja

- kanali pooloperaator

- kanali operaator

- kanali omanik

- kanali administraator

Click with the &RMB; on any &nickname; to display a context menu of operations you can perform with that &nickname;. For example, you can send a file to the &nickname;.

Need on niinimetatud kiirnupud. Võimalik on muuta nende tähendust või nad üldse kõrvaldada (seda saab teha dialoogis Seadistused).

See on tööriistariba. Selle võib peita või uuesti nähtavale tuua menüü Seadistused abil.

Märkus: kanalinimede alguses seisab mõnikord `&`, `&plus;` või `!`. Kanalinime esimene märk määrab selle tüübi (RFC 2811 kohaselt) järgmiselt:

- `#` -tavalised kanalid.

- `!` -tavalised kanalid.

- `&` - kohalikud kanalid, nendega saab ühineda ainult kanalit pakkuvalt serverilt (kõigi muude kanalitega saab liituda mis tahes serverilt).

- `&plus;` - kanalid, mis ei toeta kanalirežiime. See tähendab, et sisse ei ole lülitatud ühtki režiimi, välja arvatud kanali lipp 't'.

Kanalinimed võivad olla kuni 200 sümbolit pikad ning sisaldada mis tahes sümboleid, välja arvatud tühik, koma ja Ctrl+G.

### Kiirühendumine

Võib juhtuda, et sul on soov ühineda serveriga ilma kogu uue serveri loomist serverite nimekirjas läbi tegemata.

Klõpsa Quick Connect Button kiirühenduse nupule või vali menüükäsk Fail Kiirühendus . Ilmub dialoog Kiirühendus.

Kiirühenduse aken. Kiirühenduse aken

Sisesta serveri aadress kasti Serveri URL, meelepärane &nickname; kasti Hüüdnimi ja klõpsa nupule Ühenda. Kui &kmyapplication; on serveriga ühenduse loonud, anna kanaliga liitumiseks käsk ``/join` #kanalinimi`.

### Sagedamini kasutatavad &irc; käsud

Siin on ära toodud sagedamini kasutatavad &irc; käsud. Nende täieliku nimekirja annab RFC 2812, samuti leiab selle veebileheküljelt irchelp.org. Kui soovid näha kõiki käske, mida &kmyapplication; parsib, vaata osa Konversationi käsud.

``/help``

  Näitab kõiki antud serveril saadaolevaid käske. Kõik serverid seda käsku ei toeta.

``/help` käsk`

  Näitab abi `käsu` kohta. Kõik serverid seda käsku ei toeta.

``/join #kanal``

  Käsk `#kanal`iga liitumiseks. Kui kanalit ei ole olemas, see luuakse ja sa saad selle operaatoriks.

``/part``

  Käsk antud kanalilt lahkumiseks, sulgeb ka peaakna kaardi.

``/part` #kanal`

  Käsk `#kanal`ilt lahkumiseks, sulgeb peaakna kaardi. Sama, mis ``/leave``

``/me` sõnum`

  Saadab `sõnum`i kanalile, selle ette lisatakse sinu &nickname;. Kui näiteks &nickname; on `Tux`, siis kirjutades `/me joob parajasti teed`, ilmub sõnum Tux joob parajasti teed. Kui kasutajad ei ole just mingil põhjusel rakendanud filtrit teatud sõnumite mittenäitamiseks, peaksid seda nägema kõik kanalil viibijad. Tavaliselt kasutatakse selliseid sõnumeid mitteverbaalse info edastamiseks, näiteks enda tunnete edastamiseks või teatamiseks, mida parajasti tehakse. Kui lahkud aga mõneks ajaks arvuti juurest, kasuta käsku /away.

``/away` sõnum`

  Kui keegi püüab sulle privaatsõnumit saata või sind mõnele kanalile kutsuda, saab ta `sõnum`iga teada, et oled parajasti eemal.

``/away``

  Katkestab käsu `/away` sõnum kehtivuse.

``/query` hüüdnimi`

  Loob uue kaardi kasutajaga `hüüdnimi` privaatvestluse alustamiseks. Tavaliselt nimetatakse seda IRC-s päringuks. Kõik, mida siin kirjutatakse, on näha ainult sulle ja sinu partnerile.

``/msg` hüüdnimi sõnum`

  Saadab `sõnum`i kasutajale, kelle &nickname; on määratud muutujaga `hüüdnimi`. Ainult `hüüdnimi` näeb seda sõnumit. Pikema vestluse jaoks kasuta käsku ``/query``.

``/invite` hüüdnimi`

  Kutsub kasutaja, kelle &nickname; on määratud muutujaga `hüüdnimi`, kanaliga liituma. See on eriti kasulik siis, kui kanaliga saabki liituda ainult kutse alusel.

### Privaatvestlused (päringud)

Privaatvestlus on vestlus, mida näed ainult sina ja sinu partner. &kmyapplication; nimetab privaatvestlusi "päringuteks". Selle alustamiseks kirjuta sisendreale ``/query` hüüdnimi`, kus hüüdnimi on selle kasutaja &nickname;, kellega soovid vestlust alustada. Võimalik on ka leida kasutaja &nickname; hüüdnimede paneelil, klõpsata sellel &HPN;ga ja valida Ava päring. Luuakse uus kaart. Anna seejärel endast teada juba sõnumit saates.

Päringud on nagu kanalid, ainult et sellel kanalil on võimalik tegutseda vaid sinul ja veel ühel isikul.

Päringu lõpetamiseks sulge lihtsalt kaart. Pane siiski tähele, et kui sinu partner saadab sulle veel sõnumeid, avatakse see kaart uuesti.

Kõigi päringute sulgemiseks vali menüükäsk Toimingud Sulge kõik avatud päringud.

Kui keegi tahab sinuga privaatvestlust alustada, loob &kmyapplication; uue kaardi, kus osaleb siis see &nickname; ja sina. Kui sa ei soovi vestelda, sulge kaart.

### Märguannete määramine

Märguanded on toimingud, mida &kmyapplication; võtab ette teatud sündmuste toimumisel. Oletame, et &kmyapplication; töötab, kuid on minimeeritud või varjatud töölaual teiste avatud akende taha. Kui keegi soovib nüüd sinuga suhelda või mõni sinu sõber kanaliga liitub, oleks hea, kui sa sellest teada saaksid. Selleks ongi märguanded.

Märguannete seadistamiseks vali menüükäsk Seadistused Märguannete seadistamine . Ilmub dialoog Märguannete seadistused.

Klõpsa kohe nupule Muud valikud.

Märguannete seadistustedialoog. Märguannete seadistustedialoog

Klõpsa siia sündmuse valimiseks.

Märgi, millist tüüpi märguannet peaks kasutama, kui vastav sündmus toimub (Näidatakse tegumireal paneb ikooni tegumireal vastava sündmuse korral vilkuma).

Korda seda, valides uue sündmuse ja meelepärase märguande. Kui oled seadistanud kõik vajalikud märguanded, klõpsa nupule Rakenda.

Kui oled juba märguanded seadistanud, saad siin lubada või keelata mis tahes toimingud. Näiteks võid soovida, et kõlaks mingi heli, kui sinu &nickname; esineb mõnes sõnumis. Kui oled oma arvuti taga, võid helid välja lülitada, aga näiteks arvuti juurest kuhugi lähedusse ära minnes need sisse lülitada, et huvipakkuvast sündmusest kohe teada saada.

### Võrgusviibijate jälgimine

&kmyapplication; võib sulle teada anda, kas sinu sõbrad on parajasti serveriga ühendust võtnud või mitte.

Selle võimaluse kasutamiseks vali menüükäsk Aknad Jälgitavad hüüdnimed võrgus. Ilmub dialoog Jälgitavad hüüdnimed võrgus.

Jälgitavad hüüdnimed võrgus Jälgitavad hüüdnimed võrgus

Klõpsa nuppu Muuda. Ilmub dialoog Jälgitavad hüüdnimed.

Jälgitavad hüüdnimed. Jälgitavad hüüdnimed

Märgi see kastike hüüdnimede jälgimise sisselülitamiseks.

Siin on kirjas nende kasutajate &nickname;, keda soovid jälgida.

Nende nuppudega on võimalik &nickname; nimekirja lisada või sealt eemaldada.

Võimalus Jälgitavad hüüdnimed võrgus saadab perioodiliselt vastava päringu serverile. Siin saab määrata, kui sageli selline päring saadetakse. Ära anna vähemat väärtust kui 20 sekundit, sest see seab serverile muidu liiga ränga koormuse.

Klõpsa OK, kui iga soovitud &nickname; on nimekirja lisatud või sealt eemaldatud.

Märkus: kui avad dialoogi Jälgitavad hüüdnimed võrgus, kulub veidi aega enne seda, kui iga vajalik &nickname; seal näha on, sest &kmyapplication; peab kõigepealt serverilt andmed hankima. Tavaliselt oleks mõttekas dialoog Jälgitavad hüüdnimed võrgus üldse lahti jätta.

&kmyapplication; näitab ka teadet kõigil kanalitel, kui kasutaja, kes on sinu jälgitavate hüüdnimede nimekirjas, serveriga liitub või lahkub. See sõnum näeb välja umbes selline:

`[17:52] [Märguanne] psn on võrgus (irc.kde.org).`

### Ekraaniesituse (&osd;) seadistamine

Ekraaniesitus (OnScreen Display ehk &osd;) on &kmyapplication;i unikaalne omadus. &osd; sisselülitamisel ilmuvad kanali sõnumid otse ekraanile ka siis, kui &kmyapplication; on minimeeritud. Siin on näha &osd; tegevus. Sõnum ekraani ülemises vasakpoolses osas on pärit &kmyapplication;ist, mis ise aga töötab süsteemsesse salve minimeerituna.

Ekraaniesituse näide Ekraaniesituse näide

&osd; sisselülitamiseks vali menüükäsk Seadistused &kmyapplication;i seadistamine. Ilmub dialoog Seadistused.

Ekraaniesituse dialoog. Ekraaniesituse dialoog

Klõpsa siia elemendi Vestlus avamiseks.

Klõpsa siia OSD valimiseks.

Märgi see kastike &osd; sisselülitamiseks.

Klõpsa sellele nupule &osd; fondi valimiseks. Märkus: mitte kõik fondid ei sobi; kindlasti sobivad näiteks Luxi Sans 22 ja Impact 22.

Märgi siin kastid vastavalt sellele, millist laadi sõnumeid soovid ekraanile ilmumas näha, ja klõpsa siis nupule Rakenda.

### Värviliste sõnumite saatmine

Iga sõnumi võib saata ka värvilisena. Selleks hakka mis tahes kanali sisendreal sõnumit kirjutama. Klõpsa Insert IRC Color Button IRC värvi lisamise nupule või vali menüükäsk Toimingud Lisa IRC värv . Ilmub IRC värvivalija.

IRC värvivalija. IRC värvivalija

Vali värv ja klõpsa nupule OK. Jätka sõnumi kirjutamist sisendireal. Kui soovid uuesti värvi muuta, klõpsa taas nupule Lisa IRC värv. Vali mõni muu värv ja klõpsa nupule OK.

### Uute serverite ja kanalite määramine

Uue serveri või kanali lisamiseks serverite nimekirja vali menüükäsk Fail Serverite nimekiri . Ilmub dialoog Serverite nimekiri. Klõpsa uue serveri ja kanali määramiseks nupule Uus vali mõni olemasolev server ja klõpsa nupule Redigeeri. Ilmub dialoog Serveri redigeerimine.

Serveri redigeerine. Serveri redigeerimine

Sisesta siia, mida ise soovid: seda kasutatakse ainult kirjete järjestamisel serverite nimekirjas.

Serveri nimi või IP aadress. Serverite nimekirja haldab irchelp.org.

Sisesta port, mida on vaja serveriga ühendumiseks. Enamasti peaks sobima `6667`.

Kui soovid serveriga ühenduse saamisel kohe mingi kanaliga liituda, kirjuta selle nimi siia. Enamasti tuleb kanalinime ette kirjutada `#`. Kui soovid serveriga ühenduda, ilma et sa automaatselt mõne kanaliga liituks, jäta see tühjaks. Kui soovid liituda mitme kanaliga, jäta kanalinimede vahele tühikud.

Vali siin oma identiteet. Sellega määratakse ühtlasi ära sinu &nickname;. Vaata lähemalt osa Identiteedi määramine.

Kui server nõuab ühinemiseks parooli, anna see siin, muidu jäta tühjaks.

Kui server nõuab ühinemiseks parooli, anna see siin, muidu jäta tühjaks. See parool kehtib kõigile kanalitele, mis on kirjas kanalinime kastis.

See käsk saadetakse serverile pärast ühendumist. Siin toodud näide käib freenode võrgu kohta, mis nõuab, et kasutaja ühendumisel oma &nickname; parooli ja kasutajanimega registreeriks. `konvirocks` on parool hüüdnimele, mis on antud kaardil Vaikeidentiteet. Korraga võib anda ka mitu käsku, eraldades need semikooloniga.

Klõps nupule OK lõpetab serveri ja kanali määramise.

### Kiirnuppude seadistamine

Kui valida peaaknas kanali kaart, ilmub nähtavale kaheksa kiirnuppu. Neid võib oma maitse järgi seadistada, pannes nad sooritama &irc; mõningaid kõige sagedamini ettetulevaid käske. Kiirnuppude seadistamiseks vali menüükäsk Seadistused Konversationi seadistamine. Ilmub dialoog Seadistused. Klõpsa kirjele Välimus ja seejärel Kiirnupud, mis avab dialoogi Kiirnupud.

Kiirnupud Kiirnupud

Siin on kaheksa kiirnuppu. Muutmiseks klõpsa vajalikule kirjele. Veerus Nupu nimi on nimi, mille all nupp on näha peaaknas. Püüa nimed võimalikult lühikesed hoida. Veerus Nupu toiming on toiming, mis sooritatakse, kui klõpsad kiirnupule. Toimingute määramisel saab näha ka vihjeid.

Muudatuste rakendamiseks klõpsa nupule OK.

Näide:

Nupu nimi: `Sõnum`

  Nupu toiming: `Msg %u` (siin tuleb jätta tühik `%u` järele)

Nupu kasutamiseks peaaknas vali &nickname; hüüdnimede paneelilt ja klõpsa siis nupule. Näed, et sisendreale ilmub `/MSG` , millele järgneb valitud &nickname;. Kirjuta nüüd sõnum, mida soovid antud isikule saata, ja vajuta klahvi &Enter;. Sõnum saadetakse valitud kasutajale ja seda sõnumit näebki peale sinu veel ainult tema.

Märkus: kiirnuppe ei saa lisada ega kustutada, kuid need on võimalik kõik korraga peita. Seda saab teha dialoogis Seadistused Konversationi seadistamine Välimus Üldine .

### Failide saatmine ja saamine

&irc; võimaldab saata faile teistele võrgusviibivatele kasutajatele või neilt faile vastu võtta.

HOIATUS: ära kunagi ava sulle saadetud faili, kui seda ei ole saatnud usaldusväärne isik. Nii võidakse levitada ka viiruseid.

Faili saatmiseks mõnele kanalilviibijale vali &HPN;ga klõpsates soovitud isiku &nickname; hüüdnimede paneelil (peaaknas). Vali käsk Saada fail . Ilmuvas dialoogis saad valida, millist faili saata. Seejärel ilmub uus kaart DCC olek.

DCC oleku kaart DCC oleku kaart

Siin on näha vastuvõtja &nickname; ja faili nimi.

Veerg Olek näitab faili saatmise või vastuvõtmise olekut järgmiselt:

Pakkumine

  Püüad saata faili ja &kmyapplication; ootab vastuvõtmisega soostumist.

Ühendumine

  &kmyapplication; püüab luua partneriga ühendust.

Saatmine

  &kmyapplication; saadab faili.

Saamine

  &kmyapplication; saab faili.

Tehtud

  Fail on edukalt edastatud.

Seiskunud

  Edastus algas, aga peatus mingil põhjusel.

Katkestatud

  Kas klõpsasid sina nupule Katkesta või katkestas partner edastuse.

Ebaõnnestus

  Tekkis viga, edastus ei õnnestunud.

Järjekorras

  Edastusega oldi nõus ning see algab kohe, kui selleks on valmis saaja tarkvara.

Otsimine

  &kmyapplication; püüab leida saatja IP aadressi.

Jätkamine

  Kui edastuse alates leitakse, et fail on juba kasutaja süsteemis olemas, päritakse kasutajalt: Fail on juba olemas. Kas jätkata edastust? See staatus annab märku, et kasutaja on edastust jätkanud.

Kui keegi soovib sulle faili saata, luuakse kaart DCC olek (kui seda juba olemas ei ole). Klõpsa selle nägemiseks kaardi DCC olek tähisel ja kui seejärel klõpsad faili vastuvõtmisega nõustumise nuppu, algabki edastus. Märkus: &kmyapplication; on võimalik panna faile automaatselt vastu võtma ( Seadistused Konversationi seadistamine DCC seadistused ).

Kui sul on failide saatmise või saamisega probleeme, blokeerib võib-olla tulemüür või ruuter DCC porte. Vaata osa Küsimused ja vastused.

### &URL;-i hankimine sõnumist

Igal kanalil edastavad kasutajad mõnikord huvipakkuvate veebilehekülgede või muude internetiressursside &URL;-e. Kui teed sellisel &URL;-il topeltklõpsu, käivitab &kmyapplication; &URL;-iga seonduva rakenduse. Käivitatav rakendus sõltub &URL;-i &MIME; tüübist. Näiteks &URL;, mille alguses seisab http:, avab sinu vaikeveebilehitseja ja näitab veebilehekülge (sa võid ka määrata, millist veebilehitsejat kasutada). Kui &URL; sõnumite reas üle ekraani libiseb, võib olla üpris keeruline seda uuesti üles leida. &kmyapplication; suudab aga sinu eest mugavalt vajalikud &URL;-id meeles pidada. Selleks vali menüükäsk Aknad URL püüdja . Luuakse uus kaart nimetusega URL püüdja.

URL püüdja. URL püüdja.

See on &URL;-ide nimekiri, mis on esinenud alates &kmyapplication;i käivitamisest. Veerus Hüüdnimi on selle isiku &nickname;, kes &URL;-i edastas. Kui &nickname; puudub, esines see serveri sõnumite kaardil (&URL;-e, mis esinevad liitumis- ja lahkumisteadetes, nimekiri ei kajasta). Valimiseks klõpsa soovitud &URL;-il.

Klõpsa siia valitud &URL;-iga seonduva rakenduse käivitamiseks. Käivitatav rakendus sõltub antud &URL;-i &MIME; tüübist. Näiteks &URL;, mille alguses seisab http:, käivitab sinu vaikeveebilehitseja ja avab vastava veebilehekülje. Veebiviitade puhul on sul võimalik ka määrata, millist veebilehitsejat kasutada.

Klõpsa siia valitud &URL;-i kopeerimiseks &kde; lõikepuhvrisse.

Klõpsa siia valitud &URL;-i kustutamiseks nimekirjast.

Klõpsa siia &URL;-ide nimekirja salvestamiseks failina.

Klõpsa siia nimekirja puhastamiseks.

### Veebilehitseja määramine

Kui klõpsad &kmyapplication;is esile tõstetud &URL;-ile, avatakse see rakendusega, mida KDE vaikimisi seostab antud &URL;-i &MIME; tüübiga. Näiteks klõps &URL;-ile, mille alguses seisab http, avab &konqueror;i ja näitab veebilehekülge. Sa võid siiski määrata mõne muu rakenduse kui KDE vaikevalik, näiteks kasutada veebilehitsejat Mozilla.

Muu veebilehitseja määramiseks vali menüükäsk Seadistused &kmyapplication;i seadistamine. Ilmub dialoog Seadistused.

Veebilehitseja dialoog Veebilehitseja dialoog

Klõpsa siia veebilehitseja dialoogi avamiseks.

Klõpsa siia kinnitamaks, et soovid kasutada muud veebilehitsejat.

Kirjuta käsk, millega soovitud veebilehitseja käivitada. Kui klõpsad &URL;-ile, asendatakse `%u` &URL;-iga.

Vihje: (ainult &UNIX; süsteemides) Vaikekäsk on `mozilla '%u'`, mis käivitab uue Mozilla protsessi iga kord, kui klõpsad &URL;-ile. Kui eelistad, et Mozilla näitaks veebilehekülge juba töötava akna uuel kaardil, loo järgmise sisuga fail:

    #!/bin/sh
    mozilla -remote "openURL($@, new-tab)" || exec mozilla "$@";

Anna failile nimeks `moz`, kontrolli, et see asuks sinu otsinguteel (PATH) ja tee fail käivitataks (`chmod a+x moz`). Seejärel kirjuta ülalolevasse veebilehitseja käsureale `moz '%u'`.

Märkus: veebilehitseja seadistused ei rakendu mailto: &URL;-idele. mailto: &URL;-id käivitavad alati KDE vaikimisi e-posti rakenduse.

Klõpsa muudatuste rakendamiseks nupule Rakenda. Et kõik rakenduks, tuleb ühendus kõigi serverite ja kanalitega katkestada ja siis uuesti ühendust võtta. Lihtsaim viis selleks on väljuda &kmyapplication;ist ja see uuesti käivitada.

### Kanali- ja päringulogide märkimine

Sul on võimalik lisada marker kanali ja päringu aknasse, mis aitab kiiresti vajaliku info üles leida. Selleks vali menüükäsk Toimingud Lisa meelespidamisrida . See tekitab aknas teksti alla rea, mis kerib edasi koos ülejäänud tekstiga.

### &kmyapplication;i käsud

Allpool on toodud käsud, mida &kmyapplication; iseseisvalt tõlgendab ja mis võivad erineda standardsetest &irc; käskudest. Nurksulgudes asuv osa ei ole kohustuslik. Püstkriipsuga (|) on eraldatud käsu erinevad vormid. Käsud, mida siin ei leitud, saadetakse serverile nii, nagu need sisestatakse.

``/me` sõnum`

  Saadab `sõnum`i kanalile, selle ette lisatakse sinu &nickname;. Kui näiteks &nickname; on `Tux`, siis kirjutades `/me joob parajasti teed`, ilmub sõnum Tux joob parajasti teed. Kui kasutajad ei ole just mingil põhjusel rakendanud filtrit teatud sõnumite mittenäitamiseks, peaksid seda nägema kõik kanalil viibijad. Tavaliselt kasutatakse selliseid sõnumeid mitteverbaalse info edastamiseks, näiteks enda tunnete edastamiseks või teatamiseks, mida parajasti tehakse. Kui lahkud aga mõneks ajaks arvuti juurest, kasuta käsku /away.

``/ame` sõnum`

  Nagu käsk ``/me``, ainult et sõnum saadetakse kõigile kanalitele ja päringutele, mis on avatud ükspuha millisel serveril, millega &kmyapplication; on ühendatud.

``/join` kanal [parool]`

  Ühineb `kanal`iga. Kui server seda lubab ja kanalit ei ole olemas, luuakse sellenimeline kanal ja sa saad selle operaatoriks. Kui kanal nõuab liitumiseks parooli, anna see pärast kanali nime (`parool`). Enamasti seisab kanalinime alguses `#`.

``/j` kanal [parool]`

  Sama, mis ``/join``.

``/part` [kanal] [põhjus]`

  Lahkub `kanal`ilt toodud `põhjus`el ja sulgeb vastava kanali kaardi. &kmyapplication;i kanali või päringukaardil võib anda lihtsalt käsu ``/part``, mis sulgeb antud kanali või päringu vaikepõhjusega, mille saab määrata kindlaks seadistustedialoogis.

``/leave` [kanal] [põhjus]`

  Sama, mis ``/part``.

``/quit``

  Kanali, päringu või DCC kaardil antuna katkestab ühenduse vastava serveriga ja sulgeb kõik sellel serveril avatud kanali-, päringu või DCC kaardid.

``/notice` hüüdnimi|kanal sõnum`

  Saadab `sõnum`i kasutajale, kelle &nickname; on määratud muutujaga `hüüdnimi` või kõigile antud `kanal`il. See võib välja näha näiteks selline (kanalikaardil):

  `[17:14] [Teade] Teate "Ma arvan, et ma saan aru" saatmine kanalile #konversation`

  Ja saajad näevad seda sellisena:

  `[17:15] [Teade] -Eisfuchs- Ma arvan, et ma saan aru`

``/query` hüüdnimi`

  Loob uue kaardi kasutajaga `hüüdnimi` privaatvestluse alustamiseks. Tavaliselt nimetatakse seda IRC-s päringuks. Kõik, mida siin kirjutatakse, on näha ainult sulle ja sinu partnerile. Kui siin anda tühikutega eraldatult enam kui üks &nickname;, avatakse päringukaart iga &nickname; tarbeks. Iga päringukaart ja seal kõneldav on nähtav ainult sulle ja konkreetsele partnerile.

``/msg` hüüdnimi|kanal` `sõnum`

  Saadab `sõnum`i kasutajale, kelle &nickname; on määratud muutujaga `hüüdnimi`, või kõigile kasutajatele `kanal`il. Erinevalt käsust ``/query`` ei avata uut kaarti. Kui `sõnum` algab käsuga ``/me`` , vormindatakse sõnum samamoodi, nagu käsu ``/me`` korral.

  Näited:

  `/msg Eisfuchs Mul läheks vaja veidi abi msg käsuga`

  `/msg #konversation Uus Konvi versioon on üleval!`

  `/msg Eisfuchs /me kompileerib parajasti käsiraamatut.`

``/smsg` hüüdnimi|kanal` `sõnum`

  Sama, mis ``/msg``, ainult et sõnumit sinu ekraanil ei näidata. See on mõttekas näiteks paroolide ja muu tundliku info varjamiseks ekraanil või logimise vältimiseks.

``/amsg` hüüdnimi|kanal` `sõnum`

  Sama, mis ``/msg``, ainult et sõnum saadetakse kõigile kanalitele ja päringutele kõigil serveritel, millega &kmyapplication; on ühendatud.

``/op` hüüdnimi`

  Kanalikaardil sisestatuna püüab anda kasutajale `hüüdnimi` kanali operaatori õigusi. See ei pruugi toimida, kui käsu andjal ei ole kanalil vastavaid õigusi (selleks peab ise olema eelnevalt kanali operaator). Soovi korral võib olla antud enam kui üks &nickname;, eraldajaks tühikud.

``/deop` hüüdnimi`

  Kanalikaardil sisestatuna võtab kasutajalt `hüüdnimi` kanali operaatori õigused. Soovi korral võib olla antud enam kui üks &nickname;, eraldajaks tühikud.

``/oper` [hüüdnimi]`

  Annab kasutajale, kelle &nickname; on määratud muutujaga `hüüdnimi` IRC-Op ehk administraatori privileegid. See on võimalik ainult siis, kui &nickname; esineb serveri O: real. IRC operaatoritel on õigus suvaline &nickname; kõrvaldada (``/kill``), ühendada serverid &irc; võrguga (``/connect``) ja veel palju muid õigusi. Kui jätta `hüüdnimi` sisestamata, püütakse IRC-Op privileegid anda sulle endale. Nii või teisiti päritakse sinu käest igal juhul IRC-Op kasutajanime ja parooli.

``/voice` hüüdnimi`

  Teatud kanalitel (lipuga +m) ei saa kasutajad sõnumeid saata, kui neil ei ole niinimetatud hääleprivileegi. Selle käsuga püütakse anda kasutajale `hüüdnimi` just selline õigus. Selle andmiseks peab olema kanali operaator. Enamasti pruugitakse seda siis, kui tegemist on modereeritava kanaliga.

``/unvoice` hüüdnimi`

  Võtab kasutajalt `hüüdnimi` kanalil hääleprivileegi.

``/topic` [kanal] [sõnum]`

  Püüab määrata `kanal`i teemaks `sõnum`i. Kanalikaardil sisestatuna võib `kanal`i ära jätta, sellisel juhul eeldatakse vaikimisi kaardil aktiivset kanalit. Kui ära jätta `sõnum`, näidatakse kanali parajasti kehtivat teemat. Kanali teema muutmine ei pruugi aga õnnestuda, kui sul selleks õigusi pole.

``/away` põhjus`

  Kui keegi püüab sulle privaatsõnumit saata või sind mõnele kanalile kutsuda, saab ta teada, et oled parajasti arvutist eemal toodud `põhjus`el. Oleku muutmiseks tagasi normaalseks anna käsk ``/away`` ilma põhjuseta.

``/aaway` põhjus`

  Sama, mis ``/away``, ainult et käsk saadetakse kõigile serveritele, millega &kmyapplication; on ühendatud

``/invite` hüüdnimi [kanal]`

  Kutsub kasutaja, kelle &nickname; on määratud muutujaga `hüüdnimi`, `kanal`iga liituma. See on eriti kasulik siis, kui kanaliga saabki liituda ainult kutse alusel. Kanalikaardil sisestatuna võib `kanal`i ära jätta.

``/exec` skript [parameetrid]`

  Käivitab &kmyapplication;iga ühilduva skripti nimega `skript` ja annab sellele vajadusel `parameetrid`. Rohkem infot skriptide kasutamise ja kirjutamise kohta annab osa Skriptide kasutamine.

  Näited:

  `/exec kdeversion`

  Saadab kanalile sinu süsteemi KDE ja Qt versiooni info.

  `/exec cmd uname -a`

  Saadab kanalile sinu Linuxi versiooni info.

``/notify` [hüüdnimi]`

  Lisab või eemaldab kasutaja `hüüdnimi` sinu loendist Jälgitavad hüüdnimed võrgus. Kui &nickname; on juba loendis, eemaldatakse ta sealt, kui mitte, siis lisatakse. Kui `hüüdnimi` ära jätta, näidatakse loendit, kus on kirjas iga parajasti jälgitav &nickname;.

``/prefs` [`list`|grupp] [`list`|võti] [väärtus]`

  Näitab või kehtestab &kmyapplication;i seadistusi ilma seadistustedialoogi avamata. Kui parameetris esineb tühikuid, aseta see jutumärkidesse.

  Näited:

  `/prefs list`

  Näitab saadaolevaid võtmegruppe.

  `/prefs "General Options" list`

  Näitab võtmeid grupis `General Options` koos nende parajasti kehtivate väärtustega.

  `/prefs "General Options" ShowTrayIcon`

  Näitab parajasti kehtivat väärtust &kmyapplication;i ikooni süsteemses salves näitamise seadistuse kohta.

  `/prefs "General Options" ShowTrayIcon false`

  Lülitab &kmyapplication;i ikooni näitamises süsteemses salves välja.

``/kick` hüüdnimi põhjus`

  Kanalikaardil sisestatuna püüab lüüa kasutaja, kelle &nickname; on määratud muutujaga `hüüdnimi`, kanaliltminema toodud `põhjus`el. Kui jätta `põhjus` andmata, kasutatakse vaikepõhjust, mida saab määrata seadistustedialoogis. Seda käsku saab kasutada ainult kanalikaardil.

``/ban` [`-host`|`-domain`| `-userhost`|`-userdomain`] [kanal] kasutaja|mask`

  Püüab pagendada `kasutaja` või `mask`i `kanal`ilt. Kanalikaardil sisestatuna võib `kanal`i ära jätta. Rohkem infot masinate, domeenide ja maskide kohta leiab veebist irchelp.org. Kanalil parajasti pagendatute nimekirja näeb käsuga ``/mode` kanal `b``.

``/unban` [kanal] muster`

  Tühistab varasema kanalilt pagendamise. Kanalikaardil sisestatuna võib `kanal`i ära jätta.

``/ignore` [`-all`] hüüdnimi`

  `hüüdnimi` lisatakse sinu ignoreeritavate loendisse. Antud võib olla ka enam kui üks &nickname;, eraldajaks tühikud. Kanali sõnumeid ignoreeritavate loendis olevatelt kasutajatelt ei näidata. Lisaks sellele ignoreeritakse ``-all`` andmisel üldse igasuguseid kasutajalt pärit sõnumeid (päringud, teadaanded, CTCP, DCC, erandid).

``/quote` käsk`

  `käsk` saadetakse serverile.

``/say` sõnum`

  Kanalikaardil sisestatuna saadab `sõnum`i kanalile. Sama, mis `sõnum`i sisestamine kanali sisendreal. Mõttekas &irc; käskude saatmiseks, kui sa ei soovi käske käivitada. Kaks käsumärki üksteise järel (//) tähendavad samuti ``/say``. Seda kasutatakse ka skriptides sõnumite saatmiseks.

``/raw` [`open`|`close`]`

  Seab serveri logi toorrežiimi (`open`) või peatab selle (`close`). Kui antud pole ei `open` ega `close`, eeldatakse vaikimisi, et mõeldud oli `open`. Toorrežiimis näitab logi iga serverilt saadud sõnumit &irc; loomupärases vormingus.

``/konsole``

  Avab uue kaardi KDE Konsooliga.

``/server` [url] [parool]`

  Võtab ühendust serveriga aadressil `url`. Kui `url` ära jätta, võetakse ühendust serveriga, mis on seotud kaardiga, millel käsk sisestati. See on kasulik taasühendumiseks serveriga, kui ühendus mingil põhjusel katkes. Kui server nõuab ühendumiseks parooli, anna see muutujaga `parool`. Kui server nõuab mingit muud porti kui vaikeport (6667), sisesta `url` kujul irc.kde.org:6665.

``/dcc` `SEND` hüüdnimi [failinimi]`

  Saadab faili `failinimi` kasutajale, kelle &nickname; on määratud muutujaga `hüüdnimi`. Kui `failinimi` ära jätta, ilmub dialoog, kus saab faili valida.

``/dcc``

  Avab DCC oleku kaardi,

``/ctcp` hüüdnimi|kanal `ping``

  Saadab PING sõnumi kasutajale `hüüdnimi` või `kanal`ile. Sellest on abi selgitamisel, kas isikul, kellega vestled, on äkki suur võrguviivitus või kas see on sul endal (kui saata käsk kanalile).

``/ctcp` hüüdnimi|kanal sõnum`

  Saadab sõnumi kasutajale `hüüdnimi` või kõigile kasutajatele `kanal`il. Sama, mis ``/msg``, ainult et sõnum saadetakse CTCP protokolli kasutades. Vastus sellele oleneb teise poole kasutatavast &irc; klientprogrammist. Näiteks teise &kmyapplication;i kasutajaga vesteldes tagastab `/ctcp Eisfuchs TIME` Eisfuchi arvuti süsteemse aja, `/ctcp Eisfuchs VERSION` aga Eisfuchi arvutil töötava &kmyapplication;i versiooni.

### Skriptide kasutamine

&kmyapplication; pakub mitu vahvat skripti, mida saab käivitada otse rakendusest. Skripti käivitamiseks kanali-, päringu-, DCC või serverikaardil anna käsk kujul

``/exec` skript [parameetrid]`

mis käivitab skripti nimega `skript`, edastades sellele (kui on määratud) `parameetrid`.

Kirjuta näiteks kanalikaardis käsk

`/exec kdeversion`

mis edastab kanalile sinu süsteemi KDE ja Qt versiooni.

`/exec cmd uname -a`

käivitab skripti `cmd`, edastades sellele parameetri `uname -a`. See saadab kanalile sinu Linuxi versiooni.

Kõigi saadaolevate skriptide nägemiseks anna Konsoolis järgmine käsk:

`ls $KDEDIR/share/apps/konversation/scripts`

Skripte võib ka ise kirja panna. Need on shelliskriptid ning neid võib kirjutada mis tahes shellikeeles, näiteks bash, perl või python. Kui &kmyapplication; skripti käivitab, saadetakse skriptile kõigepealt kolm parameetrit:

- Selle kaardi &irc; serveri pordi number, millel käsk ``/exec`` anti.

- Serveri aadress.

- Kanali nimi.

Toome siin näite bashi skriptist (cmd).

    #!/bin/bash

    # Käivitab käsu ja saadab väljundi Konversationi.

    PORT=$1;
    SERVER=$2;
    TARGET=$3;
    shift;shift;shift;

    $@ | while read line; do dcop $PORT Konversation say $SERVER "$TARGET" "$@: $line"; done

Pane tähele, et skript kasutab &kmyapplication;iga suhtlemisel DCOP-i. Käsk `say` sunnib väljundi kanalile tavalise sõnumina saatma. Millegi näitamiseks kaardil ilma seda teistele kasutajatele saatmata kasuta käsku `info`. Skriptide kirjutamisega aitab kindlasti paremini tutvuda näiteskriptide põhjalik uurimine.

Kui soovid enda loodud skripti käivitada, tuleb see sul paigadalda, kopeerides skripti kataloogi $KDEDIR/share/apps/konversation/scripts või $HOME/.kde/share/apps/konversation/scripts. Failile tleb anda ka käivitamisõigused, näiteks käsuga `chmod a+x minuskript`.

## Käskude seletused

### &kmyapplication;i peaaken

#### Failimenüü

Fail Serverite nimekiri

  Näitab serverite ja kanalite nimekirja.

Fail Kiirühendus

  Avab kiirühenduse dialoogi serveriga ühendumiseks.

&Ctrl;Q Fail Välju

  Lõpetab &kmyapplication;i töö.

#### Menüü Toimingud

Toimingud Leia tekst

  Otsib vajalikku teksti aktiivsel ekraanil.

Toimingud Lisa IRC värv

  Vaata osa Värviliste sõnumite saatmine.

Toimingud Lisa meelespidamisrida

  Vaata osa Kanali- ja päringulogide märkimine.

Toimingud Puhasta aken

  Puhastab aktiivse akna sisu.

Toimingud Eelmine kaart

  Näitab järjekorras eelmist kaarti.

Toimingud Järgmine kaart

  Näitab järjekorras järgmist kaarti.

Toimingud Sulge kaart

  Sulgeb aktiivse kaardi. Kui see on kanal, lahkub kanalilt. Kui see on serveri teadete kaart, sulgeb kõik antud serveri avatud kanalid ja katkestab ühenduse serveriga.

F11 Toimingud Sulge kõik avatud päringud

  Sulgeb kõik päringu- ehk privaatvestluste kanalid. Vaata osa Privaatvestlused.

#### Menüü Aknad

Aknad Jälgitavad hüüdnimed võrgus

  Näitab dialoogi Jälgitavad hüüdnimed võrgus. Vaata osa Võrgusviibijate jälgimine.

Aknad Kanalite nimekiri

  Näitab serveril saadaolevate kanalite nimekirja.

Aknad URL püüdja

  Avab URL püüdja dialoogi.

Aknad Uus konsool

  Avab terminaliakna. Avada võib nii mitu konsooliakent, kui süda lustib.

Aknad Ava logifail

  Avab dialoogi aktiivse kaardi logiteadetega. Toimib ainult kanali ja serveri teadete kaartide korral. Logimine peab olema sisse lülitatud ( Seadistused Konversationi seadistamine Logiseadistused ).

#### Menüü Seadistused

Seadistused Menüüriba peitmine

  Peidab menüüriba. Selle taasnägemiseks kasuta kiirklahvi &Ctrl;M.

Seadistused Tööriistariba peitmine

  Peidab tööriistariba.

Seadistused Olekuriba peitmine

  Peidab akna allservas asuva olekuriba.

Seadistused Kiirklahvide seadistamine

  Võimaldab muuta &kmyapplication;i kiirklahve.

Seadistused Tööriistaribade seadistamine

  Võimaldab lisada nuppe &kmyapplication;i tööriistaribale või neid sealt eemaldada.

Seadistused Märguannete seadistamine

  Avab märguannete seadistamise dialoogi.

Seadistused &kmyapplication;i seadistamine

  Avab dialoogi Seadistused.

#### Abimenüü

&help.menu.documentation;

## Küsimused ja vastused

&reporting.bugs; &updating.documentation;

Tahaksin &kmyapplication;i käivitades automaatselt liituda mitme kanaliga ühel serveril. Kuidas seda teha?

Määra dialoogis Serveri redigeerimine kõik vajalikud kanalid kastis Kanalinimi, jättes kanalinimede vahele tühikud.

Tahaksin &kmyapplication;i käivitades kohe ühenduda serveriga, aga mitte mõne konkreetse kanaliga. Kuidas seda teha?

Jäta dialoogis Serveri redigeerimine kast Kanalinimi tühjaks.

&kmyapplication; ei saa ühegi serveriga ühendust. Milles asi?

Sellel võib olla mitu põhjust.

1. Kontrolli, et serveri nimi ja port on dialoogis Serveri nimekiri korrektselt sisestatud.

2. Kontrolli kaardi Serveri sõnumid teateid. Kas seal on teateid mingitest vigadest? Kas server keeldus ühendusest vigase parooli tõttu? Kas server keeldus seepärast, et talle on vajalik IDENTD, aga sinu arvuti serveri IDENTD soovile ei vastanud?

3. Kui oled tulemüüri taga, kontrolli, et korrektsed pordid oleks ikka lubatud. &kmyapplication; vajab tööks järgmisi porte:

   - Väljapoole TCP 6667 (või selle serveri port, millega ühendust soovid võtta)

   - Sissepoole TCP 113 (kui serverile on vajalik IDENTD)

   Rohkem infot IRC ühenduse probleemide kohta annab irchelp.org.

## Autorid ja litsents

&kmyapplication;

Rakenduse autoriõigus 2002, 2003: Konversationi meeskond.

konversation.sourceforge.net

Kaasautorid:

- Dario Abatianni eisfuchs@tigress.com

- Matthias Gierlings gismore@users.sourceforge.net

- Alex Zepeda garbanzo@hooked.net

- Stanislav Karchebny berkus@users.sourceforge.net

- Mickael Marchand marchand@kde.org

- Peter Simonsson psn@linux.se

- Christian Muehlhaeuser chris@chris.de

Tänusõnad:

- Frauke Oster frauke@frsv.de

  Süsteemse salve paik.

- Lucijan Busch lucijan@kde.org

  Veaparandused.

- Sascha Cunz mail@sacu.de

  Laiendatud kasutajarežiimide paik.

- Steve Wollkind steve@njord.org

  Nähtava kaardi kiirklahvita sulgemise paik.

- Thomas Nagy thomas.nagy@eleve.emn.fr

  Kaartide läbikerimine hiirerattaga.

- Tobias Olry tobias.olry@web.de

  Kanali omaniku režiimi paik.

- Ruud Nabben r.nabben@gawab.com

  Võimalus lubada IRC värvifiltrit.

- Michael Goettsche mail@tuxipuxi.de

  Mitmesugused veaparandused

- Ismail Donmez kde@myrealbox.com

  Veaparandused ja uued võimalused

Dokumentatsiooni autoriõigus © 2003: Gary R. Cramblitt garycramblitt@comcast.net

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

&underFDL; &underGPL;

## Paigaldamine

### &kmyapplication;i hankimine

&install.intro.documentation;

&kmyapplication;i uusima versiooni, sealhulgas lähtekoodi ja paigaldamise juhised leiab ka &kmyapplication;i koduleheküljelt.

### Nõuded

&kmyapplication;i edukaks kasutamiseks on vajalik &kde; 3.0.3 või uuem ning internetiühendus. Varasematel &kde; versioonidel puudusid mitmed huvitavad võimalused. Kui kasutad &kmyapplication;i tulemüüri taga asudes, vaata osa Küsimused ja vastused.

&documentation.index;