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

<book lang="&language;">

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

<authorgroup>
<author
><firstname
>Anne-Marie</firstname
> <othername
></othername
> <surname
>Mahfouf</surname
> <affiliation
> <address
><email
>annma@kde.org</email
></address>
</affiliation>
</author>
</authorgroup>


<copyright>
<year
>2001</year
><year
>2003</year>
<holder
>Anne-Marie Mahfouf</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2003-10-15</date>
<releaseinfo
>1.3</releaseinfo>

<abstract>
<para
>&khangman; ist ein klassisches Galgenmännchenspiel für &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>Galgenmännchen</keyword>
<keyword
>Spiel</keyword>
<keyword
>Kind</keyword>
<keyword
>Wörter</keyword>
</keywordset>

</bookinfo>

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

<para
>&khangman; ist ein Spiel, das auf dem wohlbekannten Galgenmännchen basiert. Es ist für Kinder ab 6 Jahren. Es hat vier Schwierigkeitsstufen. Ein Wort wird zufällig ausgewählt, die Buchstaben verdeckt und Sie müssen das Wort raten, indem Sie einen Buchstaben nach dem anderen eingeben. Jedesmal, wenn Sie einen falschen Buchstaben eingeben, wird ein Bild eines Henkers gezeichnet. Sie müssen das Wort raten, bevor Sie gehenkt werden. Sie haben 10 Versuche. </para>
<para
>Mein Sohn Joachim, damals 9 1/2 Jahre alt, brachte mich auf die Idee für dieses Spiel im Juni 2000. </para>

</chapter>

<chapter id="using-khangman">
<title
>&khangman; benutzen</title>

<screenshot>
<screeninfo
>Hier ist ein Bildschirmfoto von &khangman;, wenn Sie es zum ersten Mal starten</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Bildschirmfoto von &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Hier können Sie &khangman; sehen, wenn es das erste Mal läuft. Die Schwierigkeitsstufe ist "Leicht", die Sprache ist standard (hier: Englisch), es gibt kein Hintergrunddesign und die Galgenmännchenbilder sind nicht transparent. Änderungen in der Stufe, Sprache oder dem Hintergrund werden in der Konfigurationsdatei gespeichert und beim nächsten Spiel wiederhergestellt. </para>

<para
>Bitte beachten Sie, wie einfach es ist, die Schwierigkeitsstufe und den Hintergrund zu verändern, benutzen Sie einfach die Auswahlboxen in der Werkzeugleiste. Ein neues Wort zu bekommen und das Spiel zu verlassen ist auch einfach, dafür sind auch Knöpfe auf der Werkzeugleiste zu finden. </para>

<sect1 id="general-usage">
<title
>Allgemeine Benutzung</title>

<!-- FIXME: A word can't really be displayed and hidden at the same time, -->
<!-- although I can't think of a better way to phrase this -->
<para
>Ein Wort wird angezeigt, versteckt. Sie wissen, wie viele Buchstaben das Wort hat. Sie müssen raten, was das Wort ist, indem Sie einen Buchstaben nach dem anderen versuchen. Das Wort wird zufällig ausgesucht und ist nicht dasselbe, wie das zuvor.</para>

<important
><para
>Alle Wörter sind Nomen (keine Verben, keine Adjektive, usw.).</para
></important>

<para
>Es ist nicht wichtig, ob Sie kleine oder große Buchstaben eingeben. Das Programm wandelt alle Eingaben in Kleinbuchstaben um, außer den deutschen Worte, die mit einem Großbuchstaben beginnen. Das Programm tut dies automatisch. </para>

<para
>Die aktuelle Schwierigkeitsstufe und die aktuelle Sprache werden in der Statusleiste angezeigt. </para>
<para
>Jedesmal, wenn Sie einen Buchstaben probieren, der nicht im Wort enthalten ist, wird das Galgenmännchen ein wenig weiter gezeichnet. Sie haben 10 Versuche, das Wort zu erraten. Danach wird das Wort angezeigt. </para>
<para
>Es gibt 4 Schwierigkeitsstufen: "Leicht", "Mittel", "Schwer" und "Tiere", und zusätzliche Stufen für andere Themen in einigen Sprachen. Das Programm sucht alle Datendateien in allen Sprachen. </para>
<para
>In der einfachen Schwierigkeitsstufe sind die Wörter recht einfach und beziehen sich auf das alltägliche Leben. Sie ist gut für Kinder von 6 bis 9. Die Stufe "Tiere" enthält nur Namen von Tieren, sind also einfach zu raten. Einige sind einfach, andere sind schwerer. In der mittleren Stufe sind die Wörter länger und schwieriger. Sie ist für Kinder ab 9 Jahren. Die schwere Stufe ist einfach schwer, das heißt, dass die Wörter schwer zu buchstabieren sind und nicht so bekannt sind. Auch für Erwachsene herausfordernd. </para>

<para
>Nachdem ein Wort erraten wurde (oder das Galgenmännchen fertig ist), werden Sie gefragt, ob Sie noch ein Wort haben möchten und Sie können entweder die Tasten <keycap
>J</keycap
> oder <keycap
>N</keycap
> oder die Maus benutzen, um "Ja" oder "Nein" zu antworten. Falls Sie mit <guilabel
>Nein</guilabel
> antworten, beendet sich das Spiel. Falls Sie mit <guilabel
>Ja</guilabel
> antworten, bekommen Sie ein weiteres Wort zum Raten. </para>

<!-- FIXME: should we call it 'field' or 'text edit' or...? -->
<para
>Sie geben den Buchstaben in das Feld ein, den Sie probieren wollen und drücken die Eingabetaste. Falls der Buchstabe zu dem Wort gehört, nimmt er seinen Platz ein, so oft, wie er im Wort vorhanden ist. Wenn der Buchstabe nicht zum Wort gehört, erscheint er im Feld "Falsch" und ein weiterer Teil des Galgenmännchens wird rechts gezeichnet. Sie haben zehn Versuche und danach verlieren Sie und das korrekte Wort wird angezeigt. </para>

<para
>Während des Spiels können Sie ein neues Spiel starten, wenn Sie aus dem Menü <guimenu
>Spiel</guimenu
> <guimenuitem
>Neu</guimenuitem
> auswählen oder den Knopf <guiicon
>Neu</guiicon
> in der Werkzeugleiste benutzen. Sie können auch die Schwierigkeitsstufe mit dem Schwierigkeitsstufenknopf in der Werkzeugleiste verändern (Das bringt Ihnen auch eines neues Wort in der neuen Schwierigkeitsstufe).</para>

<para
>Weitere Verbesserungen werden Ihnen erlauben, Ihre eigene Wörterdatei zu erstellen oder eine weitere Datei zu laden, neben den vier enthaltenen. </para>

<para
>You can play &khangman; in thirteen languages: Brazilian Portuguese, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Italian, Portuguese, Spanish and Swedish. You can easily change the Language by going in the <guimenu
>Languages</guimenu
> menu and choosing another language. </para>

<para
>Bitte beachten Sie, dass Sie nun spezielle Zeichen in einer Sprache mit der Werkzeugleiste <interface
>Spezielle Zeichen</interface
> eingeben können. Diese Werkzeugleiste enthält Knöpfe mit einem Bild jedes speziellen Zeichens der Sprache wie &eacute; in Französisch. Ein Klick auf einen solchen Knopf schreibt den entsprechenden Buchstaben in die Eingabezeile und übernimmt Ihre Wahl mit der Eingabetaste. Sie können natürlich auch eine Tastaturbelegung benutzen, die Ihrer Sprache entspricht. Diese Werkzeugleiste kann gezeigt oder versteckt werden. Die Einstellung wird beim nächsten Spielen mit &khangman; wiederhergestellt. </para>

<important
><para
>Please note that for Czech special characters you will need a font that supports these characters so you can see them displayed. Choosing Arial in KDE Control Center as a general font and adjusting all fonts will work fine. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Ein paar Tipps</title>
<para
>Versuchen Sie es zuerst mit Vokalen. Dann testen Sie die oft benutzten Konsonanten: l, t, r, n, s </para>
<para
>Wenn Sie "io" sehen, versuchen Sie es, im Englischen oder Französischen (natürlich auch im Deutschen, d. Übers.), danach mit "n". </para>
<para
>In Brasilianischen Portugiesisch, Katalanisch, Spanisch und Portugiesisch werden akzentuierte Vokale automatische entdeckt, wenn Sie den nicht akzentuierten entsprechenden Vokal eingeben. Zum Beispiel werden alle <quote
>a</quote
> mit einem Akzent im Wort angezeigt wenn Sie ein <quote
>a</quote
> eingeben. Das gilt nur wenn <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>Buchstaben mit Akzent eingeben</guimenuitem
></menuchoice
> nicht ausgewählt ist. Falls <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>Buchstaben mit Akzent eingeben</guimenuitem
></menuchoice
> ausgewählt ist, müssen Sie die akzentuierten Buchstaben selbst eingeben. Wenn Sie dann ein <quote
>a</quote
> eingeben wird nur das <quote
>a</quote
> angezeigt und Sie müssen zum Beispiel ein &atilde; eingeben, damit es angezeigt wird. </para>
<para
>Wussten Sie? Im Englischen ist der üblichste Buchstabe das e (12,7%), gefolgt vom t (9,1%), dann das a (8,2%), i (7,0%) und n (6,7%). </para>
</sect1>
</chapter>

<chapter id="menus">
<title
>Menüleiste und Werkzeugleisten</title>

<sect1 id="mainwindow">
<title
>Das Hauptfenster von &khangman;</title>

<para
>Das <guimenu
>Spiel</guimenu
>menü hat 2 Einträge: <guimenuitem
>Neu</guimenuitem
> und <guimenuitem
>Beenden</guimenuitem
>.</para>

<para
><guimenuitem
>Neu</guimenuitem
> startet ein neues Spiel, das heißt ein neues Wort zum Raten in der aktuellen Schwierigkeitsstufe. <guimenuitem
>Beenden</guimenuitem
> beendet das Spiel, schließt das Hauptfenster und schreibt die aktuellen Einstellungen in die Konfigurationsdatei.</para>

<para
>The <guimenu
>Languages</guimenu
> menu has thirteen menu items: <guimenuitem
>Brazilian Portuguese</guimenuitem
>, <guimenuitem
>Catalan</guimenuitem
>, <guimenuitem
>Czech</guimenuitem
>, <guimenuitem
>Danish</guimenuitem
>, <guimenuitem
>Dutch</guimenuitem
>, <guimenuitem
>English</guimenuitem
>, <guimenuitem
>Finnish</guimenuitem
>, <guimenuitem
>French</guimenuitem
>, <guimenuitem
>German</guimenuitem
>, <guimenuitem
>Italian</guimenuitem
>, <guimenuitem
>Portuguese</guimenuitem
>, <guimenuitem
>Spanish</guimenuitem
> and <guimenuitem
>Swedish</guimenuitem
>. As default, if your &kde; language is one of those thirteen, then it is set as default otherwise English is chosen. After your first game, the language you set up the last time you used &khangman; is restored. </para>
<para
>Das Menü <guimenuitem
>Einstellungen</guimenuitem
> erlaubt Ihnen, &khangman; einfach einzurichten. Zuerst geben Ihnen <guimenuitem
>Werkzeugleisten</guimenuitem
> und <guimenuitem
>Statusleiste anzeigen</guimenuitem
> die Möglichkeit, die Werkzeugleisten und die Statusleiste anzuzeigen oder zu verbergen. </para>

<para
>Es gibt zwei Werkzeugleisten: Die eine, die sich oben befindet und die Knöpfe und Auswahlfelder enthält und die Werkzeugleisten <interface
>Zeichen</interface
>, die, falls angezeigt, unten zu finden ist. Diese Werkzeugleiste hat Knöpfe mit speziellen Zeichen für jede Sprache: akzentuierten Buchstaben und andere spezielle Zeichen. Dies erlaubt es dem Benutzer, einfach mit anderen Sprachen zu experimentieren, ohne ein neues Tastaturlayout definieren zu müssen. Sie klicken auf ein spezielles Zeichen und es wird als der zu versuchende Buchstabe angezeigt. Ein Druck auf die Eingabetaste lässt das Programm nachschauen, ob der Buchstabe im Wort vorkommt. Diese Werkzeugleiste kann versteckt werden, wenn Sie sie nicht brauchen. Das wird in der Konfigurationsdatei gespeichert, wenn die Werkzeugleiste also versteckt ist, bleibt sie das auch, wenn Sie &khangman; das nächste Mal starten. </para>
<tip>
<para
>Es ist natürlich möglich, die Werkzeugleisten zu bewegen. Stellen Sie den Mauszeiger über den kleinen Griff auf der linken Seite der Werkzeugleiste drücken die linke Maustaste und ziehen die Werkzeugleiste auf den Bildschirm, wohin Sie wollen. Wenn Sie mit der Maus auf eine Werkzeugleiste zeigen und die rechte Maustaste drücken, erscheint ein Menü, das Sie aus verschiedenen Einstellungen für die Werkzeugleiste wählen lässt. </para>
</tip>
<para
><guimenuitem
>Kurzbefehle festlegen...</guimenuitem
> ist eine allgemeine &kde;-Einstellung, die Ihnen erlaubt, verschiedene Tastaturkürzel für Aktionen zu vergeben. Zum Beispiel ist <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> das normale Kürzel für <guimenuitem
>Beenden</guimenuitem
>.</para>
<para
><guimenuitem
>Werkzeugleisten einrichten...</guimenuitem
> ist auch ein allgemeiner &kde;-Menüeintrag, der Ihnen erlaubt, Einträge aus der Werkzeugleiste zu entfernen oder welche hinzuzufügen. Wenn der <guimenuitem
>Vollbildmodus</guimenuitem
> angewählt ist, bringt Sie das in den Vollbildmodus, in dem nur die Werkzeugleiste oben zu sehen ist und &khangman; den ganzen Bildschirm bedeckt. Auf der Hauptwerkzeugleiste erlaubt Ihnen der Knopf <guiicon
>Zurück zur normalen Größe</guiicon
> zurückzukommen zu der vorherigen Größe.</para>

<para
><guimenuitem
>Transparente Bilder</guimenuitem
> erlaubt Ihnen einzustellen, ob die Galgenmännchenbilder transparent sein sollen oder nicht, je nachdem, ob der Eintrag gewählt ist oder nicht.</para>

<para
><guimenuitem
>Weniger harte Bilder</guimenuitem
> gibt Ihnen die Möglichkeit für die spätere Phasen weniger harte Galgenmännchenbilder auszuwählen. Das bedeutet, das das Männchen nicht gehenkt wird sondern das Seil in seiner Hand hält. Das ist sinnvoller für kleinere Kinder.</para>

<para
><guimenuitem
>Buchstaben mit Akzent eingeben</guimenuitem
> ist nur verfügbar, wenn Sie Katalanisch, Brasilianisch-Portugiesisch oder Spanisch gewählt haben. Wenn es ausgewählt ist, muss der Benutzer akzentuierte Buchstaben eingeben, wie &atilde;, um sie im Wort anzuzeigen. Wenn die Einstellungen nicht aktiviert ist, dann wird der normale Vokal auch alle akzentuierten enthüllen. Zum Beispiel werden dann durch den Versuch <quote
>a</quote
> auch &atilde; und andere akzentuierte "a"s im Wort angezeigt.</para>

<para
><guimenuitem
>Tipps aktivieren</guimenuitem
> ist nur verfügbar für Französisch und Italienisch. Wenn Sie diese Einstellung aktivieren, können Sie mit der rechten Maustaste irgendwohin klicken und bekommen einen Tipp für vier Sekunden angezeigt. Dieser Tipp sollte helfen, das Wort zu erraten.</para>

<para
>Bitte beachten Sie, das transparente Bilder für das Galgenmännchen nicht im Modus "Kein Hintergrund" aktiviert sind. Transparenz ist nur verfügbar mit einem Hintergrundbild. Normalerweise ist die Transparenz aktiviert.</para>

<screenshot>
<screeninfo
>&khangman; Blaues Design</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>&khangman; Blaues Design</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Hier sehen Sie &khangman; mit dem blauen Design, transparenten Galgenmännchenbildern, Katalanischer Sprache und dem einfache Schwierigkeitsstufe. Die Werkzeugleiste <interface
>Zeichen</interface
> wird angezeigt.</para>

<para
>Die Schwierigkeitsstufe wird mit der Auswahlbox ausgewählt und Sie können "leicht", "mittel", "Tiere" oder "schwer" auswählen. "Leicht" bezieht sich auf normale Objekte die ein Kind im Alter von sechs oder sieben Jahren kennt. "Mittel" betrachtet Nomen, die etwas schwieriger sind und "schwer" ist ganz schwer und "Tiere" beinhaltet nur Tiernomen. </para>

<para
>Alle Wörter sind Nomen. Keine Verben, keine Adjektive. Die gewählte Schwierigkeitsstufe wird in der Statusleiste angezeigt.</para>
<para
>Nur Buchstaben können in das Feld eingegeben werden.</para>
</sect1>
</chapter>

<chapter id="commands">
<title
>Befehlsreferenz</title>

<sect1 id="khangman-mainwindow">
<title
>Menüs und Kurzbefehle</title>

<sect2>
<title
>Das Menü <guimenu
>Spiel</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Neu</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Neues</action
> Spiel (also ein neues Wort)</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Beenden</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Beendet</action
> &khangman;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Das Menü <guimenu
>Sprachen</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Sprachen</guimenu
> <guimenuitem
>Sprachen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Wählt</action
> die Sprache für die Wörter</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Die Menü <guimenu
>Einstellungen</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleisten</guimenuitem
> <guimenuitem
>Main anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zeigt</action
> die Hauptwerkzeugleiste an bzw. blendet sie aus</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleisten</guimenuitem
> <guimenuitem
>Spezielle Zeichen anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zeigt</action
> die Werkzeugleiste "Spezielle Zeichen" an bzw. blendet sie aus</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Statusleiste anzeigen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zeigt</action
> die Statusleiste an bzw. blendet sie aus</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Transparente Bilder</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Schaltet</action
> die Transparenz für die Galgenmännchenbilder an </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Weniger harte Bilder</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Schaltet</action
> zwischen den weniger harten und normalen Galgenmännchenbildern um </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Buchstaben mit Akzent eingeben</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Erlaubt Ihnen, akzentuierte Buchstaben selbst einzugeben (in Brasilianischem Portugiesisch, Katalanisch, Portugiesisch und Spanisch) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Tipps aktivieren</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Erlaubt Ihnen, auf einen Mausklick mit der rechten Maustaste einen Tipp anzuzeigen (nur in Französisch und Italienisch) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
> </shortcut
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Vollbildmodus</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Schaltet</action
> den Vollbildmodus aus bzw. ein </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Kurzbefehle einrichten...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Richtet</action
> die Tastaturtasten ein, die Sie für verschieden Aktion benutzen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleisten einrichten...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Richtet</action
> die Einträge ein, die Sie in der Werkzeugleiste haben möchten </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>Das Menü <guimenu
>Hilfe</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Entwicklerdokumentation für &khangman;</title>

<sect1 id="changing-words">
<title
>Wie man die Wörter für eine neue Sprache dem Spiel hinzufügt</title>

<para
>Thanks to Stefan Asserhäll, it is very easy to add a new language directly to the game. The procedure described here can also be found in the <filename class="directory"
>khangman</filename
> source folder in the file <filename
>README.languages</filename
>. However, as there are already thirteen languages, it will be difficult to add others as the menu will be too long. So please follow the procedure below but instead of committing your files you send them to me tarred and gzipped. That way I'll make your language available on the &khangman; web page. Next &khangman; release (with &kde; 3.3) will have a wizard to easily download and install new languages. </para>

<para
>Laden Sie die neueste CVS-Version von &khangman; herunter. Die Wörter werden in 4 einzelnen Dateien gespeichert, einer für jede Schwierigkeitsstufe. Die Dateien sind in <filename class="directory"
>/khangman/data/sprach_code</filename
>. Die Datei <filename
>easy.txt</filename
> ist für die Stufe "Leicht", die Datei <filename
>medium.txt</filename
> für die Stufe "Mittel", die Datei <filename
>animals.txt</filename
> für die Stufe "Tiere" und die Datei <filename
>hard.txt</filename
> für die Stufe "Schwer".</para>

<procedure>
<step
><para
>Geben Sie die folgenden Befehle in einer Befehlseingabe ein, um die Verzeichnisse und Dateien für eine neue Sprache zu erzeugen:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>sprach_code</replaceable
></command
></userinput
></screen>
<para
>Sie müssen <replaceable
>sprach_code</replaceable
> durch Ihren Sprachcode ersetzen.</para>
</step>
<step>
<para
>Bearbeiten Sie alle angegebenen Textdateien im neuen Verzeichnis mit einem Texteditor, und ersetzen Sie jedes Wort durch ein übersetztes Wort. Es ist nicht wirklich wichtig, dass die Bedeutung des Wortes beibehalten wird, aber versuchen Sie, die Länge und die Schwierigkeit beizubehalten.</para
> 

<para
>Sie können die Worte einfach übersetzen, oder auch gemäß der Schwierigkeit neue hinzufügen oder anpassen. Zum Beispiel ist <quote
>Tisch</quote
> im Deutschen ein "einfaches" Wort, aber in Ihrer Sprache könnte es schwerer sein. Passen Sie die Wörter ruhig auf die Bedürfnisse Ihrer Sprache an. Die Anzahl der Wörtre in einer Datei ist nicht wichtig, Sie können so viele Wörter hinzufügen, wie Sie möchten.</para>

<para
>Beachten Sie, dass alle Wörter Nomen sind.</para>

<para
>Beachten Sie, dass Sie beim Bearbeiten die Kodierung UTF-8 benutzen müssen. Wenn Ihr Editor dies nicht kann, benutzen Sie &kwrite; oder &kate;. Wenn Sie eine Datei in &kwrite; oder &kate; öffnen können Sie die Kodierung "utf8" in der Auswahlbox am oberen Rand des Öffnen-Dialogs auswählen.</para>

<para
>Bitte behalten Sie die englischen Dateinamen in ihrem <replaceable
>sprach_code</replaceable
>-Verzeichnis bei.</para>
</step>

<step>
<para
>Geben Sie den folgenden Befehl ein, um die neuen Datendateien zu installieren:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>Sie müssen je nach Ihrer Installation <systemitem class="username"
>root</systemitem
> werden, um <command
>make install</command
> ausführen zu können.</para>
</step>
<step>
<para
>Starten Sie das Spiel und schauen Sie nach, ob Ihre Sprache hinzugefügt wurde:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>Fügen Sie die neuen Sprachdateien mit folgendem Befehl dem Softwarearchiv (CVS) hinzu:</para>
<screen
><userinput
><command
>cvs commit -m "Neue Sprache hinzugefügt" <replaceable
>name_ihrer_sprache</replaceable
>"</command
></userinput
></screen>
</step>
</procedure>

<para
>Falls Sie Tipps in der neuen Sprach haben wollen, haben Sie mehr Arbeit. Sie müssen das "kvtml"-Format benutzen und am besten schauen Sie in die Französischen oder Italienischen Daten. Das Tag <sgmltag class="starttag"
>o</sgmltag
> ist für ein Wort und <sgmltag class="starttag"
>t</sgmltag
> für den Tipp. Versuchen Sie den Tipp an den Schwierigkeitsgrad anzupassen. Die Stufe <quote
>Einfach</quote
> erfordert einen einfach Tipp, aber die Stufe <quote
>Schwerk</quote
> erfordert eine Wörterbuchdefinition. Versuchen Sie keine Wörter derselben Sprachfamilie zu benutzen, das könnte das Wort zu einfach verraten!</para>

<para
>Eine Beispieldatei im "kvtml"-Format sieht wie folgt aus:</para>
<programlisting
><markup>
&lt;?xml version="1.0"?&gt; 
&lt;!DOCTYPE kvtml SYSTEM "kvoctrain.dtd"&gt; 
&lt;kvtml&gt; 
&lt;e&gt; 
&lt;o&gt;cane&lt;/o&gt; 
&lt;t&gt;&egrave; il tuo animale domestico preferito&lt;/t&gt; 
&lt;/e&gt; 
...
...
&lt;/kvtml&gt;
</markup
></programlisting>


</sect1>
<sect1 id="planned-features">
<title
>Geplante Funktionen für &khangman;</title>

<para
>Da die Anzahl der Sprachen steigt, wird es nötig sein, das Hinzufügen zu stoppen. Wir planen, nur eine kleine Auswahl von Sprach wie Englisch, Spanisch, Französisch und Deutsch mit &khangman; auszuliefern und die anderen Sprachen im Übersetzungsmodul und als Download verfügbar zu machen. &khangman; wird dann die Klasse <classname
>KNewStuff</classname
> benutzen, um es mit einem Assistenten dem Benutzer zu erleichtertn, neue Sprachen zu installieren. Das wird auch für &klettres; und &kstars; zutreffen, da wird die Größe des Modulpaketes nicht weiter wachsen lassen wollen. </para>
<para
>Eine weitere geplante Verbesserung sind natürlich Tipps in allen Sprachen. </para>
<para
>Weiterhin sollen auch andere kvtml-Dateien wie die auf der KDE-Edu-Webseite dafür benutzt werden können, &khangman; zu spielen. Stellen Sie sich vor, dass Sie mit den Hauptstädten der Welt spielen könnten, der Tipp würde Ihnen das Land verraten und Sie müssten die Hauptstadt raten. Oder lernen Sie Wörter in anderen Sprachen, der Tipp ist das Wort in Ihrer Sprache und das zu ratende Wort ist die Übersetzung in ihre Sprache. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Fragen und Antworten</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Ich erhalte eine Fehlermeldung, die mir mitteilt, dass die Bilder nicht gefunden wurden.</para>
</question>
<answer>
<para
>Das Spiel ist standardmäßig in <filename class="directory"
>/usr/local/kde</filename
>, also fügen Sie <filename class="directory"
>/usr/local/kde/bin</filename
> zu Ihrem Pfad hinzu und setzen Sie die <envar
>KDEDIR</envar
> Variable auf <filename class="directory"
>/usr/local/kde</filename
> vor dem Starten des Spiels. Ein einfacher Weg ist, &khangman; mit der Option <option
>--prefix</option
> =$<envar
>KDEDIR</envar
>  zu konfigurieren, wobei $<envar
>KDEDIR</envar
> auf den Pfad gesetzt werden sollte, wo der Rest von &kde; installiert ist. Der Wert variiert sehr und hängt von Ihrer Distribution und Ihrem Betriebssystem ab.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; startet nicht korrekt, nachdem ich es auf eine &kde; 3.2 Version aktualisiert habe</para>
</question>
<answer>
<para
>Es könnte ein Problem geben, das mit der neuen Einstellungsdatei zusammenhängt. Bitte löschen Sie <filename
>khangmanrc</filename
> aus dem Verzeichnis <filename class="directory"
>$HOME/.kde/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Mitwirkende und Lizenz</title>

<para
>&khangman; </para>
<para
>Programm-Copyright 2001-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
<para
>Mitwirkende: <itemizedlist>
<listitem
><para
>Galgenmännchen-Graphiken: Renaud Blanchard <email
>kisukuma AT chez DOT com</email
></para
> </listitem>
<listitem
><para
>Töne: Ludovic Grossard <email
>ludovic.grossard AT libertysurf DOT fr</email
></para
> </listitem>
<listitem
><para
>Blaues Design, Symbole und Code: Primoz Anzur <email
>zerokode AT yahoo DOT com</email
></para
> </listitem>
<listitem
><para
>Schwedischen Datendateien, Programmierhilfe, transparente Bilder und Übersetzungsreparatur: Stefan Asserhäll <email
>stefan DOT asserhall AT telia DOT com</email
></para
> </listitem>
<listitem
><para
>Naturdesign: Joe Bolin <email
>jbolin AT users DOT sourceforge DOT net</email
></para
> </listitem>
<listitem
><para
>Weniger harte Galgenmännchenbilder: Matt Howe <email
>mdhowe AT bigfoot DOT com</email
></para
> </listitem>
<listitem
><para
>Spanische Datendateien: eXParTaKus <email
>expartakus AT expartakus DOT com</email
></para
> </listitem>
<listitem
><para
>Dänische Datendateien: Erik Kjaer Pedersen <email
>erik AT mpim-bonn DOT mpg DOT de</email
></para
> </listitem>
<listitem
><para
>Finnische Datendateien: Niko Lewman <email
>niko DOT lewman AT edu DOT hel DOT fi </email
></para
> </listitem>
<listitem
><para
>Brasilianisches Portugiesische Datendateien: João Sebastião de Oliveira Bueno <email
>gwidion AT mpc DOT com DOT br </email
></para
> </listitem>
<listitem
><para
>Katalanische Datendateien: Antoni Bella <email
>bella5 AT teleline DOT es </email
></para
> </listitem>
<listitem
><para
>Italienische Datendateien: Giovanni Venturi <email
>jumpyj AT tiscali DOT it </email
></para
> </listitem>
<listitem
><para
>Holländische Datendateien: Rinse <email
>rinse AT kde DOT nl </email
></para
> </listitem>
<listitem
><para
>Portugiesische Datendateien: Pedro Morais <email
>morais AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Programmierhilfe: Robert Gogolok <email
>robertgogolok AT gmx DOT de</email
></para
> </listitem>
<listitem
><para
>Programmierhilfe: Benjamin Meyer <email
>ben AT meyerhome DOT net</email
></para
> </listitem>
<listitem
><para
>Programmierverbesserung: Lubos Lun&agrave;k <email
>l.lunak AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Programmierverbesserung: Albert Astals Cid <email
>tsdgeos AT terra DOT es</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Dokumentation Copyright 2001-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-khangman">
<title
>Woher man &khangman; bekommt</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilierung und Installation</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
