# Das &knewsticker; Handbuch

Frerich
Raabe

    raabe@kde.org

Frank
Schütte

    F.Schuette@t-online.de

Deutsche Übersetzung
2001
Frerich Raabe
&FDLNotice;
2001-01-24
1.00.00

&knewsticker; ist ein Nachrichten-Miniprogramm für die &kde; 2.x Kontrollleiste ( auch als &kicker; bekannt).

KDE
KNewsTicker
kdenetwork
Nachrichten-Ticker
applet

## Einleitung

&knewsticker; ist ein Miniprogramm für die &kde; Kontrollleiste (auch bekannt als &kicker;). Es bietet einen leichten und komfortablen Zugriff auf Neuigkeiten, wie sie von vielen Nachrichtenseiten (wie Slashdot, Linux Weekly News oder Freshmeat) angeboten werden.

Dazu muss die Nachrichtenseite für &knewsticker; eine spezielle RDF oder RSS-Datei bereithalten, die sowohl die Titelzeilen als auch Verweise auf die zugehörigen Artikel enthält. Solche Dateien sind durchaus üblich und &knewsticker; enthält bereits eine gute Auswahl an guten Informationsquellen.

### Kurze Information zu RDF-Dateien

RDF-Dateien werden immer populärer und dieses Miniprogramm ist nicht die erste Anwendung, die sie verwendet. Was aber sind RDF-Dateien? Dieser Abschnitt versucht, auf diese Frage eine kurze Antwort zu geben und weitere Informationsquellen zu nennen.

RDF ist ein Akronym für Resource Definition Framework . Es wurde vom World Wide Web Consortium erfunden und ist eine der ersten Anwendungen für die Extended Markup Language ( XML)) gewesen. RDF-Dateien (sowie die sehr ähnlichen RSS-Dateien) definieren und beschreiben sogenannte Meta-Informationen, also Informationen über Informationen.

RDF-Dateien können verschiedene Arten von Metadaten enthalten, also nicht nur Neuigkeiten (News). Dennoch sind sie gerade bei Nachrichtenseiten sehr populär, da sie einen klaren, einfachen und portablen Weg zur Verteilung von Neuigkeiten darstellen. Die Nachrichtenseite stellt eine RDF-Datei bereit, die eine Anzahl Datensätze enthält, wobei jeder der Datensätze aus einer Überschrift und einer URL, die auf den kompletten Artikel verweist, besteht. Daneben enthält die RDF-Datei auch den offiziellen Namen der Nachrichtenseite und einige andere allgemeine Informationen, die von &knewsticker; ausgewertet werden.

Dies ist natürlich nur eine kurze und unvollständige Erklärung zum Konzept der RDF-Dateien und Metadaten. Wenn man weitere Informationen sucht, können die folgenden Verweise hilfreich sein:

http://www.oasis-open.org/cover/rdf.html

  Diese Seite enthält eine sehr gute Erklärung des Resource Definition Frameworks und hat außerdem eine lange Liste Verweise auf Internetseiten, die sich mit diesem Thema beschäftigen. Für das Verständnis werden keine speziellen Voraussetzungen benötigt. Weiterhin ist die Seite immer sehr aktuell.

http://www.ccil.org/~cowan/XML/RDF-made-easy.html

  Hier findet man einen mehr praktischen Zugang zu Resource Definition Frameworks. Diese Seite demonstiert die Verwendung von RDF-Dateien und zeigt, warum und wann sie ein geeignetes Mittel sind. Der Leser sollte sich mit XML 1.0 auskennen, wie es vom World Wide Web Consortium definiert werden.

http://www.andrew.cmu.edu/user/mingfai/rdf/

  Hier findet sich eine lange und vollständige Liste mit Internetseiten, die sich mit RDF beschäftigen. Es lohnt sich ein Lesezeichen auf diese Seite zu setzen, da sie stets aktuelle ist und damit so gut wie keine toten Verweise enthält.

http://www.w3.org/RDF/

  Die Quelle direkt vom World Wide Web Consortium. Sie enthält eine umfangreichen Liste anderer Internetseiten, als auch einen Zeitplan für die RDF-Entwicklung, einen Überblick über die Architektur, ein Archiv mit Artikeln über RDF sowie eine sorgfältig zusammengestellte Liste von Hilfsprogrammen für Entwickler, die RDF verwenden wollen.

Wer andere Internetseiten und Dokumente über dieses Thema findet, sollte sich mit Frerich Raabe raabe@kde.org in Verbindung setzen, damit diese in diesen Hilfetext eingefügt werden können und für jeden eine Hilfe darstellen.

Vielen Dank!

## &knewsticker; starten

Hier findet man einen Screenshot von &knewsticker; in &kde;s Kontrollleiste
Hier findet man einen Screenshot von &knewsticker; in &kde;s Kontrollleiste

&knewsticker; wird wie jedes andere Miniprogramm gestartet, man fügt es einfach der Kontrollleiste hinzu ( oder einem Ableger der Haupt-Kontrollleiste). Dazu wählt man Newsticker aus dem Menü Miniprogramme von &kicker;.

Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste
Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste

Ein weiterer Weg, &knewsticker; zu verwenden, ist, ihn in einen eigenen Ableger der Kontrollleiste zu setzen. Dazu fügt man eine neue Kontrollleiste hinzu durch Auswahl von Hinzufügen Erweiterung Abhängige Kontrollleiste im Kontextmenü von &kicker;. Nun kann &knewsticker; wie oben beschrieben in diese abhängige Kontrollleiste eingefügt werden.

## &knewsticker; einrichten

Da &knewsticker; eng in das System integriert ist, gibt es mehr als eine Möglichkeit, ihn einzurichten:

Über &kcontrol;

  Man startet &kcontrol; durch Klicken auf den Knopf in der &kde; Kontrollleiste oder wählt den entsprechenden Eintrag im K-Menü. Dann wählt man das &knewsticker; Modul aus, indem man im Menü Persönliche Einstellungen den Punkt Newsticker auswählt.

Mit der rechten Maustaste

  Man kann das Kontextmenü von &knewsticker; auswählen, indem man mit der rechten Maustaste klickt oder auf den Pfeilknopf klickt und den Eintrag Preferences im Menü wählt.

### Allgemeine Konfiguration

#### Globale Einstellungen

So sieht die Karteikarte Allgemein aus, wenn man sie über &kcontrol; öffnet.
So sieht die Karteikarte Allgemein aus, wenn man sie über &kcontrol; öffnet.

Egal auf welche Weise man die Konfiguration öffnet, stets wird die erste Karteikarte mit der Überschrift Allgemein angezeigt. Hier kann die Laufgeschwindigkeit des Textes, sein Aussehen sowie weitere allgemeine Werte für das Miniprogramm eingestellt werden. Es folgt eine kurze Erläuterung der Knöpfe und Schalter dieser Karteikarte:

Zeitintervall zur Nachrichtenabfrage

  Hier kann man festlegen, in welchen Intervallen &knewsticker; die Nachrichtenseiten nach Neuigkeiten durchsucht. Diese Einstellung hängt generell davon ab, wie schnell man Nachrichten bekommen möchte und wie sehr man dadurch das Netzwerk belasten möchte:

  - Ein geringer Wert (weniger als 15 Minuten) führt zu einer sehr schnellen Benachrichtigung über Neuigkeiten. Dadurch wird aber der Netzwerkverkehr deutlich erhöht. Daher sollten solche geringen Werte nicht für sehr populäre Nachrichtenseiten verwendet werden (wie z.B. Slashdot oder Freshmeat), da sie ohnehin bereits genügend Anfragen beantworten müssen.

  - Bei einem großen Wert (mehr als 45 Minuten) Wert wird man von Nachrichten nicht so schnell erreicht. Für nicht zeitkritische Anwendungen sollte es aber schnell genug sein. Der Vorteil eines großen Wertes ist, dass eine geinge Belastung des Netzwerkes verursacht wird. Das schont Resourcen und Nerven für den Benutzer und das System-Acministrator der abgefragten Nachrichtenseiten.

  Der Standardwert (30 Minuten) ist für die meisten Fälle sinnvoll und passend.

Benutzerdefinierte Namen für Nachrichtenseiten benutzen

  Markiert man dieses Ankreuzfeld, so verwendet &knewsticker; die vom Benutzer festgelegten Namen in der Liste der Nachrichtenquellen (auf der Karteikarte Nachrichtenquellen) anstatt der von den Nachrichtenseiten selbst angegebenen Namen. Dies kann nützlich sein, falls eine Nachrichtenseite einen sehr langen Namen hat.

Endloser Lauftext

  Markiert man dieses Feld, so läuft der Lauftext ohne Unterbrechungen. Wenn die letzte Schlagzeile angezeigt wurde, wird die erste Schlagzeile von &knewsticker; nahtlos angefügt.

Nur die aktuellsten Schlagzeilen anzeigen

  Markiert man dieses Feld, so wird von jeder Nachrichtenseite nur die aktuellste Nachricht anstatt alle verfügbaren Nachrichten angezeigt.

#### Erscheinungsbild

Geschwindigkeit des Lauftextes

  Hier wird die Geschwindigkeit des Lauftextes eingestellt. Falls man wenig Platz in der Fensterleiste ( und daher wenig Raum für den Lauftext) hat, sollte man die Geschwindigkeit etwas herabsetzen, damit man eine Möglichkeit hat, den Lauftext zu entziffern. Bei einem breiten Newsticker (und besseren Augen) kann man den Text schneller laufen lassen, damit die Wartezeit auf die nächste Schlagzeile nicht zu lang wird.

  Der Wert legt fest, nach welcher Zeit der Text ein wenig weiterwandert, ist also antiproportional zur Laufgeschwindigkeit. Das bedeutet, größere Werte resultieren in einem langsamer laufenden Text.

Laufrichtung

  Hier wird festgelegt, in welche Richtung der Text läuft, also z.B. von links, von rechts, aufwärts oder abwärts.

Schriftart

  Man klickt auf den Knopf Schriftart wählen..., um eine Schriftart für den Lauftext auszuwählen.

  Schriftarten sind unterschidlich schwer zu lesen, besonders wenn man sie für einen Lauftext einsetzt, daher sollte man eine Schriftart wählen, die auch in Bewegung leicht zu lesen ist.

Vordergrundfarbe

  Klickt man auf diesen Knopf, so öffnet sich ein Farbauswahldialog, der die Auswahl einer Farbe für den Vordergrund ermöglicht (also für die Farbe des Lauftextes selbst).

Hintergrundfarbe

  Klickt man auf diesen Knopf, so öffnet sich ein Farbauswahldialog, der die Auswahl der Hintergrundfarbe des Lauftextes erlaubt.

Hervorhebungsfarbe

  Klickt man auf diesen Knopf, so öffnet sich ein Farbauswahldialog, mit dem man die Farbe der Schlagzeilen bestimmen kann, wenn sie hervorgehoben sind, wenn sich also der Mauszeiger darüber befindet.

Hervorgehobene Schlagzeile unterstreichen

  Markiert man dieses Ankreuzfeld, so wird die hervorgehobene Schlagzeile (also die Schlagzeile, über der sich der Mauszeiger befindet) zusätzlich unterstrichen dargestellt.

### Einrichtung der Nachrichtenquellen

So sieht die Karteikarte Nachrichtenquellen des Einrichtungsdialogs aus, wenn man sie über den Menüpunkt Einstellungen im Kontextmenü von &knewsticker; aufruft.
So sieht die Karteikarte Nachrichtenquellen des Einrichtungsdialogs aus, wenn man sie über den Menüpunkt Einstellungen im Kontextmenü von &knewsticker; aufruft.

Neben den Einstellungen auf der Karteikarte Allgemein gibt es auf der Karteikarte Nachrichtenquellen wesentlich mehr Möglichkeiten, &knewsticker; an die persönlichen Bedürfnisse anzupassen. Diese Karteikarte besteht im Wesentlichen aus einer Tabelle, die die Konfiguration der Nachrichtenseiten erlaubt, die nach Nachrichten abgesucht werden. Klickt man mir der rechten Maustaste auf einen Eintrag, so erscheint ein Kontextmenü, welches es erlaubt, den Eintrag zu löschen oder einen neuen Eintrag mit den gleichen Einstellungen einzufügen.

Unten findet man zwei Knöpfe mit einem Pfeil nach oben und einem Pfeil nach unten. Diese zwei Knöpfe erlauben die Veränderung der Reihenfolge in der Tabelle. Das ist nützlich, wenn man eine bestimmte Reihenfolge der Nachrichtenquellen möchte.

Wenn man das Miniprogramm gestartet hat, kann man mit den Einstellungen experimentieren. Klickt man auf Anwenden, so werden die neuen Einstellungen ohne Neustart des Miniprogramms übernommen.

#### Eine Nachrichtenseite hinzufügen

Es gibt vier verschiedene Wege, eine Nachrichtenseite hinzuzufügen:

- Man kann auf den Knopf Hinzufügen unten klicken.

- Man kann mit der rechten Maustaste auf die Tabelle klicken und den Menüeintrag Nachrichtenquelle hinzufügen auswählen. Das fügt einen neuen Eintrag hinzu setzt den Namen auf Unbekannt.

- Man kann mit der rechten Maustaste auf einen Tabelleneintrag klicken und aus dem Kontextmenü Nachrichtenquelle hinzufügen auswählen. Es wird ein neuer Eintrag mit den gleichen Eigenschaften wie der vorhandene Eintrag erzeugt.

- Man kann eine RDF- oder RSS-Datei aus einer anderen Anwendung (wie z.B. &konqueror;) in die Tabelle ziehen. Dies fügt einen neuen Eintrag in der Liste ein, setzt den Namen auf Unbekannt und die Artikelmaximalzahl auf 10.

Es gibt eigentlich noch einen dritten Weg. Man kann in &konqueror; auf eine RDF- oder RSS-Datei klicken. Dadurch wird sie automatisch zur Tabelle hinzugefügt.

#### Eine Nachrichtenquelle verändern

Um eine Nachrichtenquelle zu bearbeiten, kann man die Eingabefelder auf der rechten Seite verwenden, die sich im Feld Allgemein befinden. Sie sind deaktiviert, solange nicht ein Eintrag der Tabelle ausgewählt worden ist. Sobald ein Eintrag gewählt ist, werden die Felder aktiviert und die Einträge können verändert werden:

- Das oberste Feld Name erlaubt die Eingabe eines Namens. Dieser Name wird verwendet, wenn das Programm keine Verbindung zur Nachrichtenseite herstellen konnte, oder wenn das Ankreuzfeld Benutzerdefinierte Namen für Nachrichtenseiten verwenden (auf der Karteikarte Allgemein) markiert wurde.

- Das Eingabefeld Quelldatei darunter erlaubt die Eingabe der URL, die zur RDF- oder RSS-Datei zeigt. Man kann diesen Eintrag entweder per Hand ändern oder indem man auf den Knopf auf der rechten Seite klickt. Es wird ein Dateidialog geöffnet, der die Auswahl der gewünschten Datei erlaubt.

- Im Feld Max. Artikel schließlich kann die Anzahl der Artikel festgelegt werden, die &knewsticker; herunter laden soll. Der Standardwert ist 10 Artikel, aber es kann sinnvoll sein, diesen Wert für einige Nachrichtenseiten anzupassen.

Wenn der Wert in einem der Felder geändert wird, sind die Auswirkungen in der Tabelle sofort sichtbar.

#### Eine Nachrichtenquelle entfernen

Natürlich kann es vorkommen, das man eine Nachrichtenseite aus der Tabelle entfernen möchte. Dazu kann man entweder

- mit der rechten Maustaste auf den Eintrag klicken und im Kontextmenü Nachrichtenquelle entfernen auswählen.

- den Eintrag auswählen und dann auf den Knopf Entfernen unterhalb der Tabelle klicken.

In beiden Fällen wird ein Bestätigungsdialog eingeblendet, der sicherstellt, dass nicht der falsche Eintrag entfernt wird.

## &knewsticker; verwenden

Die Verwendung von &knewsticker; sollte keine besonderen Probleme bereiten, vorausgesetzt, dass die Konfiguration von &knewsticker; erfolgt ist. Egal, ob &knewsticker; teil der Kontrollleiste oder innerhalb einer abhängigen Kontrollleiste ist, besteht er aus einem Fenster mit dem Lauftext und einem Knopf mit einem schmalen Pfeil daneben.

### Das Miniprogramm

Der Bereich (er ist standardmäßig weiß, aber seine Farbe kann im Einstellungsdialog geändert werden) mit dem laufenden Text heißt Lauftext. Hier werden die herunter geladenen Schlagzeilen (oder nur die aktuellsten Schlagzeilen) kontinuierlich angezeigt. Der Zugriff auf die zugehörigen Artikel ist sehr einfach. Ein Klick auf eine Schlagzeile startet den Internetbrowser &konqueror; mit der gewünschten Seite. Falls eine Schlagzeile gerade aus dem Bild gelaufen ist, gibt es mehrere Einflussmöglichkeiten auf den Lauftext:

- Man kann mit der linken Maustaste auf den Lauftext klicken und bei gedrückter Maustaste die Maus hin- und herbewegen. Nach dem Loslassen der Maustaste läuft der Lauftext weiter.

- Wenn man über eine Maus mit Mausrad verfügt, kann man auch das Rad verwenden, um den Lauftext vor- und zurückzuspulen.

Indem man entweder mit der rechten Maustaste klickt oder mit der linken auf den Pfeilknopf klickt, kann man ein umfangreiches Kontextmenü aufrufen. Dieses Menü enthält beinahe die gesamte Funktionalität des Miniprogramms.

### Das Kontextmenü

So sieht das Kontextmenü von &knewsticker; aus, wenn man die Standardnachrichtenquellen verwendet.
So sieht das Kontextmenü von &knewsticker; aus, wenn man die Standardnachrichtenquellen verwendet.

Das Kontextmenü ist aufgeteilt in zwei Teile:

Der obere Teil enthält eine Liste von Einträgen, die alle ein kleines Symbol wie dieses neben sich haben. Dies ist die Liste der eingestellten Nachrichtenquellen. Klickt man auf einen der Einträge, öffnet sich ein Menü, das aus den Schlagzeilen dieser Nachrichtenquelle besteht. Außerdem gibt es einen Eintrag mit Namen Nachrichten holen, der dazu dient die Schlagzeilenliste dieser Nachrichtenquelle aufzufrischen. Neben jeder Schlagzeile befindet sich entweder das Symbol , das anzeigt, dieser Artikel wurde bereits gelesen, oder das Symbol , das auf einen ungelesenen Artikel hindeutet.

Der untere Teil des Menüs enthält bisher vier Einträge (erläutert von oben nach unten):

Nachrichten holen

  Dieser Eintrag hat das kleine Symbol . Dieser Menüpunkt veranlasst &knewsticker;, die Nachrichtenquellen nach neuen Nachrichten abzusuchen.

  Der interne Intervallzähler wird durch diesen Eintrag nicht auf Null gesetzt.

Offline-Modus

  Dieser Eintrag hat kein Symbol. Klickt man auf diesen Eintrag, so wird &knewsticker; in den Offline-Modus geschaltet. Der interne Intervallzähler wird angehalten und &knewsticker; lädt keine Schlagzeilen automatisch herunter. Dieser Eintrag ist nützlich, falls man seinen Computer eine Weile verlassen muss und die Internetverbindung während dieser Zeit nicht besteht. Ansonsten würden viele Fehlermeldungen auflaufen, dass die Nachrichtenseiten nicht gefunden werden konnten.

  Auch im Offline-Modus kann man explizit neue Schlagzeilen herunterladen, indem man auf den Eintrag Nachrichten holen für alle Nachrichtenseiten oder für eine spezielle Nachrichtenseite klickt.

Hilfe

  Dieser Eintrag ist mit einem kleinen markiert. Klickt man auf diesen Eintrag, so wird die Hilfedatei zu &knewsticker; geöffnet (die sie gerade lesen). Sie enthält eine detailierte Beschreibung der Möglichkeiten und Fähigkeiten von &knewsticker;.

Über

  Dieser Eintrag ist ebenfalls mit einem kleinen markiert. Er öffnet einen kleinen Dialog, der die Mitwirkenden an &knewsticker; auflistet und Informationen über Copyright und Lizenz enthält.

Einstellungen

  Dieser Eintrag kann leicht am identifiziert werden. Über diesen Eintrag werden allen Einstellungen und Anpassungen für &knewsticker; vorgenommen.

## Fragen und Antworten

&reporting.bugs;

Wo finde ich die RDF-Datei für die Nachrichtenseite XY?

Es ist möglich, das die Nachrichtenseite weder eine RDF- noch eine RSS-Datei bereitstellt. Nichts desto trotz findet man unter http://www.webreference.com/services/news eine mehr oder weniger vollständige Liste von Nachrichtenseiten im Internet, die eine RDF- oder RSS-Datei bereitstellen. Eine weitere Quelle für RDF-Dateien ist http://www.xmltree.com. Hier sind hunderte von RDF- und RSS-Dateien nach Sprache und Kategorie geordnet aufgeführt.

Falls man interessante Nachrichtenseiten findet, die RDF- oder RSS-Dateien bereitstellen, sollte man diese Information an Frerich Raabe raabe@kde.org weitergeben. Sie können dann in spätere Versionen aufgenommen werden. Vielen Dank dafür!

## Mitwirkende und Lizenz

&knewsticker;

Programm Copyright 2000, 2001 Frerich Raabe raabe@kde.org

Mitwirkende:

- Malte Starostik malte.starostik@t-online.de

- Wilco Greven greven@linux.org

Dokumentation Copyright 2001 Frerich Raabe raabe@kde.org

&underFDL; &underBSDLicense;

## Glossar

Dieser Abschnitt dient der Erläuterung verschiedener Akronyme, die in der Dokumentation von &knewsticker; verwendet wurden. Falls Akronyme fehlen, sollte man sich an Frerich Raabe raabe@kde.org wenden, damit sie hinzugefügt werden. Vielen Dank!

RDF

  Resource Description Framework. Eine von XML abgeleitete Sprache zur Beschreibung von Metadaten. Üblicherweise verwendet für Artikel und andere Veröffentlichungen. Weitere Informationen zu RDF sind zu finden unter kurze Informationen zu RDF-Dateien oder direkt auf der offiziellen Seite zu RDF-Dateien beim World Wide Web Consortium.

RSS

  Die RDF Site Summary ist nach Aussagen von der offiziellen RSS v1.0 specification eine Erweiterung der RDF-Sprache:

  RDF Site Summary (RSS) ist ein schlankes und erweiterbares Metadatenbeschreibungformat. RSS ist eine XML-Anwendung, entspricht dem W3C-Standard für RDF und ist durch einen XML-Namensraum und/oder RDF-basierte Modularisierung erweiterbar.

XML

  Die Extensible Markup Language ist das universelle Format für strukturierte Dokumente und Daten im Web. Es ist von SGML abgeleitet und an die Bedürfnisse des World Wide Web angepasst. Weitere Informationen findet man unter Extensible Markup Language beim World Wide Web Consortium.

W3C

  Eine Abkürzung für das World Wide Web Consortium. Nach der offiziellen Seite des W3C entwickelt das Consortium interoperable Technologien (Spezifikationen, Rcihtlinien, Software und Hilfsprogramme), um das volle Potenzial des Web als ein Forum für Information, Kommerz, Kommunikation und allgemeinem Verständnis auszuschöpfen.

&URL;

  &URL; steht für Uniforme Resource Locator, einem speziell formatierten Text, der Resourcen wie Bilder, Dokumente und andere Dinge im Internet identifizieren kann. Weitere Informationen unter dieser Internetseite.

DCOP

  Das Desktop COmmunication Protocol ist ein Weg für Anwendungen, mit einander zu kommunizieren. Zum Beispiel verwendet &knewsticker;s Einrichtungsdialog DCOP, um dem Miniprogramm die aktuelle Konfiguration mitzuteilen. Weitere Informationen findet man unter http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html.

## Installation

### Wo bekommt man &knewsticker;

&knewsticker; ist ein Teil des &kde;-Projektes . Die aktuelle Version von &knewsticker; befindet sich im Paket kdenetwork auf ftp://ftp.kde.org/pub/kde , dem &FTP;-Server des &kde;-Projektes.

### Voraussetzungen

Für die Installation von &knewsticker; benötigt man mindestens &kde; 2.1.

Falls man &knewsticker; selbst kompilieren und installieren will, benötigt man die folgenden Programme:

- g++ 2.8 / egcs 1.0.3 (oder kompatibel)

- GNU make

- autoconf 2.1

- automake 1.4

- Qt 2.2.x

- KDE 2.1

### Kompilierung und Installation

&knewsticker; ist ein Teil des Pakets kdenetwork von &kde; 2.1 und wird zusammen mit diesem installiert. Im allgemeinem gibt es keinen Grund für den Benutzer &knewsticker; von Hand zu kompilieren. Falls man es dennoch möchte, so verläuft die Kompilierung und Installation wie sonst auch unter &Linux; üblich durch:

    % ./configure
    % make
    % su -c "make install"

&knewsticker; verwendet autoconf und automake, daher sollte es keine Probleme während der Kompilation geben. Falls dennoch Probleme auftreten, kann man sich an die Mailingliste der &kde;-Entwickler kde-devel@master.kde.org wenden.

## Informationen für Entwickler und fortgeschrittene Benutzer

&knewsticker; enthält ein augenblicklich sehr begrenztes aber wachsendes DCOP-Interface. Es ist nicht nur für die Kommunikation mit anderen Anwendungen notwendig sondern ermöglicht auch die Steuerung von &knewsticker; über ein Shellskript. Je mehr das Interface ausgearbeitet ist, desto umfangreicher werden die Steuerungsmöglichkeiten sein.

Um diese DCOP-Funktionen zu nutzen, kann man entweder den Befehldcop oder das komfortablere KDCOP-Programm verwenden. Beide sind funktionell gleich, also entscheidet lediglich der Geschmack. :-)

In diesesm Kapitel wird angenommen, dass das Befehlszeilenprogramm DCOP verwendet wird, um &knewsticker;s DCOP-Funktionen zu verwenden. Man muss zunächst &knewsticker; starten und dann das Folgende an der Konsole eingeben:

    % dcop knewsticker KNewsTicker [function]

If an error appears that tells you that `dcop` couldn't be found or executed, please check whether the file `dcop` exists in `$KDEDIR/bin` and make sure it's permissions are appropriately set.

In that command line, just replace [function] with the respective function name, i.e. type

    % dcop knewsticker KNewsTicker updateNews

to make &knewsticker; check for new news and download them if neccessary.

### DCOP Reference

So, here's (finally) the complete list of all the DCOP which &knewsticker; provides:

`updateNews`

  This function forces &knewsticker; to updates the internal list of articles (e.g. it queries the list of news sources which has been configured for new news) and downloads them when neccessary.

  This also works if &knewsticker; is currently in offline mode.

  Example:

      % dcop knewsticker KNewsTicker updateNews

`reparseConfig`

  The `reparseConfig` command makes &knewsticker; reload it's configuration from the configuration file. This function is used by the configuration dialog to talk to &knewsticker; but you can use it in case you modified the configuration file by hand.

  The configuration file is saved in `~/.kde/share/config/knewstickerrc`

  Example:

      % dcop knewsticker KNewsTicker reparseConfig

`setOfflineMode [bool]`

  You can call this function to define whether &knewsticker; is currently in the offline mode (e.g. whether &knewsticker; should query the configured news sites for new news).

  Example:

      % dcop knewsticker KNewsTicker setOfflineMode true

  to enable the offline mode, or type

      % dcop knewsticker KNewsTicker setOfflineMode false

  to disable offline mode.

&documentation.index;