# Das Handbuch zu &khangman;

## Einleitung

&khangman; is a game based on the well-known hangman game. It is aimed at children aged six and over. The game has several categories of words to play with and among them: Animals, Clothing, Computers, Currencies, Easy and Fruits. A word is picked at random, the letters are hidden, and you must guess the word by trying one letter after another. Each time you guess a wrong letter, part of a picture of a hangman is drawn. You must guess the word before being hanged! You have 10 tries.

## &khangman; spielen

Hier ist ein Bildschirmfoto von &khangman;, wenn Sie es zum ersten Mal starten Bildschirmfoto von &khangman;

Here you can see &khangman; as it is the first time you run it. Category is Animals, language is default (English here, the default is your current &kde; language if the data exists), the theme is Notes. Any changes in category, language or theme (background) are written in the configuration file and restored in your next game.

Please note how easy it is to change the theme, just click on the button on the bottom toolbar. Getting a new word and quitting the game are also easily done by clicking on the corresponding buttons on the toolbars.

### Einführung

A word is chosen and its letters are displayed as an underscore (_) symbol. You know how many letters there are in the word. You have to guess the word by trying one letter after another. You type the letter on the keyboard or select them with the &LMB;. If the letter belongs to the word the background color of the letter will change to green, otherwise to red.

The letter keys in the game window allow you to play &khangman; in foreign languages without changing your keyboard layout.

Das Wort wird zufällig ausgesucht, bei jedem Spiel ein anderes Wort.

Alle Wörter sind Nomen (keine Verben, keine Adjektive, &etc;).

If you need help guessing the word, you can click on the icon in the toolbar and a hint will be displayed to give you some clue about the word. Clicking this icon again will hide the hint.

Hints are not displayed by default.

Usually, it is not important whether you type in lowercase or uppercase. The program converts all input into an uppercase letter. The program does that automatically.

The current category, wins and losses are displayed in the window.

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 gesuchte Wort angezeigt.

There are several categories of words available, depending on the selected language. The program scans for all data files in all languages and uses &kanagram; words files as well.

After a word is guessed (or the hangman is completed), you are congratulated and the next word is presented. To quit the game click the icon in the top toolbar.

You type the letter you want to try on the keyboard or select it with the &LMB;. If the letter belongs to the word the key is highlighted in green and the letter its place, as many times as it appears in the word. If the letter does not belong to the word, the key is highlighted red. You have ten tries and after that you lose and the correct word is displayed.

During the game, you can choose to start a new game by clicking on the on the bottom toolbar. You can also change the category of words clicking the current category .

The look can easily be changed with theme button on the bottom toolbar.

### Spielen in unterschiedlichen Sprachen

You can play &khangman; in many languages including: Brazilian Portuguese, Bulgarian, Catalan, Czech, Danish, Dutch, English (US and GB), Finnish, French, German, Hungarian, Irish (Gaelic), Italian, Norwegian (Bokmål), Norwegian (Nynorsk), Polish, Portuguese, Romanian, Spanish, Serbian (Latin and Cyrillic), Slovenian, Tajik, Swedish, Russian and Turkish. You can even try Chinese if you install the files from &kanagram;.

By default, after the first installation of &khangman;, only English and your &kde; language if it is one of the above and if you have the corresponding kde-i18n package will be installed. For example if you are a Danish user and if you have &kde; in Danish, in Language you will see two items: English and Danish and Danish will be the default.

You can still play &khangman; in other languages. It is very easy to add new data in &khangman;. All you need is a working Internet connection. You click on and a dialog appears, similar to this one:

Der Dialog Neue Sachen abholen für &khangman; Der Dialog Neue Sachen abholen für &khangman;

Klicken Sie auf den Namen der gewünschten Sprache und dann auf den Knopf Installieren. Wurde die Sprache richtig installiert, wird dies durch einen grünen Haken vor dem Namen der Sprache angezeigt und der Knopf Installieren ändert sich zu Deinstallieren. Die Daten sind in &khangman; sofort verfügbar. Für weitere Sprachen müssen Sie diese Schritte wiederholen. Mit dem Knopf Schließen verlassen Sie den Dialog Neue Sachen abholen.

You can then easily change the language by clicking the language button and choose the new language.

Please note that you the special characters in a language are displayed on the keyboard. Here you see buttons with an icon of each special character per language like é in French for example. Clicking on such a button will select the corresponding letter. You can of course also use the keyboard layout corresponding to the language.

### Ein paar Tipps

In English, try to guess the vowels first. Then have a go with the most common consonants: l, t, r, n, s.

Wenn Sie io sehen, versuchen Sie es im Englischen oder Französischen (natürlich auch im Deutschen, d. Übers.) danach mit n.

ou have to either type the accented letters yourself or click on them.. When you type a, only a is displayed and you have to type for example ã for this letter to be displayed.

Wussten Sie schon, dass im Englischen der häufigste Buchstabe das e (12,7 %) ist, gefolgt vom t (9,1 %), dann das a (8,2 %), i (7,0 %) und n (6,7 %).

## Menubar and Toolbars

### Das Hauptfenster von &khangman;

&khangman; Wüsten-Design &khangman; Wüsten-Design

Here you have &khangman; with the Desert theme, French language and category Animaux. The special characters for french are shown here.

The game has the main toolbar at the top of the window:

- or Start or stop a game
- Open the settings dialog
- About &khangman;
- About &kde;
- View the &khangman; handbook
- Download new language files from the Internet
- Quit &khangman;

The bottom toolbar is displayed only when playing a game, if you pause the game this toolbar is hidden:

- - Display a hint about the word to guess
- A button to change the category
- Language selection
- Theme selection
- Reveal the word to guess
- Load the next word and start a new game

Alle Wörter sind Nomen. Keine Verben, keine Adjektive. Die gewählte Kategorie wird in der Statusleiste angezeigt.

Nur Buchstaben können in das Textfeld eingegeben werden.

### Settings

&khangman; settings &khangman; settings

The Word resolve time in seconds sets the maximum allowed time for resolving the word in &khangman;. Default value is 120 seconds. Young children will need more time to understand the game, for adults reduce the resolve time to keep the game exciting.

Score Multiplying Factor determines the factor by which the scores will be multiplied.

If you check Sounds then a sound will be played on new game and another sound will be played when you win a game.

## Entwicklerdokumentation für &khangman;

### Wörter für eine neue Sprache für das Spiel

Please follow the procedure and then send the files tarred and gzipped to the kde-edu mailinglist.

Please have a look in &khangman; in the top toolbar to see if your language is available yet. If it is, then you can check if it contains hints.

Die Wörter der Standardkategorien werden in 4 einzelnen Dateien gespeichert, um verschiedene Spielstufen anzulegen. Die Dateien finden Sie in `/khangman/data/`. Die Datei `easy.kvtml` ist für die Stufe Einfach, die Datei `medium.kvtml` für die Stufe Mittel, die Datei `animals.kvtml` für die Stufe Tiere und die Datei `hard.kvtml` für die Stufe Schwer.

Englisch ist die Standardsprache und wird daher als einzige Sprache mit &khangman; installiert. Alle weiteren Sprachdateien sind in den entsprechenden Sprachpaketen kde-l10n enthalten.

1. Die Wortdateien haben das kvtml-Format. Das Tag `text` ist für ein Wort und `comment` für den Tipp. Diese sind in einem Tag `entry` zusammengefasst. Versuchen Sie den Tipp an den Schwierigkeitsgrad anzupassen. Die Kategorie Leicht braucht auch einen einfachen Tipp, aber für Schwer sollten Sie eine Definition aus dem Wörterbuch verwenden. Versuchen Sie keine Wörter derselben Sprachfamilie zu benutzen, das könnte das Wort zu einfach verraten!

   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.

   Eine Beispieldatei im kvtml-Format sieht wie folgt aus:

       <?xml version="1.0"?>
       <DOCTYPE kvtml PUBLIC "kvtml2.dtd"
       "http://edu.kde.org/kanagram/kvtml2.dtd">
       <kvtml version="2.0">
       <information>
           <generator>converter</generator>
           <title>Animals</title><!--Translate tag content-->
           <comment>Animals from across the
       planet</comment><!--Translate tag content-->
         </information>
         <identifiers>
           <identifier id="0" >
             <locale>en</locale>
           </identifier>
         </identifiers>
       ...
       <entry id="0" >
             <inactive>false</inactive>
             <inquery>false</inquery>
             <translation id="0" >
               <text>bear</text><!--Translate all text tags
       content-->
               <comment>Large heavy animal with thick
       fur</comment><!--Translate all comment tags content-->
             </translation>
           </entry>
       ...
       </kvtml>

2. Am Anfang der Datei sollten Sie den Inhalt der Tags `title` und `comment`, die vom Tag `information` umschlossen sind, übersetzen. Der Inhalt von title erscheint im Menü Kategorie (wo der Benutzer die Datei auswählt).

3. Im Tag `identifier` ersetzen Sie den Inhalt en des Tags `locale` durch Ihren Ländercode, ⪚ de.

   Bitte übersetzen Sie nicht die Dateinamen, da Dateinamen keine Sonderzeichen enthalten dürfen. Speichern Sie Ihre Datei darum bitte mit demselben englischen Dateinamen ab.

4. Bearbeiten Sie alle angegebenen kvtml-Dateien in einem Texteditor (verwenden Sie zur Erleichterung eine Hervorhebung für &XML;) und ersetzen Sie jedes Wort innerhalb der Marke `text` durch ein übersetztes Wort und jeden Tipp innerhalb der Marke `comment` durch einen übersetzten Tipp. Sie müssen die Tipps nicht direkt übersetzen, aber versuchen Sie die Länge und die Schwierigkeit der Worte etwa beizubehalten.

   You can include words with white space or - in them, in that case the white space or the - will be shown instead of the _. Please contact the kde-edu mailinglist if there is anything special related to your language so I can adapt the code to it (especially the special and accented characters).

5. Sie können die Worte einfach übersetzen, oder auch gemäß der Schwierigkeit neue hinzufügen oder anpassen. Zum Beispiel ist Tisch im Deutschen ein leichtes 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örter in einer Datei ist nicht wichtig, Sie können so viele Wörter hinzufügen, wie Sie möchten.

   Beachten Sie, dass alle Wörter Nomen sind.

6. You can then commit your files in l10n-kde4/<lang_code>/data/kdeedu/kdeedu-data/. Do not forget to update the CMakeLists.txt file as well. Please contact the kde-edu mailinglist if you need further information. When you send the files, please do not forget to mention any special characters used in your language (put them in a text file, one per line and add this file in the tarball) and please mention any other specificity.

   Spielen Sie niemals die Dateien im BRANCH ein, das könnte das Spiel unbrauchbar machen.

Vielen Dank für Ihre Mithilfe!

### Speicherung der Daten von &khangman;

When you get a new language via Game Get Words in New Language..., the new language data is stored in `$XDG_DATA_HOME/share/apps/kvtml/` in the language code folder. The available language dir names are also stored in the &khangman; config file in `$XDG_DATA_HOME/share/config/khangmanrc`.

The provider name (i.e. the address of the website where to download the new languages) is stored in `$XDG_DATA_DIRS/share/apps/khangman/khangmanrc`.

The English language (default) and the user language from his i18n package(s) (if available) are stored in `$XDG_DATA_DIRS/share/apps/kvtml`.

In the configuration file, stored for each user in `$XDG_DATA_HOME/share/config/khangmanrc` are saved all the game settings such as the background, last category played, ... plus the files that were downloaded from the Get Hot New Stuff! dialog.

## Danksagungen und Lizenz

&khangman;

Programm Copyright 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Mitwirkende:

- Galgenmännchen-Grafiken: Renaud Blanchard kisukuma@chez.com

- Töne: Ludovic Grossard ludovic.grossard@libertysurf.fr

- Ehemaliger Betreuer: &Primoz.Anzur; &Primoz.Anzur.mail;

- Schwedischen Datendateien, Programmierhilfe, transparente Bilder und Hilfe bei der Internationalisierung: Stefan Asserhäll stefan.asserhall@telia.com

- Spanische Datendateien: eXParTaKus expartakus@expartakus.com

- Tipps für die spanischen Datendateien: Rafael Beccar rafael.beccar@kdemail.net

- Dänische Datendateien: Erik Kjaer Pedersen erik@mpim-bonn.mpg.de

- Finnische Datendateien: Niko Lewman niko.lewman@edu.hel.fi

- Brasilianisches Portugiesische Datendateien: João Sebastião de Oliveira Bueno gwidion@mpc.com.br

- Katalanische Datendateien: Antoni Bella bella5@teleline.es

- Italienische Datendateien: Giovanni Venturi jumpyj@tiscali.it

- Holländische Datendateien: Rinse rinse@kde.nl

- Portugiesische Datendateien: Pedro Morais morais@kde.org

- Serbische (Kyrillisch und Latein) Datendateien: Chusslove Illich chaslav@sezampro.yu

- Slowenische Datendateien: Jure Repinc jlp@holodeck1.com

- Tschechische Datendateien: Lukáš Tinkl lukas@kde.org

- Tadschikische Datendateien: Roger Kovacs rkovacs@khujand.org

- Norwegische (Bokmål) Datendateien: Torger Åge Sinnes torg-a-s@online.no

- Ungarische Datendateien: Tamas Szanto tszanto@mol.hu

- Norwegische (Nynorsk) Datendateien: Gaute Hvoslef Kvalnes gaute@verdsveven.com

- Türkische Datendateien: Mehmet Özel mehmet_ozel2003@hotmail.com

- Bulgarische Datendateien: Radostin Radnev radnev@yahoo.com

- Irische (Gälische) Datendateien: Kevin Patrick Scannell scannell@slu.edu

- Hilfe beim Programmieren: &Robert.Gogolok; &Robert.Gogolok.mail;

- Programmierhilfe: Benjamin Meyer ben @meyerhome.net

- Programmfehler beseitigt durch: Lubos Lunàk l.lunak@kde.org

- Programmfehler beseitigt durch: Albert Astals Cid &Albert.Astals.Cid.mail;

- Studie über die Bedienbarkeit: Celeste Paul seele@obso1337.org

Copyright der Dokumentation 2001-2007 &Anne-Marie.Mahfouf;&Anne-Marie.Mahfouf.mail;

Übersetzung Burkhard Lücklueck@hube-lueck.de

&underFDL; &underGPL;
&documentation.index;