# Das Handbuch zu &knewsticker;

&Frerich.Raabe; &Frerich.Raabe.mail;
&Jonathan.Singer; &Jonathan.Singer.mail;
Frank
Schütte

    F.Schuette@t-online.de

Deutsche Übersetzung
2001, 2002, 2003
&Frerich.Raabe;
&FDLNotice;
2003-10-14
2.00.00

&knewsticker; ist ein Nachrichten-Miniprogramm für die &kde;-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 Nachrichten, wie sie von vielen Nachrichtenseiten (wie Slashdot, Linux Weekly News oder Freshmeat) angeboten werden.

Dazu muss die Nachrichtenseite für &knewsticker; eine spezielle &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 &RSS;-Dateien

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

Die kurze Antwort: &RSS; ist ein XML-basiertes Format zur Zusammenfassung von Web-Inhalten.

&RSS; wird oft als Akronym für Rich Site Summary verwendet - dabei handelt es sich nicht um eine Definition, man bekommt aber eine Vorstellung davon, was die Erfinder von &RSS; im Sinn hatten. Über die richtige Bedeutung von &RSS; gibt es bislang keine Einigung, daher ist es eigentlich kein Akronym sondern eher ein Name.

&RSS; wurde 1999 von Netscape als Agenturformat für die Internetseite my.netscape.com erfunden. Die erste offizielle Version von &RSS; war 0.9. Wenige Monate später wurde die Version 0.91 veröffentlicht, in die Netscape viele Funktionen des Formats <scriptingNews> integrierte.

Das grundlegende Konzept hinter &RSS; ist, ein einfaches, klares Format für die Verteilung von Internetinhalten, insbesondere Nachrichten, bereit zu stellen. Die Nachrichtenseite stellt eine &RSS;-Datei bereit, die eine Anzahl Datensätze enthält, wobei jeder der Datensätze aus einer Schlagzeile und einer &URL;, die auf den kompletten Artikel verweist, besteht. Desweiteren enthält die &RSS;-Datei auch einige andere allgemeine Informationen bereit wie z. B. den offiziellen Namen der Nachrichtenseite. Diese Informationen werden von &knewsticker; ausgewertet.

Heutzutage gibt es einige umfangreichere Versionen von &RSS; (0.91, 0.92, 0.93, 1.0 und das aktuelle Format 2.0), aber ca. 85% der Dateien, die man im Internet findet, stützen sich dennoch auf die ersten zwei Versionen. Dennoch kann &knewsticker; alle Versionen einschließlich 2.0 verarbeiten.

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

http://www.webreference.com/authoring/languages/xml/rss/intro/

  Hierbei handelt es sich um eine mit vielen Beispielen und Anleitungen versehene, pragmatische Einführung zum &RSS;-Format. Zusammen mit den offiziellen Spezifikationen hat man damit eine gute Hilfe, falls man auf der eigenen Internetseite Nachrichten mit &RSS; veröffentlichen möchte.

http://www.oreillynet.com/rss/

  Die &RSS;-Seite von O'Reilly enthält neben vielen allgemeinen Artikel über die Verwendung von &RSS;-Dateien auch aktuelle Neuigkeiten von der &RSS;-Entwicklergemeinde sowie wichtige Informationen für Entwickler, die &RSS; verwenden möchten.

http://blogspace.com/rss/

  Hierbei handelt es sich um eine weitere exzellente Nachrichtenquelle über die &RSS;-Entwicklungen und ist damit für Entwickler von &RSS;-basierten Programmen besonders interessant.

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

  Die offizielle Quelle zu RDF, eine XML-basierte Sprache, von der die heutigen Versionen von &RSS; abgeleitet sind, herausgegeben vom World Wide Web Consortium. Sie enthält eine umfangreiche 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.

Entwickler sollten außerdem die autorisierten Spezifikationen der verschiedenen &RSS;-Versionen kennen:

#### Spezifikationen zu &RSS;

1. Version 0.90: http://www.purplepages.ie/rss/netscape/rss0.90.html

2. Version 0.91: http://backend.userland.com/rss091

3. Version 0.92: http://backend.userland.com/rss092

4. Version 0.93: http://backend.userland.com/rss093

5. Version 1.0: http://web.resource.org/rss/1.0/

6. Version 2.0: http://backend.userland.com/rss

Wer andere Internetseiten und Dokumente über dieses Thema findet, die Erwähnenswert sind, sollte sich mit &Frerich.Raabe; &Frerich.Raabe.mail; 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 &kicker;-Miniprogramm gestartet, man fügt es einfach der Kontrollleiste hinzu ( oder einem Ableger der Haupt-Kontrollleiste). Dazu klickt man mit der rechten Maustaste auf die &kde;-Kontrollleiste und wählt im Menü Hinzufügen Miniprogramm &knewsticker;.

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.

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

Die dritte gängige Methode, &knewsticker; auszuführen, ist, es über Internet&knewsticker; (Nachrichtenticker) aus dem K-Menü zu wählen. Das startet &knewsticker; in einem eigenen, unabhängigen Fenster, das beliebig verändert werden kann.

## &knewsticker; einrichten

Man kann den Einrichtungsdialog von &knewsticker; öffnen, indem man mit der rechten Maustaste in den Lauftext klickt oder indem man auf den Pfeilknopf klickt und den Eintrag Einstellungen im Menü wählt.

### Allgemeine Einstellungen

So sieht die Karteikarte Allgemein aus.
So sieht die Karteikarte Allgemein aus.

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:

Empfindlichkeit des Mausrades:

  Dieser Schieberegler erlaubt die Einstellung, wie schnell der Lauftext bei Verwendung des Mausrades verschoben werden soll.

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 erhält man neue Nachrichten nicht so schnell. Für nicht zeitkritische Anwendungen sollte es aber schnell genug sein. Der Vorteil eines großen Wertes ist eine geringe Netzwerkbelastung. Das schont Ressourcen und Nerven für den Benutzer und den System-Administrator 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.

### Einrichtung der Nachrichtenquellen

So sieht die Karteikarte Nachrichtenquellen des Einrichtungsdialogs aus.
So sieht die Karteikarte Nachrichtenquellen des Einrichtungsdialogs aus.

Auf dieser Karteikarte kann man eine Liste von Internetseiten verwalten, die &knewsticker; nach neuen Nachrichten absuchen soll. Klickt man mit der rechten Maustaste auf einen Eintrag, so öffnet sich ein Kontextmenü, das die Funktionen zum Entfernen oder Hinzufügen eines Eintrags enthält. Unten auf der Karte befinden sich drei Knöpfe für die gleichen Funktionen.

#### Eine Nachrichtenseite hinzufügen

Man kann eine Nachrichtenquelle auf vier verschiedene Arten zur Liste hinzufügen:

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

- Man kann mit der rechten Maustaste auf die Tabelle klicken und Nachrichtenquelle hinzufügen auswählen.

- Man kann eine &RSS;-Datei aus einer anderen Anwendung (wie z.B. &konqueror;) auf die Tabelle ziehen. Dadurch wird ein neuer Eintrag zur Liste hinzugefügt, dessen Name Unbekannt lautet und dessen maximale Anzahl an Artikeln auf 10 gesetzt wird.

- Schließlich kann man einfach im &konqueror;-Dateimanager auf eine beliebige &RSS;-Datei klicken, um sie direkt zur Liste hinzuzufügen.

In jedem Fall erscheint der Dialog Nachrichtenquelle hinzufügen ..., in den man die Eigenschaften der neuen Nachrichtenquelle eintragen kann.

#### Eine Nachrichtenquelle verändern

Die Eigenschaften einer existierenden Nachrichtenquelle können auf zwei Arten verändert werden:

- Man kann unten auf den Knopf Bearbeiten ... klicken.

- Man kann mit der rechten Maustaste auf den Eintrag für die Nachrichtenquelle in der Liste klicken und '...' bearbeiten aus dem Menü auswählen.

In jedem Fall erscheint der Dialog Nachrichtenquelle bearbeiten ... mit den Einstellungen der ausgewählten Nachrichtenseite.

#### Eine Nachrichtenquelle entfernen

Es kann vorkommen, dass man eine Nachrichtenquelle aus der Nachrichtenliste entfernen möchte. Das kann man auf verschiedene Arten tun:

- Man kann auf den Knopf mit der Bezeichnung Entfernen klicken.

- Man kann mit der rechten Maustaste auf die gewünschte Nachrichtenquelle klicken und aus dem Kontextmenü '...' entfernen auswählen.

Damit nicht versehentlich eine Nachrichtenquelle gelöscht wird, erscheint in beiden Fällen ein Bestätigungsdialog.

Man kann mehrere Nachrichtenquellen gleichzeitig aus der Liste entfernen, indem man beim Klicken auf die Einträge die &Strg;-Taste gedrückt hält, oder indem man mit gedrückter linker Maustaste die gewünschten Einträge überstreicht.

#### Der Dialog Nachrichtenquelle

So sieht der Dialog zum Hinzufügen und Bearbeiten von Nachrichtenquellen aus.
So sieht der Dialog zum Hinzufügen und Bearbeiten von Nachrichtenquellen aus.

Wenn man eine Nachrichtenquelle hinzufügt oder bearbeitet, erscheint der Dialog Nachrichtenquelle (weiter oben) und bietet die benötigten Eingabemöglichkeiten zur Einrichtung der Eigenschaften für die Nachrichtenquelle:

Name:

  Das ist der Name der Nachrichtenquelle.

  Dieser Text wird nur dann verwendet, wenn man auf der Karteikarte Allgemein das Ankreuzfeld Benutzerdefinierte Namen für Nachrichtenquellen verwenden markiert hat.

Quelldatei:

  Hier kann man die &URL; der &RSS;-Datei der Nachrichtenquelle eintragen. Datei kann es sich um eine lokale Datei oder eine Datei auf dem entfernten Server handeln. Man kann auch auf den Knopf rechts klicken und damit einen Dateidialog öffnen, mit dessen Hilfe man die gesuchte Datei im Dateisystem auswählen kann. Dadurch erspart man sich das Eintippen der &URL;.

Die Datei ist ein Programm

  Falls dieses Ankreuzfeld markiert ist, nimmt &knewsticker; an, dass sich hinter der &URL; (die im Feld Quelldatei angegeben wurde) keine &RSS;-Datei sondern ein Programm (meistens ein Skript) verbirgt. Wenn die Nachrichtenquelle abgefragt wird, führt &knewsticker; das Programm aus und interpretiert die Ausgabe dieses Programms als &RSS;-Text. Damit steht eine einfache Methode bereit, um beispielsweise eine HTML-Datei aus dem Internet zu laden und daraus einen &RSS;-Text zur Verwendung in &knewsticker; zu erstellen.

  Man kann einige Beispielskripte &zb; zum Herunterladen von Börsendaten im Modul kdeaddons im Verzeichnis `knewsticker-scripts` finden.

Kategorie:

  Hier kann man festlegen, in welche Kategorie die Nachrichten eingeordnet werden sollen. Durch Sortierung nach Kategorien kann man auch lange Listen von Nachrichtenquellen gut verwalten.

Max. Artikel:

  Mit dieser Option kann man festlegen, wieviele Nachrichten der Quelle &knewsticker; zwischenspeichern soll. Dieser Wert wird nie überschritten.

  Das ist sinnvoll bei Nachrichtenquellen, die vielleicht nur immer nur drei Nachrichten gleichzeitig veröffentlichen, wenn man z. B. die letzten zehn Nachrichten sehen will. &knewsticker; lädt immer die letzten drei Nachrichten und führt sie mit den letzten zwischengespeicherten sieben Nachrichten zusammen.

Symbol:

  Hier kann man eine Adresse zu einer Bilddatei angeben (möglichst im Format 16x16 Pixel), die für diese Nachrichtenquelle verwendet werden soll. Symbole erleichtern die Unterscheidung zwischen verschiedenen Nachrichtenquellen. Man erkennt am Symbol, welche Nachrichtenseite die Nachricht veröffentlicht hat.

Unten befinden sich die üblichen Knöpfe, einer benötigt allerdings zusätzliche Hinweise: klickt man auf Vorschlag, so versucht &knewsticker; nach Eintrag der &URL; der Quelldatei für die restlichen Felder passende Werte zu erraten.

Daher kann man normalerweise einfach die &URL; einer &RSS;-Datei in das Eingabefeld Quelldatei einfügen, auf Vorschlag klicken und die automatisch eingetragenen Werte nach eigenen Wünschen anpassen.

### Filter

So sieht die Karteikarte Filter des Einrichtungsdialogs aus.
So sieht die Karteikarte Filter des Einrichtungsdialogs aus.

Auf dieser Karteikarte können verschiedene Filter angelegt werden. Diese werden auf die Nachrichten angewandt, bevor sie im Lauftext angezeigt werden.

Die Filter betreffen nur die Schlagzeilen für den Lauftext. Im Menü sind immer alle Schlagzeilen sichtbar.

Den größten Teil der Seite nimmt eine Tabelle ein, die eingerichtete Filter anzeigt. Neben jedem Filter befindet sich ein Ankreuzfeld zur Aktivierung/Deaktivierung des Filters.

Standardmäßig sind keine Filter vorgegeben, daher ist die Tabelle zu Beginn leer. Daher gibt es natürlich eine Möglichkeit, neue Filter zu erstellen und Filter zu verwalten:

- Zum hinzufügen eines Filters trägt man die gewünschten Eigenschaften (für Details siehe Bestandteile von Filtern) in die Textfelder im Bereich Filtereigenschaften ein und klickt auf Hinzufügen.

- Zum Bearbeiten eines vorhandenen Filters wählt man den Filter durch Klicken mit der linken Maustaste aus und ändert die Eigenschaften im Bereich unten.

- Zum Entfernen eines Filters wählt man diesen in der Tabelle und klickt auf Entfernen.

#### Bestandteile eines Filters

Jeder Filter besteht aus vier Bestandteilen:

##### Bestandteile eines Filters

1. Aktion - das kann entweder Anzeigen oder Ausblenden sein. Dies legt fest, was mit einer Nachricht passiert, auf deren Schlagzeile der Filter zutrifft.

2. Nachrichtenquellen - hier kann man festlegen, ob der Filter nur auf die Schlagzeilen einer Quelle oder auf die Schlagzeilen aller Quellen angewandt werden soll.

3. Bedingung - ein Verb, das zusammen mit einem Ausdruck die Filterregel darstellt. Bedingung kann z. B. enthält, nicht gleich oder trifft zu sein. Weiter unten befindet sich eine ausführlichere Beschreibung.

4. Ausdruck - ein benutzerdefinierter Text, der zusammen mit einer Bedingung den Inhalt der Filterregel bestimmt. Weiter unten befindet sich dazu eine detailierte Beschreibung.

Diese Komponenten werden alle über die Felder im Bereich Filtereigenschaften eingerichtet. Die möglichen Inhalte der Bedingung benötigen einige erklärende Worte:

- enthält und enthält nicht: diese Filter treffen zu, wenn die Schlagzeile den angegebenen Ausdruck enthält / nicht enthält.

  Beim Ausdruck wird nicht zwischen Groß- und Kleinschreibung unterschieden, also trifft der Filter, der durch "enthält KDE" definiert ist, auf KDE, kDE oder auch kde zu.

- gleich, nicht gleich: dieser Filter trifft zu, wenn die Schlagzeile gleich / ungleich dem angegebenen Ausdruck ist.

  Beim Ausdruck wird zwischen Groß- und Kleinschreibung unterschieden, also von Linux, linux oder LINUX passt nur der erste Ausdruck auf Linux.

- trifft zu: bei dieser Bedingung behandelt &knewsticker; den angegebenen Ausdruck als regulären Ausdruck. Weitere Informationen zu regulären Ausdrücken findet man in diesem Artikel, der auf www.evolt.org veröffentlicht worden ist.

### Lauftext

So sieht die Karteikarte Lauftext des Einrichtungsdialogs aus.
So sieht die Karteikarte Lauftext des Einrichtungsdialogs aus.

Auf dieser Karteikarte kann man verschiedene Einstellungen zu &knewsticker;s Lauftext vornehmen:

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.

Laufrichtung

  Hier wird festgelegt, in welche Richtung der Text läuft, also &zb; von links, von rechts, aufwärts oder abwärts. Man kann den Text zusätzlich um 90 oder 270 Grad rotieren. Das macht den Text nicht wirklich lesbar, ist aber für vertikale Kontrollleisten sinnvoll.

Schriftart

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

  Bestimmte Schriftarten sind schwerer zu lesen als andere, 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.

Nur die aktuellsten Schlagzeilen anzeigen

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

Symbole anzeigen

  Markiert man dieses Ankreuzfeld, zeigt &knewsticker;, so wird vor jeder Schlagzeile (falls vorhanden) ein Symbol angezeigt. Damit kann man leicht überblicken, aus welcher Nachrichtenquelle die Nachricht stammt.

Zeitweise verlangsamter Lauftext

  Markiert man dieses Ankreuzfeld, so verlangsamt sich der Lauftext in &knewsticker;, wenn man die Maus über den Lauftext bewegt. Damit wird das Klicken sowie das Wegziehen von Symbolen (falls aktiviert) wesentlich einfacher.

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.

## &knewsticker; verwenden

Die Verwendung von &knewsticker; sollte keine Probleme bereiten, vorausgesetzt, dass die Einrichtung von &knewsticker; erfolgt ist. Egal, ob &knewsticker; sich in der Kontrollleiste, innerhalb einer abhängigen Kontrollleiste oder in einem eigenen Fenster befindet, besteht das Programm aus einem Fenster mit dem Lauftext und einem Knopf mit einem schmalen Pfeil daneben.

### Das Hauptfenster

Der Bereich (er ist in der Voreinstellung weiß, aber seine Farbe kann im Einstellungsdialog geändert werden) mit dem laufenden Text heißt Lauftext. Hier werden die heruntergeladenen 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 linker 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 fünf 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 mit einem kleinen markiert. Klickt man auf diesen Eintrag, so wird ein kleiner Dialog geöffnet, der die Personen auflistet, die größere Beiträge zu &knewsticker; geleistet haben.

Einstellungen

  Dieser Eintrag kann leicht am Symbol identifiziert werden. Klickt man auf den Eintrag, so wird der Dialog Einrichtung geöffnet, mit dessen Hilfe man alle Eigenschaften von&knewsticker; anpassen kann.

## Fragen und Antworten

&reporting.bugs;

Wo finde ich die &RSS;-Datei für die Nachrichtenseite XYZ?

Es kann sein, dass die verwendete Nachrichtenquelle überhaupt keine &RSS;-Datei bereitstellt. Es folgt eine kurze Liste von Internetseiten, die tausende von &RSS;-Dateien, sortiert nach Sprache und/oder Thema, bereitstellen - kostenlos:

- WebReference.com

- NewsIsFree

- MoreOver

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

Wie kann ich mit &knewsticker; Artikel in einem anderen Browser (z. B. Mozilla) öffnen?

&knewsticker; verwendet denjenigen Browser, der mit dem &MIME;-Typ "text/html" verknüpft ist - der voreingestellte Browser für HTML-Dateien ist &konqueror;.

Den Dialog zum Ändern der Verknüpfungen findet man im Kontrollzentrum von &kde;. Dort muss der Eintrag KDE-Komponenten Dateizuordnungen gesucht werden.

## Mitwirkende und Lizenz

&knewsticker;

Programm Copyright 2000, 2001,2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;

Mitwirkende:

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

- &Wilco.Greven; &Wilco.Greven.mail;

- Adriaan de Groot adrig@sci.kun.nl

Dokumentation Copyright 2001, 2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;

Franke SchütteF.Schuette@t-online.de

&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; &Frerich.Raabe.mail; 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-Dateien sind zu finden 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 World Wide Web Consortium (W3C) interoperable Technologien (Spezifikationen, Richtlinien, Software und Hilfsprogramme), um das volle Potenzial des Internet 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, miteinander zu kommunizieren. Zum Beispiel verwendet &knewsticker;s Einrichtungsdialog DCOP, um dem Miniprogramm die aktuelle Konfiguration mitzuteilen.

  &knewsticker; bietet eine umfangreiche DCOP-Schnittstelle, die eine Programmkontrolle von der Befehlszeile ermöglicht.

  Weitere Informationen zu DCOP findet man unter http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html.

## Informationen für Entwickler und fortgeschrittene Benutzer

&knewsticker; enthält eine umfangreiche DCOP-Schnittstelle. 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 die Schnittstelle 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]

Falls eine Fehlermedlung mitteilt, dass `dcop` nicht gefunden oder ausgeführt werden kann, sollte man überprüfen, ob die Datei `dcop` im Ordner `$KDEDIR/bin` existiert und die korrekten Rechte gesetzt sind.

In dieser Befehlszeile ersetzen Sie einfach [Funktion] mit dem entsprechenden Funktionsnamen, z. B.

    % dcop knewsticker KNewsTicker updateNews

um &knewsticker; nach neuen Nachrichten suchen und diese bei Bedarf herunterladen zu lassen.

### &DCOP;-Referenz

In diesem Abschnitt werden alle Methoden beschrieben, die über die DCOP-Schnittstelle von &knewsticker; erreichbar sind.

`updateNews`

  Mit dieser Funktion wird &knewsticker; veranlasst, die interne Artikelliste zu aktualisieren (also die Liste der eingerichteten Nachrichtenquellen nach Neuigkeiten zu durchsuchen) und diese bei Bedarf herunterzuladen.

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

  Example:

      % dcop knewsticker KNewsTicker updateNews

`reparseConfig`

  Die Funktion `reparseConfig` lässt &knewsticker; die Einrichtung aus der Einrichtungsdatei erneut einlesen. Diese Funktion wird vom Einrichtungsdialog verwendet, aber Sie können sie auch selbst verwenden, wenn die Konfigurationsdatei von Hand geändert wurde.

  Die Einstellungen befinden sich in `~/.kde/share/config/knewsticker_appletrc`

  Example:

      % dcop knewsticker KNewsTicker reparseConfig

`setOfflineMode [bool]`

  Diese Funktion wird zum aktivieren oder deaktivieren des Offline-Modus verwendet (das heißt, ob &knewsticker; die eingerichteten Nachrichtenquellen nach neuen Nachrichten absuchen soll).

  Example:

      % dcop knewsticker KNewsTicker setOfflineMode true

  to enable the offline mode, or type

      % dcop knewsticker KNewsTicker setOfflineMode false

  to disable offline mode.

`interval`

  Gibt das augenblicklich eingestellte Intervall der Nachrichtenquellenabfrage in Minuten zurück.

  Example:

      % dcop knewsticker KNewsTicker interval
                              30
                              %

`Geschwindigkeit des Lauftextes`

  Gibt die augenblicklich eingestellte Lauftextgeschwindigkeit zurück. Es wird das Zeitintervall für die Bewegung in Pixel pro Millisekunden ausgegeben.

  Example:

      % dcop knewsticker KNewsTicker scrollingSpeed
                              20
                              %

`mouseWheelSpeed`

  Gibt die Anzahl der Pixel an, um die der Lauftext bei einem Schritt des Mausrades verschoben wird.

  Example:

      % dcop knewsticker KNewsTicker mouseWheelSpeed
                              15
                              %

`scrollingDirection`

  Gibt eine ganze Zahl zurück (Integer), die die Richtung des Lauftextes angibt:

  - 1 = nach links

  - 2 = nach rechts

  - 3 = aufwärts

  - 4 = abwärts

  - 5 = aufwärts, rotiert

  - 6 = abwärts, rotiert

  Example:

      % dcop knewsticker KNewsTicker scrollingDirection
                              1
                              %

`customNames`

  Gibt entweder 'true' oder 'false' aus, je nachdem, ob &knewsticker; benutzerdefinierte Namen für Nachrichtenquellen verwendet oder nicht.

  Example:

      % dcop knewsticker KNewsTicker customNames
                              false
                              %

`endlessScrolling`

  Gibt entweder 'true' oder 'false' aus, je nachdem ob die Option für endlosen Lauftext in &knewsticker; aktiviert ist.

  Example:

      % dcop knewsticker KNewsTicker endlessScrolling
                              true
                              %

`scrollMostRecentOnly`

  Gibt entweder 'true' oder 'false' aus, abhängig davon, ob im Lauftext von &knewsticker; augenblicklich nur die aktuellste Schlagzeile jeder Nachrichtenquelle anzeigt.

  Example:

      % dcop knewsticker KNewsTicker scrollMostRecentOnly
                              false
                              %

`offlineMode`

  Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob &knewsticker; gerade im Offline-Modus ausgeführt wird.

  Example:

      % dcop knewsticker KNewsTicker offlineMode
                              false
                              %

`underlineHighlighted`

  Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob &knewsticker; so eingerichtet ist, das die unter dem Mauszeiger befindliche Schlagzeile unterstrichen wird oder nicht.

  Example:

      % dcop knewsticker KNewsTicker underlineHighlighted
                              true
                              %

`showIcons`

  Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob &knewsticker; augenblicklich so eingerichtet ist, dass das Symbol der Nachrichtenquelle vor jeder Schlagzeile angezeigt wird.

  Example:

      % dcop knewsticker KNewsTicker showIcons
                              true
                              %

`slowedScrolling`

  Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob bei &knewsticker; die Funktion verlangsamter Lauftext aktiviert ist.

  Example:

      % dcop knewsticker KNewsTicker slowedScrolling
                              false
                              %

`foregroundColor`

  Gibt die augenblicklich eingestellte Vordergrundfarbe als Text in dem Format #rrggbb zurück. Dabei sind rr, gg und bb zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

  Example:

      % dcop knewsticker KNewsTicker foregroundColor
                              #804000
                              %

`backgroundColor`

  Gibt die augenblicklich eingestellte Hintergrundfarbe als Text in dem Format #rrggbb zurück. Dabei sind rr, gg und bb zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

  Example:

      % dcop knewsticker KNewsTicker backgroundColor
                              #0030ff
                              %

`highlightedColor`

  Gibt die augenblicklich eingestellte Hervorhebungsfarbe als Text in dem Format #rrggbb zurück. Dabei sind rr, gg und bb zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.

  Example:

      % dcop knewsticker KNewsTicker highlightedColor
                              #000080
                              %

`newsSources`

  Gibt eine Liste der augenblicklich registrierten Nachrichtenquellen zurück. Hierbei werden alle Nachrichtenquellen zurückgegeben, nicht nur die ausgewählten Quellen. In der Ausgabe wird der Name jeder Nachrichtenquelle in einer eigenen Zeile ausgegeben.

  Example:

      % dcop knewsticker KNewsTicker newsSources
                              Freshmeat
                              GNOME News
                              dot.kde.org
                              Slashdot.org
                              %

&documentation.index;