# 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.

## 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.).

Oftast spelar det 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.

### Spela med olika språk

Du kan spela Hänga gubben på nitton språk: brasiliansk portugisiska, danska, engelska, finska, franska, holländska, italienska, katalanska, norska (bokmål), portugisiska, serbiska (latinsk och kyrillisk), sloveniska, spanska, svenska, tadzjikiska, tjeckiska, tyska och ungerska.

Normalt är bara engelska och ditt &kde;-språk installerade, om det är ett av de ovanstående och om du har motsvarande kde-i18n paket, efter den första installationen av Hänga gubben för KDE 3.3. Om du till exempel är en svensk användare och har &kde; på svenska, innehåller Hänga gubbens meny Språk två poster: Engelska och Svenska, och Svenska är förvalt.

Du kan ändå spela Hänga gubben på andra språk. Det är mycket lätt att lägga till ny data i Hänga gubben. Allt du behöver är en fungerade anslutning till Internet. Du klickar på menyn Arkiv och därefter på Hämta data på ett nytt språk.... En dialogruta visas, som liknar den här:

Dialogrutan Hämta heta nyheter för Hänga gubben Skärmbild av Hämta heta nyheter

Klicka på språknamnet som du vill installera, och därefter på knappen Installera. En dialogruta talar om för dig när språket har installerats genom att visa "Installerade heta nyheter med lyckat resultat". Du klickar på Ok för att stänga informationsdialogrutan, och därefter på Stäng för att stänga dialogrutan Hämta heta nyheter (om du vill ha ett språk till, får du upprepa stegen). Det nya språket är nu tillgängligt.

Därefter kan du 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.

Observera att du behöver teckensnitten Arial och URW Bookman för att kunna visa specialtecken i vissa språk. Under förutsättning att du har dessa teckensnitt installerade, använder Hänga gubben dem automatiskt. Om du ser små fyrkanter istället för bokstäver, kanske du saknar ett av teckensnitten.

### 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 Anpassa &khangman; Skriv in bokstäver med accent inte är markerat. När Skriv in bokstäver med accent ä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 tre alternativ: Ny, Hämta data på ett nytt språk och Avsluta.

Ny ger dig ett nytt spel, dvs. ett nytt ord att gissa, med samma nivå som du redan använder. Hämta data på ett nytt språk visar dialogrutan Hämta heta nyheter, som låter dig ladda ner data på ett nytt språk. Avsluta avslutar spelet genom att stänga huvudfönstret, och skriva ut nuvarande inställningar i inställningsfilen.

Menyn Språk har normalt ett eller två språk: Engelska och ditt KDE-språk om det är tillgängligt (om ditt &kde;-språk är ett av följande arton språk: brasiliansk portugisiska, danska, finska, franska, holländska, italienska, katalanska, latinsk serbiska, norska (bokmål), portugisiska, serbiska, sloveniska, spanska, svenska, tadzjikiska, tjeckiska, tyska och ungerska, och om du har motsvarande i18n-paket installerat är det förvalt). Efter det första spelet, återställs språket du ställde in förra gången 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.

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.

### Tillgängliga inställningar

#### Normala inställningar

Hänga gubben normala inställningar Hänga gubben normala inställningar

En verktygsrad tillhandahålls för att snabbt komma åt vissa inställningar. Du kan klicka på en knapp för att start ett nytt spel (dvs. ett nytt ord), för att avsluta spelet och för att få fullskärmsläge (tillhandahålls för skärmar med låg upplösning och för att spela med flera personer). Handboken visas också om du klickar på ikonen med Hänga gubbens handbok. Nivån och bakgrunden ändras enkelt via två kombinationsrutor på verktygsraden.

Under Inställningar, Anpassa Khangman hittar du två flikar. Den första är för normala inställningar. Genomskinliga bilder ger dig möjlighet att låta bilderna av gubben vara genomskinliga 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. Genomskinliga och snällare bilder är normalvärden.

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.

Du kan ha särskilda inställningar för vissa språk. Dessa inställningar är inte aktiverade om de inte är tillgängliga i språket du för närvarande spelar med. Den första inställningen, Skriv in bokstäver med accent, är tillgänglig för brasiliansk portugisiska, katalanska, portugisiska och spanska. Om du markerar Skriv in bokstäver med accent, måste du skriva vokaler med accent (som ã). Om det inte är markerat, och du skriver in vilken vokal som helst, visas också alla vokaler med accent.

Vissa språk har också tips för att hjälpa dig att gissa ordet. Tipset visas med ett högerklick, och ger en kort beskrivning av ordet som ska gissas. Om inställningen är aktiverad och du markerar alternativet, 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.

I rutan Ljud, om du markerar Aktivera ljud, spelas ett ljud när ett nytt spel startas och ett annat ljud när du vinner ett spel.

#### Avancerade inställningar

Hänga gubben avancerade inställningar Hänga gubben avancerade inställningar

Om den är markerad, visar Bara en förekomst av bokstaven bara den första förekomsten av en bokstav om det finns flera likadana bokstäver i ordet. Om ordet till exempel är 'potatis' och du skriver 't', visas bara det första. Du måste skriva 't' igen för att visa den andra förekomsten av 't', och ett tredje 't' hamnar i listan över felaktiga bokstäver. Det här ökar svårighetsnivån.

Om du markera Visa inte dialogrutan 'Gratulerar! Du vann!' visas inte denna dialogruta när du vinner ett spel. Istället visas ordet under fyra sekunder, och därefter startas omedelbart ett nytt spel.

## Kommandoreferens

### Menyer och snabbtangenter

#### Menyn Spel

&Ctrl;N Spel Ny

- Nytt spel (dvs. ett nytt ord)

&Ctrl;G Spel Hämta data på ett nytt språk...

- Visa dialogrutan för heta nyheter som listar all data tillgänglig i de olika språken.

&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;&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.

Inställningar Anpassa &khangman;...

- Visa Hänga gubbens inställningsdialogruta

#### Menyn Hjälp

&help.menu.documentation;

## Utvecklingsguide till Hänga gubben

### Hur man lägger till ord på ett nytt språk i 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`. Följ proceduren och skicka filerna i ett tar-arkiv komprimerat med gzip till annemarie.mahfouf@free.fr.

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. Packa därefter filerna i ett tar-arkiv och skicka in dem, så att jag kan lägga till dem på servern för Hämta heta nyheter, och i motsvarande kde-i18n modul i CVS.

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>

### Vad som lagras av Hänga gubben och var det lagras

När du hämtar ett nytt spel via Arkiv -> Hämta data på ett nytt språk, lagras det nya språkets data i `~/.kde/share/apps/khangman/data` under språkkodens katalog. Tillgängliga språknamn lagras också i Hänga gubbens konfigurationsfil i `~/.kde/share/config/khangmanrc`.

Leverantörsnamnet (dvs. adressen till webbplatsen där nya språk kan laddas ner) lagras i `$KDEDIR/share/apps/khangman/khangmanrc`.

Det engelska språket (normalvärdet) och användarens språk från i18n-paketet (om tillgängligt) lagras i `$KDEDIR/share/apps/khangman`.

I inställningsfilen, som lagras som `~/.kde/share/config/khangmanrc` hos varje användare, sparas alla spelinställningar, som bakgrunden, senast spelade nivå, ... samt filerna som laddats ner via dialogrutan Hämta heta nyheter.

### Planerade funktioner i Hänga gubben

En planerad funktion är förstås att ha mer språkdata, och dessutom tips på alla språk. Du kan hjälpa till med detta i ditt eget språk om det inte ännu har gjorts. Kontakta mig gärna om du vill hjälpa till med detta, det är bara frågan om att översätta de engelska orden till ditt språk (se Hur man lägger till ord på ett nytt språk i spelet.

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.3 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-2004 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

- Serbiska (kyrilliska och latinska) datafiler: Chusslove Illich chaslav AT sezampro DOT yu

- Slovenska datafiler: Jure Repinc jlp AT holodeck1 DOT com

- Tjeckiska datafiler: Lukáš Tinkl lukas AT kde DOT org

- Tadzjikiska datafiler: Roger Kovacs rkovacs AT khujand DOT org

- Norska (bokmål) datafiler: Torger Åge Sinnes torg-a-s AT online DOT no

- Ungerska datafiler: Tamas Szanto tszanto@mol.hu

- 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-2004 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;