Ophavsret © 2001, 2002, 2003 Frerich Raabe
Tilladelse er hermed givet til at kopiere, videregive og/eller ændre dette dokument under betingelserne i GNU's Fri Dokumentation License, Version 1.1 eller en vilkårlig senere version publiceret af Free Software Foundation; uden invariante afsnit, uden tekster før omslaget, og uden tekster efter omslaget. En kopi af licensen er inkluderet i afsnittet ved navn " Medvirkende og licens".
Nyhedstelegrafen er et program til at overvåge nyheder i KDE's panel (også kendt som Kicker).
Indholdsfortegnelse
Nyhedstelegrafen er et program for KDE's panel (også kendt som Kicker) som giver en let og bekvem måde at komme til nyhederne som rapporteres af mange nyhedskilder (såsom Danmarks Radio, TV2, Information, Slashdot, Linux® Weekly News eller Freshmeat).
For at gøre dette, kræver nyhedstelegrafen at nyhedskilderne sørger for en speciel RSS-fil, som indeholder overskrifter og peger på tilsvarende fuldstændige artikler. Sådanne filer er meget almindelige nu om dage, og nyhedstelegrafen levereres med en opsætning med gode nyhedskilder som sørger for sådanne filer.
RSS-filer bliver mere og mere populære for tiden, og dette program er ikke det første program som drager nytte af dem. Men hvad er RSS-filer? Dette afsnit forsøger at give et kortfattet svar på dette spørgsmål, samt pege på andre kilder med yderligere information.
Et kort svar: RSS er et XML-baseret format for distribution af internet-indhold.
RSS bruges ofte med betydningen “Rich Site Summary” (Indholdsrig opsummering af sted): – det er ikke en almindelig definition, men giver en idé om hvad forfatterne til RSS tænkte sig. Der er ikke enighed om betydningen af RSS, så det er i virkeligheden ikke en forkortelse, men et navn.
RSS oprettedes i 1999, det blev opfundet af Netscape som et distributionsformat for deres hjemmeside my.netscape.com. Den allerførste udgave af RSS var version 0.9. Nogle måneder senere, introducerede Netscape® RSS version 0.9.1, som indeholdt mange funktioner fra formatet “<scriptingNews>”.
Det grundlæggende begreb for alle RSS-filer, er at sørge for en ren, enkel og flytbar måde at distribuere net-indhold, i særdeleshed nyheder: Nyhedskilderne sørger for en RSS-fil, som i egentlig blot indeholder et antal poster, hvor hver post består af en overskrift og en net-adresse som peger på den fuldstændige artikel. RSS-filen indeholder også anden almen information om netop denne nyhedskilde, såsom dens navn og hjemmeside, som evalueres af nyhedstelegrafen.
Nu om dage er der nogle yderligere, mere sofistikerede udgaver af RSS-formatet (0.91, 0.92, 0.93, 1.0 og den nuværende formatversion 2.0) men de to første versioner udgør stadigvæk omkring 85 % af filerne som håndteres på nettet. Ikke desto mindre, kan alle versioner til og med 2.0 håndteres af nyhedstelegrafen!
Dette er naturligvis kun et kort og meget ufuldstændigt forsøg på at forklare de grundlæggende ideer bag RSS-filer. Hvis du er interesseret i dette emne, vil du måske følge nogen af følgende link som peger på yderligere, mere komplette, informationskilder.
En meget pragmatisk introduktion til RSS-formatet, med konkrete eksempler og retningslinjer. Sammen med de autoritative specifikationer, er den en god vejledning for de som overvejer at sørge for en RSS-baseret nyhedskilde på deres hjemmeside.
RSS-siden fra O'Reilly præsenterer mange almene artikler om at udnytte og bruge RSS-filer, aktuelle nyheder om RSS-udviklingssamfundet, samt væsentlig information for internet-udviklere som overvejer at drage nytte af RSS.
Denne side er yderligere en udmærket kilde til nyheder om RSS-udviklingen, som er særlig interessant for udviklere som arbejder med RSS-baseret teknologi.
Den autoritative kilde om RDF, et XML-baseret sprog, som er ophav til moderne RSS-versioner, publiceret af World Wide Web konsortiet. Den sørger for en fuldstændig liste med link til andre steder om emnet, samt en tidsplan over RDF-udviklingen, en oversigt over arkitekturen, et arkiv med artikler om RDF samt en nøjagtigt sammenstillet liste over værktøj for udviklere som har til hensigt at arbejde med RDF.
Udviklere bør også kontrollere de autoritative specifikationer for de forskellige RSS-versioner:
RSS-specifikationer
Version 0.90: http://www.purplepages.ie/rss/netscape/rss0.90.html
Version 0.91: http://backend.userland.com/rss091
Version 0.92: http://backend.userland.com/rss092
Version 0.93: http://backend.userland.com/rss093
Version 1.0: http://web.resource.org/rss/1.0/
Version 2.0: http://backend.userland.com/rss
Hvis du finder nogle andre steder eller dokumenter om dette emne, og synes at de er værd at nævnes her, så tøv ikke med at sende dem til Frerich Raabe (raabe AT kde.org)
, så de kan indsættes i dette dokument og være til hjælp for alle.
Mange tak!
Nyhedstelegrafen startes som ethvert andet Kicker-program, du skal blot tilføje det til panelet (eller et af hovedpanelets underpaneler). For at gøre dette, højreklikkes på KDE's panel, og så vælges ->->.
En anden god måde at bruge nyhedstelegrafen på, er at starte den i sit eget underpanel. Tilføj blot et nyt underpanel ved at vælge ->-> i panelmenuen. Nu kan du højreklikke på underpanelet og vælge nyhedstelegrafen, følgende beskrivelsen ovenfor.
En tredje, populær, måde at starte nyhedstelegrafen på, er at vælge KNewsTicker ->-> i K-menuen. Så startes nyhedstelegrafen og køres i et eget vindue, som du derefter kan ændre størrelse på eller flytte omkring som du vil.
Du kan komme til nyhedstelegrafens indstillingsdialog ved at klikke med højre museknap på den rullende tekst, eller ved at klikke på knappen med pilen og vælge punktet som hedder i menuen.
Her kan du angive hvordan hurtigt teksten skal rulles, hvordan den skal se ud samt andre valgmuligheder for programmet. Her er en oversigt over hvad hver af knapperne i dette faneblad gør:
Denne skyder lader dig definere hvor hurtigt/langsomt teksten skal rulle når du bruger musehjulet.
Her kan du definere i hvilke intervaller nyhedstelegrafen sender en forespørgsel efter nye overskrifter til de indstillede nyhedskilder. Det her afhænger i almindelighed af hvor hurtigt du vil have dine nyheder og hvor meget du vil belaste netværket:
En lavere værdi (lavere end 15 minutter) gør det muligt at få meddelelser om nyheder vældig hurtigt hvis du vil det eller behøver det. Bemærk dog at det øger netværkstrafikken væsentligt. Derfor bør så lave værdier ikke bruges hvis du bruger populære nyhedskilder (såsom Slashdot eller Freshmeat) eftersom de i almindelighed allerede har nok at gøre med at håndtere indkommende forespørgsler.
En højere værdi (højere end 45 minutter) lader dig ikke få dine nyheder så hurtigt. For ikke tidskritiske anvendelser, burde dette dog være passende. Det positive aspekt ved længere intervaller er at netværket udsættes for en meget lille belastning; dette sparer ressourcer og beroliger nerverne hos dig og systemadministratorerne på nyhedskilderne du bruger.
Standardværdien (30 minutter) burde være passende og rimeligt i de fleste tilfælde.
Markér dette felt for at nyhedstelegrafen skal bruge de navne som du angav i listen med nyhedskilder (tilgængelig i fanebladet med navnet Nyhedskilder) i stedet for de navne som nyhedskilderne selv rapporterer. Dette kan være praktisk for nyhedskilder som rapporterer meget lange eller unyttige navne.
I dette faneblad kan du håndtere listen med nyhedskilder som nyhedstelegrafen spørger efter nyheder. Klik på hvilken som helst post med højre museknap for at åbne en sammenhængsafhængig menu, som lader dig fjerne denne post, eller tilføje en ny post. Længst nede på siden er der også knapper som har samme effekt.
Der er fire måder at tilføje et nyt sted i listen:
Du kan klikke på knappen længst nede som hedder Tilføj....
Du kan klikke med højre museknap på tabellen og vælge .
Du kan trække hvilken som helst RSS-fil fra et andet program (såsom Konqueror) til tabellen. Da tilføjes en ny post til i listen, navnet sættes til “Ukendt” og det maksimale antal artikler sættes til 10.
Til sidst, så kan du klikke på hvilken som helst RSS-fil i Konquerors filhåndtering, for at tilføje den til listen med det samme.
Alle måder gør at dialogen for nyhedskilder vises, hvor der er en formular til at indtaste egenskaberne for nyhedskilden som skal tilføjes.
Der er to måder at justere egenskaberne for en eksisterende nyhedskilde:
Du kan klikke på knappen længst nede som hedder Ændr....
Du kan klikke med højre museknap på nyhedskilden som du vil redigere, og vælge i menuen.
Uafhængig af hvilken måde du vælger, så vises dialogen for nyhedskilder, som angiver egenskaberne for den markerede nyhedskilde.
Du vil naturligtvis sommetider fjerne en nyhedskilde fra listen. For at opnå dette, er der to ting du kan gøre:
klikke på knappen længst nede som hedder Fjern,
klikke med højre museknap på nyhedskilden som du vil fjerne, og vælge i menuen.
I begge tilfælde vises et felt til at bekræfte handlingen, og sikre at du ikke valgte den forkerte indgang.
Du kan også fjerne flere nyhedskilder på en gang, ved at holde Ctrl nede, mens du klikker på indgangene som du vil fjerne, eller ved at klikke med museknap, og trække musen over alle indgange du vil markere.
Når en nyhedskilde tilføjes eller ændres, dukker dialogen for nyhedskilder op (som vises ovenfor), og sørger for indtastningsmuligheder for at redigere de forskellige egenskaber for en nyhedskilde:
Dette er nyhedskildens navn.
Denne tekst bruges kun hvis Eget navn for nyhedskilder i fanebladet som hedder Generelt aktiveres.
Her kan du angive en URL som refererer til nyhedsstedets RSS-fil. Dette kan enten være en lokal fil, eller en fil som gemmes på en anden server. Du kan også klikke på knappen til højre for at åbne en bekvem filvalgsdialog og bladre hen til filen som du vil bruge, i stedet for at indtaste en URL i hånden.
Hvis dette afkrydset, antager nyhedstelegrafen ikke at den URL (som angives i feltet Kildefil) refererer til en RSS-fil, men i stedet at den refererer til et program (oftest et script). Ved en forespørgsel til nyhedskilden kører nyhedstelegrafen programmet og behandler det som programmet skriver ud på standardudskriften som RSS-data. Dette er meget bekvemt for konverteringsscripter som henter en HTML-fil og behandler den, hvilket skaber RSS-data som det er muligt at bruge med nyhedstelegrafen.
Du finder nogle scripter som f.eks. henter aktiekurser i kdeaddons-pakken, under mappen knewsticker-scripts
.
Her kan du angive hvilken kategori nyhedskilden tilhører. At arrangere nyhedskilder i kategorier gør det meget lettere at håndtere store lister med nyhedskilder.
Dette punkt lader dig angive hvor mange artikler nyhedstelegrafen gemmer fra nyhedskilden. Denne værdi overskrides aldrig.
Dette er særlig praktisk for nyhedskilder som kun sørger for tre punkter af gangen, men du vil (for eksempel) se de ti seneste. Nyhedstelegrafen henter tre punkter og tilføjer dem til listen, og gemmer de syv sidste punkter.
Her kan du angive en URL for en billedfil (helst 16x16 billedpunkter stor), som skal bruges for nyhedskilden. Ikoner gør det meget lettere at adskille flere nyhedskilder, og se hvilken nyhedskilde en overskrift kommer fra når den ruller forbi i nyhedstelegrafen.
Længst nede finder du de almindelige knapper. En af dem fortjener at nævnes særligt: Ved at klikke på knappen Foreslå forsøger nyhedstelegrafen at gætte passende værdier for de fleste felter hvis du angiver en URL til en gyldig kildefil.
Det betyder at du oftest blot kan indsætte en URL til en RSS-fil i indtastningsfeltet som hedder Kildefil, trykke på knappen Foreslå, og derefter ændre de foreslagne værdier efter behov.
Dette faneblad lader dig definere diverse filtre, som skal bruges inden overskrifter vises i den rullende tekst.
Disse filtre påvirker kun overskrifter som vises i rulleteksten. Menuen viser altid alle overskrifter.
Den største del af fanebladet optages af en tabel som er en liste af de filtre som er indstillede for øjeblikket. Hvert filter har et lille felt som kan krydses af i: Markeres den så aktiveres filtret, afmarkeres den så inaktiveres filtret midlertidigt uden at fjerne det fra listen.
Normalt er der ingen filtre, så der er stor chance for at du ser en helt tom tabel. Naturligvis tilbyder denne dialog dig muligheder for at tilføje nye filtre, og håndtere dem i almindelighed.
For at tilføje et filter, skrives helt enkelt filteregenskaberne (se Filterkomponenter for en detaljeret beskrivelse af de forskellige filteregenskaber) ved at bruge indtastningsfeltet i feltet som hedder Filteregenskaber, og derefter trykkes på knappen som hedder Tilføj.
For at ændre et eksisterende filter, markeres filtret som du vil redigere i tabellen ved at venstreklikke på det, og derefter ændres egenskaberne i feltet længst nede.
For at fjerne et filter, markeres det i tabellen og der trykkes på knappen som hedder Fjern.
Hvert filter består af flere dele:
Filterkomponenter
Handling – dette kan enten være Vis eller Skjul og angiver hvad der skal ske med en overskrift om filtret matcher.
Nyhedskilder – her kan du angive om filtret kun gælder en enkelt nyhedskilde, eller om filtret skal bruges på overskrifter fra alle nyhedskilder.
Betingelse – dette er et verbum som, sammen med Udtryk, angiver om et filter matcher. En betingelse kan f.eks. være indeholder, ikke lig med eller matcher. Se nedenfor for en mere detaljeret beskrivelse.
Udtryk - dette er en brugerdefineret streng, som er filtrets hoveddel, sammen med betingelserne. Se nedenfor for en mere detaljeret beskrivelse af denne del.
Alle dele kan indstilles med funktionerne som findes i fanebladet som hedder Filteregenskaber. Mulige værdier for betingelserne fortjener en særlig forklaring:
indeholder, indeholder ikke: dette filter matcher hvis overskriften indeholder/ikke indeholder det angivne udtryk.
Udtrykket betragtes ikke som versalfølsomt, så udtrykkene “KDE”, “kDE” og “kde”, matcher alle overskrifter som indeholder “KDE”.
lig med, ikke lig med: dette filter matcher om overskriften er lig med/ikke er lig med det angivne udtryk.
Udtrykket behandles versalfølsomt, så af udtrykkene “Linux”, “Linux®” eller “LINUX”, så matcher kun det første “Linux®”.
matcher: bruges dette udtryk, behandler nyhedstelegrafen det angivne udtryk som et “regulært udtryk”. For yderligere information om regulære udtryk, kan du læse denne artikel som publiceredes på www.evolt.org.
Dette faneblad lader dig angive diverse valgmuligheder som påvirker nyhedstelegrafens rullende text:
Denne skyder lader dig definere hvor hurtigt den rullende tekst skal rulle. Hvis du har ganske lidt plads i din opgavelinje (og derfor en ganske lille nyhedstelegraf) bør du nok indstille en lav værdi så du har en chance for at læse overskrifterne. For bredere nyhedstelegrafer (og bedre øjne) er en hurtigere tekst formodentlig passende, så du behøver at vente på resten af overskriften så kort tid som muligt.
Disse valgmuligheder lader dig definere i hvilken retning teksten skal rulles, dvs til venstre eller til højre, opad eller nedad. Du kan også rotere teksten med 90 eller 270 grader her, hvilket ikke er særlig læsbart, men giver mening for lodrette paneler.
Klik på knappen til højre med navnet Vælg skrifttype... for at vælge skrifttype som bruges til rulleteksten.
Visse a skrifttyper er sværere at læse end andre, særlig når de bruges som en rulletekst, så du bør formodentlig vælge en skrifttype som er letlæselig også når en tekst bevæger sig.
Klik på denne knap for at åbne en bekvem farvevalgsdialog som lader dig vælge farven som bruges som forgrund for den rullende tekst (dvs. farven på selve teksten).
Klik på denne knap for at åbne en bekvem farvevalgsdialog som lader dig vælge farven som bruges som baggrund for den rullende tekst.
Klik på denne knap for at åbne en bekvem farvevalgsdialog som lader dig vælge farven som bruges som overskriftfarve når der markeres (når du flytter musen hen over dem).
Klik på denne knap for kun at lade den rullende tekst vise de nyeste overskrifter fra hver nyhedskilde, i stedet for at vise alle overskrifter som er tilgængelig fra hver nyhedskilde.
Markering af dette felt, gør at nyhedstelegrafen viser en ikon (om tilgængelig) foran hver overskrift som rulles frem. Det gør det meget lettere at afgøre hvilken nyhedskilde der sørger for hvilken overskrift.
Markering af dette felt gør at nyhedstelegrafen sagtner rullehastigheden når du flytter musemarkøren hen over den rullende tekst. Dette gør det meget lettere at klikke på et objekt, og trække ikonerne væk (hvis det er aktiveret).
Markér dette felt for at den markerede overskrift (dvs. overskriften som for øjeblikket er under musmarkøren) skal understreges.
Brug af nyhedstelegrafen er ganske ligetil og bør ikke forårsage nogen store problemer, under forudsætning af at du allerede har indstillet den. Uafhængig af om du kører nyhedstelegrafen i hovedpanelet, i sit eget underpanel eller i sit eget vindue, vises den som et område med rullende tekst og en knap med en lille pil før teksten.
Området (som normalt er hvidt, men baggrundsfarven kan let ændres i indstillingsdialogen) med den rullende tekst i sig kaldes “nyhedsviseren”. Den fortsætter med at vise de hentede overskrifter (eller kun de nyeste overskrifter) hele tiden og giver let adgang til artiklerne. Hvis du ser en interessant artikel, så klik blot på den for at åbne Konquerors browser, og vis hele artiklen som hører til overskriften du klikkede på. Hvis du mærker at en overskrift som kan være interessant netop forsvandt udenfor skærmen, er der også nogen måder at påvirke rulningen:
Du kan klikke på nyhedsviseren med
museknap og flytte rundt på musen (mens du holder museknap nede). Nyhedstelegrafen fortsætter med at rulle som sædvanligt når du slipper venstre museknap igen.Hvis du ejer en såkaldt “hjulmus”, kan du bruge musens hjul til at rulle overskrifterne frem og tilbage.
Der er også en meget kraftfuld sammenhængsafhængig menu, som du kan komme til ved enten at klikke på nyhedsviseren med museknap, eller klikke på pileknappen med museknap. Denne sammenhængsafhængige menu er den interessanteste del af miniprogrammet, eftersom den indeholder stort set al funktionalitet.
Den sammenhængsafhængige menu er egentlig opdelt i to funktionelle dele:
Den øverste del viser en liste med indgange, hvor hver indgang har en lille ikon som ser sådan her ud . Denne liste repræsenterer listen af de for øjeblikket indstillede nyhedskilder. Du kan klikke på en af nyhedskilderne for at åbne en anden menu som indeholder en liste over overskrifter som er tilgængelige for denne specielle nyhedskilde, samt en indgang som hedder
Tjek nyheder for at opdatere overskriftlisten for denne nyhedskilde. Hver af overskrifterne har en
ikon som angiver om du allerede har læst artiklen eller
hvis den stadigvæk er ulæst.
Den nederste del viser for øjeblikket fem indgange (forklarende oppefra og nedad):
Denne indgang har en lille foran sig. Hvis du vil tvinge nyhedslæseren til at tjekke de indstillede nyhedskilder for nye artikler, kan du klikke her.
Dette nulstiller ikke den interne tiden som spørger nyhedskilder automatisk efter nye overskrifter med faste intervaller.
Denne indgang i den sammenhængsafhængige menu har ingen tilhørende ikon. Klik på denne indgang for at aktivere en særlig “offline tilstand” som stopper den interne tid som spørger nyhedskilderne og forhindrer al automatisk download af nye overskrifter. Den frakoblede tilstand er praktisk hvis du skal forlade maskinen et stykke tid og systemet ikke er tilsluttet internettet i den tid, eftersom det sparer dig for alle fejlmeddelelser som dukker op hvis nogen af nyhedskilderne ikke kunne kontaktes.
Du kan stadigvæk fremtvinge en genindlæsning for enkelte nyhedskilder eller alle nyhedskilder, ved at vælge den tilsvarende indgang i Tjek nyheder.
Denne indgang er markeret med en lille . Ved at klikke på denne indgang vises nyhedstelegrafens dokumentation (som du læser lige nu), som indeholder detaljer om alle funktioner og muligheder for nyhedstelegrafen.
Denne indgang er markeret med en lille . Ved at klikke på denne indgang vises hvem der er skyldig i nyhedstelegrafen, og angiver de som bidrog med væsentlige forbedringer af den.
Denne indgang er let at genkende, på grund af ikonen som er foran den. Vælg denne indgang for at åbne indstillingsdialogen som lader dig indstille alle egenskaber for nyhedstelegrafen.
KNewsTicker
Program ophavsret 2000, 2001, 2002, 2003 Frerich Raabe (raabe AT kde.org)
Bidragydere:
Malte Starostik (malte.starostik AT t-online.de)
Wilco Greven (greven AT kde.org)
Adriaan de Groot (adrig AT sci.kun.nl)
Dokumentation ophavsret 2001, 2002, 2003 Frerich Raabe (raabe AT kde.org)
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dokumentation er udgivet under betingelserne i GNU Free Documentation License.
Dette program er udgivet under betingelserne i BSD Licensen.
Dette kapitel er beregnet til at forklare de forskellige forkortelser som er brugt i hele dokumentationen for nyhedstelegrafen. Hvis du mener at nogle forkortelser eller termer mangler her, så tøv ikke med at skrive til Frerich Raabe (raabe AT kde.org)
så de kan tilføjes. Mange tak!
Resource Description Framework, ressourcebeskrivelsesskelet. Et sprog afledt fra XML som beskriver metadata. Ofte brugt som et underliggende format for artikler og andre publikationer. For mere detaljeret information om RDF-filer, kan du gå direkte til den officielle side om RDF-filer hos World Wide Web konsortiet.
RDF Site Summary er i virkeligheden en udvidelse af RSS-sproget. Med et citat fra den officielle RSS v1.0 specifikationen:
“RDF Site Summary (RSS), RDF pladsoversigt, er et letvægts mangesidet udvideligt metadatabeskrivelses- og distributionsformat. RSS er en tilpasning af XML, som følger W3C's RDF-specifikationen og kan udvides via XML-navnerum og/eller RDF-baseret modularisering.”
Extensible Markup Language er det “universel format for strukturerede dokumenter og data på nettet”. Det er en variant af SGML som passer til behovene på internettet. Du kan tage et kig på siden Extensible Markup Language hos World Wide Web konsortiet for yderligere information.
En forkortelse for “World Wide Web Consortium”. Med et citat fra den officielle hjemmeside for W3C, “World Wide Web Consortium (W3C) udvikler samarbejdende teknologier (specifikationer, guider, programmel og værktøj) for at føre nettet til dets fulde potential som et forum for information, handel, kommunikation og fælles forståelse.”
URL står for “Uniform Resource Locator”, net-adresse, en specielt formateret streng som kan referere til ressourcer såsom billeder, dokumenter og andre ting på internettet. Se tilsvarende netside for mere detaljeret information om dette emne.
Desktopkommunikationsprotokollen er en måde for programmer at kommunikere med hinanden. Nyhedstelegrafens indstillingsdialog bruger for eksempel DCOP til at informere selve programmet om den nuværende indstilling.
Nyhedstelegrafen sørger for en omfattende DCOP-grænseflade, som gør det muligt at styre mange af nyhedstelegrafens funktioner fra kommandolinjen eller et script.
For mere detaljeret information om DCOP kan du besøge http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html, for en fuldstændig forklaring.
Indholdsfortegnelse
Nyhedstelegrafen sørger for en DCOP-grænseflade, som er ganske omfattende, og stadigt voksende. Dette bruges ikke kun til at kommunikere med andre programmer, men gør det også muligt at kontrollere nyhedstelegrafen med et skal-script. Desto mere grænsefladen udvides, jo mere nyttigt bliver den og jo mere fleksible bliver mulighederne for at kontrollere nyhedstelegrafen fra et script.
For at bruge disse DCOP-funktionerne kan du kalde kommandolinjeprogrammet dcop eller bruge det bekvemmere program KDCOP. Begge sørger for samme funktionalitet, så det er kun en spørgsmål om smag når det gælder hvilket program du foretrækker. :-)
Dette kapitel antager at du bruger kommandolinjeprogrammet dcop. For at komme til nyhedstelegrafens DCOP-funktioner, så sørg for at nyhedstelegrafen er startet og skriv derefter blot noget lignende i terminalen:
%
dcop
knewsticker
KNewsTicker
[funktion]
Hvis en fejlmeddelelse vises som siger at dcop
ikke kunne findes eller køres, kontrollér om filen dcop
findes i mappen $
og sørg for at rettighederne er rigtigt indstillede.KDEDIR
/bin
På kommandolinjen, erstattes “[funktion]” med et tilsvarende funktionsnavn, dvs. skriv
%
dcop
knewsticker
KNewsTicker
updateNews
for at få nyhedstelegrafen at kigge efter opdaterede nyheder og hente dem om nødvendigt.
I dette afsnit er en liste af alle metoder som er tilgængelige via nyhedstelegrafens DCOP-grænseflade.
Denne funktion tvinger nyhedstelegrafen til at opdatere den interne liste over artikler (dvs. den spørger de indstillede nyhedskilder efter opdaterede nyheder) og henter dem når det behøves.
Dette virker også hvis nyhedstelegrafen er i frakoblet tilstand.
Eksempel:
%
dcop
knewsticker
KNewsTicker
updateNews
Kommandoen reparseConfig får nyhedstelegrafen til at genindlæse sine indstillinger fra konfigurationsfilen. Denne funktion bruges af indstillingsdialogen til at tale med nyhedstelegrafen, men du kan bruge den hvis du har ændret konfigurationsfilen i hånden.
Konfigurationsfilen gemmes i ~/.kde/share/config/knewsticker_appletrc
Eksempel:
%
dcop
knewsticker
KNewsTicker
reparseConfig
Du kan kalde denne funktion for at angive om nyhedstelegrafen er i nedkoblet tilstand for øjeblikket (dvs. hvis nyhedstelegrafen skal spørge de indstillede nyhedskilder efter opdaterede nyheder).
Eksempel:
%
dcop
knewsticker
KNewsTicker
setOfflineMode
true
for at aktivere nedkoblet tilstand.
%
dcop
knewsticker
KNewsTicker
setOfflineMode
false
for at deaktivere nedkoblet tilstand.
Returnerer det nuværende indstillede interval mellem nyhedsforespørgsler i minutter.
Eksempel:
%
dcop
30knewsticker
KNewsTicker
interval
%
Returnerer nuværende indstillede rullehastighed. Intervallet som teksten rulles med i billedpunkter returneres i billedpunkter pr sekund.
Eksempel:
%
dcop
20knewsticker
KNewsTicker
scrollingSpeed
%
Returnerer antallet af billedpunkter som den rullende tekst flyttes for hvert trin på musehjulet.
Eksempel:
%
dcop
15knewsticker
KNewsTicker
mouseWheelSpeed
%
Returnerer et heltal som svarer til retningen som den rullende teksten bevæger sig:
1 = Til venstre
2 = Til højre
3 = Opad
4 = Nedad
5 = Opad, roteret
6 = Nedad, roterer
Eksempel:
%
dcop
1knewsticker
KNewsTicker
scrollingDirection
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen bruger egne navn for nyhedskilder.
Eksempel:
%
dcop
falseknewsticker
KNewsTicker
customNames
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen har funktionen uendelig rulning aktiveret.
Eksempel:
%
dcop
trueknewsticker
KNewsTicker
endlessScrolling
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen for øjeblikket kun viser de seneste overskrifter for hver nyhedskilde.
Eksempel:
%
dcop
falseknewsticker
KNewsTicker
scrollMostRecentOnly
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen er i nedkoblet tilstand.
Eksempel:
%
dcop
falseknewsticker
KNewsTicker
offlineMode
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen er blevet bedt om at understrege overskrifter som for øjeblikket er under musemarkøren.
Eksempel:
%
dcop
trueknewsticker
KNewsTicker
underlineHighlighted
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen viser ikonen for nyhedskilden hvor hver enkelt overskrift publiceredes foran overskriften.
Eksempel:
%
dcop
trueknewsticker
KNewsTicker
showIcons
%
Returnerer enten 'true' (sand) eller 'false' (falsk) afhængig af om nyhedstelegrafen har funktionen “langsom rulning” aktiveret.
Eksempel:
%
dcop
falseknewsticker
KNewsTicker
slowedScrolling
%
Returnerer den for øjeblikket indstillede forgrundsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.
Eksempel:
%
dcop
#804000knewsticker
KNewsTicker
foregroundColor
%
Returnerer den for øjeblikket indstillede baggrundsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.
Eksempel:
%
dcop
#0030ffknewsticker
KNewsTicker
backgroundColor
%
Returnerer den for øjeblikket indstillede fremhævningsfarve, som en streng på formatet “#rrggbb”, hvor “rr”, “gg” og “bb” er to cifres hexadecimale værdier som repræsenterer intensiteten for den røde, grønne og blå komponent på en skala fra 00 til ff.
Eksempel:
%
dcop
#000080knewsticker
KNewsTicker
highlightedColor
%
Returnerer listen over nyhedskilder som for øjeblikket er registrerede. Bemærk at dette returnerer alle nyhedskilder, ikke kun de valgte. I udskriften, skrives navnet på hver nyhedskilde på en linje.
Eksempel:
%
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