# Handbok Hänga gubben

## Inledning

&khangman; är ett spel baserat på det välkända Hänga gubben spelet. Det är avsett för barn i åldrarna sex och uppåt. Spelet har fyra svårighetsgrader: djur (djurord), lätt, normal och svår. Ett ord väljs slumpmässigt, bokstäverna är dolda och du måste gissa ordet genom att försöka med en bokstav i taget. Varje gång du gissar fel bokstav, ritas en del av bilden av en hängd gubbe. Du måste gissa ordet innan du blir hängd! Du har tio försök.

Min son Joachim, som då var 9 1/2 år gammal, gav mig idén till spelet i juni 2000.

## Att använda Hänga gubben

Här är en skärmbild av &khangman; när du startar det för första gången Skärmbild av Hänga gubben

Här ser du Hänga Gubben som det ser ut första gången det körs. Nivån är lätt, språket är det förvalda (här svenska), det finns inget bakgrundstema och bilderna är inte genomskinliga. Alla ändringar av nivå, språk eller bakgrundsläge skrivs in inställningsfilen och återställs nästa gång du spelar.

Observera hur lätt det är att ändra nivå och bakgrundsläge. Klicka bara på kombinationsrutorna i verktygsraden. Att välja ett nytt ord, eller avsluta spelet görs också enkelt genom att klicka på motsvarande knappar på verktygsraden.

### Allmän användning

Ett ord visas, dolt. Du vet hur många boksäver som ordet har. Du måste gissa vad ordet är genom att försöka med en bokstav i taget. Ordet väljs slumpmässigt och är aldrig samma som det föregående ordet.

Alla ord är substantiv (inga verb, inga adjektiv, etc.).

Det spelar ingen roll om du skriver in små eller stora bokstäver. Programmet ändrar allt som skrivs in till små bokstäver, utom för tyska ord som börjar med stor bokstav. Programmet gör detta automatiskt.

Nuvarande nivå och språk visas i statusraden.

Varje gång du gissar en bokstav som inte finns i ordet, ritas ytterligare en del av den hängda gubben. Du har tio försök att gissa ordet. Därefter visas det riktiga svaret.

Det finns fyra nivåer: lätt, normal, svår och djur. Dessutom finns nivåer för andra ämnen på vissa språk. Programmet letar efter alla datafiler i alla språk.

På den lätta nivån är orden mycket enkla, relaterade till vardagslivet. Den är lämplig för barn från 6 till 9 år. Djurnivån innehåller bara namn på djur, så de är lättare att hitta. Några av dem är lätta, andra är svårare. På normalnivån är orden längre och svårare. Den är lämplig för 9 år och uppåt. Den svåra nivån är ... svår, dvs. orden är svårstavade och inte särskilt välkända. Den här nivån är en utmaning, till och med för vuxna.

Efter ett ord har gissats (eller den hängda gubben är färdig), blir du tillfrågad om ett annat ord, och du kan antingen använda tangenterna Y eller N, eller musen för att svara ja eller nej. Om du svarar Nej, avslutas spelet. Om du svarar Ja, visas ett nytt ord att gissa.

Du skriver in bokstaven som du vill pröva med i fältet (muspekaren är redan i fältet) och trycker på returtangenten. Om bokstaven hör till ordet, visas det på sin plats, så många gånger som den finns i ordet. Om bokstaven inte hör till ordet, hamnar den i fältet Fel, och ytterligare en del av gubben ritas till höger. Du har tio försök, och därefter förlorar du, och det riktiga ordet visas.

Under spelets gång kan du välja att starta ett nytt spel, genom att gå till menyn Spel och välja Ny, eller klicka på ikonen Ny i verktygsraden. Du kan också ändra nivå med nivåknappen i verktygsraden (det ger dig ett nytt ord på den nya nivån).

Framtida förbättringar kommer att låta dig skapa din egen ordfil eller ladda en fil som skiljer sig från de fyra som ingår.

Du kan spela Hänga Gubben på tolv språk: katalanska, danska, holländska, engelska, finska, franska, tyska, brasiliansk portugisiska, italienska, portugisiska, spanska och svenska. Du kan enkelt byta språk genom att gå till menyn Språk och välja ett annat språk.

Observera att du nu kan skriva in specialtecken i varje språk genom att visa verktygsraden med specialtecken. Den här verktygsraden innehåller knappar med en ikon för varje specialtecken i ett språk, som till exempel é i franska. Genom att klicka på en sådan knapp, skrivs motsvarande bokstav in på inmatningsraden och du bekräftar valet med returtangenten. Du kan förstås också använda tangentbordslayouten som motsvarar språket. Verktygsraden kan visas eller döljas om du vill. Inställningen återställs nästa gång du spelar Hänga Gubben.

### Några tips

Försök gissa vokalerna först. Gör sedan ett försök med de vanligaste konsonanterna: l, t, r, n, s

När du ser io, försök då med n, för franska och engelska.

På brasiliansk portugisiska, katalanska, spanska och portugisiska hittas vokaler med accenttecken när du skriver in motsvarande vokal utan accenttecken. Om du till exempel skriver a, visas alla a med accenttecken i ordet. Det här är när alternativet Inställningar Skriv in bokstäver med accent inte är markerat. När det är markerat, måste du själv skriva in bokstäver med accent. När du skriver in a, visas bara a och du måste till exempel skriva ã för att den bokstaven ska visas.

Visste du detta? På engelska är den vanligaste bokstaven e (12.7%), följd av t (9.1%) sedan a (8.2%), i (7.0%) och n (6.7%).

## Menyrad och verktygsrader

### Hänga gubbens huvudfönster

Menyn Spel har två alternativ: Ny och Avsluta.

Ny ger dig ett nytt spel, dvs. ett nytt ord att gissa, med samma nivå som du redan använder. Avsluta avslutar spelet genom att stänga huvudfönstret, och skriva ut nuvarande inställningar i konfigurationsfilen.

Menyn Språk har tolv menyalternativ: Brasiliansk portugisiska, Danska, Engelska, Finska, Franska, Holländska, Italienska, Katalanska, Portugisiska, Spanska, Svenska och Tyska. Normalt väljs ditt språk i &kde; om det är ett av de tolv, annars väljs engelska. Efter första spelet, återställs språket du sist ställde in när du använde Hänga Gubben.

Menyn Inställningar låter dig enkelt anpassa Hänga Gubben. Alternativen Verktygsrader och Visa statusrad ger dig möjlighet att dölja eller visa verktygsraderna och statusraden.

Det finns två verktygsrader: huvudverktygsraden som är den längst upp med knapparna och kombinationsrutorna och Tecken-verktygsraden, som är längst ner när den visas. Den här verktygsraden har knappar med specialtecken för varje språk: bokstäver med accent och andra specialtecken. Den låter dig enkelt spela med ett annat språk utan att behöva ställa in en ny tangentbordslayout. Du klickar på specialtecknet och det visas som bokstav att prova. Genom att trycka på returtangenten kontrollerar programmet om bokstaven finns i ordet eller inte. Verktygsraden kan döljas om du inte vill ha den. Det sparas i inställningsfilen, så om verktygsraden är dold, förblir den dold nästa gång du spelar Hänga Gubben.

Det är förstås möjligt att flytta omkring verktygsraderna. Placera muspekaren på det lilla greppet till vänster om verktygsraden, håll nere vänster musknapp och dra verktygsraden för att placera den där du vill ha den på skärmen. Om du pekar på en av verktygsraderna och håller nere höger musknapp, visas en sammanhangsberoende meny som låter dig välja olika inställningar för verktygsraden.

Anpassa genvägar... är en standardinställning i &kde;, som låter dig välja olika snabbtangenter för olika åtgärder. &Ctrl;Q är till exempel standardtangenten för Avsluta.

Anpassa verktygsrader... är också ett standardalternativ i &kde;, som låter dig lägga till eller ta bort knappar i verktygsrader. När Fullskärmsläge är markerat, kommer du till fullskärmsläge, där Hänga Gubben upptar hela skärmen, bara med verktygsraden längst upp. Ikonen Avsluta fullskärmsläge i huvudverktygsraden låter dig återgå från fullskärmsläge till fönsterstorleken du tidigare hade.

Genomskinliga bilder ger dig valet att låta Hänga Gubbens bilder vara genomskinliga eller inte, beroende på om alternativet är markerat eller inte.

Snällare bilder ger dig valet att göra de sista bilderna snällare. Det betyder att gubben inte hängs, utan håller repet i handen. Det är lämpligare för små barn.

Skriv in bokstäver med accent är ett läge som bara är tillgängligt på katalanska, brasiliansk portugisiska och spanska. Om alternativet är markerat, måste du skriva in bokstäver med accent, som ã, för att de ska visas i ordet. Om alternativet inte är markerat, hittar en vanlig vokal alla bokstäver med accent. Genom att försöka med a upptäcks till exempel också ã och andra a med accent om de finns i ordet.

Aktivera tips är bara tillgängligt på franska och italienska. Om du markerar alternativet med något av de två språken, kan du högerklicka var som helst i spelet och få ett tips visat under fyra sekunder. Tipset bör hjälpa dig att gissa ordet.

Observera att genomskinliga bilder för Hänga Gubben aktiveras inte när ingen bakgrund är vald. Genomskinliga bilder är bara tillgängliga med en bildbakgrund. Normalt är genomskinliga bilder aktiverade.

Blått tema i Hänga Gubben Blått tema i Hänga Gubben

Här ser du Hänga Gubben med blått tema, genomskinliga bilder, katalanska språket och lätt nivå. Teckenverktygsraden visas här.

Nivån väljs med en kombinationsruta, och du kan välja lätt, normal, djur och svår. Lätt anger vanliga objekt som ett sex- eller sjuårigt barn känner till. Normal anger substantiv som är något mer utmanande. Svår är riktigt svårt, och Djur är bara substantiv som anger djur.

Nivån väljs med en kombinationsruta, där valet är lätt, normal, djur och svår. Lätt ger vanliga objekt som ett barn på sex eller sju känner till. Normal gäller lite svårare substantiv. Svår är riktigt besvärlig, och Djur innehåller bara namn på djur. Alla ord är substantiv och skrivs med små bokstäver. Inga verb och inga adjektiv förekommer. Vald nivå visas i statusraden.

Bara bokstäver tillåts skrivas in i fältet.

## Kommandoreferens

### Menyer och snabbtangenter

#### Menyn Spel

&Ctrl;N Spel Ny

- Nytt spel (dvs. ett nytt ord)

&Ctrl;Q Spel Avsluta

- Avslutar Hänga Gubben.

#### Menyn Språk

Språk Språk

- Välj språk för orden.

#### Menyn Inställningar

Inställningar Verktygsrader Visa Huvudverktygsrad

- Visa eller dölj huvudverktygsraden.

Inställningar Verktygsrader Visa Special Characters

- Visa eller dölj teckenverktygsraden.

Inställningar VIsa statusrad

- Visa eller dölj statusraden.

&Ctrl;T Inställningar Genomskinliga bilder

- Välj genomskinliga bilder för Hänga Gubben.

&Ctrl;S Inställningar Snällare bilder

- Växla mellan snällare eller ursprungliga bilder för Hänga Gubben

&Ctrl;A Inställningar Skriv in bokstäver med accent

- Låter dig skriva bokstäver med accent för sig (med brasiliansk portugisiska, katalanska, portugisiska och spanska)

&Ctrl;H Inställningar Aktivera tips

- Låter dig se ett tips vid högerklick (bara på franska och italienska)

&Ctrl;&Shift;F Inställningar Fullskärmsläge

- Växla fullskärmsläget

Inställningar Anpassa genvägar...

- Anpassa snabbtangenterna som du använder för att komma åt de olika åtgärderna.

Inställningar Anpassa verktygsrader...

- Anpassa objekt som du vill placera i verktygsraden.

#### Menyn Hjälp

&help.menu.documentation;

## Utvecklingsguide till Hänga gubben

### Hur man lägger till ord på ett nytt språk för spelet

Tack vare Stefan Asserhäll, är det mycket lätt att lägga till ett nytt språk direkt till spelet. Proceduren som beskrivs här finns också i källkodskatalogen `khangman` i filen `README.languages`. Eftersom det redan finns tolv språk, kommer det att bli svårt att lägga till fler, eftersom menyn blir för lång. Följ alltså proceduren nedan, men istället för att arkivera filerna, skicka dem till mig i ett tar-arkiv komprimerat med gzip. På det sättet gör jag språket tillgängligt på Hänga Gubbens webbsida. Nästa utgåva av Hänga Gubben (med &kde; 3.3) kommer att ha en guide för att lätt kunna ladda ner och installera nya språk.

Ladda ner senaste CVS-versionen av &khangman;. Orden lagras i fyra olika filer, en för varje nivå. Filerna finns i `/khangman/data/språkkod`. Filen `easy.txt` är för den lätta nivån, filen `medium.txt` är för den normala nivån, filen `animals.txt` är för djurnivån, och filen `hard.txt` är för den svåra nivån.

1. Skriv in följande kommandon i en terminal för att skapa katalog och filer för det nya språket:

       ./add_language språkkod

   Här måste du ersätta `språkkod` med koden för ditt språk.

2. Redigera alla angivna textfiler i den nya katalogen med en texteditor, och ersätt varje ord med ett översatt ord. Det är inte särskilt viktigt att den exakta betydelsen bevaras, men försök hålla längden och svårighetsgraden ungefär lika.

   Du kan bara översätta orden, men du kan också anpassa dem enligt nivån och lägga till nya ord om du vill. Ordet bord finns i den lätta nivån för svenska, men i ditt språk kan den vara i normalnivån. Anpassa gärna filerna till behoven för ditt språk. Antalet ord i en fil är inte viktigt, du kan lägga till några om du vill.

   Kom ihåg att alla ord är substantiv.

   Observera att du måste använda kodningen UTF-8 när du redigerar filerna. Om din editor inte klarar det, försök använda &kwrite; eller &kate;. När du öppnar en fil i &kwrite; eller &kate;, kan du välja kodningen utf8 i kombinationsrutan längst upp till höger i dialogrutan för att öppna en fil.

   Behåll de befintliga engelska filnamnen i katalogen för din språkkod.

3. Skriv in följande kommando för att installera de nya datafilerna:

       make
       make install

   Du kanske måste logga in som `root` för att köra `make install`, beroende på din installation.

4. Kör spelet och kontrollera att ditt språk har lagts till:

       khangman

5. Arkivera de nya språkfilerna med följande kommando:

       cvs commit -m "Added new language namn_på_ditt_språk"

Om du vill ha tips i det nya språket, har du mer arbete att utföra. Du måste använda kvtml-formatet. Det bästa är att ta en titt i franska eller italienska data. Taggen `o` är ordet, och `t` är tipset. Försök att få tipset att stämma med svårighetsgraden. Nivån Lätt kräver ett enkelt tips, medan nivån Svår kräver definitionen från en ordlista. Försök att inte använda ord av samma typ i tipset, det gör det för lätt att gissa ordet!

Ett exempel på en kvtml-fil är följande:

    <?xml version="1.0"?>
    <!DOCTYPE kvtml SYSTEM "kvoctrain.dtd">
    <kvtml>
    <e>
    <o>hund</o>
    <t>Det är ditt favoritsällskapsdjur</t>
    </e>
    ...
    ...
    </kvtml>

### Planerade funktioner i Hänga Gubben

När antal språk för data ökar, blir det nödvändigt att sluta lägga till dem i programmet. Vi planerar att bara låta några få språk, som engelska, franska, tyska och spanska levereras med Hänga Gubben. Övriga språk blir tillgängliga i i18n-modulen och för nerladdning. Hänga Gubben kommer att använda klassen `KNewStuff`, för att erbjuda en guide som låter användaren enkelt ladda ner och installera ytterligare språk. Samma sak kommer också att göras för &klettres; och &kstars;, eftersom vi inte vill öka storleken på &package;-paketet.

En annan planerad funktion är förstås att ha tips på alla språk.

Vad som också kan göras är att använda andra kvtml-filer som de som finns på KDE:s utbildningsprojekts webbplats för att spela Hänga Gubben. Tänk dig till exempel att du kan spela med världens huvudstäder, tipset talar om landet och du måste gissa huvudstaden. Eller lär dig ord på ett annat språk, där tipset är ordet på ditt eget språk, och ordet att gissa är översättningen på det andra språket.

## Vanliga frågor

&reporting.bugs; &updating.documentation;

Jag får ett felmeddelande som säger att bilderna inte kan hittas.

Spelet installeras normalt i `/usr/local/kde` så lägg till `/usr/local/kde/bin` i din sökväg, och ställ in `KDEDIR`-variabeln till `/usr/local/kde` innan du kör spelet. Det enklaste sättet är att konfigurera Hänga gubben med väljaren `--prefix`=$`$KDEDIR` där $`KDEDIR` är stället där resten av &kde; är installerat. Det kan variera mycket, beroende på distribution och operativsystem.

Hänga Gubben startar inte riktigt efter att jag uppgraderade till en av &kde; 3.2 versionerna.

Det kan uppstå ett problem på grund av ändringen i inställningsfilen. Ta bort filen `khangmanrc` i katalogen `$HOME/.kde/share/config`.

## Tack till och licens

&khangman;

Program copyright 2001-2003 Anne-Marie Mahfouf annma AT kde DOT org

Bidragsgivare:

- Hänga gubben grafik: Renaud Blanchard kisukuma AT chez DOT com

- Ljud: Ludovic Grossard ludovic.grossard AT libertysurf DOT fr

- Blått tema: Primoz Anzur zerokode AT yahoo DOT com

- Svenska datafiler, kodningshjälp, genomskinliga bilder och i18n-rättningar: Stefan Asserhäll stefan DOT asserhall AT telia DOT com

- Naturtema: Joe Bolin jbolin AT users DOT sourceforge DOT net

- Snällare bilder: Matt Howe mdhowe AT bigfoot DOT com

- Spanska datafiler: eXParTaKus expartakus AT expartakus DOT com

- Danska datafiler: Erik Kjaer Pedersen erik AT mpim-bonn DOT mpg DOT de

- Finska datafiler: Niko Lewman niko DOT lewman AT edu DOT hel DOT fi

- Brasiliansk portugisiska datafiler: João Sebastião de Oliveira Bueno gwidion AT mpc DOT com DOT br

- Katalanska datafiler: Antoni Bella bella5 AT teleline DOT es

- Italienska datafiler: Giovanni Venturi jumpyj AT tiscali DOT it

- Holländska datafiler: Rinse rinse AT kde DOT nl

- Portugisiska datafiler: Pedro Morais morais AT kde DOT org

- Kodningshjälp: Robert Gogolok robertgogolok AT gmx DOT de

- Kodningshjälp: Benjamin Meyer ben AT meyerhome DOT net

- Kodrättning: Lubos Lunàk l.lunak AT kde DOT org

- Kodrättningar: Albert Astals Cid tsdgeos AT terra DOT es

Dokumentation copyright 2001 Anne-Marie Mahfouf annma AT kde DOT org

&underFDL; &underGPL;

## Installation

### Hur man skaffar Hänga gubben

&install.intro.documentation;

### Kompilering och installation

&install.compile.documentation;
&documentation.index;