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

<book lang="DE">

<bookinfo>
<title>Das KSteak Handbuch</title>

<authorgroup>
<author>
<firstname>Michael</firstname>
<surname>Heidecke</surname>
<affiliation>
<address><email>heidecke@web.de</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Michael</firstname>
<surname>Heidecke</surname>
<affiliation>
<address><email>heidecke@web.de</email></address>
</affiliation>
<contrib>Entwickler und Betreuer</contrib>
</othercredit>

<othercredit role="developer">
<firstname>Olaf</firstname>
<surname>Hartig</surname>
<affiliation>
<address><email>olebowle@gmx.de</email></address>
</affiliation>
<contrib>Entwickler</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Marcus</firstname>
<surname>Gruendler</surname>
<affiliation>
<address><email>runner@tamalin.de</email></address>
</affiliation>
<contrib>Englische &Uuml;bersetzung der Dokumentation</contrib>
</othercredit>
</authorGroup>

<copyright>
<year>2000, 2001</year>
<holder>Michael Heidecke</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>04/02/2001</date>
<releaseinfo>0.4.0</releaseinfo>

<abstract><para>&ksteak; ist ein englisch - deutsch W&ouml;rterbuch f&uuml;r das KDE.</para></abstract>

<keywordset>
<keyword>Wörterbuch</keyword>
<keyword>Übersetzung</keyword>
</keywordset>

</bookinfo>

<chapter ID="Introduction"><title>Einleitung</title>
<para>&ksteak; ist eine grafische Oberfl&auml;che für das <application>steak</application> W&ouml;rterbuch. Es basiert auf dem Programm <application>xsteak</application> von Razi Lotfi-Tabrizi (<email>razi@cs.uni-frankfurt.de</email>). </para>
<para>&ksteak; &uuml;bersetzt ein eingegebenes Wort oder das aktuelle Wort aus der Zwischenablage (Clipboard). Die Uebersetzung ist in beiden Richtungen (englisch <-> deutsch) m&ouml;glich. Seit der Version 0.2 kann &ksteak; direkt aus dem Systembereich der KDE-Kontrolleiste (Docking-Area) aufgerufen werden.</para>
</chapter>


<chapter ID="Installation"><title>Installation</title>

<Sect1 id="requirements"><title>Voraussetzungen</title>
<para>
&ksteak; erfordert ein installiertes <application>steak</application> Programmpaket. Es kann von der Homepage des Autors <ULink URL="http://www.tm.informatik.uni-frankfurt.de/~razi/steak/steak.html">http://www.tm.informatik.uni-frankfurt.de/~razi/steak/steak.html</ULink> bezogen werden. </para>
</Sect1>

<Sect1 id="compilation"><title>Compilation und installation</title>
<para>
Zum Compilieren des Programms sind die folgenden Befehle einzugeben:
<screen>
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>
</para>
<para>
Da &ksteak; autoconf verwendet, sollten hierbei keine Probleme auftreten. Bei Fehlern im Programm benachrichtigen Sie bitte den Autor  
<ULink URL="mailto:heidecke@web.de">Michael Heidecke</ULink>.
</para>
</Sect1>
</chapter>

<chapter id="usage"><title>Verwendung von KSteak</title>

<Sect1 id="input"><title>Eingabe</title>
<para>
Der im <guilabel>Suchen</guilabel>-Feld angegebene Begriff wird im englischen oder deutschen W&ouml;rterbuch nachgeschlagen.
Es k&ouml;nnen beide Sprachen gleichzeitig gew&auml;hlt werden.
Wird dieses Feld leer gelassen wird automatisch die letzte Eingabe aus der Zwischenablage (Clipboard) verwendet.
So k&ouml;nnen Sie beispielsweise in einem anderen Fenster ein Wort markieren und ksteak aufrufen.
Die Verwendung von deutschen Umlauten sind erlaubt. Mehrere Begriffe m&uuml;ssen in Anf&uuml;hrungszeichen gesetzt werden.
Das Geschlecht der Substantive wird folgendermassen behandelt: </para>
<VariableList>
<VarListEntry>
<term> {m} </term><ListItem><para> maskulin, m&auml;nnlich </para></ListItem>
</VarListEntry>
<VarListEntry>
<term> {f} </term><ListItem><para> feminin, weiblich </para></ListItem>
</VarListEntry>
<VarListEntry>
<term> {n} </term><ListItem><para> neutrum, s&auml;chlich </para></ListItem>
</VarListEntry>
<VarListEntry>
<term> {pl} </term><ListItem><para> plural, Mehrzahl </para></ListItem>
</VarListEntry>
</VariableList>
<para>
Tip: Mit Hilfe der Buchstaben "f", "m", "n", "pl" werden beispielsweise alle Substantive gleichen Geschlechts gesucht.
Es empfiehlt sich hierbei die Verwendung des <guilabel>Kontext</guilabel>, um alle Wörter zu finden.
</para>
</Sect1>

<Sect1 id="expressions"><title>Regul&auml;re Ausdr&uuml;cke</title>
<para>
KSteak akzeptiert regul&auml;re Ausdr&uuml;cke mit den folgenden Steuerzeichen: </para>
<VariableList>
<VarListEntry>
 <term> c </term><ListItem><para> ein einzelner Buchstabe passt auf sich selbst </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> . </term><ListItem><para> ein Punkt passt auf jeden Buchstaben ausser auf das Zeilenende </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \? </term><ListItem><para> das  dem  Operator \? vorangehende Muster kann 0 oder einmal vorkommen</para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> * </term><ListItem><para> das dem Operator * vorangehende Muster kann 0 mal oder oefter vorkommen </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \+ </term><ListItem><para> das dem Operator \+ vorangehende Muster kann einmal oder oefter vorkommen </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \| </term><ListItem><para> die durch den Operator  \|  verbundenden  Argumente werden oder verknuepft </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> [Buchstaben] </term><ListItem><para>passt auf alle Buchstaben; dabei k&ouml;nnen einzelne Buchstaben,
				aber auch Bereiche in der Form "von-bis" angegeben werden; wenn der
				erste Buchstabe nach &lsqb; ein ^ ist, passt der Ausdruck auf alle Buchstaben,
				au&szlig;er den Aufgef&uuml;hrten </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \( \) </term><ListItem><para> die Klammern fassen Ausdr&uuml;cke zusammen; ausserdem wird der
				auf den in Klammern eingeschlossene Teil des  Musters  passende  Text
				markiert und mit einem folgenden \N Ausdruck referenziert (Tag) </para></ListItem>
</VarListEntry>

<VarListEntry>
<term> \N </term><ListItem><para>referenziert die auf das in der N-ten runden Klammern
			        eingeschlossene Muster passende Zeichenkette. N faengt aber ab "2" an. </para>
                 <para>ACHTUNG: Solche Anfragen belasten das System sehr!</para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \ </term><ListItem><para> jedes der Sonderzeichen kann, durch einen \  (Backslash) eingeleitet,
				sich selbst suchen \b passt auf kein Zeichen,
				sondern auf den Anfang oder das Ende eines Wortes </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \B </term><ListItem><para> symbolisiert den Raum innerhalb eines Wortes </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \w </term><ListItem><para> passt auf alle alphanumerischen Zeichen &lsqb;A-Za-z0-9&rsqb; </para></ListItem>
</VarListEntry>

<VarListEntry>
 <term> \W </term><ListItem><para> passt auf alle nichtalphanumerischen Zeichen &lsqb;^A-Za-z0-9&rsqb; </para></ListItem>
</VarListEntry>
</VariableList>

<para>
Die  Rangfolge der Operatoren ist (von der h&ouml;chsten zur niedrigsten):  (, ), ?, *, + und |.
Die  anderen  Operatoren sind mit den anderen Buchstaben gleichrangig.
</para>
</Sect1>

<Sect1 id="Docking"><title>Docking</title>
<para>
Mit dem Befehl <guilabel>An Panel heften</guilabel> wird das Fenster verkleinert. KSteak ist nun im Systembereich der KDE-Kontolleiste
 (Docking-Area) zu finden. Hier stehen folgende Funktionen zur Verf&uuml;gung:
</para>
<VariableList>
<VarListEntry>
  <term> linke Maustaste </term><ListItem><para> sucht nach dem markierten Begriff</para></ListItem>
</VarListEntry>
<VarListEntry>
  <term> rechte Maustaste </term><ListItem><para> <guilabel>vom Panel trennen</guilabel> stellt das Fenster wieder her, <guilabel>Beenden</guilabel> ist klar ;-)</para></ListItem>
</VarListEntry>
</VariableList>
<para>
Die Aktionen werden durch Klicken auf das Symbol (gelbes Buch) in der Kontrolleiste aktiviert.
</para>
<para>
Der Rest des Programms sollte selbsterkl&auml;rend sein... ;-)
</para>
</Sect1>
</chapter>


<chapter id="copyright"><title>Mitwirkende und Lizenz</title>
<para>KSteak</para>
<para>Programm Copyright 2000, 2001 Michael Heidecke , heidecke@web.de</para>
<para>Entwickler</para>
<itemizedlist>
<listitem><para>Michael Heidecke <email>heidecke@web.de</email> Entwickler und Betreuer</para></listitem>
<listitem><para>Olaf Hartig <email>olebowle@gmx.de</email> Entwickler </para></listitem>
</itemizedlist>
<para>
Dokumentation Copyright 2000, 2001 Michael Heidecke , heidecke@web.de
</para>
<para>&Uuml;bersetzung der Dokumentation</para>
<itemizedlist>
<listitem><para>Michael Heidecke <email>heidecke@web.de</email> deutsche Dokumentation </para></listitem>
<listitem><para>Marcus Gruendler <email>runner@tamalin.de</email> englische Dokumentation </para></listitem>
</itemizedlist>
<para>Besonderer Dank gilt dem <application>steak</application> Entwickler, Razi Lotfi-Tabrizi (<email>razi@cs.uni-frankfurt.de</email>).</para>

&underGPL;
&underFDL;
</chapter>

<![ %addindex; [ &kdedocindex; ]]>

</book>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->