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

<book lang="&language;">

<bookinfo>
<title
>Handbok Hänga gubben</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
>2004-04-22</date>
<releaseinfo
>1.4</releaseinfo>

<abstract>
<para
>&khangman; är det klassiska Hänga gubben spelet för barn, anpassat till &kde; </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>hänga gubbe</keyword>
<keyword
>spel</keyword>
<keyword
>barn</keyword>
<keyword
>ord</keyword>
</keywordset>

</bookinfo>

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

<para
>&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. </para>

</chapter>

<chapter id="using-khangman">
<title
>Att använda Hänga gubben</title>

<screenshot>
<screeninfo
>Här är en skärmbild av &khangman; när du startar det för första gången</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Skärmbild av Hänga gubben</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>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. </para>

<para
>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. </para>

<sect1 id="general-usage">
<title
>Allmän användning</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
>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. </para>

<important
><para
>Alla ord är substantiv (inga verb, inga adjektiv, etc.).</para
></important>

<para
>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. </para>

<para
>Nuvarande nivå och språk visas i statusraden. </para>

<para
>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. </para>

<para
>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. </para>
 
<para
>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. </para>

<para
>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 <keycap
>Y</keycap
> eller <keycap
>N</keycap
>, eller musen för att svara ja eller nej. Om du svarar <guilabel
>Nej</guilabel
>, avslutas spelet. Om du svarar <guilabel
>Ja</guilabel
>, visas ett nytt ord att gissa. </para>

<!-- FIXME: should we call it 'field' or 'text edit' or...? -->
<para
>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. </para>

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

<para
>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. </para>
</sect1>

<sect1 id="languages">
<title
>Spela med olika språk</title>
<para
>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. </para>

<para
>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 <guimenu
>Språk</guimenu
> två poster: Engelska och Svenska, och Svenska är förvalt. </para>

<para
>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 <guimenu
>Arkiv</guimenu
> och därefter på <guimenu
>Hämta data på ett nytt språk...</guimenu
>. En dialogruta visas, som liknar den här: </para>

<screenshot>
<screeninfo
>Dialogrutan Hämta heta nyheter för Hänga gubben</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Skärmbild av Hämta heta nyheter</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>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. </para>

<para
>Därefter kan du enkelt byta språk genom att gå till menyn <guimenu
>Språk</guimenu
> och välja ett annat språk. </para>

<para
>Observera att du nu kan skriva in specialtecken i varje språk genom att visa <interface
>verktygsraden med specialtecken</interface
>. Den här verktygsraden innehåller knappar med en ikon för varje specialtecken i ett språk, som till exempel &eacute; 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. </para>

<important
><para
>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. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Några tips</title>
<para
>Försök gissa vokalerna först. Gör sedan ett försök med de vanligaste konsonanterna: l, t, r, n, s </para>
<para
>När du ser <quote
>io</quote
>, försök då med n, för franska och engelska. </para>
<para
>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 <quote
>a</quote
>, visas alla <quote
>a</quote
> med accenttecken i ordet. Det här är när alternativet <menuchoice
><guimenu
>Inställningar</guimenu
><guimenuitem
>Anpassa &khangman;</guimenuitem
> <guimenuitem
>Skriv in bokstäver med accent</guimenuitem
></menuchoice
> inte är markerat. När <guimenuitem
>Skriv in bokstäver med accent</guimenuitem
> är markerat, måste du själv skriva in bokstäver med accent. När du skriver in <quote
>a</quote
>, visas bara <quote
>a</quote
> och du måste till exempel skriva &atilde; för att den bokstaven ska visas. </para>
<para
>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%). </para>
</sect1>


</chapter>

<chapter id="menus">
<title
>Menyrad och verktygsrader</title>

<sect1 id="mainwindow">
<title
>Hänga gubbens huvudfönster</title>

<para
>Menyn <guimenu
>Spel</guimenu
> har tre alternativ: <guimenuitem
>Ny</guimenuitem
>, <guimenuitem
>Hämta data på ett nytt språk</guimenuitem
> och <guimenuitem
>Avsluta</guimenuitem
>.</para>

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

<para
>Menyn <guimenu
>Språk</guimenu
> 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. </para>
<para
>Menyn <guimenuitem
>Inställningar</guimenuitem
> låter dig enkelt anpassa Hänga gubben. Alternativen <guimenuitem
>Verktygsrader</guimenuitem
> och <guimenuitem
>Visa statusrad</guimenuitem
> ger dig möjlighet att dölja eller visa verktygsraderna och statusraden. </para>

<para
>Det finns två verktygsrader: huvudverktygsraden som är den längst upp med knapparna och kombinationsrutorna och <interface
>Tecken</interface
>-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. </para>
<tip>
<para
>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. </para>
</tip>
<para
><guimenuitem
>Anpassa genvägar...</guimenuitem
> är en standardinställning i &kde;, som låter dig välja olika snabbtangenter för olika åtgärder. <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> är till exempel standardtangenten för <guimenuitem
>Avsluta</guimenuitem
>.</para>
<para
><guimenuitem
>Anpassa verktygsrader...</guimenuitem
> är också ett standardalternativ i &kde;, som låter dig lägga till eller ta bort knappar i verktygsrader. När <guimenuitem
>Fullskärmsläge</guimenuitem
> är markerat, kommer du till fullskärmsläge, där Hänga gubben upptar hela skärmen, bara med verktygsraden längst upp. Ikonen <guiicon
>Avsluta fullskärmsläge</guiicon
> i huvudverktygsraden låter dig återgå från fullskärmsläge till fönsterstorleken du tidigare hade.</para>

<screenshot>
<screeninfo
>Blått tema i Hänga gubben</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Blått tema i Hänga gubben</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Här ser du Hänga gubben med blått tema, genomskinliga bilder, katalanska språket och lätt nivå. <interface
>Teckenverktygsraden</interface
> visas här.</para>

<para
>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. </para>

<para
>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.</para>
<para
>Bara bokstäver tillåts skrivas in i fältet.</para>
</sect1>

<sect1 id="settings">
<title
>Tillgängliga inställningar</title>
<sect2 id="normal-settings">
<title
>Normala inställningar</title>

<screenshot>
<screeninfo
>Hänga gubben normala inställningar</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="normalsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Hänga gubben normala inställningar</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>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. </para>
<para
>Under <guimenu
>Inställningar</guimenu
>, <guimenu
>Anpassa Khangman</guimenu
> hittar du två flikar. Den första är för normala inställningar. <guimenuitem
>Genomskinliga bilder</guimenuitem
> ger dig möjlighet att låta bilderna av gubben vara genomskinliga eller inte. <guimenuitem
>Snällare bilder</guimenuitem
> 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. </para>

<para
>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. </para>

<para
>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 &atilde;). Om det inte är markerat, och du skriver in vilken vokal som helst, visas också alla vokaler med accent. </para>
<para
>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. </para>

<para
>I rutan Ljud, om du markerar <guimenu
>Aktivera ljud</guimenu
>, spelas ett ljud när ett nytt spel startas och ett annat ljud när du vinner ett spel. </para>
</sect2>
<sect2 id="advanced-settings">
<title
>Avancerade inställningar</title>

<screenshot>
<screeninfo
>Hänga gubben avancerade inställningar</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="advancedsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Hänga gubben avancerade inställningar</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Om den är markerad, visar <guimenu
>Bara en förekomst av bokstaven</guimenu
> 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. </para>

<para
>Om du markera <guimenu
>Visa inte dialogrutan 'Gratulerar! Du vann!'</guimenu
> 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. </para>

</sect2>
</sect1>

</chapter>

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

<sect1 id="khangman-mainwindow">
<title
>Menyer och snabbtangenter</title>

<sect2>
<title
>Menyn <guimenu
>Spel</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Ny</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Nytt</action
> spel (dvs. ett nytt ord)</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Hämta data på ett nytt språk...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa</action
> dialogrutan för heta nyheter som listar all data tillgänglig i de olika språken. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Avsluta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avslutar</action
> Hänga gubben.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menyn <guimenu
>Språk</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Språk</guimenu
> <guimenuitem
>Språk</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Välj</action
> språk för orden.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menyn <guimenu
>Inställningar</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Verktygsrader</guimenuitem
> <guimenuitem
>Visa Huvudverktygsrad</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa eller dölj</action
> huvudverktygsraden.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Verktygsrader</guimenuitem
> <guimenuitem
>Visa Special Characters</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa eller dölj</action
> teckenverktygsraden.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>VIsa statusrad</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa eller dölj</action
> statusraden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Inställningar</guimenu
> <guimenuitem
>Fullskärmsläge</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Växla</action
> fullskärmsläget </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa genvägar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Anpassa</action
> snabbtangenterna som du använder för att komma åt de olika åtgärderna.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa verktygsrader...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Anpassa</action
> objekt som du vill placera i verktygsraden. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &khangman;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa</action
> Hänga gubbens inställningsdialogruta </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>Menyn <guimenu
>Hjälp</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Utvecklingsguide till Hänga gubben</title>

<sect1 id="changing-words">
<title
>Hur man lägger till ord på ett nytt språk i spelet</title>

<para
>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 <filename class="directory"
>khangman</filename
> i filen <filename
>README.languages</filename
>. Följ proceduren och skicka filerna i ett tar-arkiv komprimerat med gzip till annemarie.mahfouf@free.fr. </para>

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

<procedure>
<step
><para
>Skriv in följande kommandon i en terminal för att skapa katalog och filer för det nya språket:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>språkkod</replaceable
></command
></userinput
></screen>
<para
>Här måste du ersätta <replaceable
>språkkod</replaceable
> med koden för ditt språk.</para>
</step>
<step>
<para
>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.</para
> 

<para
>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 <quote
>bord</quote
> 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.</para>

<para
>Kom ihåg att alla ord är substantiv.</para>

<para
>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.</para>

<para
>Behåll de befintliga engelska filnamnen i katalogen för din språkkod.</para>
</step>

<step>
<para
>Skriv in följande kommando för att installera de nya datafilerna:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>Du kanske måste logga in som <systemitem class="username"
>root</systemitem
> för att köra <command
>make install</command
>, beroende på din installation.</para>
</step>
<step>
<para
>Kör spelet och kontrollera att ditt språk har lagts till:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>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.</para>
</step>
</procedure>

<para
>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 <sgmltag class="starttag"
>o</sgmltag
> är ordet, och <sgmltag class="starttag"
>t</sgmltag
> är tipset. Försök att få tipset att stämma med svårighetsgraden. Nivån <quote
>Lätt</quote
> kräver ett enkelt tips, medan nivån <quote
>Svår</quote
> 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!</para>

<para
>Ett exempel på en kvtml-fil är följande:</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;hund&lt;/o&gt; 
&lt;t&gt;Det är ditt favoritsällskapsdjur&lt;/t&gt; 
&lt;/e&gt; 
...
...
&lt;/kvtml&gt;</markup
></programlisting>


</sect1>
<sect1 id="internal">
<title
>Vad som lagras av Hänga gubben och var det lagras</title>
<para
>När du hämtar ett nytt spel via <guimenu
>Arkiv</guimenu
> -> <guimenu
>Hämta data på ett nytt språk</guimenu
>, lagras det nya språkets data i <filename class="directory"
>~/.kde/share/apps/khangman/data</filename
> under språkkodens katalog. Tillgängliga språknamn lagras också i Hänga gubbens konfigurationsfil i <filename
>~/.kde/share/config/khangmanrc</filename
>. </para>
<para
>Leverantörsnamnet (dvs. adressen till webbplatsen där nya språk kan laddas ner) lagras i <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>Det engelska språket (normalvärdet) och användarens språk från i18n-paketet (om tillgängligt) lagras i <filename class="directory"
>$KDEDIR/share/apps/khangman</filename
>. </para>
<para
>I inställningsfilen, som lagras som <filename
>~/.kde/share/config/khangmanrc</filename
> hos varje användare, sparas alla spelinställningar, som bakgrunden, senast spelade nivå, ... samt filerna som laddats ner via dialogrutan Hämta heta nyheter. </para>
</sect1>
<sect1 id="planned-features">
<title
>Planerade funktioner i Hänga gubben</title>
<para
>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 <link linkend="changing-words"
>Hur man lägger till ord på ett nytt språk i spelet</link
>. </para>
<para
>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. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Vanliga frågor</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Jag får ett felmeddelande som säger att bilderna inte kan hittas.</para>
</question>
<answer>
<para
>Spelet installeras normalt i <filename class="directory"
>/usr/local/kde</filename
> så lägg till <filename class="directory"
>/usr/local/kde/bin</filename
> i din sökväg, och ställ in <envar
>KDEDIR</envar
>-variabeln till <filename class="directory"
>/usr/local/kde</filename
> innan du kör spelet. Det enklaste sättet är att konfigurera Hänga gubben med väljaren <option
>--prefix</option
>=$<envar
>$KDEDIR</envar
> där $<envar
>KDEDIR</envar
> är stället där resten av &kde; är installerat. Det kan variera mycket, beroende på distribution och operativsystem.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Hänga gubben startar inte riktigt efter att jag uppgraderade till en av &kde; 3.3 versionerna.</para>
</question>
<answer>
<para
>Det kan uppstå ett problem på grund av ändringen i inställningsfilen. Ta bort filen <filename
>khangmanrc</filename
> i katalogen <filename class="directory"
>$HOME/.kde/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Tack till och licens</title>

<para
>&khangman; </para>
<para
>Program copyright 2001-2004 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
<para
>Bidragsgivare: <itemizedlist>
<listitem
><para
>Hänga gubben grafik: Renaud Blanchard <email
>kisukuma AT chez DOT com</email
></para
> </listitem>
<listitem
><para
>Ljud: Ludovic Grossard <email
>ludovic.grossard AT libertysurf DOT fr</email
></para
> </listitem>
<listitem
><para
>Blått tema: Primoz Anzur <email
>zerokode AT yahoo DOT com</email
></para
> </listitem>
<listitem
><para
>Svenska datafiler, kodningshjälp, genomskinliga bilder och i18n-rättningar: Stefan Asserhäll <email
>stefan DOT asserhall AT telia DOT com </email
></para
> </listitem>
<listitem
><para
>Naturtema: Joe Bolin <email
>jbolin AT users DOT sourceforge DOT net</email
></para
> </listitem>
<listitem
><para
>Snällare bilder: Matt Howe <email
>mdhowe AT bigfoot DOT com</email
></para
> </listitem>
<listitem
><para
>Spanska datafiler: eXParTaKus <email
>expartakus AT expartakus DOT com </email
></para
> </listitem>
<listitem
><para
>Danska datafiler: Erik Kjaer Pedersen <email
>erik AT mpim-bonn DOT mpg DOT de </email
></para
> </listitem>
<listitem
><para
>Finska datafiler: Niko Lewman <email
>niko DOT lewman AT edu DOT hel DOT fi </email
></para
> </listitem>
<listitem
><para
>Brasiliansk portugisiska datafiler: João Sebastião de Oliveira Bueno <email
>gwidion AT mpc DOT com DOT br </email
></para
> </listitem>
<listitem
><para
>Katalanska datafiler: Antoni Bella <email
>bella5 AT teleline DOT es </email
></para
> </listitem>
<listitem
><para
>Italienska datafiler: Giovanni Venturi <email
>jumpyj AT tiscali DOT it </email
></para
> </listitem>
<listitem
><para
>Holländska datafiler: Rinse <email
>rinse AT kde DOT nl </email
></para
> </listitem>
<listitem
><para
>Portugisiska datafiler: Pedro Morais <email
>morais AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Serbiska (kyrilliska och latinska) datafiler: Chusslove Illich <email
>chaslav AT sezampro DOT yu </email
></para
> </listitem>
<listitem
><para
>Slovenska datafiler: Jure Repinc <email
>jlp AT holodeck1 DOT com </email
></para
> </listitem>
<listitem
><para
>Tjeckiska datafiler: Luk&aacute;&scaron; Tinkl <email
>lukas AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Tadzjikiska datafiler: Roger Kovacs <email
>rkovacs AT khujand DOT org </email
></para
> </listitem>
<listitem
><para
>Norska (bokmål) datafiler: Torger &#197;ge Sinnes <email
>torg-a-s AT online DOT no </email
></para
> </listitem>
<listitem
><para
>Ungerska datafiler: Tamas Szanto <email
>tszanto@mol.hu </email
></para
> </listitem>
<listitem
><para
>Kodningshjälp: Robert Gogolok <email
>robertgogolok AT gmx DOT de</email
></para
> </listitem>
<listitem
><para
>Kodningshjälp: Benjamin Meyer <email
>ben AT meyerhome DOT net</email
></para
> </listitem>
<listitem
><para
>Kodrättning: Lubos Lun&agrave;k <email
>l.lunak AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Kodrättningar: Albert Astals Cid <email
>tsdgeos AT terra DOT es</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Dokumentation copyright 2001-2004 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
>Hur man skaffar Hänga gubben</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilering och 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:
-->
