<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&klipper;" -- this only *seems* redundant -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>


<book lang="&language;">

<bookinfo>
<title>Das &klipper;-Handbuch </title>

<authorgroup>
<author>
<firstname>Philip</firstname>
<surname>Rodrigues</surname>
<affiliation>
<address><email>philip.rodrigues@libertysurf.co.uk</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Carsten</firstname>
<surname>Pfeiffer</surname>
<affiliation>
<address><email>pfeiffer@kde.org</email></address>
</affiliation>
<contrib>Entwickler</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation>
<address><email>vampyr@atconnex.net</email></address>
</affiliation>
<contrib>Gegengelesen von</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Gregor</firstname>
<surname>Zumstein</surname>
<affiliation>
<address><email>zumstein@ssd.ethz.ch</email></address>
</affiliation>
<contrib>&Uuml;bersetzung von</contrib>
</othercredit>

</authorgroup>

<copyright>
<year>2000</year>
<holder>Philip Rodrigues</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>28/01/2001</date>
<releaseinfo>2.0.0</releaseinfo>

<abstract>
<para>&klipper; ist das Dienstprogramm f&uuml;r die KDE-Zwischenablage.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Klipper</keyword>
<keyword>kdebase</keyword>
<keyword>Zwischenablage</keyword>
</keywordset>
</bookinfo>

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

<para>&klipper; ist das Dienstprogramm f&uuml;r die KDE-Zwischenablage. Es speichertKopien in der Zwischenablage und erlaubt es, Inhalte der Zwischenablage mittels Aktionen mit Anwendungen zu verbinden. Bitte melden Sie Probleme und W&uuml;nsche nach Erweiterungen an Carsten Pfeiffer
<email>pfeiffer@kde.org</email>.</para>

<sect1 id="klipper-revhistory">
<title>&klipper;-&Auml;nderungen</title>

<itemizedlist>
<listitem><para>2.0.1 - Timeout, falls das &klipper;-Men&uuml; nicht gebraucht wird.</para></listitem>
<listitem><para>2.0 - Version f&uuml;r KDE 2.0. Neu sind ein Dialog zum Einrichten, das Speichern des Verlaufs in der Zwischenablage beim Beenden des Programms und Aktionen</para></listitem>
<listitem><para>1.0 - Erste Version</para></listitem></itemizedlist>
</sect1>
</chapter>

<chapter id="using-klipper">
<title>Wie benutze ich &klipper;</title>

<sect1 id="basic-usage">
<title>Einfache Aufgaben</title> 

<para>Um den Verlauf in der Zwischenablage anzuzeigen, muss das Symbol von &klipper; angeklickt  oder die Tastenkombination 
<keycombo action="simul">&Strg;<keycap>Alt</keycap><keycap>V</keycap>
</keycombo> gedr&uuml;ckt werden. Im Kontextmen&uuml;, das daraufhin erscheint, werden alle bisherigen Zwischenablage-Texte angezeigt. Wenn einer davon ausgew&auml;hlt wird, so wird er zum aktuellen Wert der Zwischenablage, von wo er in alle KDE- oder X-Anwendungen kopiert werden kann, wie man es gewohnt ist.
</para>
</sect1>

<sect1 id="actions">
<title>Aktionen</title>

<para>&klipper; kann Aktionen auf Basis von regul&auml;ren Ausdr&uuml;cken mit dem Inhalt der Zwischenablage durchf&uuml;hren. Zum Beispiel k&ouml;nnen alle Eintr&auml;ge der Zwischenablage, welche mit &quot;http://&quot; beginnen, an <application>Netscape</application> oder &konqueror; weitergeleitet werden, um die Webseite anzuzeigen.</para>

<para>Um diese M&ouml;glichkeit zu nutzen, muss eine &URL; oder ein Dateiname in die Zwischenablage kopiert werden. Wenn dann ein regul&auml;rer Ausdruck zutrifft, der von &klipper; gespeichert ist, erscheint ein Men&uuml;, welches die M&ouml;glichkeiten anzeigt, die zur Verf&uuml;gung stehen. Das kann zum Beispiel eine &URL; sein, die sich mit &konqueror; oder <application>Netscape</application> &ouml;ffnen l&auml;sst.
</para>

<para>Wenn keine Aktionen auf dem Inhalt der Zwischenablage durchgef&uuml;hrt werden sollen, muss der Eintrag 
"<guimenuitem>Nichts ausf&uuml;hren</guimenuitem>" im Kontextmen&uuml; gew&auml;hlt werden. Wenn Sie nichts tun, verschwindet das Men&uuml; nach einer vorgegebenen Zeit und Sie k&ouml;nnen problemlos weiterarbeiten. Sie k&ouml;nnen im Einstellungen-Dialog unter dem Punkt <guilabel>Zeitlimit f&uuml;r Aktionen-Men&uuml;s</guilabel> der Karteikarte <guilabel>Allgemein</guilabel> einstellen, wie lange das Men&uuml; angezeigt werden soll.</para>

<para>Aktionen k&ouml;nnen vollst&auml;ndig abgestellt werden, wenn im Kontextmen&uuml; der Eintrag "<guimenuitem>Aktionen aktiviert</guimenuitem>" gew&auml;hlt wird, oder die Tastenkombination
<keycombo action="simul">&Strg;<keycap>Alt</keycap><keycap>X</keycap></keycombo> gedr&uuml;ckt wird.
</para>

<para>Eintr&auml;ge der Zwischenablage, auf welche ein regul&auml;rer Ausdruck zutrifft, k&ouml;nnen vor der Weiterleitung an eine Anwendung noch bearbeitet werden. Die Eintr&auml;ge der Zwischenablage k&ouml;nnen ver&auml;ndert werden, wenn im Kontextmen&uuml; der Befehl "<guimenuitem>Bearbeiten und nochmals durchf&uuml;hren</guimenuitem>" gew&auml;hlt wird. Mit einem Klick auf <guibutton>OK</guibutton> wird dann die gew&uuml;nschte Aktion durchgef&uuml;hrt.
</para>

<para>Auf die Tastenkombination
<keycombo action="simul">&Strg;<keycap>Alt</keycap><keycap>R</keycap></keycombo> hin &ouml;ffnet &klipper; ein Kontextmen&uuml;, wo die letzte Aktion wiederholt werden kann.
</para>

</sect1>
</chapter>

<chapter id="configuration">
<title>Klipper einrichten</title>

<sect1 id="viewing-options">

<title>Einrichten</title>

<para>Um die Einstellungen f&uuml;r &klipper; anzusehen oder zu &auml;ndern, klickt man auf &klipper; und w&auml;hlt im Kontextmen&uuml; den Eintrag <guimenu>Einrichtung</guimenu>. Dies &ouml;ffnet einen Dialog mit den folgenden Einstellm&ouml;glichkeiten:
</para>

<sect2 id="general-tab">
<title>Allgemein</title>

<variablelist>
<varlistentry>
<term><guilabel>Kontextmen&uuml; an Mausposition &ouml;ffnen</guilabel></term>
<listitem><para>Die Kontextmen&uuml;s von &klipper; werden dort ge&ouml;ffnet, wo sich die Maus befindet und nicht immer an der Standardstelle. Dies ist vor allem dann n&uuml;tzlich, wenn die Maus h&auml;ufiger als die Tastatur benutzt wird.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Inhalt der Zwischenablage beim Verlassen speichern</guilabel></term>
<listitem><para>Ist dieses Ankreuzfeld an, so wird beim Beenden von &klipper; der Verlauf der Zwischenablage gespeichert und beim n&auml;chsten Start wieder geladen.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zeitlimit f&uuml;r Aktionen-Men&uuml;s</guilabel></term>
<listitem><para>Hier k&ouml;nnen Sie festlegen, wie lange das Kontextmen&uuml; ge&ouml;ffnet bleibt, wenn Sie nichts machen.</para></listitem>
</varlistentry>
</variablelist>
</sect2>


<sect2 id="actions-tab">
<title>Aktionen</title>

<variablelist>
<varlistentry>
<term><guilabel>Aktionen/Ausdr&uuml;cke bearbeiten</guilabel></term>
<listitem><para>Auf der Seite <guilabel>Aktionen</guilabel> k&ouml;nnen Aktionen bearbeitet werden, indem ein Doppelklick auf ein Aktion gemacht wird. Hier kann der regul&auml;re Ausdruck bearbeitet werden. Mit der Eingabetaste wird die Bearbeitung abgeschlossen.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hinzuf&uuml;gen von Aktionen/Ausdr&uuml;cken</guilabel></term>
<listitem><para>Ein Druck auf den Knopf <guimenuitem>Aktion hinzuf&uuml;gen</guimenuitem> erzeugt einen neuen regul&auml;ren Ausdruck, auf den &klipper reagieren kann. (F&uuml;r Interessierte: &klipper benutzt die Klasse QRegExp aus QT, welche in etwa die gleichen regul&auml;ren Ausdr&uuml;cke versteht wie die Programme <application>grep</application> oder <application>egrep</application>. Weitere Informationen zu <classname>QRegExp</classname> finden sich auf <ulink url="http://doc.trolltech.com/gregexp.html#details">http://doc.trolltech.com/gregexp.html#details</ulink>. Hinweis: &klipper; kennt den erw&auml;hnten Wildcard-Modus nicht). Danach kann der Eintrag wie oben beschrieben bearbeitet werden. Um einen Befehl zu einer Aktion hinzuzuf&uuml;gen, w&auml;hlt man "<guimenuitem>Befehl hinzuf&uuml;gen</guimenuitem>" aus dem Kontextmen&uuml; und gibt dann den Befehl im neu erzeugten Eintrag ein.</para>

<para>Der Wert <option>%s</option> auf der Befehlszeile wird mit dem Inhalt der Zwischenablage ersetzt. Wenn zum Bespiel der Befehl als
<command>kedit <option>%s</option></command> definiert ist und der Inhalt der Zwischenablage
<filename>/home/phil/textfile</filename> ist, so wird der Befehl <command>kedit
<filename>/home/phil/textfile</filename></command> ausgef&uuml;hrt. Soll die Zeichenkette <token>%s</token> in der Befehlszeile verwendet werden, so kann eine Escape-Sequenz verwendet werden:
<userinput>\%s</userinput>.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="shortcuts-tab">
<title>Tastenk&uuml;rzel</title>
<para>Die Seite "Tastenk&uuml;rzel" erlaubt die Einstellungen der Tastenk&uuml;rzel f&uuml;r die verschiedenen Funktionen von &klipper; zu &auml;ndern. Folgende drei M&ouml;glichkeiten stehen dabei zur Verf&uuml;gung:
</para>

<variablelist>
<varlistentry>
<term><guilabel>Keine Taste</guilabel></term>
<listitem><para>Die markierte Aktion kann nicht direkt mit der Tastatur ausgef&uuml;hrt werden.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Standardtaste</guilabel></term>
<listitem><para>Die markierte Aktion verwendet die von &klipper; definierte Standardtaste. Verweise in diesem Handbuch beziehen sich immer auf diese Standardtasten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Benutzerdefinierte Tasten</guilabel></term>
<listitem><para>Die markierte Aktion wird dem von Ihnen gew&auml;hlten Tastenk&uuml;rzel zugewiesen.
</para>
<para>Um eine benutzerdefinierte Taste zu verwenden, m&uuml;ssen Sie auf das Symbol der Taste (unten rechts) klicken, um die Eingabe zu aktivieren und danach die gew&uuml;nschte Taste dr&uuml;cken. Die gew&auml;hlte Taste kann in Kombination mit den <keycap>Umschalt-</keycap>, &Strg;- und
<keycap>Alt-</keycap>Tasten verwendet werden, wenn das entsprechende Ankreuzfeld an ist.</para> </listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1> 
</chapter>

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

<para>
&klipper;
</para>
<para>
Copyright 1998 Andrew Stanley-Jones <email>asj@cban.com</email>
</para>
<para>
Copyright 1998-2000 Carsten Pfeiffer <email>pfeiffer@kde.org</email></para>
<para>
Das Programm wird momentan von Carsten Pfeiffer betreut.
</para>

<para>
Copyright f&uuml;r die Dokumentation 2000 Philip Rodrigues
<email>philip.rodrigues@libertysurf.co.uk</email> </para>

&underFDL;
&underGPL;

</chapter>
<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-klipper">
<title>Woher Sie &klipper; erhalten</title>

<para>&klipper; ist Teil des KDE-Projektes (<ulink
url="http://www.kde.org">http://www.kde.org</ulink>) und befindet sich im Paket kdebase auf 
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, der Hauptseite des KDE-Projektes.
</para> 

</sect1>

<sect1 id="requirements">
<title>Voraussetzungen</title>

<para>Um &klipper; benutzen zu k&ouml;nnen, wird KDE 2 ben&ouml;tigt.</para>

<para>Alle ben&ouml;tigten Bibliotheken finden sich auf der
<ulink url="ftp://ftp.kde.org">ftp-Seite des KDE-Projektes
</ulink>. </para>
</sect1>

<sect1 id="compilation">
<title>Kompilieren und Installieren</title>
<para>&klipper; wird mit dem kdebase-Paket kompiliert und erscheint in der KDE-Kontrollleiste (ab Version 2).</para>

<screenshot>
<screeninfo>Klipper icon</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG">
	  </imageobject>
	  <textobject>
	    <phrase>Bildschirmphoto</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>Falls &klipper; nicht bei jedem Start ausgef&uuml;hrt werden soll, muss die Referenz darauf aus der Skript-Datei <filename>$KDEDIR/bin/startkde</filename> entfernt werden. </para>

</sect1>
</appendix>


<![ %addindex; [ &kdedocindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
End:
-->
