<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&knewsticker;">
<!ENTITY package "kdenetwork">
<!ENTITY % addindex "IGNORE">
<!ENTITY % German "INCLUDE">
<!ENTITY RSS "<acronym
>RSS</acronym
>">
]>

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &knewsticker;</title>

<authorgroup>
	<author
>&Frerich.Raabe; &Frerich.Raabe.mail;</author>
	<othercredit role="reviewer"
>&Jonathan.Singer; &Jonathan.Singer.mail;</othercredit>
	<othercredit role="translator"
><firstname
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>F.Schuette@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 
</authorgroup>

<copyright>
	<year
>2001, 2002, 2003</year>
	<holder
>&Frerich.Raabe;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-10-14</date>
<releaseinfo
>2.00.00</releaseinfo>

<abstract>
	<para
>&knewsticker; ist ein Nachrichten-Miniprogramm für die &kde;-Kontrollleiste ( auch als &kicker; bekannt).</para>
</abstract>

<keywordset>
	<keyword
>KDE</keyword>
	<keyword
>KNewsTicker</keyword>
	<keyword
>kdenetwork</keyword>
	<keyword
>Nachrichten-Ticker</keyword>
	<keyword
>applet</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Einleitung</title>

<para
>&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 <ulink url="http://slashdot.org"
>Slashdot</ulink
>, <ulink url="http://lwn.net"
>Linux Weekly News</ulink
> oder <ulink url="http://freshmeat.net"
>Freshmeat</ulink
>) angeboten werden.</para>

<para
>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.</para>

<sect1 id="rssfiles">
<title
>Kurze Information zu &RSS;-Dateien</title>

<para
>&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.</para>

<para
>Die kurze Antwort: &RSS; ist ein <acronym
>XML-basiertes</acronym
> Format zur Zusammenfassung von Web-Inhalten.</para>

<para
>&RSS; wird oft als Akronym für <quote
>Rich Site Summary</quote
> 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.</para>

<para
>&RSS; wurde 1999 von <ulink url="http://www.netscape.com"
>Netscape</ulink
> als Agenturformat für die Internetseite <ulink url="http://my.netscape.com"
>my.netscape.com</ulink
> 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 <quote
>&lt;scriptingNews&gt;</quote
> integrierte.</para>

<para
>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.</para>

<para
>Heutzutage gibt es einige umfangreichere Versionen von &RSS; (<ulink url="http://backend.userland.com/rss091"
>0.91</ulink
>, <ulink url="http://backend.userland.com/rss092"
>0.92</ulink
>, <ulink url="http://backend.userland.com/rss093"
>0.93</ulink
>, <ulink url="http://web.resource.org/rss/1.0/"
>1.0</ulink
> und das aktuelle Format <ulink url="http://backend.userland.com/rss"
>2.0</ulink
>), 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.</para>

<para
>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:</para>

<variablelist>
<varlistentry>
	<term
><ulink url="http://www.webreference.com/authoring/languages/xml/rss/intro/"
>http://www.webreference.com/authoring/languages/xml/rss/intro/</ulink
></term>
	<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
	<term
><ulink url="http://www.oreillynet.com/rss/"
>http://www.oreillynet.com/rss/</ulink
></term>
	<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
	<term
><ulink url="http://blogspace.com/rss/"
>http://blogspace.com/rss/</ulink
></term>
	<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
	<term
><ulink url="http://www.w3.org/RDF/"
>http://www.w3.org/RDF/</ulink
></term>
	<listitem
><para
><emphasis
>Die</emphasis
> offizielle Quelle zu <acronym
>RDF</acronym
>, eine <acronym
>XML</acronym
>-basierte Sprache, von der die heutigen Versionen von &RSS; abgeleitet sind, herausgegeben vom <ulink url="http://www.w3.org"
>World Wide Web Consortium</ulink
>. Sie enthält eine umfangreiche Liste anderer Internetseiten, als auch einen Zeitplan für die <acronym
>RDF</acronym
>-Entwicklung, einen Überblick über die Architektur, ein Archiv mit Artikeln über <acronym
>RDF</acronym
> sowie eine sorgfältig zusammengestellte Liste von Hilfsprogrammen für Entwickler, die <acronym
>RDF</acronym
> verwenden wollen.</para
></listitem>
</varlistentry>
</variablelist>

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

<orderedlist>
<title
>Spezifikationen zu &RSS;</title>
<listitem
><para
>Version 0.90: <ulink url="http://www.purplepages.ie/rss/netscape/rss0.90.html"
>http://www.purplepages.ie/rss/netscape/rss0.90.html</ulink
> </para
></listitem>
<listitem
><para
>Version 0.91: <ulink url="http://backend.userland.com/rss091"
>http://backend.userland.com/rss091</ulink
> </para
></listitem>
<listitem
><para
>Version 0.92: <ulink url="http://backend.userland.com/rss092"
>http://backend.userland.com/rss092</ulink
> </para
></listitem>
<listitem
><para
>Version 0.93: <ulink url="http://backend.userland.com/rss093"
>http://backend.userland.com/rss093</ulink
> </para
></listitem>
<listitem
><para
>Version 1.0: <ulink url="http://web.resource.org/rss/1.0/"
>http://web.resource.org/rss/1.0/</ulink
> </para
></listitem>
<listitem
><para
>Version 2.0: <ulink url="http://backend.userland.com/rss"
>http://backend.userland.com/rss</ulink
> </para
></listitem>
</orderedlist>

<para
>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.</para>

<para
>Vielen Dank!</para>
</sect1>
</chapter>

<chapter id="starting-knewsticker">
<title
>&knewsticker; starten</title>

<screenshot>
	<screeninfo
>Hier findet man einen Screenshot von &knewsticker; in &kde;s Kontrollleiste.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="knewsticker-kicker.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>Hier findet man einen Screenshot von &knewsticker; in &kde;s Kontrollleiste.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>&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ü <menuchoice
><guimenu
>Hinzufügen</guimenu
><guisubmenu
>Miniprogramm</guisubmenu
> <guimenuitem
>&knewsticker;</guimenuitem
></menuchoice
>.</para>

<screenshot>
	<screeninfo
>Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="knewsticker-childpanel.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>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 <menuchoice
><guimenu
>Hinzufügen</guimenu
> <guisubmenu
>Erweiterung</guisubmenu
><guimenuitem
>Abhängige Kontrollleiste</guimenuitem
> </menuchoice
> im Kontextmenü von &kicker;. Nun kann &knewsticker; wie oben beschrieben in diese abhängige Kontrollleiste eingefügt werden.</para>

<screenshot>
	<screeninfo
>Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="knewsticker-ownwindow.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>Hier ist ein Screenshot mit &knewsticker; in einem eigenen Ableger der Hauptkontrollleiste.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

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

<chapter id="configuration">
<title
>&knewsticker; einrichten</title>

<para
>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 <guimenuitem
><inlinemediaobject
><imageobject
> <imagedata fileref="preferences-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
> Einstellungen</guimenuitem
> im Menü wählt.</para>

<sect1 id="config-general">
<title
>Allgemeine Einstellungen</title>

<screenshot>
	<screeninfo
>So sieht die Karteikarte <guilabel
>Allgemein</guilabel
> aus.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="kcmnewsticker-general.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht die Karteikarte <guilabel
>Allgemein</guilabel
> aus.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>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:</para>

<variablelist>
<varlistentry>
	<term
><guilabel
>Empfindlichkeit des Mausrades:</guilabel
></term>
	<listitem>
		<para
>Dieser Schieberegler erlaubt die Einstellung, wie schnell der Lauftext bei Verwendung des Mausrades verschoben werden soll.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Zeitintervall zur Nachrichtenabfrage</guilabel
></term>
	<listitem>
		<para
>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:</para>
		<itemizedlist>
			<listitem>
				<para
>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. <ulink url="http://slashdot.org"
> Slashdot</ulink
> oder <ulink url="http://freshmeat.net"
>Freshmeat</ulink
>), da sie ohnehin bereits genügend Anfragen beantworten müssen.</para>
			</listitem>
			<listitem>
				<para
>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.</para>
			</listitem>
		</itemizedlist>
		<tip
><para
>Der Standardwert (30 Minuten) ist für die meisten Fälle sinnvoll und passend.</para
></tip>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Benutzerdefinierte Namen für Nachrichtenseiten benutzen</guilabel
></term>
	<listitem>
		<para
>Markiert man dieses Ankreuzfeld, so verwendet &knewsticker; die vom Benutzer festgelegten Namen in der Liste der Nachrichtenquellen (auf der Karteikarte <guilabel
>Nachrichtenquellen</guilabel
>) anstatt der von den Nachrichtenseiten selbst angegebenen Namen. Dies kann nützlich sein, falls eine Nachrichtenseite einen sehr langen Namen hat.</para>
	</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="config-newssources">
<title
>Einrichtung der Nachrichtenquellen</title>

<screenshot>
	<screeninfo
>So sieht die Karteikarte <guilabel
>Nachrichtenquellen</guilabel
> des Einrichtungsdialogs aus.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="kcmnewsticker-newssources.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht die Karteikarte <guilabel
>Nachrichtenquellen</guilabel
> des Einrichtungsdialogs aus.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>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.</para>

<sect2>
<title
>Eine Nachrichtenseite hinzufügen</title>
<para
>Man kann eine Nachrichtenquelle auf vier verschiedene Arten zur Liste <emphasis
>hinzufügen</emphasis
>:</para>
<itemizedlist>
	<listitem>
		<para
>Man kann unten auf den Knopf <guilabel
>Hinzufügen ...</guilabel
> klicken.</para>
	</listitem>
	<listitem>
		<para
>Man kann mit der rechten Maustaste auf die Tabelle klicken und <guimenuitem
>Nachrichtenquelle hinzufügen</guimenuitem
> auswählen.</para>
	</listitem>
	<listitem>
		<para
>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 <quote
>Unbekannt</quote
> lautet und dessen maximale Anzahl an Artikeln auf 10 gesetzt wird.</para>
	</listitem>
	<listitem>
		<para
>Schließlich kann man einfach im &konqueror;-Dateimanager auf eine beliebige &RSS;-Datei klicken, um sie direkt zur Liste hinzuzufügen.</para>
	</listitem>
</itemizedlist>
<para
>In jedem Fall erscheint der Dialog <link linkend="config-news-site-dialog"
>Nachrichtenquelle hinzufügen ...</link
>, in den man die Eigenschaften der neuen Nachrichtenquelle eintragen kann.</para>
</sect2>

<sect2>
<title
>Eine Nachrichtenquelle verändern</title>
<para
>Die Eigenschaften einer existierenden Nachrichtenquelle können auf zwei Arten verändert werden:</para>
<itemizedlist>
	<listitem>
		<para
>Man kann unten auf den Knopf <guilabel
>Bearbeiten ...</guilabel
> klicken.</para>
	</listitem>
	<listitem>
		<para
>Man kann mit der rechten Maustaste auf den Eintrag für die Nachrichtenquelle in der Liste klicken und <guimenuitem
>'...' bearbeiten</guimenuitem
> aus dem Menü auswählen.</para>
	</listitem>
</itemizedlist>
<para
>In jedem Fall erscheint der Dialog <link linkend="config-news-site-dialog"
>Nachrichtenquelle bearbeiten ...</link
> mit den Einstellungen der ausgewählten Nachrichtenseite.</para>
</sect2>

<sect2>
<title
>Eine Nachrichtenquelle entfernen</title>
<para
>Es kann vorkommen, dass man eine Nachrichtenquelle aus der Nachrichtenliste <emphasis
>entfernen</emphasis
> möchte. Das kann man auf verschiedene Arten tun:</para>
<itemizedlist>
	<listitem>
		<para
>Man kann auf den Knopf mit der Bezeichnung <guilabel
>Entfernen</guilabel
> klicken.</para>
	</listitem>
	<listitem>
		<para
>Man kann mit der rechten Maustaste auf die gewünschte Nachrichtenquelle klicken und aus dem Kontextmenü <guimenuitem
>'...' entfernen</guimenuitem
> auswählen.</para>
	</listitem>
</itemizedlist>
<para
>Damit nicht versehentlich eine Nachrichtenquelle gelöscht wird, erscheint in beiden Fällen ein Bestätigungsdialog.</para>
<tip
><para
>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 <mousebutton
>linker</mousebutton
> Maustaste die gewünschten Einträge überstreicht.</para
></tip>
</sect2>

<sect2 id="config-news-site-dialog">
<title
>Der Dialog Nachrichtenquelle</title>

<screenshot>
	<screeninfo
>So sieht der Dialog zum Hinzufügen und Bearbeiten von Nachrichtenquellen aus.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="kcmnewsticker-newssitedialog.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht der Dialog zum Hinzufügen und Bearbeiten von Nachrichtenquellen aus.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>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:</para>

<variablelist>
<varlistentry>
	<term
><guilabel
>Name:</guilabel
></term>
	<listitem>
		<para
>Das ist der Name der Nachrichtenquelle.</para>
		<note
><para
>Dieser Text wird nur dann verwendet, wenn man auf der Karteikarte <link linkend="config-general"
>Allgemein</link
> das Ankreuzfeld <guilabel
>Benutzerdefinierte Namen für Nachrichtenquellen verwenden</guilabel
> markiert hat.</para
></note>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Quelldatei:</guilabel
></term>
	<listitem>
		<para
>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;.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Die Datei ist ein Programm</guilabel
></term>
	<listitem>
		<para
>Falls dieses Ankreuzfeld markiert ist, nimmt &knewsticker; an, dass sich hinter der &URL; (die im Feld <guilabel
>Quelldatei</guilabel
> 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 <acronym
>HTML</acronym
>-Datei aus dem Internet zu laden und daraus einen &RSS;-Text zur Verwendung in &knewsticker; zu erstellen.</para>
		<tip
><para
>Man kann einige Beispielskripte &zb; zum Herunterladen von Börsendaten im Modul kdeaddons im Verzeichnis <filename class="directory"
>knewsticker-scripts</filename
> finden.</para
></tip>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Kategorie:</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Max. Artikel:</guilabel
></term>
	<listitem>
		<para
>Mit dieser Option kann man festlegen, wieviele Nachrichten der Quelle &knewsticker; zwischenspeichern soll. Dieser Wert wird nie überschritten.</para>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Symbol:</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
</variablelist>

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

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

<sect1 id="config-filters">
<title
>Filter</title>

<screenshot>
	<screeninfo
>So sieht die Karteikarte <guilabel
>Filter</guilabel
> des Einrichtungsdialogs aus.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="kcmnewsticker-filters.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht die Karteikarte <guilabel
>Filter</guilabel
> des Einrichtungsdialogs aus.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

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

<note
><para
>Die Filter betreffen nur die Schlagzeilen für den Lauftext. Im Menü sind immer alle Schlagzeilen sichtbar.</para
></note>
<para
>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.</para>

<para
>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:</para>

<itemizedlist>
<listitem>
	<para
>Zum <emphasis
>hinzufügen</emphasis
> eines Filters trägt man die gewünschten Eigenschaften (für Details siehe <link linkend="filter-components"
>Bestandteile von Filtern</link
>) in die Textfelder im Bereich <guilabel
>Filtereigenschaften</guilabel
> ein und klickt auf <guilabel
>Hinzufügen</guilabel
>.</para>
</listitem>
<listitem>
	<para
>Zum <emphasis
>Bearbeiten</emphasis
> eines vorhandenen Filters wählt man den Filter durch Klicken mit der linken Maustaste aus und ändert die Eigenschaften im Bereich unten.</para>
</listitem>
<listitem>
	<para
>Zum <emphasis
>Entfernen</emphasis
> eines Filters wählt man diesen in der Tabelle und klickt auf <guilabel
>Entfernen</guilabel
>.</para>
</listitem>
</itemizedlist>

<sect2 id="filter-components">
<title
>Bestandteile eines Filters</title>

<para
>Jeder Filter besteht aus vier Bestandteilen:</para>

<orderedlist>
<title
>Bestandteile eines Filters</title>
<listitem>
	<para
>Aktion - das kann entweder <guilabel
>Anzeigen</guilabel
> oder <guilabel
>Ausblenden</guilabel
> sein. Dies legt fest, was mit einer Nachricht passiert, auf deren Schlagzeile der Filter zutrifft.</para>
</listitem>
<listitem>
	<para
>Nachrichtenquellen - hier kann man festlegen, ob der Filter nur auf die Schlagzeilen einer Quelle oder auf die Schlagzeilen aller Quellen angewandt werden soll.</para>
</listitem>
<listitem>
	<para
>Bedingung - ein Verb, das zusammen mit einem Ausdruck die Filterregel darstellt. Bedingung kann z. B. <guilabel
>enthält</guilabel
>, <guilabel
>nicht gleich</guilabel
> oder <guilabel
>trifft zu</guilabel
> sein. Weiter unten befindet sich eine ausführlichere Beschreibung.</para>
</listitem>
<listitem>
	<para
>Ausdruck - ein benutzerdefinierter Text, der zusammen mit einer Bedingung den Inhalt der Filterregel bestimmt. Weiter unten befindet sich dazu eine detailierte Beschreibung.</para>
</listitem>
</orderedlist>

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

<itemizedlist>
<listitem>
	<para
><guilabel
>enthält</guilabel
> und <guilabel
>enthält nicht</guilabel
>: diese Filter treffen zu, wenn die Schlagzeile den angegebenen Ausdruck enthält / nicht enthält.</para>
	<note
><para
>Beim Ausdruck wird nicht zwischen Groß- und Kleinschreibung unterschieden, also trifft der Filter, der durch "enthält <quote
>KDE</quote
>" definiert ist, auf <quote
>KDE</quote
>, <quote
>kDE</quote
> oder auch <quote
>kde</quote
> zu.</para
></note>
</listitem>
<listitem>
	<para
><guilabel
>gleich</guilabel
>, <guilabel
>nicht gleich</guilabel
>: dieser Filter trifft zu, wenn die Schlagzeile gleich / ungleich dem angegebenen Ausdruck ist.</para>
	<note
><para
>Beim Ausdruck wird zwischen Groß- und Kleinschreibung unterschieden, also von <quote
>Linux</quote
>, <quote
>linux</quote
> oder <quote
>LINUX</quote
> passt nur der erste Ausdruck auf <quote
>Linux</quote
>.</para
></note>
</listitem>
<listitem>
	<para
><guilabel
>trifft zu</guilabel
>: bei dieser Bedingung behandelt &knewsticker; den angegebenen Ausdruck als <quote
>regulären Ausdruck</quote
>. Weitere Informationen zu regulären Ausdrücken findet man in <ulink url="http://www.evolt.org/article/rating/20/22700/"
>diesem Artikel</ulink
>, der auf <ulink url="http://www.evolt.org"
>www.evolt.org</ulink
> veröffentlicht worden ist.</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>

<sect1 id="config-scroller">
<title
>Lauftext</title>

<screenshot>
	<screeninfo
>So sieht die Karteikarte <guilabel
>Lauftext</guilabel
> des Einrichtungsdialogs aus.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="kcmnewsticker-scrollerprefs.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht die Karteikarte <guilabel
>Lauftext</guilabel
> des Einrichtungsdialogs aus.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Auf dieser Karteikarte kann man verschiedene Einstellungen zu &knewsticker;s Lauftext vornehmen:</para>

<variablelist>
<varlistentry>
	<term
><guilabel
>Geschwindigkeit des Lauftextes</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Laufrichtung</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Schriftart</guilabel
></term>
	<listitem>
		<para
>Man klickt auf den Knopf <quote
>Schriftart wählen ...</quote
>, um eine Schriftart für den Lauftext auszuwählen.</para>
		<tip
><para
>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.</para
></tip>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Vordergrundfarbe</guilabel
></term>
	<listitem>
		<para
>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).</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Hintergrundfarbe</guilabel
></term>
	<listitem>
		<para
>Klickt man auf diesen Knopf, so öffnet sich ein Farbauswahldialog, der die Auswahl der Hintergrundfarbe des Lauftextes erlaubt.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Hervorhebungsfarbe</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Nur die aktuellsten Schlagzeilen anzeigen</guilabel
></term>
	<listitem>
		<para
>Markiert man dieses Feld, so wird von jeder Nachrichtenseite nur die aktuellste Nachricht anstatt aller verfügbaren Nachrichten angezeigt.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Symbole anzeigen</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Zeitweise verlangsamter Lauftext</guilabel
></term>
	<listitem>
		<para
>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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Hervorgehobene Schlagzeile unterstreichen</guilabel
></term>
	<listitem>
		<para
>Markiert man dieses Ankreuzfeld, so wird die hervorgehobene Schlagzeile (also die Schlagzeile, über der sich der Mauszeiger befindet) zusätzlich unterstrichen dargestellt.</para>
	</listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter>

<chapter id="using-knewsticker">
<title
>&knewsticker; verwenden</title>

<para
>Die Verwendung von &knewsticker; sollte keine Probleme bereiten, vorausgesetzt, dass die <link linkend="configuration"
>Einrichtung von &knewsticker;</link
> 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.</para>

<sect1 id="applet-descr">
<title
>Das Hauptfenster</title>

<para
>Der Bereich (er ist in der Voreinstellung weiß, aber seine Farbe kann im Einstellungsdialog geändert werden) mit dem laufenden Text heißt <quote
>Lauftext</quote
>. 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:</para>

<itemizedlist>
	<listitem>
		<para
>Man kann mit der <mousebutton
>linken</mousebutton
> Maustaste auf den Lauftext klicken und (bei gedrückter <mousebutton
>linker</mousebutton
> Maustaste) die Maus hin- und herbewegen. Nach dem Loslassen der Maustaste läuft der Lauftext weiter.</para>
	</listitem>
	<listitem>
		<para
>Wenn man über eine Maus mit <quote
>Mausrad</quote
> verfügt, kann man auch das Rad verwenden, um den Lauftext vor- und zurückzuspulen.</para>
	</listitem>
</itemizedlist>

<para
>Indem man entweder mit der <mousebutton
>rechten</mousebutton
> Maustaste klickt oder mit der linken auf den Pfeilknopf klickt, kann man ein umfangreiches <link linkend="contextmenu-descr"
>Kontextmenü</link
> aufrufen. Dieses Menü enthält beinahe die gesamte Funktionalität des Miniprogramms.</para>
</sect1>

<sect1 id="contextmenu-descr">
<title
>Das Kontextmenü</title>

<screenshot>
	<screeninfo
>So sieht das Kontextmenü von &knewsticker; aus, wenn man die Standardnachrichtenquellen verwendet.</screeninfo>
	<mediaobject>
		<imageobject
><imagedata fileref="contextmenu.png" format="PNG"/></imageobject>
		<textobject>
			<phrase
>So sieht das Kontextmenü von &knewsticker; aus, wenn man die Standardnachrichtenquellen verwendet.</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Das Kontextmenü ist aufgeteilt in zwei Teile:</para>

<para
>Der obere Teil enthält eine Liste von Einträgen, die alle ein kleines Symbol wie dieses <inlinemediaobject
><imageobject
> <imagedata fileref="newssite-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
> 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 <guilabel
> <inlinemediaobject
><imageobject
><imagedata fileref="checknews-icon.png" format="PNG"/></imageobject
></inlinemediaobject
>Nachrichten holen</guilabel
>, der dazu dient die Schlagzeilenliste dieser Nachrichtenquelle aufzufrischen. Neben jeder Schlagzeile befindet sich entweder das Symbol <inlinemediaobject
><imageobject
> <imagedata fileref="oldarticle-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
>, das anzeigt, dieser Artikel wurde bereits gelesen, oder das Symbol <inlinemediaobject
><imageobject
> <imagedata fileref="newarticle-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
>, das auf einen ungelesenen Artikel hindeutet.</para>

<para
>Der untere Teil des Menüs enthält bisher fünf Einträge (erläutert von oben nach unten):</para>

<variablelist>
<varlistentry>
	<term
><guilabel
><inlinemediaobject
><imageobject
><imagedata fileref="checknews-icon.png" format="PNG"/></imageobject
></inlinemediaobject
> Nachrichten holen</guilabel
></term>
	<listitem>
		<para
>Dieser Eintrag hat das kleine Symbol <inlinemediaobject
><imageobject
> <imagedata fileref="checknews-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
>. Dieser Menüpunkt veranlasst &knewsticker;, die Nachrichtenquellen nach neuen Nachrichten abzusuchen.</para>
		<note
><para
>Der interne Intervallzähler wird durch diesen Eintrag nicht auf Null gesetzt.</para
></note>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
>Offline-Modus</guilabel
></term>
	<listitem>
		<para
>Dieser Eintrag hat kein Symbol. Klickt man auf diesen Eintrag, so wird &knewsticker; in den <quote
>Offline-Modus</quote
> 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.</para>
		<tip
><para
>Auch im Offline-Modus kann man explizit neue Schlagzeilen herunterladen, indem man auf den Eintrag <guilabel
><inlinemediaobject
><imageobject
> <imagedata fileref="checknews-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
>Nachrichten holen</guilabel
> für alle Nachrichtenseiten oder für eine spezielle Nachrichtenseite klickt.</para
></tip>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
><inlinemediaobject
><imageobject
><imagedata fileref="help-icon.png" format="PNG"/></imageobject
></inlinemediaobject
> Hilfe</guilabel
></term>
	<listitem>
		<para
>Dieser Eintrag ist mit einem kleinen <inlinemediaobject
> <imageobject
><imagedata fileref="help-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
> 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;.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
><inlinemediaobject
><imageobject
><imagedata fileref="knewsticker-icon.png" format="PNG"/></imageobject
></inlinemediaobject
> Über</guilabel
></term>
	<listitem>
		<para
>Dieser Eintrag ist mit einem kleinen <inlinemediaobject
> <imageobject
><imagedata fileref="help-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
> 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.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><guilabel
><inlinemediaobject
><imageobject
><imagedata fileref="preferences-icon.png" format="PNG"/></imageobject
></inlinemediaobject
> Einstellungen</guilabel
></term>
	<listitem>
		<para
>Dieser Eintrag kann leicht am Symbol <inlinemediaobject
> <imageobject
><imagedata fileref="preferences-icon.png" format="PNG"/></imageobject
> </inlinemediaobject
> identifiziert werden. Klickt man auf den Eintrag, so wird der Dialog <link linkend="configuration"
>Einrichtung</link
> geöffnet, mit dessen Hilfe man alle Eigenschaften von&knewsticker; anpassen kann.</para>
	</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="faq">
<title
>Fragen und Antworten</title>
&reporting.bugs; <qandaset id="faqlist">
<qandaentry>
	<question>
		<para
>Wo finde ich die &RSS;-Datei für die Nachrichtenseite XYZ?</para>
	</question>
	<answer>
		<para
>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:</para>

		<itemizedlist>
		<listitem
><para>
		<ulink url="http://www.webreference.com/services/news"
>WebReference.com</ulink>
		</para
></listitem>
		<listitem
><para>
		<ulink url="http://www.newsisfree.com/syndicate.php"
>NewsIsFree</ulink>
		</para
></listitem>
		<listitem
><para>
		<ulink url="http://w.moreover.com/categories/category_list_rss.html"
>MoreOver</ulink>
		</para
></listitem>
		</itemizedlist>

		<para
>Falls man interessante Nachrichtenseiten findet, die <acronym
>RDF</acronym
>- oder <acronym
>RSS</acronym
>-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!</para>
	</answer>
</qandaentry>
<qandaentry>
	<question>
		<para
>Wie kann ich mit &knewsticker; Artikel in einem anderen Browser (z. B. Mozilla) öffnen?</para>
	</question>
	<answer>
		<para
>&knewsticker; verwendet denjenigen Browser, der mit dem &MIME;-Typ "text/html" verknüpft ist - der voreingestellte Browser für <acronym
>HTML</acronym
>-Dateien ist &konqueror;.</para>
		<para
>Den Dialog zum Ändern der Verknüpfungen findet man im Kontrollzentrum von &kde;. Dort muss der Eintrag <menuchoice
><guimenu
>KDE-Komponenten</guimenu
><guisubmenu
>Dateizuordnungen</guisubmenu
></menuchoice
> gesucht werden.</para>
	</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">
<title
>Mitwirkende und Lizenz</title>

<para
>&knewsticker;</para>

<para
>Programm Copyright 2000, 2001,2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;</para>

<para
>Mitwirkende:</para>

<itemizedlist>
<listitem>
	<para
>Malte Starostik <email
>malte.starostik@t-online.de</email
></para>
</listitem>
<listitem>
	<para
>&Wilco.Greven; &Wilco.Greven.mail;</para>
</listitem>
<listitem>
	<para
>Adriaan de Groot <email
>adrig@sci.kun.nl</email
></para>
</listitem>
</itemizedlist>

<para
>Dokumentation Copyright 2001, 2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;</para>

<para
>Franke Schütte<email
>F.Schuette@t-online.de</email
></para
> 
&underFDL; &underBSDLicense; </chapter>

<glossary id="glossary">
<title
>Glossar</title>

<para
>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!</para>

<glossentry id="gloss-rdf">
	<glossterm
>RDF</glossterm>
	<glossdef>
		<para
>Resource Description Framework. Eine von <acronym
>XML</acronym
> abgeleitete Sprache zur Beschreibung von Metadaten. Üblicherweise verwendet für Artikel und andere Veröffentlichungen. Weitere Informationen zu <acronym
>RDF</acronym
>-Dateien sind zu finden auf der <ulink url="http://www.w3.org/RDF/"
>offiziellen Seite zu <acronym
> RDF</acronym
>-Dateien</ulink
> beim <ulink url="http://www.w3.org"
>World Wide Web Consortium</ulink
>.</para>
	</glossdef>
</glossentry>
<glossentry id="gloss-rss">
	<glossterm
>&RSS;</glossterm>
	<glossdef>
		<para
>Die <acronym
>RDF</acronym
> Site Summary ist nach Aussagen von der offiziellen <ulink url="http://www.purl.org/rss/1.0/"
>&RSS; v1.0 specification</ulink
> eine Erweiterung der <acronym
>RDF</acronym
>-Sprache:</para>
		<para
><quote
><acronym
>RDF</acronym
> Site Summary (&RSS;) ist ein schlankes und erweiterbares Metadatenbeschreibungformat. &RSS; ist eine <acronym
>XML</acronym
>-Anwendung, entspricht dem <acronym
>W3C</acronym
>-Standard für <acronym
>RDF</acronym
> und ist durch einen <acronym
>XML</acronym
>-Namensraum und/oder <acronym
>RDF</acronym
>-basierte Modularisierung erweiterbar.</quote
></para>
	</glossdef>
</glossentry>
<glossentry id="gloss-xml">
	<glossterm
>&XML;</glossterm>
	<glossdef>
		<para
>Die Extensible Markup Language ist das <quote
>universelle Format für strukturierte Dokumente und Daten im Web</quote
>. Es ist von <acronym
>SGML</acronym
> abgeleitet und an die Bedürfnisse des World Wide Web angepasst. Weitere Informationen findet man unter <ulink url="http://www.w3.org/XML/"
>Extensible Markup Language</ulink
> beim <ulink url="http://www.w3.org"
>World Wide Web Consortium</ulink
>.</para>
	</glossdef>
</glossentry>
<glossentry id="gloss-w3c">
	<glossterm
>W3C</glossterm>
	<glossdef>
		<para
>Eine Abkürzung für das <quote
>World Wide Web Consortium</quote
>. Nach der <ulink url="http://www.w3.org"
>offiziellen Seite</ulink
> des <acronym
>W3C</acronym
> entwickelt das <quote
>World Wide Web Consortium  (<acronym
>W3C</acronym
>) 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.</quote
></para>
	</glossdef>
</glossentry>
<glossentry id="gloss-url">
	<glossterm
>&URL;</glossterm>
	<glossdef>
		<para
>&URL; steht für <quote
>Uniforme Resource Locator</quote
>, einem speziell formatierten Text, der Resourcen wie Bilder, Dokumente und andere Dinge im Internet identifizieren kann. Weitere Informationen unter <ulink url="http://www.w3.org/Addressing/"
>dieser Internetseite</ulink
>.</para>
	</glossdef>
</glossentry>
<glossentry id="gloss-dcop">
	<glossterm
>&DCOP;</glossterm>
	<glossdef>
		<para
>Das Desktop COmmunication Protocol ist ein Weg für Anwendungen, miteinander zu kommunizieren. Zum Beispiel verwendet &knewsticker;s <link linkend="configuration"
>Einrichtungsdialog</link
> <acronym
>DCOP</acronym
>, um dem Miniprogramm die aktuelle Konfiguration mitzuteilen.</para>
		<para
>&knewsticker; bietet eine umfangreiche <link linkend="develinfo"
><acronym
>DCOP</acronym
>-Schnittstelle</link
>, die eine Programmkontrolle von der Befehlszeile ermöglicht.</para>
		<para
>Weitere Informationen zu <acronym
>DCOP</acronym
> findet man unter <ulink url="http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html"
> http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html</ulink
>.</para>
	</glossdef>
</glossentry>
</glossary>

<appendix id="develinfo">
<title
>Informationen für Entwickler und fortgeschrittene Benutzer</title>

<para
>&knewsticker; enthält eine umfangreiche <acronym
>DCOP</acronym
>-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.</para>

<para
>Um diese <acronym
>DCOP</acronym
>-Funktionen zu nutzen, kann man entweder den Befehl<application
>dcop</application
> oder das komfortablere <application
>KDCOP</application
>-Programm verwenden. Beide sind funktionell gleich, also entscheidet lediglich der Geschmack. :-)</para>

<para
>In diesesm Kapitel wird angenommen, dass das Befehlszeilenprogramm <application
>DCOP</application
> verwendet wird, um &knewsticker;s <acronym
>DCOP</acronym
>-Funktionen zu verwenden. Man muss zunächst &knewsticker; <link linkend="starting-knewsticker"
>starten</link
> und dann das Folgende an der Konsole eingeben:</para>

<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>[function]</option
></userinput
>
</screen>

<note
><para
>Falls eine Fehlermedlung mitteilt, dass <filename
>dcop</filename
> nicht gefunden oder ausgeführt werden kann, sollte man überprüfen, ob die Datei <filename
>dcop</filename
> im Ordner <filename class="directory"
>$KDEDIR/bin</filename
> existiert und die korrekten Rechte gesetzt sind.</para
></note>

<para
>In dieser Befehlszeile ersetzen Sie einfach <quote
>[Funktion]</quote
> mit dem entsprechenden Funktionsnamen, z. B.</para>

<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>updateNews</option
></userinput
>
</screen>

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

<sect1 id="dcop-reference">
<title
>&DCOP;-Referenz</title>

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

<variablelist>
<varlistentry>
	<term
><command
>updateNews</command
></term>
	<listitem>
		<para
>Mit dieser Funktion wird &knewsticker; veranlasst, die interne Artikelliste zu aktualisieren (also die Liste der <link linkend="config-newssources"
>eingerichteten</link
> Nachrichtenquellen nach Neuigkeiten zu durchsuchen) und diese bei Bedarf herunterzuladen.</para>
		<note
><para
>This also works if &knewsticker; is currently in offline mode.</para
></note>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>updateNews</option
></userinput
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>reparseConfig</command
></term>
	<listitem>
		<para
>Die Funktion <command
>reparseConfig</command
> lässt &knewsticker; die Einrichtung aus der Einrichtungsdatei erneut einlesen. Diese Funktion wird vom <link linkend="configuration"
>Einrichtungsdialog</link
> verwendet, aber Sie können sie auch selbst verwenden, wenn die Konfigurationsdatei von Hand geändert wurde.</para>
		<tip
><para
>Die Einstellungen befinden sich in <filename
>~/.kde/share/config/knewsticker_appletrc</filename
></para
></tip>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>reparseConfig</option
></userinput
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>setOfflineMode [bool]</command
></term>
	<listitem>
		<para
>Diese Funktion wird zum aktivieren oder deaktivieren des Offline-Modus verwendet (das heißt, ob &knewsticker; die <link linkend="config-newssources"
>eingerichteten Nachrichtenquellen</link
> nach neuen Nachrichten absuchen soll).</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>setOfflineMode</option
> <option
>true</option
></userinput
>
                </screen>
		<para
>to enable the offline mode, or type</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>setOfflineMode</option
> <option
>false</option
></userinput
>
                </screen>
		<para
>to disable offline mode.</para>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>interval</command
></term>
	<listitem>
		<para
>Gibt das augenblicklich eingestellte Intervall der Nachrichtenquellenabfrage in Minuten zurück.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>interval</option
></userinput>
                        30
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>Geschwindigkeit des Lauftextes</command
></term>
	<listitem>
		<para
>Gibt die augenblicklich eingestellte Lauftextgeschwindigkeit zurück. Es wird das Zeitintervall für die Bewegung in Pixel pro Millisekunden ausgegeben.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>scrollingSpeed</option
></userinput>
                        20
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>mouseWheelSpeed</command
></term>
	<listitem>
		<para
>Gibt die Anzahl der Pixel an, um die der Lauftext bei einem Schritt des Mausrades verschoben wird.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>mouseWheelSpeed</option
></userinput>
                        15
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>scrollingDirection</command
></term>
	<listitem>
		<para
>Gibt eine ganze Zahl zurück (Integer), die die Richtung des Lauftextes angibt:</para>
		<itemizedlist>
			<listitem
><para
>1 = nach links</para
></listitem>
			<listitem
><para
>2 = nach rechts</para
></listitem>
			<listitem
><para
>3 = aufwärts</para
></listitem>
			<listitem
><para
>4 = abwärts</para
></listitem>
			<listitem
><para
>5 = aufwärts, rotiert</para
></listitem>
			<listitem
><para
>6 = abwärts, rotiert</para
></listitem>
		</itemizedlist>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>scrollingDirection</option
></userinput>
                        1
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>customNames</command
></term>
	<listitem>
		<para
>Gibt entweder 'true' oder 'false' aus, je nachdem, ob &knewsticker; benutzerdefinierte Namen für Nachrichtenquellen verwendet oder nicht.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>customNames</option
></userinput>
                        false
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>endlessScrolling</command
></term>
	<listitem>
		<para
>Gibt entweder 'true' oder 'false' aus, je nachdem ob die Option für endlosen Lauftext in &knewsticker; aktiviert ist.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>endlessScrolling</option
></userinput>
                        true
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>scrollMostRecentOnly</command
></term>
	<listitem>
		<para
>Gibt entweder 'true' oder 'false' aus, abhängig davon, ob im Lauftext von &knewsticker; augenblicklich nur die aktuellste Schlagzeile jeder Nachrichtenquelle anzeigt.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>scrollMostRecentOnly</option
></userinput>
                        false
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>offlineMode</command
></term>
	<listitem>
		<para
>Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob &knewsticker; gerade im Offline-Modus ausgeführt wird.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>offlineMode</option
></userinput>
                        false
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>underlineHighlighted</command
></term>
	<listitem>
		<para
>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.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>underlineHighlighted</option
></userinput>
                        true
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>showIcons</command
></term>
	<listitem>
		<para
>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.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>showIcons</option
></userinput>
                        true
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>slowedScrolling</command
></term>
	<listitem>
		<para
>Gibt entweder 'true' oder 'false' zurück, abhängig davon, ob bei &knewsticker; die Funktion <quote
>verlangsamter Lauftext</quote
> aktiviert ist.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>slowedScrolling</option
></userinput>
                        false
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>foregroundColor</command
></term>
	<listitem>
		<para
>Gibt die augenblicklich eingestellte Vordergrundfarbe als Text in dem Format <quote
>#rrggbb</quote
> zurück. Dabei sind <quote
>rr</quote
>, <quote
>gg</quote
> und <quote
>bb</quote
> zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>foregroundColor</option
></userinput>
                        #804000
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>backgroundColor</command
></term>
	<listitem>
		<para
>Gibt die augenblicklich eingestellte Hintergrundfarbe als Text in dem Format <quote
>#rrggbb</quote
> zurück. Dabei sind <quote
>rr</quote
>, <quote
>gg</quote
> und <quote
>bb</quote
> zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>backgroundColor</option
></userinput>
                        #0030ff
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>highlightedColor</command
></term>
	<listitem>
		<para
>Gibt die augenblicklich eingestellte Hervorhebungsfarbe als Text in dem Format <quote
>#rrggbb</quote
> zurück. Dabei sind <quote
>rr</quote
>, <quote
>gg</quote
> und <quote
>bb</quote
> zweiziffrige Hexadezimalzahlen, die die Intensität der Grundfarben rot, grün und blau auf einer Skala von 00-ff repräsentieren.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>highlightedColor</option
></userinput>
                        #000080
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
<varlistentry>
	<term
><command
>newsSources</command
></term>
	<listitem>
		<para
>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.</para>
		<para
>Example:</para>
		<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>dcop</command
> <option
>knewsticker</option
> <option
>KNewsTicker</option
> <option
>newsSources</option
></userinput>
                        Freshmeat
                        GNOME News
                        dot.kde.org
                        Slashdot.org
                        <prompt
>%</prompt
>
                </screen>
	</listitem>
</varlistentry>
</variablelist>
</sect1>
</appendix>

&documentation.index;

</book>
