<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY palapeli "<application
>Palapeli</application
>">
<!ENTITY kappname "&palapeli;">
<!ENTITY package "kdegames">
<!ENTITY % Estonian  "INCLUDE">
<!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
	<bookinfo>
		<title
>&palapeli; käsiraamat</title>
		<authorgroup>
			<author
><firstname
>Stefan</firstname
> <surname
>Majewsky</surname
> <affiliation
><address
><email
>majewsky@gmx.net</email
></address
></affiliation>
			</author>
			<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
		</authorgroup>

		<copyright>
			<year
>2009, 2010</year>
			<holder
>Stefan Majewsky</holder>
		</copyright>
		<legalnotice
>&FDLNotice;</legalnotice>
		<date
>2010-05-24</date>
		<releaseinfo
>1.1</releaseinfo>

		<abstract>
			<para
>See on &kde; tehnoloogial põhineva puslemängu &palapeli; käsiraamat.</para>
		</abstract>
		<keywordset>
			<keyword
>KDE</keyword>
			<keyword
>kdegames</keyword>
			<keyword
>mäng</keyword>
			<keyword
>pusle</keyword>
			<keyword
>pusle</keyword>
			<keyword
>palapeli</keyword>
		</keywordset>
	</bookinfo>

	<chapter id="introduction">
		<title
>Sissejuhatus</title>
		<para
>&palapeli; on ühele mängijale mõeldud pusle.</para>
		<para
>&palapeli; aken jaguneb kaheks alaks: puslekogu ja puslelaud. Käsiraamat kirjeldab allpool mõlemat ala.</para>
	</chapter>

	<chapter id="collection">
		<title
>Puslekogu sirvimine</title>
		<para
>When you launch &palapeli; for the first time, your puzzle collection is preloaded with some default puzzles that come with &palapeli;. Click on one of the puzzles to immediately start playing. Playing takes place on the puzzle table; see <link linkend="puzzletable"
>the next section</link
> for how to use the puzzle table.</para>
		<para
>Lisaks pusle valimisele saab puslekogus ette võtta järgmisi toiminguid:</para>
		<itemizedlist>
			<listitem
><para
><emphasis
>luua</emphasis
> uusi puslesid kettal olevate piltide põhjal</para
></listitem>
			<listitem
><para
><emphasis
>importida</emphasis
> teiste loodud puslesid</para
></listitem>
			<listitem
><para
><emphasis
>eksportida</emphasis
> puslesid, et jagada neid oma sõprade ja kogu maailmaga</para
></listitem>
			<listitem
><para
><emphasis
>kustutada</emphasis
> puslesid, mida sa enam ei vaja</para
></listitem>
		</itemizedlist>
		<para
>Järgnevalt kirjeldatakse, kuidas neid ülesandeid ette võtta tööriistariba nuppude abil.</para>
		<sect1 id="toolbars-collection">
			<title
>Tööriistariba tutvustus</title>
			<note
><para
>Puslesid saab nimekirjast valida, kui vajutada korraga klahvi &Ctrl; ja hiire vasakut nuppu. Hiire vasaku või parema nupu vajutamine ilma klahvita &Ctrl; avab konkreetse pusle puslelaual.</para
></note>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Loo uus pusle</guiicon
></term>
					<listitem>
						<para
><action
>Opens a dialog which allows you to create a puzzle from an image on your disk.</action
> Be sure to enter the correct metadata for the image: You should give attribution to the author of the image (&eg; the photographer or the painter); please respect the copyright of the image author.</para>
						<para
>Also, you will have to select the puzzle type. &palapeli; does not restrict you to classic puzzle pieces, other puzzle types can be easily added by third-party developers. Each puzzle type may offer a set of further properties, such as the piece count.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Kustuta</guiicon
></term>
					<listitem
><para
><action
>Kõik pusleloendis valitud pusled kustutatakse lõplikult sinu kogust. </action
></para
><warning
><para
>Seda toimingut ei saa tagasi võtta.</para
></warning
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Impordi failist</guiicon
></term>
					<listitem
><para
><action
>Kui oled hankinud &palapeli; puslefaili (seda eristab tavaliselt laiend <literal role="extension"
>*.puzzle</literal
>), võid selle importida oma kohalikku kogusse.</action
> Puslefaile saab mängimiseks avada ka neil failihalduris klõpsates, kuid importimise korral on see pusle näha ka sinu kohalikus kogus ning sa võid turvaliselt kustutada allalaaditud puslefaili.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Ekspordi failina</guiicon
></term>
					<listitem
><para
><action
>Sellega saab valitud pusled salvestada failina, et neid siis jagada sõpradele, avaldada veebis või ka lihtsalt teha oma kogust varukoopia.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="puzzletable">
		<title
>Mängimine puslelaual</title>
		<screenshot
><mediaobject>
			<imageobject
><imagedata fileref="puzzletable1.png" format="PNG"/></imageobject>
			<textobject
><phrase
>Puslelaud (detail)</phrase
></textobject>
		</mediaobject
></screenshot>
		<para
>Mängu eesmärk on panna etteantud tükkidest kokku pilt.</para>
		<para
>Tükke võib vabalt liigutada, klõpsates neil ja lohistades &HVNga;. Soovi korral saab valida korraga mitu tükki, hoides all klahvi &Ctrl; ja tükkidel klõpsates, või tõmmata nende ümber valimisjoon &HVNga; lohistades.</para>
		<para
>Kui asetad tüki selle naabertüki kõrvale, haakuvad nad automaatselt omavahel (1). Kui tükid on haakunud, ei saa neid enam lahutada. Erinevalt pärismaailmast ei saa kokku asetada tükke, mis tegelikult kokku ei kuulu.</para>
		<para
>Puslelaua all olev edenemisriba näitab sinu edenemist (2). &palapeli; salvestab sinu edenemise automaatselt iga käigu järel, mistõttu enamasti ei ole vaja muret tunda salvestamise pärast.</para>
		<para
>Hiirerattaga või all paremal asuva liuguriga (3) saab puslelauda suurendada või vähendada. Puslelaua vaadet saab liigutada &HVNga; klõpsates ja lohistades.</para>
		<para
>Tükke saab liigutada vaid <emphasis
>puslelaua alal</emphasis
>. Seda näitab taustast eristuv heledam ristkülikukujuline ala. Kui liigutad tüki mänguala piirde (4) vastu, laiendatakse seda automaatselt, et sul oleks rohkem ruumi tükkidega majandada. Varjutatud piirete lähedal muutub hiirekursor kahe otsaga nooleks, andes märku, et mänguala on võimalik muuta &HVNga; klõpsates ja lohistades.</para>
		<para
>Pusleala võib lukustada pisikese nupuga (5) edenemisribast paremal. Vari (4) pusleala ümber tumeneb ning tükid jäävad nüüd liigutamisel piirde äärde lihtsalt seisma ega liigu enam edasi. Käsitsi on siiski võimalik pusleala suurust muuta.</para>
		<sect1 id="puzzletable-mouseactions">
			<title
>Mängimine hiire abil</title>
			<para
>Nagu eespool kirjeldatud, saab &palapeli; puslelaual väga mitmel moel hiirega talitada. See, millised hiirenupud milliseid toiminguid käivitavad, on täielikult sinu enda määrata (vaata selle kohta täpsemalt osa <link linkend="configuration-mouseactions"
>Mängu seadistamine</link
>). Järgnevalt on kokku võetud kõik võimalikud hiiretoimingud:</para>
			<variablelist>
				<varlistentry>
					<term
><action
>Puslelaua ala suuruse muutmine selle servi lohistades</action
></term>
					<listitem
><para
>Vaikimisi sooritatakse see toiming &HVNga;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Tükkide liigutamine lohistades</action
></term>
					<listitem
><para
>Pusletükile klõpsates ja seda lohistades tükki liigutatakse. Kui valitud on mitu tükki ning klõpsad ühele neist ja seda lohistad, liigutatakse kõiki tükke. Vaikimisi sooritatakse see &HVNga;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Vaate muutmine lohistades</action
></term>
					<listitem
><para
>Vaikimisi sooritatakse see &HPNga;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Mitme tüki korraga valimine</action
></term>
					<listitem
><para
>Kui klõpsad pusletüki asemel puslelaua vabale alale, võid joonistada valikujoone. Kui vabastad hiirenupu, valitakse kõik selle sisse jäävad tükid. Kõigi ülejäänud tükkide varasem valitus eemaldatakse. Vaikimisi sooritatakse see &HPNga;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Tükkide valimine klõpsuga</action
></term>
					<listitem
><para
>Kui klõpsad ühele pusletükile, see valitakse. Kui see juba oli valitud, siis valitud olek eemaldatakse. Vaikimisi sooritatakse see &HVNga; ning ainult siis, kui hoitakse all klahv &Ctrl;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Puslelaua ala lukustuse lülitamine</action
></term>
					<listitem
><para
>See toiming on samane olekuribal nupu (5) klõpsamisega. Vaikimisi ei ole see omistatud ühelegi hiirenupule, kuid seda võib teha vastavas <link linkend="configuration-mouseactions"
>seadistustedialoogis</link
>.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Vaate rõhtne kerimine</action
> ja <action
>vaate püstine kerimine</action
></term>
					<listitem
><para
>Vaikimisi ei ole see omistatud hiirerattale, kuid seda võib teha vastavas <link linkend="configuration-mouseactions"
>seadistustedialoogis</link
>.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Vaate suurendamine</action
></term>
					<listitem
><para
>See toiming on samane liuguri (3) liigutamisega olekuribal. See toiming on vaikimisi omistatud hiirerattale.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="toolbars-puzzletable">
			<title
>Tööriistariba tutvustus</title>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Alusta puslet uuesti</guiicon
></term>
					<listitem
><para
><action
>Tühistab pusle salvestatud edenemise.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="interface">
		<title
>Liidese tutvustus</title>
		<para
>&palapeli; kaks ala, puslekogu ja puslelaud, on põimitud menüüribale kaartidena. Mängul on ka kaks menüüd standardsete toimingutega, mida allpool kirjeldatakse.</para>
		<sect1 id="settings-menu">
			<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
			<variablelist>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Puslelaua olekuriba näitamine</guimenuitem
></menuchoice
></term>
					<listitem
><para
><action
>Lülitab puslelaua all oleva edenemisriba ja nuppude näitamise sisse või välja.</action
> See ei muuda midagi puslekogu puhul.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
></menuchoice
></term>
					<listitem
><para
><action
>Avab dialoogi, kus saab seadistada</action
> &palapeli; kiirklahve</para
></listitem>
				</varlistentry>
				<varlistentry id="settings-menu-configure">
					<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&palapeli; seadistamine...</guimenuitem
></menuchoice
></term>
					<listitem
><para
>Avab mängu seadistustedialoogi. Täpsemalt kõneleb sellest osa <link linkend="configuration"
>Mängu seadistamine</link
>.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="help">
			<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect1>
	</chapter>

	<chapter id="configuration">
		<title
>Mängu seadistamine</title>
		<para
>Seadistustedialoogi saab avada menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>&palapeli; seadistamine...</guimenuitem
></menuchoice
></para>
		<sect1 id="configuration-general">
			<title
><guilabel
>Üldised seadistused</guilabel
></title>
			<variablelist>
				<varlistentry>
					<term
><guilabel
>Taust</guilabel
></term>
					<listitem
><para
><action
>Võimaldab valida puslelauale teise taustatekstuuri.</action
> Kui valid tekstuuri asemel konkreetse värvi, saab valikukasti kõrval asuvat nuppu kasutada värvi määramiseks.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guilabel
>Haarde täpsus</guilabel
></term>
					<listitem
><para
><action
>Võimaldab valida, kui lähedal peavad naabertükid teineteisele asuma, enne kui nad haakuvad.</action
> Kui liigutad liugurit paremale, haakuvad tükid isegi siis, kui nad ei ole väga lähedal. See muudab mängu veidi lihtsamaks.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configuration-mouseactions">
			<title
><guilabel
>Hiire käitumine</guilabel
></title>
			<para
>See seadistustedialoogi lehekülg võimaldab omistada hiirenuppudele eri tegevusi, mida kirjeldati osas <link linkend="puzzletable-mouseactions"
>Mängimine puslelaual</link
>. Toimingud on jagatud nendeks, mida saab omistada hiirenuppudele (nt. <action
>Vaate liigutamine lohistades</action
>), ja nendeks, mida saab omistada hiirerattale (nt. <action
>Vaate rõhtne kerimine</action
>).</para>
			<sect2>
				<title
><guilabel
>Hiirenuppude</guilabel
> kaart</title>
				<para
>Iga toimingu kõrval on nupp hiire pildiga, mis näitab parajasti omistatud toimingut. Seoseid võib määrata, kui klõpsata nupule &HVNga; ja seejärel vajutada hiirenuppu, millele soovid toimingu omistada. Kui hoiad teisel klõpsamisel all muuteklahvi, lubab puslelaud antud toimingut ainult juhul, kui all hoitakse ka muuteklahvi.</para>
				<tip
><para
>Klõpsamise asemel võib vajutada ka <keycap
>tühikuklahvi</keycap
>, et omistada toimingule spetsiaalne väärtus <guilabel
>Nuputa</guilabel
>. See on lubatud ainult siis, kui all hoitakse muuteklahve. <guilabel
>Nuputa</guilabel
> tähendab, et hiirenupu rolli võtavad üle muuteklahvid. Toiming käivitub siis, kui vajutatakse muuteklahve, ja lõpeb siis, kui vabastatakse üks muuteklahvidest.</para
></tip>
			</sect2>
			<sect2>
				<title
><guilabel
>Hiireratta</guilabel
> kaart</title>
				<para
>See on samasugune nagu eelmine kaart. Kui paremal asuv nupp vajab sisendit, siis hiirenupuga klõpsamise asemel tuleb hoopis liigutada hiireratast. Siin on samuti lubatud muuteklahvide allhoidmine, mis avaldavad samasugust mõju nagu hiirenuppude korral.</para>
				<tip
><para
>Kui sinu hiirel on kahesuunaline hiireratas (nagu leidub sageli sülearvutite puuteplaatidel), võib seda ära kasutada: nupp tunneb ära, kas hiireratast liigutati rõhtsalt või püstiselt.</para
></tip>
			</sect2>
		</sect1>
	</chapter>

	<chapter id="credits">
		<title
>Autorid ja litsents</title>
		<para
>&palapeli; püüab pakkuda sinu töölaual sulaselget rõõmu ja nuputamislusti puslede kokkupanemisega.</para>
		<para
>The idea was first developed by Bernhard Schiffner, together with Stefan Majewsky, who is the current lead developer of &palapeli;.</para>
		<para
>Documentation Copyright 2009, 2010 Stefan Majewsky.</para>
		<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

	<appendix id="installation">
		<title
>Paigaldamine</title>
		&install.intro.documentation;
		<sect1 id="Compilation">
			<title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>
	</appendix>
	&documentation.index;
</book>