Autoriõigus © 2001, 2002, 2003 Frerich Raabe
Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".
KNewsTicker on KDE paneeli (nimetatud ka Kickeriks) uudiste jälgimise aplett.
Sisukord
KNewsTicker on KDE paneeli (tuntud ka Kickeri nime all) aplett, mis võimaldab kiiresti ja mugavalt jälgida uudiseid päris paljudel uudistesaitidel (näiteks Slashdot, Linux® Weekly News, Freshmeat).
Selleks hangib KNewsTicker uudistesaidilt erilise RSS faili, mis sisaldab nii pealkirju kui viiteid vastavatele artiklitele endale. Sellised failid on tänapäeval üsna levinud ning KNewsTicker pakub juba omalt poolt välja päris korraliku valiku selliseid faile pakkuvatest uudisteallikatest.
RSS failid on muutunud aina populaarsemaks ning käesolev aplett ei ole kaugeltki esimene, mis neid kasutab. Aga mis üldse on RSS failid? Selles osas püüamegi sellele lühidalt vastata ning viidata mõningatele allikatele, kus leiab antud teema kohta täpsemat infot.
Lühidalt öeldes on RSS kompaktne XML-põhine infovahetusstandard, mille alusel saidid saavad üksteise uudiste pealkirju ja uudiseid vahetada.
Sageli arvatakse, et RSS on lühend, mis lahtimõtestatult tähendab Rich Site Summary ehk “rikkalik saidikokkuvõte”. Selline seletus ei ole küll üldlevinud, kuid see annab aimu, mida ilmselt RSS loojad silmas pidasid. Kuna tegelikult ei valitse üksmeelt, mida RSS tähendab, siis ei tuleks seda pidada lühendiks, vaid nimeks.
RSS sai alguse 1999. aastal, kui selle leiutas NetScape oma veebisaidi my.netscape.com sisu kompaktse edastamise vorminguna. Esimene ilmavalgust näinud RSS väljalase kandis numbrit 0.9. Mõni kuu hiljem üllitas Netscape® RSS versiooni 0.91, mis sisaldas ka hulganisti “<scriptingNews>” vormingu elemente.
RSS-failide põhimõte on pakkuda lihtne, selge ja porditav meetod veebisisu, eriti aga just uudiste levitamiseks: uudistesaidid pakuvad RSS-faili, mis koosneb põhimõtteliselt valikust kirjetest ning iga kirje sisaldab pealkirja ja täielikule artiklile viitavat URL-i. RSS-fail sisaldab ka muud üldist infot konkreetse uudistesaidi kohta, näiteks selle nime ja kodulehekülge, mida KNewsTicker samuti edastab.
Praeguseks on olemas mitu täiendavat ja täiendatud RSS vormingu versiooni (0.91, 0.92, 0.93, 1.0 ja praegune versioon 2.0), kuid esimesed kaks versiooni sisaldavad endiselt umbes 85% kõigist veebis pakutavatest failidest. Ometi suudab KNewsTicker käsitleda kõiki versioone kuni 2.0 välja!
Loomulikult oli eeltoodu vaid põgus ja äärmiselt ebatäielik katsetus anda elementaarne ülevaade RSS-failidest. Kui see teema sind rohkem huvitab, võid tutvuda järgmiste materjalidega, mis pakuvad märksa põhjalikumat ülevaadet ja selgitusi:
Väga pragmaatiline sissejuhatus RSS vormingusse konkreetsete näidete ja juhistega. Koos põhjalike spetsifikatsioonidega on see kindlasti hea teejuht inimestele, kes kaaluvad mõtet pakkuda RSS-faile ka oma koduleheküljelt.
O'Reilly RSS lehekülg pakub hulganisti üldisi artikleid RSS kasutamise kohta, viimaseid uudiseid RSS arendajatelt, samuti olulist infot veebiarendajatele, kes kavatsevad RSS-i kasutama hakata.
Ka see lehekülg kujutab endast suurepärast allikat RSS arendamist puudutavate uudiste kohta, mis peaks eriti pakkuma huvi neile arendajatele, kes töötavad RSS-põhise tehnoloogia kallal.
Ainus autoriteetne allikas RDF-i ehk XML-põhise keele kohta, millest on välja kasvanud RSS versioonid. Selle avaldajaks on World Wide Web Consortium. Siin on ära toodud ulatuslik valik viitu teistele teemakohastele saitidele, samuti RDF-i arendamise ajalugu, ülevaade selle arhitektuurist, RDF-i puudutavate artiklite arhiiv ning hoolikalt valitud tööriistade nimekiri arendajatele, kes kavatsevad RDF-i kasutada.
Arendajad võivad ka üle vaadata erinevate RSS versioonide spetsifikatsioonid:
RSS spetsifikatsioonid
Versioon 0.90: http://www.purplepages.ie/rss/netscape/rss0.90.html
Versioon 0.91: http://backend.userland.com/rss091
Versioon 0.92: http://backend.userland.com/rss092
Versioon 0.93: http://backend.userland.com/rss093
Versioon 1.0: http://web.resource.org/rss/1.0/
Versioon 2.0: http://backend.userland.com/rss
Kui leiad veel mingeid teemakohaseid saite või dokumente ja arvad, et neid võiks siin ära märkida, ära kõhkle, vaid saada need Frerich Raabele (raabe AT kde.org)
, et need oleks võimalik käesolevasse dokumenti lisada, kus nad saavad olla kõigile kasulikud.
Suured tänud juba ette! P.S. Eesti keeles on võimalik RSS kohta põhjalikumalt lugeda ning leida RSS faile pakkuvate uudisteallikate andmeid aadressil http://www.feedreader.com.
KNewsTickeri saab käivitada nagu iga muu Kickeri apleti: see tuleb vaid lisada paneelile (või alampaneelile). Selleks tee hiire parema nupuga klõps KDE paneelil ja vali ->->.
Teine võimalus on seada KNewsTicker omaette alampaneelile. Selleks lisa uus alampaneel paneelimenüü käsuga ->->. Seejärel klõpsa alampaneelil hiire parema nupuga ja lisa KNewsTicker, nagu eespool kirjeldatud.
Kolmas levinud viis KNewsTicker käivitada on valida K menüüst ->. See käivitab KNewsTickeri omaette aknas, mida saab soovikohaselt liigutada ja mille suurust on võimalik igati muuta.
KNewsTickeri seadistustedialoogi saab avada hiire parema klõpsuga keritavatel uudistel või klõpsates noolega nupul ning valides ilmuvast menüüst kirje .
Siin saab määrata, kui kiiresti teksti keritakse, kuidas see peaks välja nägema ning veel mitmeid apleti üldisi omadusi. Kirjeldame lühidalt, mis tähendus on selle kaardi igal elemendil:
Selle liuguri abil saab määrata teksti kerimise kiirust hiireratta kasutamisel.
Siin saab määrata, milliste ajavahemiku järel esitab KNewsTicker seadistatud uudisteallikatele päringu saada uusi pealkirju. Üldiselt sõltub see sellest, kui kiiresti soovid uudistest teada saada ja kui suure koormuse alla tahad oma võrgu panna:
Väiksem väärtus (vähem kui 15 minutit) võimaldab sul saada uudistest päris ruttu teada, kuid arvesta, et see suurendab märgatavalt võrguliiklust. Seepärast ei peaks madalaid väärtusi kasutama väga populaarsete uudistesaitide (näiteks Slashdot või Freshmeat) puhul, mis on niigi tugevasti koormatud kõigile sissetulevatele päringutele vastamisega.
Suurem väärtus (enam kui 45 minutit) ei võimalda sul just väga kiiresti uudistest teada saada, aga kui reaalajas töötamine ei ole omaette siht, ei tohiks see probleeme valmistada. Pikema ajavahe puhul on positiivne ka see, et nii on võrgukoormus suhteliselt väike, mis säästab nii sinu kui päringut saava uudistesaidi süsteemiadministraatori närve ja ressursse.
Enamasti peaks olema igati sobiv ja mõistlik vaikeväärtus (30 minutit).
Selle kasti märkimine sunnib uudistejälgija kasutama nime, mida oled määranud uudisteallikate nimekirjas (seda saab näha kaardil Uudisteallikad), mitte aga nime, mida uudisteallikas ise teatab. See võib olla üsna tulus selliste saitide korral, mis annavad teada väga pika või mõttetu nime.
Sellel kaardil saab hallata uudisteallikaid, millele KNewsTicker päringuid esitab. Klõps suvalisel kirjel hiire parema nupuga avab kontekstimenüü, mis võimaldab klõpsatud kirje eemaldada, seda muuta või lisada hoopis uue kirje. Kaardi allosas on kolm nuppu, mis lasevad teha samasuguseid asju.
Uut uudisteallikat saab nimekirja lisada neljal moel:
Klõpsuga kaardi allosas asuval nupul Lisa....
Hiire parema nupu klõpsuga nimekirjas ja kontekstimenüüst käsku valides.
Suvalise RSS faili võib lohistada nimekirja mõnest muust rakendusest (näiteks Konqueror). See lisab nimekirja uue kirje, märgib selle nimeks “Tundmatu” ja määrab maksimaalseks artiklite arvuks 10.
Lõpuks võib ka klõpsata suvaliselt RSS failil failihalduris Konqueror, et see lisataks kohe nimekirja.
Millist võimalust sa ka ei kasutaks, ilmub uudisteallika dialoog, mis võimaldab sisestada lisatava uudisteallika täpsed omadused.
Olemasolevat uudisteallikat saab muuta kahel moel:
Klõpsates dialoogi allosas asuval nupul Muuda....
Hiire parema nupu klõpsuga nimekirjas sellel uudisteallikal, mida soovid muuta, ja kontekstimenüüst käsku valides.
Millist võimalust sa ka ei kasutaks, ilmub uudisteallika dialoog, mis näitab valitud uudisteallika omadusi.
Mõnikord võib tekkida soov uudisteallikas nimekirjast eemaldada. Seda saab teha kahel moel:
Klõpsates dialoogi allosas asuvale nupule Eemalda.
Klõpsates hiire parema nupuga uudisteallika nimel nimekirjas ja valides kontekstimenüüst käsu .
Mõlemal juhul ilmub dialoog, mis küsib, kas sa tõesti soovid just seda uudisteallikat eemaldada.
Võimalik on eemaldada ka mitu uudisteallikat korraga, kui hoida all klahvi Ctrl ja klõpsata kirjetel, mida soovid eemaldada, või klõpsata hiire nupuga ja lohistada hiirt üle kirjete, mida soovid eemaldada.
Uudisteallikat lisades või muutes ilmub uudisteallika dialoog (nagu ülaltoodud pildil), mis pakub võimaluse muuta uudisteallika mitmesuguseid omadusi:
Uudisteallika nimi.
Seda teksti kasutatakse ainult juhul, kui kaardil Üldine on lubatud võimalus Sisestatud nimede kasutamine uudistesaitidel.
Siin saab määrata URL-i, mis osutab uudiste allika RSS failile. See võib olla nii kohalik kui ka võrguserveril asuv fail. Samuti võib klõpsata paremal asuvale nupule, mis avab mugava faili valimise dialoog, kus saab URL-i käsitsi sisestamise asemel vajaliku faili ise valida.
Selle märkimisel ei pea KNewsTicker URL-i (mis on määratud väljal Lähtefail) mitte viiteks RSS-failile, vaid rakendusele (tavaliselt skriptile) viitavaks URL-iks. Antud uudisteallikale päringut esitades käivitab KNewsTicker rakenduse ning käsitleb kogu selle standardväljundit RSS-ina. See on üsna mugav võimalus pruukida teisendusskripte, mis laadivad alla HTML-faili ja töötlevad seda, andes tulemuseks RSS-i, millest KNewsTicker suudab aru saada.
Mõningaid skripte, mis nt. laadivad alla börsiandmeid, leiab moodulis kdeaddons kataloogis knewsticker-scripts
.
Siin saab määrata, millisesse kategooriasse uudisteallikas kuulub. Uudisteallikate jagamine kategooriatesse muudab palju hõlpsamaks arvukate allikate nimekirja haldamise.
Siin saab määrata, mitu artiklit jätab KNewsTicker antud uudisteallika puhul vahemällu. Seda väärtust ei ületata kunagi.
See on eriti mugav uudistesaitide puhul, mis pakuvad korraga ainult kolm uudist, kuid sina soovid näha näiteks viimast kümmet. Sellisel juhul tõmbab KNewsTicker alla kolm kirjet ning liidab need nimekirjaga, kus on juba ees vahemälus paiknevad seitse eelmist kirjet.
Siin saab määrata pildifaili (eelistatavalt suurusega 16x16 pikselit) URL-i, mida kasutatakse antud uudisteallika puhul. Ikoonide abil on märksa lihtsam eristada erinevaid uudistesaite ja näha, millise saidi pealkiri parajasti KNewsTickeris end ette kerib.
Allosas on harjumuspärased nupud, millest üks väärib siiski erilist tähelepanu: klõps nupul Soovita sunnib KNewsTickeri pakkuma enamikule väljadele tõenäoliselt parimaid väärtusi, kui oled määranud sobiliku lähtefaili URL-i.
See tähendab, et enamasti piisab lihtsalt RSS-failile viitava URL-i asetamisest väljale Lähtefail. Kui nüüd klõpsata nupul Soovita, ilmuvad ülejäänud väljadele väärtused, mida saab vajaduse korral muuta.
Sellel kaardil saab määrata filtreid, mida rakendatakse enne seda, kui pealkirjad hakkavad üle ekraani kulgema.
Filtrid puudutavad ainult keritavas tekstis näidatavaid pealkirju, menüüs on alati näha kõik pealkirjad.
Suurema osa kaardist hõlmab kast, kus on üles loetud kõik parajasti seadistatud filtrid. Iga filtri ees on väike märkekastike, mille märkimine rakendab filtri ja märke eemaldamine keelab ajutiselt filtri rakendamise, jättes selle samas nimekirjast eemaldamata.
Vaikimisi filtreid ei kasutata, nii et tõenäoliselt on suur kast täiesti tühi. Mõistagi pakub dialoog võimaluse uusi filtreid lisada ja neid ka hallata:
Filtri lisamiseks sisesta selle omadused (üksikasjaliku kirjelduse filtri erinevatest omadustest leiab osast Filtri komponendid) kastidesse sektsioonis Filtri omadused ja klõpsa nuppu Lisa.
Olemasoleva filtri muutmiseks vali filter, mida soovid muuta, tehes sellel nimekirjas klõpsu hiire vasaku nupuga, ja seejärel muuda selle omadusi allasuvas sektsioonis.
Filtri eemaldamiseks vali see nimekirjast ja klõpsa nuppu Eemalda.
Iga filter koosneb neljast komponendist:
Filtri komponendid
Tegevus – see võib olla kas Näita või Ära näita ning see määrab, mis juhtub pealkirjaga juhul, kui filter sobib.
Uudisteallikas – siin saab määrata, kas filter mõjutab ainult konkreetset uudisteallikat või tuleb seda rakendada kõigi uudisteallikate pealkirjade puhul.
Tingimus – see määrab koos võtmesõna või avaldisega, kas filter sobib või mitte. Tingimus võib olla nt. sisaldab, ei võrdu või vastab. Täpsemalt on sellest juttu edaspidi.
Võtmesõna/Avaldis - kasutaja määratud string, mis koos tingimusega kujutab endast filtri põhielementi. Täpsemalt on seda komponenti kirjeldatud edaspidi.
Kõiki komponente saab seadistada sektsioonis Filtri omadused. Tingimuse võimalikud väärtused väärivad lähemat selgitamist:
sisaldab, ei sisalda: filter sobib siis, kui pealkirjas leidub/ei leidu vastav võtmesõna/avaldis.
See ei ole tõstutundlik, nii et võtmesõnad “KDE”, “kDE” või “kde” sobivad kõigile pealkirjadele, milles leidub “KDE”.
võrdub, ei võrdu: filter sobib siis, kui pealkirjas on/ei ole täpselt määratud võtmesõna/avaldis.
See on tõstutundlik, nii et avaldiste “Linux”, “linux” ja “LINUX” puhul sobib pealkirjas leiduvale “Linux” ainult esimene.
vastab: selle tingimuse kasutamine paneb KNewsTickeri määratud võtmesõna/avaldist käsitlema “regulaaravaldisena”. Regulaaravaldistest räägib lähemalt see artikkel, mille leiab saidilt www.evolt.org.
Sellel kaardil saab määrata asju, mis mõjutavad KNewsTickeri teksti kerimist:
Selle liuguriga saab määrata, kui kiiresti teksti keritakse. Kui tegumiribal on üsna vähe ruumi (ja seepärast ka Uudistejälgija aken üpris tilluke), oleks võib-olla mõttekas määrata väiksem kiirus, et jõuaks ikka pealkirja läbi lugeda. Suurema ruumi (ja paremate silmade) korral on pigem soovitatav kiirust suurendada, et ei peaks liiga kaua ootama uute pealkirjade nägemist.
Nende võimalustega saab määrata, millises suunas tuleb teksti kerida, nt. paremalt vasakule või vasakult paremale, ülevalt alla või alt üles. Samuti saab siin lasta teksti 90 või 270 kraadi võrra keerata, mis ei ole just väga hästi loetav, kuid võib tulla kasuks vertikaalse paneeli korral.
Klõpsuga paremal asuval nupul Vali font... saab valida fondi, mida kasutatakse keritava teksti näitamisel.
Mõned fondid on halvemini loetavad, eriti kui neid kasutatakse keritavas tekstis, nii et siin oleks mõttekas valida font, mida on hõlpus lugeda isegi siis, kui tekst liigub.
Klõps sellel nupul avab mugava värvi valimise dialoogi, kus saab valida värvi, mida kasutatakse keritava teksti esiplaanil (st. teksti enda värv).
Klõps sellel nupul avab mugava värvi valimise dialoogi, kus saab valida värvi, mida kasutatakse keritava teksti taustal.
Klõps sellel nupul avab mugava värvi valimise dialoogi, kus saab valida värvi, mida kasutatakse pealkirjade puhul siis, kui need on esile tõstetud (siis, kui hiirekursor on pealkirja kohale viidud).
Selle märkimine sunnib keritavas tekstis näitama iga uudisteallika puhul ainult kõige uuemat pealkirja tavalise kõigi pealkirjade näitamise asemel.
Selle kasti märkimine sunnib KNewsTickeri näitama iga keritava pealkirja ees ikooni (kui see on olemas). Nii on võimalik märksa hõlpsamalt määrata, millisele uudistesaidile mingi pealkiri kuulub.
Selle kasti märkimine sunnib KNewsTickeri kerimist aeglustama, kui viid hiirekursori keritava teksti kohale. See muudab kirjetel klõpsamise ja ikoonide äralohistamise (kui see on lubatud) märksa hõlpsamaks.
Selle kasti märkimisel joonitakse alla parajasti esiletõstetud pealkiri (st. pealkiri, mis parajasti asub hiirekursori all).
KNewsTickeri kasutamine on üsna lihtne ega peaks tekitama erilisi probleeme, seda muidugi eeldusel, et rakendus on seadistatud. Pole vahet, kas KNewsTicker töötab põhipaneelil, alampaneelil või omaette aknas - igal juhul on tegemist alaga, kus jookseb keritav tekst, ning selle kõrval asuva väikese noolt kujutava nupuga.
Ala keritava tekstiga (vaikimisi on see valge, kuid seadistustedialoogis saab taustavärvi hõlpsasti muuta) nimetatakse “uudistekerijaks”. Sellel keritakse järjepidevalt alla tõmmatud pealkirju (või ainult kõige viimaseid pealkirju) ning siit saab hõlpsasti ligi ka artiklitele endale. Kui märkad huvitavat artiklit, klõpsa sellel ning see avaneb veebilehitsejas Konqueror, kus saab lugeda kogu seda artiklit, mille pealkirja kerijas näidati. Kui arvad, et huvitav pealkiri vilksatas just äsja mööda, saab kerimist mitmel moel mõjutada:
Uudistekerijal võib klõpsata hiire
nupuga ja hiirega vajalikku kohta liikuda (samal ajal hiire nuppu jätkuvalt all hoides). Uudistekerija asub taas teksti kerima niipea, kui oled hiire vasaku nupu lahti lasknud.Kui sul on niinimetatud “ratashiir”, saad hiirerattaga pealkirju edasi-tagasi kerida.
Lisaks sellele on olemas ka väga võimas kontekstimenüü, millele pääseb ligi uudistekerijas kas hiire nupuga klõpsates või hiire nupuga noolekesega nupul klõpsates. Kontekstimenüü on küllap kõige huvipakkuvam apleti osa, sest selles peitub omamoodi kogu rakendus.
Kontekstimenüü jaguneb funktsionaalselt kaheks osaks:
Ülemises osas on valik kirjeid, igaühe kõrval umbes selline väike ikoon. See nimekiri näitab kõiki parajasti seadistatud uudistesaite. Mõnel meist klõpsates avaneb alammenüü, mis näitab antud uudistesaidi pealkirju ning kirjet
Uudiste kontrollimine, mis uuendab antud uudistesaidi pealkirju. Iga pealkirja juures on ikoon
, kui sa oled seda uudist juba lugenud, või
, kui uudist ei ole loetud.
Alumises osas on praegu viis kirjet (ülalt alla):
Selle kirje kõrval on väike ikoon . Kui soovid anda KNewsTickerile käsu kontrollida seadistatud uudistesaitidel uute artiklite olemasolu, klõpsa sellele kirjele.
See ei mõjuta sisemist taimerit, mis esitab uudistesaitidele uusi pealkirju otsiva päringu automaatselt teatud kindla ajavahemiku tagant.
Selle kirje juures omaette ikooni ei ole. Sellele klõpsamine rakendab erilise “võrguühenduseta” režiimi, mis peatab uudistesaitidele päringuid esitava sisemise taimeri ning väldib uute pealkirjade automaatset allatõmbamist. Võrguta režiim on kasulik juhul, kui pead arvuti juurest mõneks ajaks lahkuma, või kui arvuti ei ole ühendatud internetti, säästes sind arvukatest veateadetest, mis tekivad, kui mõne uudistesaidiga ei saada ühendust.
Ka selle režiimi korral on võimalik laadida konkreetse uudistesaidi või ka kõigi saitide pealkirjad, kui kasutada vastavat kirjet Uudiste kontrollimine.
Seda kirjet tähistab väike ikoon . Sellele klõpsates avaneb KNewsTickeri dokumentatsioon (ehk käsiraamat, mida sa praegu loed), mis selgitab põhjalikult KNewsTickeri kõiki võimalusi.
Seda kirjet tähistab väike ikoon . Sellele klõpsates avaneb väike dialoog, mis näitab, keda süüdistada KNewsTickeri väljamõtlemise eest ning kes on selle arendamisse suure panuse andnud.
Selle kirje tunneb hõlpsasti ära ikooni järgi. Sellel klõpsamine avab seadistustedialoogi, kus saab kohandada kõiki KNewsTickeri võimalusi.
5.1. | Kust leida uudistesaidi XYZ RSS fail? |
On täitsa võimalik, et sind huvitav uudistesait ei pakugi RSS faili! Igatahes toome siin ära mõned veebileheküljed, mis pakuvad tuhandeid RSS allikaid täiesti tasuta, sorteerituna keele ja/või teema järgi: Kui leiad mõne sellist võimalust pakkuva huvitava uudistesaidi, ära kõhkle seda saatmast Frerich Raabele | |
5.2. | Kuidas panna KNewsTicker artikleid avama mõnes muus veebilehitsejas (nt. Mozillas)? |
KNewsTicker kasutab just seda veebilehitsejat, mis on sinu arvutis seotud MIME tüübiga text/html - vaikimisi on aga KDE-s HTML-lehekülgede vaatamiseks mõeldud just Konqueror. Dialoogi, kus seda seost muuta saab, leiab KDE juhtimiskeskuses, kui valida seal ->. |
KNewsTicker
Rakenduse autoriõigus 2000, 2001, 2002, 2003: Frerich Raabe (raabe AT kde.org)
Kaasautorid:
Malte Starostik (malte.starostik AT t-online.de)
Wilco Greven (greven AT kde.org)
Adriaan de Groot (adrig AT sci.kun.nl)
Dokumentatsiooni autoriõigus 2001, 2002, 2003: Frerich Raabe (raabe AT kde.org)
Tõlge eesti keelde: Marek Laane (bald AT online.ee)
Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.
Käesolev programm on litsenseeritud vastavalt BSD litsentsi tingimustele.
Selles peatükis selgitatakse mitmesuguseid lühendeid, mida KNewsTickeri dokumentatsioonis ohtralt kasutatakse. Kui arvad, et mõni lühend või mõiste on siit puudu, anna sellest palun teada Frerich Raabele (raabe AT kde.org)
, et see oleks võimalik lisada. Tänan juba ette!
Ressursside kirjeldamise raamistik (inglise keeles Resource Description Framework). XML-ist arenenud keel, mis kirjeldab metaandmeid. Tavaliselt kasutatakse artiklite ja muude publikatsioonide taustavorminguna. Täpsemat infot RDF-failide kohta leiab RDF-failide ametlikul koduleheküljel, mida haldab World Wide Web Consortium.
RDF saidi kokkuvõte on tegelikult RDF keele laiendus. Kui tsiteerida ametlikku RSS v1.0 spetsifikatsiooni:
“RDF saidi kokkuvõte (RSS) on lihtne mitmeotstarbeline laiendatav metaandmete kirjeldamise ja avaldamise vorming. RSS on XML-rakendus, vastab W3C RDF spetsifikatsioonile ning on laiendatav XML-nimeruumi ja/või RDF-põhise modulariseerimise kaudu.”
Laiendatav märkekeel on “struktureeritud dokumentide ja andmete veebis esitamise universaalne vorming”. See tuleneb SGML-ist, mis sobib veebivajadustega. Täpsemat infot leiab XML-i koduleheküljel, mida haldab World Wide Web Consortium.
Lühend sõnadest “World Wide Web Consortium”. Kui tsiteerida W3C ametlikku kodulehekülge, “arendab World Wide Web Consortium (W3C) ühilduvaid tehnoloogiaid (spetsifikatsioonid, juhised, tarkvara, abivahendid), mis võimaldavad veebil väljendada kogu oma jõudu informatsiooni, kaubanduse, suhtluse ja kollektiivse üksteisemõistmise foorumina”.
URL tähendab “üldine ressursiaadress” (inglise keeles Uniform Resource Locator) ning kujutab endast eriliselt vormindatud stringi, mis võib viidata sellistele internetis paiknevatele ressurssidele, nagu pildid, dokumendid ja nii edasi. Täpsemat infot selle kohta leiab vastavalt veebileheküljelt.
Töölaua suhtlusprotokoll (inglise keeles Desktop COmmunication Protocol) võimaldab rakendustel omavahel suhelda. Nii kasutab KNewsTickeri seadistustedialoog DCOP-i, et anda apletile teada parajasti kehtivast seadistusest.
KNewsTicker pakub laialdast DCOP-liidest, mis võimaldab juhtida paljusid KNewsTickeri funktsioone käsurealt.
Täpsemat infot DCOP-i kohta leiab aadressilt http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html.
Sisukord
KNewsTicker pakub praegu üsna laialdast ja aina laienevat DCOP-liidest. Seda ei kasutata mitte ainult suhtlemiseks teiste rakendustega, vaid see võimaldab ka juhtida KNewsTickerit shelliskriptiga. Mida avaram liides on, seda kasulikum ta on ja seda paindlikumalt saab ka KNewsTicker skriptiga juhtida.
DCOP-i funktsioonide kasutamiseks tuleb tarvitada käsurearakendust dcop või tublisti mugavamat rakendust KDCOP. Mõlema võimalused on ühesugused, nii et valik sõltub vaid sinu enda eelistusest. :-)
Selles peatükis eeldatakse, et kasutad käsurearakendust dcop. KNewsTickeri DCOP-funktsioonide kasutamiseks kontrolli, et KNewsTicker on käivitatud ja kirjuta konsoolile midagi sellist:
%
dcop
knewsticker
KNewsTicker
[funktsioon]
Kui ilmub veateade, mis ütleb, et dcop
jäi leidmata või seda ei õnnestunud käivitada, kontrolli, kas fail dcop
on ikka kataloogis $
ja kas selle loabitid on korrektselt seatud.KDEDIR
/bin
Võti “[funktsioon]” asenda käsureal vastava funktsiooni nimega, st. kirjuta
%
dcop
knewsticker
KNewsTicker
updateNews
et KNewsTicker kontrolliks uute artiklite olemasolu ja vajadusel need alla tõmbaks.
Selles osas kirjeldatakse kõiki meetodeid, mida saab kasutada KNewsTickeri DCOP -liidese vahendusel.
See funktsioon sunnib KNewsTickeri uuendama oma sisemist artiklite nimekirja (st. ta esitab seadistatud uudiste allikatele päringu uute artiklite sooviga) ja vajadusel uued artiklid alla tõmbama.
See toimib ka siis, kui KNewsTicker on parajasti võrguta režiimis.
Näide:
%
dcop
knewsticker
KNewsTicker
updateNews
Käsk reparseConfig sunnib KNewsTickeri oma seadistuse konfiguratsioonifailist uuesti laadima. Seda funktsiooni kasutab seadistustedialoog KNewsTickerile vastava korralduse andmiseks, kuid seda võib kasutada ka siis, kui oled konfiguratsioonifaili käsitsi muutnud.
Konfiguratsioonifail on salvestatud ~/.kde/share/config/knewsticker_appletrc
Näide:
%
dcop
knewsticker
KNewsTicker
reparseConfig
Selle funktsiooni väljakutsumisega saab määrata, kas KNewsTicker on parajasti võrguta režiimis (st. kas KNewsTicker esitab päringuid seadistatud uudistesaitidele uute artiklite kohta).
Näide:
%
dcop
knewsticker
KNewsTicker
setOfflineMode
true
võrguta režiimi lubamiseks või
%
dcop
knewsticker
KNewsTicker
setOfflineMode
false
võrguta režiimi keelamiseks.
Tagastab parajasti kehtiva uudiste päringu intervalli minutites.
Näide:
%
dcop
30knewsticker
KNewsTicker
interval
%
Tagastab parajasti kehtiva kerimiskiiruse. Kerimiskiirust määratakse pikslites sekundi kohta.
Näide:
%
dcop
20knewsticker
KNewsTicker
scrollingSpeed
%
Tagastab pikslite arvu, mille võrra keritavat teksti liigutatakse hiireratta ühe liigutuse kohta.
Näide:
%
dcop
15knewsticker
KNewsTicker
mouseWheelSpeed
%
Tagastab täisarvu, mis vastab teksti kerimise suunale:
1 = vasakule
2 = paremale
3 = üles
4 = alla
5 = üles, pööratult
6 = alla, pööratult
Näide:
%
dcop
1knewsticker
KNewsTicker
scrollingDirection
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTicker kasutab uudistesaitide jaoks sisestatud nimesid või mitte.
Näide:
%
dcop
falseknewsticker
KNewsTicker
customNames
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTickeril on katkematu kerimine lubatud või mitte.
Näide:
%
dcop
trueknewsticker
KNewsTicker
endlessScrolling
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTicker kerib parajasti ainult iga uudistesaidi uusimaid pealkirju või mitte.
Näide:
%
dcop
falseknewsticker
KNewsTicker
scrollMostRecentOnly
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTicker on parajasti võrguta režiimis või mitte.
Näide:
%
dcop
falseknewsticker
KNewsTicker
offlineMode
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTickerile on parajasti antud korraldus joonida alla pealkirjad, mis asuvad hiirekursori all, või mitte.
Näide:
%
dcop
trueknewsticker
KNewsTicker
underlineHighlighted
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTicker näitab parajasti uudistesaidi ikooni iga keritava pealkirja ees või mitte.
Näide:
%
dcop
trueknewsticker
KNewsTicker
showIcons
%
Tagastab 'true' või 'false' vastavalt sellele, kas KNewsTickeril on “aeglustatud kerimise” võimalus sisse lülitatud või mitte.
Näide:
%
dcop
falseknewsticker
KNewsTicker
slowedScrolling
%
Tagastab parajasti kehtiva esiplaani värvi vormingus “#rrggbb”, kus “rr”, “gg” ja “bb” on kahenumbrilised 16-ndväärtused vastavalt punase (red), rohelise (green) ja sinise (blue) komponentidele 00-ff skaalal.
Näide:
%
dcop
#804000knewsticker
KNewsTicker
foregroundColor
%
Tagastab parajasti kehtiva taustavärvi vormingus “#rrggbb”, kus “rr”, “gg” ja “bb” on kahenumbrilised 16-ndväärtused vastavalt punase (red), rohelise (green) ja sinise (blue) komponentidele 00-ff skaalal.
Näide:
%
dcop
#0030ffknewsticker
KNewsTicker
backgroundColor
%
Tagastab parajasti kehtiva esiletõstmise värvi vormingus “#rrggbb”, kus “rr”, “gg” ja “bb” on kahenumbrilised 16-ndväärtused vastavalt punase (red), rohelise (green) ja sinise (blue) komponentidele 00-ff skaalal.
Näide:
%
dcop
#000080knewsticker
KNewsTicker
highlightedColor
%
Tagastab parajasti registreeritud uudisteallikate nimekirja. Arvesta, et tagastatakse kõik uudisteallikad, mitte ainult näitamiseks valitud. Väljundis on iga uudisteallika nimi esitatud ühel real.
Näide:
%
dcop
Freshmeat GNOME News dot.kde.org Slashdot.orgknewsticker
KNewsTicker
newsSources
%
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team