# &akregator;i käsiraamat

Frank Osterfeld

    frank.osterfeld@kdemail.net

Anne-Marie Mahfouf

    &Anne-Marie.Mahfouf.mail;

Marek Laane

    bald@starman.ee

Tõlge eesti keelde
2006 Frank Osterfeld
2006 &Anne-Marie.Mahfouf;
&FDLNotice;
2006-12-08
1.2.5

&akregator; on rakendus RSS- ja teiste võrgu-uudistekanalite lugemiseks.

KDE Akregator

## Sissejuhatus

### Mis on &akregator;?

&akregator; on &kde; rakendus uudistekanalite lugemiseks. Selle võimas ja kasutajasõbralik kasutajaliides võimaldab kanaleid nii lugeda kui ka neid hallata.

&akregator; on lihtne ja kiire programm, mis näitab uudistekanalite pakutavaid uudiseid, toetades kõiki levinumaid RSS- ja Atom-kanalite versioone. Liides sarnaneb e-posti rakendustele, mis muudab kasutamise väga lihtsaks. Muu hulgas saab otsida artikleid pealkirjade järgi, paigutada kanaleid rühmadesse ning määrata kindlaks arhiveerimise sätted. Kanaleid saab lasta näidata samamoodi nagu e-kirju. Kanaliga seotud veebilehekülgi võib vaadata kas &akregator;isse põimitud brauseris või avada need välises brauseris.

### RSS- ja Atom-kanalid

RSS (Real Simple Syndication) on &XML;-põhine vorming uudiste või artiklite avaldamiseks masinloetaval kujul. RSS- või Atom-faili nimetatakse ka kanaliks. Programmi, mis selliseid kanaleid loeb, nimetatakse uudistelugejaks või agregaatoriks. Viimasest tuleneb ka rakenduse &akregator; nimi.

&akregator; eraldab automaatselt kanalist üksikud elemendid ehk uudised ja näitab neid kasutajale. Nii võidab kasutaja ohtralt aega, sest ei pea enam regulaarselt veebilehele minema, et uut infot otsida.

RSS-il on mitu, omavahel ühildumatut versiooni (need on loonud omavahel konkureerivad firmad): RSS 0.9, RSS 1.0 ja RSS 2.0. Atom on samuti &XML;-põhine uudistekanalite keel, mis loodi spetsiifilisemalt veebipäevikute pidajate ja uudistesaitide vajadustest lähtuvalt. Ühtlasi üritab Atom asendada RSS-kanaleid ja kõrvaldada probleemid, mida tekitavad ühildumatud RSS-i versioonid.

## &akregator;i kiirtutvustus

Käesolev osa tutvustab, kuidas &akregator;it kasutama hakata. Siin selgitatakse kasutajaliidese komponente ja õpetatakse, kuidas lisada nimekirja omaenda kanaleid. Seda tasuks eriti lugeda neil, kellel pole seni olnud kokkupuuteid RSS/Atomi kanalitega ja uudistekanalite lugemise rakendustega.

### Peaaken

&akregator;i esmakäivitusel näeb peaakent: &akregator;i peaaken

&akregator;i peaaken

Peaaken koosneb kanalite nimekirjast, artiklite nimekirjast ja artiklite näitajast.

Kanalite nimekiri asub vasakul. Puus leiab kõik olemasolevad uudistekanalid. Uudistekanal kujutab endast artiklite kogu, näiteks uudistesaidi viimaseid uudiseid või veebipäeviku uusi kirjeid. Vaikimisi on nimekirjas &kde;-ga seotud uudistekanalid, aga otse loomulikult võid sa kanaleid ise lisada ja ebavajalikke eemaldada. Kõik artiklid on tõmmatud

Kõik artiklid on tõmmatud

Paremal ülal asub artiklite nimekiri. Selles leiduvad kanalite nimekirjas valitud uudistekanali artiklid (kui artiklite nimekiri on tühi, tuleb kõigepealt artiklid tõmmata). Nimekiri näitab artiklite pealkirju ja nende avaldamise aega. Vaikimisi on uusimad artiklid kõige ees. Artiklite nimekiri

Ühe kanali artiklite nimekiri

Artiklit valides näidatakse seda paremal all asuvas artiklite näitajas. Sõltuvalt kanalist võib seal näha kas ainult pealkirja, lühikokkuvõtet või ka terve artiklit. Planet &kde; artikli lugemine

Planet &kde; artikli lugemine

### Kanali lisamine

&akregator; pakub vaikimisi mõningaid &kde;-ga seotud uudistekanaleid. Sa võid neile lisada muid vajalikke ja meelepäraseid kanaleid, näiteks selliste saitide uudised, mida sa nagunii regulaarselt külastad.

- Vali menüüst Kanal käsk Lisa kanal... või kasuta vaikimisi kiirklahvi (Insert). Ilmub järgmine dialoog, mille sisendrida kannab nimetust Kanali URL:. Uue kanali lisamine

  Uue kanali lisamine

- Kirjuta Kanali URL järele näiteks `www.slashdot.org` või `http://www.slashdot.org` ja klõpsa OK.

- Ilmub kanali seadistustedialoog, kus saad valida vaikeväärtustest erinevad valikud. Kui kõik on seadistatud, klõpsa taas OK. Kanali omaduste dialoog

  Kanali omaduste dialoog

- Nüüd ongi Slashdot sinu kanalite nimekirja lisatud.

Huvipakkuvaid kanaleid saab leida ja lisada veel mitmel viisil. KDE-d kasutades näitab &konqueror; veebisaitidel leitud "RSS-vooge" akna parempoolses alumises nurgas. Klõpsa lihtsalt ikoonile hiire vasaku nupuga ja vali Lisa kanal &akregator;ile: Kanalite automaatne leidmine &konqueror;is

Kanalite automaatne leidmine &konqueror;is
Lehekülgedel, kus on RSS-i ikoon , klõpsa ikoonile hiire parema nupuga ja vali kontekstimenüüst käsk Lisa kanal &akregator;ile: Kanalite automaatne leidmine &konqueror;is
Kanalite automaatne leidmine &konqueror;is

### Kataloogi loomine

Pärast oma kanalite lisamist võib tekkida soov neid mingil moel sorteerida. Loome selleks äsja lisatud Slashdoti kanalile omaette kataloogi:

- Vali uue kataloogi ülemkataloog. Antud näites valime selleks Kõik kanalid.

- Vali Kanal Uus kataloog.... Kirjuta sisestusreale `Uudised` (või mis tahes sulle sobivana tunduv nimetus) ja klõpsa OK. Uue kataloogi dialoog

  Uue kataloogi dialoog

- Nüüd võid lohistada Slashdoti kanali uude kataloogi. Uudiste kataloog kanalite nimekirjas

  Uudiste kataloog kanalite nimekirjas

### Veebilehitsemine &akregator;is

Kanali artikleid lugedes võib tihtipeale tekkida soov lugeda veebilehekülge, kust artikkel on pärit: mõnigi artikkel sisaldab ainult pealkirja, mitte aga sisu. Sel juhul tuleb terve artikli lugemiseks külastada veebilehekülge. Samasugune vajadus võib tekkida siis, kui artiklis on viidad mõnele muule veebileheküljele, või kui sa loed veebipäevikut ja soovid midagi kommenteerida. Sellisteks juhtumiteks pakub &akregator; omalt poolt välja väga lihtsa brauseri. Kui klõpsad artiklite näitajas viidale, avab &akregator; selle uuel kaardil:

Pane tähele, et &akregator;i brauser ei ole mõeldud asendama sinu lemmikbrauserit. See on mõeldud artiklite lugemiseks, nende kommenteerimiseks või viitade kiireks avamiseks. See ei ole mõeldud kõikvõimalikuks veebilehitsemiseks, sest sellel puuduvad paljud täiemahuliste brauserite omadused.

## &akregator;i seadistamine

Enamiku &akregator;i seadistamisvalikuid leiab &akregator;i seadistustedialoogist. Selle saab avada menüükäsuga Seadistused&akregator;i seadistamine...

### Üldine

Kaardil Üldine paiknevad &akregator;i kõige peamised valikud, aga ka mõned valikud, mis mujale ei sobi.

Kaart Üldine
Kaart Üldine

Globaalne
  Paneeliikooni näitamine

    &akregator;i ikooni näidatakse süsteemses salves.

  Kõigil kanalitel kasutatakse märguandeid

    Määrab globaalsed märguanded kõigile kanalitele. See valik tühistab kõik kanalitele määratud individuaalsed märguanded. Sisselülitamisel annab &akregator; märku kõigi kanalite uutest artiklitest. Kui soovid kasutada märguandeid ainult mõne, mitte kõigi kanalite korral, jäta see valik sisse lülitamata ning määra vajalikele kanalitele märguanded kanali omaduste dialoogis.

  Kasutatakse intervalliga tõmbamist

    Kui see on märkimata, on ka intervalliga tõmbamine keelatud. Kui see on aga märgitud, saad kastis Kanalid tõmmatakse iga: määrata intervalli, mille järel &akregator; automaatselt kontrollib, kas kanalites on uusi kirjeid. Pane tähele, et artiklite tõmbamine tekitab omajagu veebiliiklust ja võib kaasa tuua raskusi kanali pakkujale. Mõned saidid võivad isegi blokeerida sinu arvutist tulevad ühendused, kui sa neid liiga sageli külastad. Üldiselt on mõistlik intervall 30 minutit.

  Kanalid tõmmatakse iga:

    Seda valikut saab kasutada, kui sisse on lülitatud valik Kasutatakse intervalliga tõmbamist. Siin saab määrata ajavahemiku, mille järel kontrollitakse, kas kanalitel on uusi artikleid. Vaikimisi on intervalliks 30 minutit.

Käivitumine
  Kõik kanalid märgitakse käivitumisel loetuks

    Sisselülitamisel märgib &akregator; käivitumisel kõik artiklid loetuks.

  Kõik kanalid tõmmatakse käivitumisel

    Sisselülitamisel tõmbab &akregator; kõik kanalid kohe pärast käivitumist.

Võrk
  Veebilehitseja puhvri kasutamine (vähendab liiklust)

    Sisselülitamisel kasutatakse kanalite uuendamisel kogu &kde;-s kehtivaid brauseri puhvri seadistusi. &kde; brauseri puhvrit saab seadistada kas &juhtimiskeskus;es või &konqueror;i seadistustedialoogis.

    Üldiselt oleks mõistlik seda valikut mitte välja lülitada. Väljalülitamise korral suureneb võrguliiklus. Puhverdamist mittekasutatavate uudistelugejate tekitatud liiklus suurendab uudistepakkujate koormust, mis võib kaasa tuua isegi pakutavate kanalite vähendamise.

### Säilitamine

Artiklite säilitamine tähendab artiklite viitade säilitamist. Siin saab piirata säilitatavate artiklite arvu ja määrata säilitamiseks kasutatava meetodi. Need on globaalsed seadistused, mida kasutatakse kõigi &akregator;i kanalite puhul. Kui soovid mõne kanali puhul neid muuta, tuleb seda teha vajaliku kanali omaduste dialoogi säilitamise kaardil.

Kaart Säilitamine
Kaart Säilitamine

Säilitamise vaikeseadistused
  Kõik artiklid hoitakse alles

    Kõik artiklid hoitakse igavesti alles.

  Säilitamise limiit:

    Kui artiklite arv ületab määratud piirangu, kustutatakse vanemad artiklid. Pane tähele, et artiklite arvu määramisel ei arvetata tähistatud artikleid: kui oled limiidiks valinud 500 ning sl on 510 tähistamata ja 50 tähistatud artiklit, eirab &akregator; 50 tähistatud artiklit ja kustutab ainult 10 vanemat tähistamata artiklit. See tähendab, et alles jäetakse kokku 550 artiklit.

  Kustutatakse artiklid, mis on vanemad kui:

    Artiklid, mis on vanemad kui määratud arv päevi, kustutatakse arhiivist, kui neid ei ole just säilitamiseks tähistatud. &akregator; kontrollib artiklite aegumist käivitamisel ja seejärel kord tunnis, mistõttu kustutamine käib teatud viivitusega.

  Säilitamine keelatakse

    Artikleid ei salvestata - kõik artiklid unustatakse &akregator;ist väljumisel.

Tähtsad artiklid ei aegu

  Hiire parema nupuga artiklil klõpsates avaneb kontekstimenüü, mille abil saab artikli märkida tähtsaks. Tähtsaks märgitud artiklid ei aegu ja neid ei kustutata.

### Välimus

Sellel kaardil saab seadistada artiklite näitaja ja brauseri kaartide välimust. Siin saab määrata kasutatavate fontide suuruse ja perekonna.

Kaart Välimus
Kaart Välimus

Fondi suurus
  Minimaalne fondisuurus

    Fondi minimaalne suurus artiklite näitajas

  Keskmine fondisuurus

    Fondi vaikimisi suurus artiklite näitajas

Fondid
  Standardne font:

    Artiklite näitajas kuvatakse sisu standardse fondiga ja keskmise fondi suurusega. Kui muudad standardset fonti, muutub ka artiklite välimus artiklite näitajas.

  Fikseeritud font:

    Kui artikkel kasutab artiklite näitajas fikseeritud laiusega fonti, kuvatakse sisu siin määratud fondiperet kasutades (keskmise fondi suurusega).

  Serif-font:

    Kui artikkel kasutab seriif-fonti, kuvatakse sisu siin määratud fondiperet kasutades (keskmise fondi suurusega).

  Sans serif-font:

    Kui artikkel kasutab seriifita fonti, kuvatakse sisu siin määratud fondiperet kasutades (keskmise fondi suurusega).

Viidad joonitakse alla

  Märkimisel joonitakse viidad vaikimisi alla.

### Sirvija

Sellel kaardil saab kohandada seesmise brauseri kaartide käitumist.

Kaart Sirvija
Kaart Sirvija

Hiire vasaku nupu klõps annab käsu

  Hiire vasaku nupu klõpsule saab valida kolm toimingut: Ava uuel kaardil (viit avatakse uuel kaardil, mis saab ka fookuse), Ava taustale jääval kaardil (viit avatakse uuel kaardil, kuid fookusse jääb aktiivne kaart) ja Ava välises veebilehitsejas (avatakse uus aken sinu vaikimisi brauseris).

Hiire keskmise nupu klõps annab käsu

  Nagu eespool, saab siin valida ühe kolmest toimingust hiire keskmise nupu klõpsu jaoks.

Välise veebilehitseja korral
  Kasutatakse &kde; vaikimisi veebilehitsejat

    Märkimise korral kasutab &akregator; veebilehitsejat, mille oled määranud &juhtimiskeskus;es. See võib olla KDE vaikimisi brauser &konqueror; või ka midagi muud vastavalt sellele, mida oled juhtimiskeskuses määranud.

  Kasutatakse järgmist käsku:

    &akregator;is võib kasutada ka muud brauserit kui &kde; vaikebrauser. Sellise soovi korral märgi see kast ja sisesta brauseri käivitamiseks vajalik käsk (eeldusel, et see asub keskkonnamuutujaga $`PATH` määratud asukohas).

Hiirekursori liikumisel sakile näidatakse sulgemisnuppu

  Märkimise korral ilmub sulgemisnupp nähtavale, kui viid hiire kaardi saki vasakusse serva. See võimaldab hõlpsamini kaarte sulgeda.

### Muud

Kaardil Muud saab määrata mitmeid täppisseadistusi. Kui sa ei ole kindel, mis mõju need avaldavad, võid rahulikult jätta kehtima vaikeväärtused.

Kaart Muud
Kaart Muud

Säilitamine
  Arhiveerimisrakendus:

    &akregator; kasutab praegu ainult Metakiti andmebaasi, kuid &kde; 4 ajal pakub &akregator; kindlasti ka muid andmebaaside taustaprogramme.

Artiklite nimekiri
  Valitud artikkel märgitakse loetuks pärast

    Vaikeväärtus on 9 sekundit, mis tähendab seda, et artikkel märgitakse loetuks kohe, kui oled sellele klõpsanud. Vajaduse korral võid siin määrata, mitme sekundi pärast artikkel loetuks märgitakse.

  Otsinguriba lähtestamine kanalite muutmisel

    Märkimisel puhastatakse otsinguriba, kui vahetad kanalit.

## Käskude seletus

### Menüüd ja kiirklahvid

#### Menüü Fail

Fail Impordi kanalid...

  Avab kanalite importimise dialoogi

Fail Ekspordi kanalid...

  Avab salvestamisdialoogi

&Ctrl;P Fail Trüki...

  Avab trükkimisdialoogi

&Ctrl;Q Fail Välju

  Lõpetab &akregator;i töö

#### Menüü Redigeerimine

F2 Redigeerimine Muuda kanalit...

  Võimaldab muuta aktiivse kanali omadusi selle omaduste dialoogis

&Alt;Delete Redigeerimine Kustuta kanal

  Kustutab aktiivse kanali

&Ctrl;C Redigeerimine Kopeeri

  Kopeerib valitud teksti lõikepuhvrisse

&Ctrl;A Redigeerimine Vali kõik

  Valib artiklite näitajas kogu teksti

&Ctrl;F Redigeerimine Otsi...

  Käivitab teksti otsimise dialoogi, mis võimaldab otsida teksti artiklite näitajas

F3 Redigeerimine Otsi järgmine

  Liigub alates kursori asukohast nimekirja pidi järgmisele otsingusõna (teksti või regulaaravaldise) esinemiskohale, mida sa artiklite näitajas parajasti otsid

#### Menüü Vaade

Vaade Vaaterežiim

  Võimaldab valida &akregator;i vaaterežiimi

&Ctrl;+ Vaade Suurenda fonti

  Suurendab fonti artiklite näitajas

&Ctrl;- Vaade Vähenda fonti

  Vähendab fonti artiklite näitajas

#### Menüü Liikumine

Nool vasakule Liikumine Eelmine artikkel

  Liigub artiklite nimekirja eelmisele artiklile

- Liikumine Eelmine lugemata artikkel

  Liigub artiklite nimekirja eelmisele lugemata artiklile

Nool paremale Liikumine Järgmine artikkel

  Liigub artiklite nimekirja järgmisele artiklile

+ Liikumine Järgmine lugemata artikkel

  Liigub artiklite nimekirja järgmisele lugemata artiklile

P Liikumine Eelmine kanal

  Liigub kanalite nimekirja eelmisele kanalile

&Alt;- Liikumine Eelmine lugemata kanal

  Liigub kanalite nimekirja eelmisele lugemata kanalile

N Liikumine Järgmine kanal

  Liigub kanalite nimekirja järgmisele kanalile

&Alt;+ Liikumine Järgmine lugemata kanal

  Liigub kanalite nimekirja järgmisele lugemata kanalile

#### Menüü Kanal

Insert Kanal Lisa kanal...

  Avab kanali lisamise dialoogi

&Shift;Insert Kanal Uus kataloog...

  Avab kataloogi lisamise dialoogi

&Ctrl;R Kanal Märgi kanal loetuks

  Märgib aktiivse kanali loetuks

&Ctrl; &Shift;R Kanal Märgi kõik kanalid loetuks

  Märgib kõik kanalid loetuks

F5 Kanal Tõmba kanal

  Tõmbab aktiivse kanali

&Ctrl;L Kanal Tõmba kõik kanalid

  Tõmbab kõik kanalid

Escape Kanal Loobu tõmbamisest

  Peatab &akregator;i kanalite tõmbamise

#### Menüü Artikkel

&Shift;Return Artikkel Ava uuel kaardil

  Avab aktiivse artikli &akregator;i kaardil

&Ctrl; &Shift;Return Artikkel Ava välises veebilehitsejas

  Avab aktiivse artikli välises brauseris

&Ctrl;I Artikkel Märgi artikkel tähtsaks

  Märgib aktiivse artikli tähtsaks

Artikkel Artikli märkimine

  Märgib aktiivse artikli loetud, uueks või lugemata artikliks

Delete Artikkel Kustuta

  Kustutab aktiivse artikli

Artikkel Saada viida aadress...

  Avab e-posti kliendi ja lisab kirjale lingi

Artikkel Saada fail...

  Avab e-posti kliendi ja lisab kirjale faili

#### Menüü Seadistused

Seadistused Tööriistaribad

  Lülitab tööriistaribade näitamist

Seadistused Olekuriba näitamine/peitmine

  Lülitab olekuriba näitamist

Seadistused Kiirfiltri näitamine

  Lülitab kiirfiltri näitamist Kiirfilter

  Kiirfilter
Seadistused Märguannete seadistamine...

  Avab märguannete seadistamise dialoogi

Seadistused &akregator;i seadistamine...

  Avab &akregator;i seadistustedialoogi

Seadistused Kiirklahvide seadistamine...

  Avab &kde; standardse kiirklahvide seadistamise dialoogi, kus saab valida erinevatele toimingutele kiirklahvid

Seadistused Tööriistaribade seadistamine...

  Võimaldab seadistada tööriistaribadel leiduvaid elemente

#### Menüü Abi

&help.menu.documentation;

## Autorid ja litsents

&akregator;

Rakenduse autoriõigus 2004-2006: Frank Osterfeld frank.osterfeld@kdemail.net

Dokumentatsiooni autoriõigus 2006: Frank Osterfeld frank.osterfeld@kdemail.net

Dokumentatsiooni autoriõigus 2006: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

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

&underFDL; &underGPL;

## Paigaldamine

### &akregator;i hankimine

&install.intro.documentation;

### Kompileerimine ja paigaldamine

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