# &ksirc;i käsiraamat

## Sissejuhatus

&ksirc; on &kde; vaikimisi &irc; klient. See toetab Perli skripte ning on suuresti ühilduv &mirc;-ga.

## &ksirc;i kasutamine

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

Lühidalt öeldes on &irc; ametlike internetistandarditega määratletud vestlemisprotokoll, mis suudab sinu elust endale röövida palju-palju tunde. &irc; kasutamiseks tuleb võtta ühendust serveriga ja seejärel liituda kanaliga (see on sama, mis jututuba).

Serveriga ühendumiseks ava &ksirc; ja vali Ühendused Uus server... või vajuta klahvi F2. Ilmuvas dialoogis vali vasakul ülal asuvast hüpikkastist grupp ning keskel asuvast hüpikkastist server. Paremal näidatav port peaks üldjuhul olema 6667. Ilmub uus aken, mis näitab serverilt kliendile saadetavaid teateid. Kui teadete saabumine on läbi, võid valida kanali. Kõigi kättesaadavate kanalite nägemiseks anna käsk ``/list``. Kanaliga ühendumiseks anna käsk ``/join` `#kanalinimi``. Kanalilt lahkumiseks anna käsk ``/part``.

See oli kõige peamine. Kui soovid rohkem teada saada, loe edasi...

### &ksirc;i põhitõed

#### Serverid

&ksirc; lubab ühenduda suvalise arvu serveritega. Serveriga ühendumiseks vali menüükäsk Ühendused Uus server või vajuta klahvi F2. Ilmub dialoog Serveriga ühendumine, kus saab valida grupi, serveri ja pordi, millega ühendus luuakse.

Kui oled valmis, klõpsa nupul Ühenda ning nähtavale ilmub uus, serverit näitav aken. Serveritest, millega on ühendus loodud, saab ülevaate &ksirc;i aknas Serveri kontrollimine.

Enamiku &irc; käskude kohta saab abi, kui anda käsk `/help `käsu_nimi``. Kui anda ainult käsk `/help`, tagastatakse kõik kasutatavad käsud.

#### Kanalid

Kanalitega saab ühineda tavalise &irc; käsuga ``/join` `#kanalinimi``, menüükäsuga Ühendused Ühine kanaliga... või klahvile F3 vajutades.

Kanaleid, millega oled ühinenud, näidatakse aknas Serveri kontrollimine selle serveri all, millele nad kuuluvad. Kanalilt lahkumiseks võib anda käsu `/part`, valida menüükäsu Kanal Sulge või kasutada kiirklahvi &Ctrl;W.

#### Kanali valikud

Suvalises kanaliaknas leiduv menüü Kanal võimaldab kasutada mõningaid tulusaid võimalusi:

&Ctrl;S Salvesta logifaili...

- Salvestab kanali sisu failina.

Ajatempel

- Valimise korral varustab kõik, mis sa kanalil ütled, ütlemise ajaga vormis [HH:MM:SS]

&Alt;C T ASCII tabel

- Näitab ASCII sümbolite tabelit, millest saab valida suvalise vajaliku sümboli.

&Alt;C P Anna muutusest märku

- Selle valimisel teatab &ksirc; piiksuga, kui kanalil midagi öeldakse.

#### Kasutaja valikud

Kanalil näidatakse parempoolses servas kasutajate nimekirja. Hüüdnimel hiire parema nupuga klõpsates ilmub hüpikmenüü, mille enamik kirjeid räägib iseenda eest. Kirjeid saab ka seadistada (järjekorda muuta, lisada või eemaldada) KSirci seadistustedialoogi kaardil Kasutaja menüü. Vaikimisi toimingud on järgmised:

Värskenda hüüdnimesid

- Saadab serverile soovi saada kanali kasutajate nimekirja. See tagab hüüdnimede nimekirja värskuse.

Järgi

- Tõstab kasutaja hüüdnime esile igas kanalile saadetavas sõnumis. Sel moel on võimalik järgida kellegi vestluskatkeid näiteks aktiivsematel kanalitel. Kasutaja hüüdnime värv valitakse juhuslikult.

Lõpeta järgimine

- Peatab kasutaja järgimise.

Keson

- Saadab &CTCP; keson (whois) päringu kasutajale, mis annab infot kasutaja kohta, näiteks masinanime ja millise serveriga on ta ühendatud.

Ping

- Saadab &CTCP; pingi päringu kasutajale määramaks tema echo aega.

Versioon

- Saadab &CTCP; versiooni päringu kasutajale määramaks tema kasutatavat tarkvara.

Tee midagi paha

- Kuritarvitab kasutajat mingil armastusväärsel viisil.

Järgnevad käsud on kasutatavad ainult siis, kui oled kanali operaator:

Löö minema

- Eemaldab kasutaja kanalilt.

Keela ära

- Keelab kasutajal kanaliga ühinemast.

Tühista keelamine

- Eemaldab kasutajalt keelu kanaliga ühineda.

Operaatoriks

- Annab kasutajale operaatorile privileegid.

Operaatorist ära

- Võtab kasutajalt operaatori privileegid.

### Automaatne ühendumine

Kui sul on mitu serverit ja/või kanalit, millega alati &ksirc;i kasutamisel ühenduse lood, võid panna &ksirc;i nende automaatselt ühenduma. Vali aknas Serveri juhtimine menüükäsk Seadistused KSirci seadistamine... ning ilmuvas dialoogis kaart Automaatühendus. Kanali lisamiseks uuele serverile täida tekstiväljad Server ja Kanal ning klõpsa Lisa. Veel ühe kanali lisamiseks samale serverile vali server puuvaates, kirjuta kanali nimi tekstiväljale Kanal ning klõpsa Uuenda/Lisa. Neid samme võib korrata just nii palju, kui vajad servereid ja kanaleid, millega &ksirc; peaks kohe käivitumisel automaatselt ühenduma.

## &ksirc;i seadistamine

### Sissejuhatus seadistamisse

&ksirc;i seadistustedialoogi saab avada menüükäsuga Seadistused KSirc seadistamine... &ksirc;i aknast Serveri kontrollimine.

### Kaart Välimus

#### Akna välimus

Üksikaken (vanamoeline)

- Sunnib &ksirc;i kasutama üheaknalist režiimi, mille puhul igal uuel kanalil või `query` ehk päringu aknal on omaette eraldi aken.

Kaartidega mitmeaknaline (XChat)

- Sunnib &ksirc;i kasutama mitmeaknalist režiimi, mis sarnaneb rakenduse XChat stiiliga, kus igal uuel kanalil või `/query` ehk päringu aknal on omaette kaart ühes &ksirc;i põhiaknas. Iga kaardi võib tuua esiplaanile vastaval kaardil klõpsates, kaartide vahel saab liikuda ka kiirklahvidega &Shift;Nool vasakule ja &Shift;Nool paremale.

#### Taustapilt

Sektsioonis Taustapilt saab muuta &ksirc;i akende taustal näidatavat pilti. Kasutatava faili nime võib kirjutada otse tekstikasti, samuti võib kasutada tekstikastist paremal pool asuvat nuppu vajaliku faili leidmiseks. Kasutatavad pildifailid peavad olema vormingus &GIF;, JPEG või PNG. Dialoogi parempoolses osas on näha ka pildi eelvaatlus.

Kui sa ei soovi taustapilti kasutada, klõpsa hiire parema nupuga asukohaväljale ja vali kontekstimenüüst puhastamiskäsk. Teine võimalus on jätta väli tühjaks ja klõpsata nupule Rakenda. Sel juhul taustapilti ei määrata.

### Kaart Üldine

#### Globaalsed valikud

Dokkimine süsteemsesse salve

- See võimaldab dokkida KSirci süsteemsesse salve. Vaikimisi on see välja lülitatud. Kui KSirc on dokitud süsteemsesse salve, saab mitmeid võimalusi kasutada klõpsuga KSirci ikoonile. KSirci akna sulgemisel jääb ikoon süsteemsesse salve, kuni väljud KSircist.

Värvivalija hüpikaken

- Valimise korral näidatakse hüpikakent, kus saab valida värvi oma tekstile, iga kord, kui kasutad kiirklahvi &Ctrl;K. Valimatajätmisel tuleb värvide koodid käsitsi sisestada. Täpsemalt räägib sellest sectcolors. Vaikimisi on see sisse lülitatud.

Automaatne akende loomine

- Valimise korral loob &ksirc; automaatselt uue akna igale kasutajale, kes saadab sulle käsu `/msg`. Kui see ei ole valitud, näidatakse kõiki sulle käsuga `/msg` saadetud tekste käesolevas aknas ning sa saad käsuga `/query `kasutajanimi`` luua akna, milles antud kasutajaga vestelda. Vaikimisi on see sisse lülitatud.

Automaatne taasühinemine

- Ühenduse katkemise korral ühinetakse kanalitega automaatselt uuesti.

Automaatne loomine märguandel

- Kui keegi saadab sulle sõnumi, kasutades /notice, siis juhul, kui see valik on sisse lülitatud, luuakse uus aken.

Eemalolekuteadete levitamine

- Sisselülitamisel näed sõnumeid, kui kasutaja valib eemaloleku võimaluse. Vaikimisi ei ole see sisse lülitatud.

Hüüdnime lõpetamine

- Valimise korral võimaldab hüüdnime automaatselt lõpule viia. See toimib nii:

  1. Kirjuta kasutaja hüüdnime esimesed tähed.

  2. Vajuta klahvi TAB. Kirjutatud tekst viiakse lõpule, nii et see sobib hüüdnimega, sealhulgas jälgitakse vajadusel ka tõstu. ⪚ `phi<TAB>` tulemuseks on `PhilRod`, kui kanalil on olemas kasutaja hüüdnimega PhilRod.

  3. Kui kirjutatud tekstile vastab enam kui üks kanalil esinev hüüdnimi, valitakse neist esimene. Uuesti klahvile TAB vajutades asendatakse see järgmisega. Kui näiteks kanalil on kasutajad PhilA ja PhilRod ning sa kirjutad `phi<TAB>`, on tulemuseks algul `PhilA` ja teistkordsel TAB vajutamisel `PhilRod`.

Hüüdnimede värvimine nimekirjas

- Sisselülitamisel kasutatakse KSirci seadistustedialoogi värvide kaardil määratud värve hüüdnimede värvimiseks.

Teemat näidatakse akna tiitliribal

- Näitab käesoleva kanali teemat akna tiitliribal. Valimatajätmisel on teema näha ainult akna sees.

Passiivsed hüpikaknad dokitakse

- Seda saab valida ainult siis, kui valitud on ka dokkimine süsteemsesse salve. Sisselülitamisel näidatakse passiivseid hüpikaknaid dokituna süsteemsesse salve.

Üherealine tekstikast

- Kui see ei ole sisse lülitatud, suureneb tekstikast, kuhu sa kanalitel viibides oma teksti kirjutad, vastavalt teksti pikkusele. Kui see on sisse lülitatud, siis on kast alati üherealine, mis tähendab, et kui kirjutad pikema teksti, ei näe sa enam selle algust.

Ajaloo pikkus

- Igas aknas salvestatakse siinmääratud hulk ridu, mis võimaldab aknas kerimisel näha varemöeldut.

Ajaloo automaatne salvestamine

- Sisselülitamisel salvestatakse privaatsõnumite ajalugu. Kui avad sama kasutaja korral uuesti privaatakna, näed eelmiste temaga peetud vestluste logi (ajalugu).

#### Kanali seadistused

Olemasolevaid kanali seadistusi ei arvestata

- Sisselülitamisel tühistavad antud kaardi seadistused kõigi kanalite valikud, nii et neid rakendatakse kõigil kanalitel sõltumata kanali seadistustest kanalimenüüs. See toimib ainult seni, kuni avad seadistustedialoogi uuesti. Siis määratakse sellele taas sisselülitamata olek. Selle põhjuseks on asjaolu, et arvatavasti pole mõttekas alati ja iga kord tühistada olemasolevad kanalite valikud.

Ajatempel

- Varustab kõik, mis sa kanalil ütled, ütlemise ajaga vormis [HH:MM:SS].

Teema näitamine

- Kanali teemat näidatakse iga kanaliakna ülaosas.

Helisignaal muutuse korral

- Valimise korral kõlab süsteemne piiks iga kord, kui kasutaja sinu `/notify` nimekirjas ühineb &irc; serveriga, millega sina oled juba ühinenud.

Logimine on lubatud

- Loob logifaili iga kanali kohta. Need salvestatakse asukohta $TDEHOME/share/apps/ksirc/logs/ ning failid näevad välja sellised: /$TDEHOME/share/apps/ksirc/logs/#kanalinimi_aasta_kuu_päev_serverinimi.log

Lahkumis-/ühinemisteateid ei näidata

- Lahkumis-/ühinemisteateid ei näidata. See on kasulik paljude inimestega kanalitel.

Vaikekodeering

- Kehtestab kõigile kanalitele vaikekodeeringu. Selle saab valida liitkastist.

### Kaart Käivitamine

Siin saab seadistada &ksirc;i käivitamisega seotut.

#### Server

#### Nimeseadistused

Hüüdnimi

- Siin saab määrata oma &irc; hüüdnime

Alternatiivne hüüdnimi

- Siin saab määrata hüüdnime, mida kasutatakse siis, kui esimene peaks juba kellelgi teisel kasutusel olema.

Tegelik nimi

- Sinu tegelik nimi, nagu see saadakse vastuseks päringule `/whois`.

Kasutaja ID

- Sinu tegelik nimi, nagu see saadakse vastuseks päringule `/whois`.

#### Märguannete nimekiri

Siia saab sisestada need kasutajad, keda soovid lisada käivitamisel oma `/notify` nimekirja. Kui keegi neist sama kanaliga ühineb, antakse sellest sulle teada.

### Kaart Värvid

Siin saab seadistada, kuidas &ksirc; värve kasutab.

#### Vestluse värvide seadistamine

Siin saab määrata värvi igat laadi tekstile. Klõps iga kategooria kõrval asuvale värvinupule avab värvi valimise dialoogi, kus saab valida just meelepärase värvi antud tüüpi teksti tähistamiseks.

#### Hüüdnime värvid

Esiplaan: ja Taust: võimaldavad määrata kasutajate hüüdnimede esiplaani ja tausta värvi vestlusakendes. Omaenda hüüdnimega sõnumite värv võimaldab määrata värvi kõigile sõnumitele kanalil, kus esineb sinu hüüdnimi.

#### Värvikoodid

Siin saab määrata, kas &ksirc; lubab kasutada loomulikke värvikoode (täpsemalt räägib sellest sectcolors), samuti seda, kas lubatakse kasutada &mirc; värvikoode.

### Kaart Kasutaja menüü

Sellel kaardil saab seadistada hiire parema nupu menüüd igast kanalist paremal pool näidatava hüüdnimede nimekirja jaoks. Hüüdnimele hiire parema nupuga klõpsates on ilmuvas menüüs vaikimisi teatud toimingud. Need on ära toodud vasakul. Sul on võimalik muuta nende järjekorda, mõned eemaldada, teised aga lisada.

### Kaart Server/kanal

Siin on kirjas serverid ja kanalid, millega sa saad liituda kanalimenüüs olevate käskudega Uus server (F2) ja Uus kanal (&Ctrl;N) avanevates dialoogides.

#### Server

Siin saad lisada servereid, mida soovid kasutada. Kirjuta serveri nimi väljale ja klõpsa nupule Lisa server nimekirja. Kui soovid serveri nimekirjast kustutada, klõpsa serveri nimel ja seejärel nupul Kustuta server nimekirjast.

#### Kanalid

Siin saad lisada kanaleid, millega soovid ühineda. Kirjuta kanali nimi väljale ja klõpsa nupule Lisa kanal nimekirja. Kui soovid kanali nimekirjast kustutada, klõpsa kanali nimel ja seejärel nupul Kustuta kanal nimekirjast.

### Kaart Automaatne ühendamine

#### Automaatse ühendamise seadistamine

Siin saad määrata serveri ja kanali nimed, millega soovid ühineda kohe KSirci käivitumisel.

Uute kanalite lisamiseks tuleb kõigepealt kasutada automaatse ühendamise seadistamise dialoogi. Seal tuleb sisestada serveri nimi. Serveri pordi jaoks sobib peaaegu alati vaikeväärtus. Kui sa ei ole kindel, ära seda muutma hakka. Tavaliselt serverid parooli ei päri, nii et kui sa just ei tea, et seda vajad, jäta see väli tühjaks. Seejärel anna kanali nimi ja klõpsa nupule Lisa. Kanalit näeb seejärel automaatsete ühenduste nimekirjas.

Kui soovid lisada samal serveril rohkem kanaleid, klõpsa automaatsete ühenduste nimekirjas serverile ning selle nime näidatakse automaatse ühendamise seadistamise dialoogis. Kirjuta kanali nimi kanaliväljale ja klõpsa nupule Uuenda/Lisa.

Kanali eemaldamiseks automaatsete ühenduste nimekirjast klõpsa nimekirjas kanali nimele ja seejärel nupule Kustuta.

### Kaart Fondid

Siin saad muuta peaakna fonti. Vali font ja klõpsa muudatuse nägemiseks nupule Rakenda. Nupp OK rakendab muudatused ja sulgeb dialoogi.

## &ksirc;i värvid

&ksirc; järgib värviskeemi, mida kasutab &mirc;, ning on seda kergelt muutnud, et asi veel võimsam välja näeks.

    <fg> == esiplaan
    <bg> == taust
    [] == lisavõimalus

### Ühilduvus &mirc;iga

Vorming:

- `0x03<fg>[,<bg>]` määrab esiplaani ja tausta

- `0x03` taastab selle rea algväärtused

### &ksirc;i loomulikud värvid

Vorming:

- `˜<fg>[,<bg>]` määrab esiplaani ja tausta

- `˜c` taastab algväärtused

- `˜b` määrab fondi rasvaseks

- `˜u` määrab allajoonimise

- `˜i` määrab kaldkirja

- `˜r` määrab vastupidise esituse

Miks ma panin &ksirc;i kasutama ˜, mitte aga 0x03 (&Ctrl;C)? See on sellepärast, et 0x03 on üsna keeruline kasutada skriptides ja sugugi mitte kõik C funktsioonid ei taha seda tunnustada. `˜`täht`` võimaldab ka kasutada rohkem käske, muutumata takistuseks &mirc; tulevastele muutustele.

### Värvide numbrid

1. valge

2. must

3. sinine

4. roheline

5. punane

6. pruun

7. purpurpunane

8. oranž

9. kollane

10. heleroheline

11. lilla

12. helelilla

13. helesinine

14. roosa

15. hall

16. helehall

### Rasvase, allajoonimise, vastupidise ja värvi saatmine

Juhtkoodide lisamiseks teksti saab kasutada järgmisi kiirklahve:

- &Ctrl;B rasvase teksti jaoks

- &Ctrl;U teksti allajoonimise jaoks

- &Ctrl;R vastupidise teksti jaoks

- &Ctrl;K värvilise teksti jaoks

- &Ctrl;O tavalise teksti jaoks

### Näited

Üheainsa sõna allajoonimiseks lauses:

1. Kirjuta &Ctrl;U

2. Kirjuta sõna

3. Kirjuta uuesti &Ctrl;U

Mõjutatud on ainult tekst, mida vastav kood eest ja tagant piirab. Sama meetodit saab kasutada ka teiste juhtkoodide puhul.

Juhtkood &Ctrl;K on mõnevõrra erinev, sest see võimaldab määrata ka värvi numbri. Üheainsa sõna värvimiseks lauses:

1. Kirjuta &Ctrl;K

2. Kirjuta number 0 ja 15 vahel

3. Kirjuta sõna

4. Kirjuta uuesti &Ctrl;K

Kui soovid muuta ka sõna taustavärvi, tuleb ühe numbri asemel kirjutada kaks numbrit ja need komaga eraldada. Esimene number on sellisel juhul teksti, teine tausta värv. Numbrid peavad jääma vahemikku 0 kuni 15, nende seletus on ära toodud eelmises osas.

Teksti võib piirata erinevate juhtkoodidega, nii võib sõna olla näiteks rasvases kirjas, alla joonitud ja värviline.

## Filtrid

### Filtrite reeglid ja kuidas neid luua

Kui sa siinkõneldust väga hästi aru ei saa, oota veidi, kuni ma olen valmis saanud ühe korraliku filtrilooja, mille abil kõik käib paari hiireklõpsuga. Selleni võib aga veel hulk aega minna.

Filter püüab leida kokkusobiva stringi ja siis kasutada asendusena Mis ja Milleks. Kokkusobivus, Mis ja Milleks on kõik Perli regulaaravaldised. Reegleid arvestatakse alanevas järjekorras, see tähendab esimest reeglit esimesena, siis teist &etc; Kõiki reegleid arvestatakse nii:

`$`nimi`` asemele läheb keskkonnamuutuja ``nimi``. Seda tehakse kohe pärast reegli lisamist ning seda ei saa enam muuta. Seepärast ei ole selle väärtus vahest nii suur.

`$$`nimi`` asemele läheb kokkusobivuse ajal Perli muutuja `$`nimi``. Selleks võib olla alamstring, näiteks `$1`, `$2` asendusel, või tavaline sirc-i puhul kasutatav muutuja, näiteks `$nick`, `$channel`&etc;

`˜`nimi`˜`, mis üks ja ainult üks kord lisatakse reale, saadab tekstirea aknasse nimetusega `nimi`. Kui akent ei ole olemas, saadetakse see viimasele fookuses olevale aknale. On olemas mitu erilist akent, mille kõigi nimetused algavad märgiga `!`:

`!default`

- Käesolev vaikeaken. On kindlasti olemas.

`!all`

- Saadab igale aknale. Olenevalt sellest, kuidas teksti analüüsitakse, ei pruugi see olla näha kõigis akendes. Näiteks kanaliaknad ei näita `/part` või `/quit`, kui antud hüüdnimi ei ole kanalil.

`!discard`

- tühistab teksti.

Ülejäänud osa avaldisest käsitletakse tavalise Perli regulaaravaldisena. Kindlasti on abiks `perlre` manuaalilehekülgede korralik ja põhjalik läbiuurimine, aga ilmselgelt on vaja vähemalt põhimõttelist arusaama regulaaravaldistest.

### Näited:

1. Kõigi boren asemele tahetakse saada BoreN

       Kokkusobivus: .*
       Mis: boren
       Milleks: BoreN

   Üsna lihtne: sobib kõik, boren asemele tuleb BoreN.

2. Sobima peab kõik, kus leidub boren, ning see tuleb saata aknasse nimetusega boren

       Kokkusobivus: boren
       Mis: ˆ
       Milleks: ˜boren˜

   Otsitakse tähekombinatsiooni boren ning leidmisel tuleb stringi alguse (ˆ) asemele ˜boren˜.

3. Kuigi eelmine näide toimis, on juhul, kui stringis oli juba `˜mingiaken˜`, nüüd kaks `˜boren˜˜mingiaken˜...` Nii et selle asemel tuleks teha nii:.

       Kokkusobivus: boren
       Mis: ^(?:˜\S+˜)
       Milleks: ˜boren˜

   Olgu, mis-rida näeb nüüd veidi keerulisem välja. See tähendab, et sobib 0 või 1 korda `˜\S+˜`. Mis tähendab 1 tildet, ühte või enamat mittetühikut ja veel üht tildet. Paranoik võib anda ka `(*:˜\S+˜)`, mis tähendab, et sobib 0 või enam kanali direktiivi juhul, kui varasemad reeglid on katki.

4. Serveri tapmisteated on enamasti pikad, inetud, tülikad &etc; Näiteks dalneti põhiteade näeb välja selline:

       *** Notice -- Received KILL message for
       BOBO!ANDY@line82-basel.datacomm.ch from NickServ
       Path: empire.ny.us.dal.net[209.51.168.14]!trapdoor.ca.us.dal.net
       [206.86.127.252]!caris.ca.us.dal.net[208.1.222.221]
       !services.dal.net[2008.1.222.222]!services.dal.net
       (NickServ Enforcement)

   Kui oled `+s`, saad selliseid teateid meetrite kaupa ja on küll väheusutav, et sulle meeldib, kui see kõik sinu ekraanilt üle vurab. Näitan nüüd kolme reeglit, mis järk-järgult seda koormat vähendab. Seda saab teha ka vähema arvu reeglitega, kuid ma näitan siin reegli põhilist struktuuri loodetavasti kenasti arusaadavate sammudena ning selgitan, kuidas kasutada sõnumi analüüsimisel mitut reeglit. Esimene samm on eemaldada sõnumist Path: osa.

       Kokkusobivus: ^\*\*\*.* KILL message for.*
       Mis:  Path: \S+
       Milleks: .

   Otsitakse niisiis sõnumit, mis algab `***`. Tärnid `*` tuleb märkida sümboliga `\`, sest omaette tähendavad nad 0 või enam eelnevat märki. `.*` tähendab, et sobib kõik, kuni leitakse `KILL message for`. Nii saab jätta kirjutamata `-- Received...` &etc; Lõpus seisev `.*` tähendab, et sobib kõik kuni rea lõpuni (seda vahest polegi vaja, ma arvan).

   Mis-rida tähendab, et "Path: " ja kõik mittetühikust märgid asendatakse Milleks-reaga. Milleks-real seisab `"."`, mistõttu kogu rada muutub üheksainsaks punktiks.

   Sõnum näeb nüüd välja selline:

       *** Notice -- Received KILL message for BOBO!ANDY@line82-basel.datacomm.ch
       from NickServ. (NickServ Enforcement)

   Pane tähele, et `NickServ` järel seisab nüüd `"."`, mida varem polnud.

5. Olgu, sõnum on nüüd palju lühem, aga tegelikult ei ole kõik need KILLid nickservilt üldse olulised, nii et suuname nad hoopis aknasse `discard` (ehk tühistame).

       Kokkusobivus: ^\*\*\*.*KILL message.*\(NickServ Enforcement\)
       Mis: ^(?:˜\S+˜)
       Milleks:  ˜!discard˜

   Kokkusobivuse reegel otsib väljendit KILL message ja kontrollib, et selle saatja oleks NickServ. Pane tähele, et regulaaravaldises on kasutusel nii `\(` kui `\)`, mistõttu mõlemad tuleb tsiteerida. See on üsna sarnane sellega, mida tegime üle-eelmises näites.

6. Oleme nüüd välja filtreerinud kõik nickservi tapmisteated, kuid sõnum ise on esmapilgul endiselt üsna raskesti loetav. Seepärast korraldame selle veidi ümber, näiteks selliseks:

       *** [KILL] TAPJA; tappis TAPETU; (PÕHJUS)

       Kokkusobivus: \*\*\*.*KILL message
       Mis: \*\*\*.*for (.*?) from (.*?)\. \((.*?)\).*
       Milleks: *** [KILL] $$2 killed $$1 ($$3)

   Sobivuseks otsitakse nüüd siis `***`miski` KILL message`. Me ei saa kasutada `ˆ`, sest alles äsja on lisatud `˜<aken>˜`.

   Mis-rida näeb juba päris huvitav välja. `"for (.*?) "` otsib sõna "for" ja sellele järgnevat teksti. `.*?` tähendab, et sobib 0 või enam korda ükspuha mis, välja arvatud reavahetusmärk. Reegel lõpetab toimimise, kui leitakse esimene, mitte aga viimane lõpetamistingimus. See tähendab, et sobib kõik, kuni vastu tuleb tühik. Sulud `()` tähendavad sisu säilitamist. Iga () säilitab sobivad andmed `$#` puhul, kus `#` vasteks on 1 esimese alamstringi korral &etc; Antud juhul hangib `$1` tapetud isiku hüüdnime/kasutajainfo, `$2` tapja nime. Sulgude `()` vahel seisab tapmise põhjus. Siin lähevad `(` ja `)` veidi segaseks, aga pea meeles, et `\(` vasteks on tegelik sümbol `'('`.

7. Kuidas elu värviliseks muuta

   Olgu, proovime nüüd &ksirc;ile veidi värvi anda. Vaata värvide kohta lähemalt osa Värvid, kuid siin näitan filtrireeglit, kuidas igal real värvida ära hüüdnimi märkide `<HÜÜDNIMI>` vahel:

       Kokkusobivus: ^(?:˜\S+˜)<\S+>
       Mis: <(\S+)>
       Milleks: <˜4$$1˜c>

   Võtab hüüdnime ja lisab värvi #4 märkide `<>` vahele. `˜c` puhastab värvi.

## Klahvid

Alltoodud nimekiri näitab &ksirc;is kasutatavaid kiirklahve.

## Kiirklahvid

Kiirklahv | Tegevus
&Ctrl;N | Avab uue kanali/päringuakna.
&Ctrl;Q | Lõpetab töö
&Ctrl;Enter | Alustab sõnumit isikule, kes viimati sulle sõnumi saatis.
&Ctrl;&Shift;Enter | Alustab sõnumit isikule, kes sulle eelviimasena sõnumi saatis.
&Ctrl;K | Alustab numbriga määratud värvikoodi. Selle järele kirjutatav tekst esitatakse värvilisena.
&Ctrl;U | Alustab või lõpetab teksti allajoonimise. Tekst pärast selle esimest esinemist joonitakse alla kuni selle teise esinemiseni.
&Ctrl;I | Kaldkirja algus või lõpp. Tekst pärast selle esimest esinemist pannakse kakldkirja kuni selle teise esinemiseni.
&Ctrl;B | Rasvase kirja algus või lõpp. Tekst pärast selle esimest esinemist muudetakse rasvaseks kuni selle teise esinemiseni.
&Ctrl;R | Vastupidise teksti algus või lõpp. Tekst pärast selle esimest esinemist muudetakse vastupidiseks kuni selle teise esinemiseni.
TAB | Püüab sisestatud teksti põhjal viia lõpule kellegi kanalil viibija hüüdnime. Tõenäoliselt on selline käitumine tuttav shelli käsurealt, kuigi see ei pruugi päris täpselt samamoodi töötada. Täpsemalt räägib sellest nick-completion.

## Nõuanded

### &kde; kanalitega ühinemine

&kde; &irc; kanalid asuvad Freenode võrgus. Kasuta nende lisamiseks dialoogi KSirci seadistamine kaarti Server/kanal või Automaatne ühendus. Võrk peab olema ``irc.freenode.org``, port `6667`. Allpool on ära toodud kõige olulisemad &kde; kanalid ja nende eesmärk. Vali kanalid, mis sulle huvi pakuvad.

Mõningaid nõuandeid selle kohta, kuidas &kde; kanalitel küsimusi esitada, annab &kde; kogukonna wiki.

### KDE IRC kanalid

Kanal | Olemasolu mõte
#kde | Kasutajate abistamine
#kde-devel | &kde; arendus
#tdevelop | KDevelopi küsimused
#kontact | Kontactiga (&kmail;, &korganizer;, &knotes;, ...) seotud küsimused
#amarok | amaroKi kogukonna kanal: kasutajate küsimused, arendus
#debian-kde | Debiani KDE-ga seotud küsimused
#kde-freebsd | FreeBSD KDE-ga seotud küsimused

### Automaatne identiteet

Kui kavatsed kasutada &irc;-d regulaarselt, on sul arvatavasti huvi oma hüüdnimi registreerida. See kaitseb sinu hüüdnime, nii et ainult sina saad seda tarvitada. DALnetis saab pärast sisselogimist hüüdnime registreerida käsuga ``/msg` nickserv register `PAROOL``, kus `PAROOL` on sinu parool. Selle peale saad kinnituse, et sinu hüüdnimi registreeriti.

Seejärel saad iga kord DALnetti sisse logides sõnumi, kus sul palutakse ennast identifitseerida. Selleks pead kirjutama ``/msg nickserv identify `PAROOL```.

&ksirc; võib sind ka selle ka sinu eest automaatselt ära teha mis tahes kanali puhul. Selleks tuleb sul lihtsalt lisada järgmine Perli skript oma kodukataloogi:

Järgnev skript töötab kindlasti Freenode võrgus. See tuleb salvestada oma kodukataloogi nimega `.sircrc.pl`. &ksirc;i käivitades identifitseerib see skript sind automaatselt.

    sub hook_nick_notice {
    my $n = shift;
    my $m = shift;

    if($who =~ /NickServ/){
    if($m =~ /If this is your nickname/){
    $silent = 1;
    &msg("nickserv", "identify XXXXXX");
    $silent = 0;
    }
    }
    }
    &addhook("notice", "nick_notice");   # join on the "end of MOTD" numeric

Asenda `XXXXXX` oma parooliga.

See skript töötab ka muudes võrkudes kui Freenode, kus server saadab sulle päringu "identify", kuid mõnes võrgus (näiteks Undernet) läheb vaja veidi teistsugust skripti:

    sub hook_connected {
    if($server =~ /undernet.org$/){
            &msg("X\@channels.undernet.org", "login SINU_NIMI XXXX");
                    &docommand("umode +x");
    }
    }
    &addhook("255", "connected");   # join on the "end of MOTD" numeric

Asenda `SINU_NIMI` oma sisselogimisel kasutatava nimega ja `XXXX` oma parooliga.

Rohkem infot SIRC-i programmeerimise kohta leiab veebist: http://www.iagora.com/~espel/sirc/PROGRAMMING

## Autorid ja litsents

&ksirc;i autoriõigus 1997-2002: &ksirc; arendajad.

Osa dokumentatsiooni autoriõigus 1997: &Andrew.Stanley-Jones;

Dokumentatsiooni uuendas &kde; 3.0 tarbeks: &Philip.Rodrigues; &Philip.Rodrigues.mail;.

tips kirjutas &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;.

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

&underFDL; &underGPL;

## Paigaldamine

### &ksirc;i hankimine

&install.intro.documentation;

### Kompileerimine ja paigaldamine

&install.compile.documentation;
&documentation.index;