<?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 % German "INCLUDE">
<!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
	<bookinfo>
		<title
>Das Handbuch zu &palapeli;</title>
		<authorgroup>
			<author
><firstname
>Stefan</firstname
><surname
>Majewsky</surname
> <affiliation
><address
><email
>majewsky@gmx.net</email
></address
></affiliation>
			</author>
			<othercredit role="translator"
><firstname
>Johannes</firstname
><surname
>Obermayr</surname
><affiliation
><address
><email
>johannesobermayr@gmx.de</email
></address
></affiliation
><contrib
>Übersetzung</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
>Dieses Handbuch beschreibt &palapeli;, ein Bilderpuzzle-Spiel für &kde;</para>
		</abstract>
		<keywordset>
			<keyword
>KDE</keyword>
			<keyword
>kdegames</keyword>
			<keyword
>Spiel</keyword>
			<keyword
>Puzzlespiel</keyword>
			<keyword
>Bilderpuzzle</keyword>
			<keyword
>Palapeli</keyword>
		</keywordset>
	</bookinfo>

	<chapter id="introduction">
		<title
>Einleitung</title>
		<para
>&palapeli; ist ein Bilderpuzzle-Spiel für einen Spieler.</para>
		<para
>Das Fenster von &palapeli; ist in die beiden Bereiche <guilabel
>Sammlung</guilabel
> und <guilabel
>Puzzletisch</guilabel
> unterteilt. Dieses Handbuch beschreibt diese beiden Bereiche.</para>
	</chapter>

	<chapter id="collection">
		<title
>Sammlung durchsuchen</title>
		<para
>Beim erstmaligen Start von &palapeli; ist die <guilabel
>Sammlung</guilabel
> mit ein paar standardmäßig mit &palapeli; ausgelieferten Puzzle gefüllt. Sobald auf eines dieser Puzzle geklickt wird startet das Spiel unverzüglich. Das Spiel findet auf dem <guilabel
>Puzzletisch</guilabel
> statt. Weitere Informationen zur Bedienung des <emphasis
>Puzzletisches</emphasis
> werden im <link linkend="puzzletable"
>nächsten Abschnitt</link
> gegeben.</para>
		<para
>Zusätzlich zur Auswahl des Puzzles kann die <emphasis
>Sammlung</emphasis
> für folgende weitere Aktionen verwendet werden:</para>
		<itemizedlist>
			<listitem
><para
><emphasis
>Erstellen</emphasis
> neuer Puzzle aus auf der Festplatte befindlichen Bilder</para
></listitem>
			<listitem
><para
><emphasis
>Importieren</emphasis
> von anderen erstellten Puzzle</para
></listitem>
			<listitem
><para
><emphasis
>Exportieren</emphasis
> von Puzzle zur Weitergabe an andere</para
></listitem>
			<listitem
><para
><emphasis
>Entfernen</emphasis
> von nicht weiter benötigten Puzzle</para
></listitem>
		</itemizedlist>
		<para
>Der folgende Abschnitt zeigt, wie diese Aufgaben mit den Knöpfen der Werkzeugleiste bewerkstelligt werden.</para>
		<sect1 id="toolbars-collection">
			<title
>Werkzeugleiste</title>
			<note
><para
>Die Puzzle können mittels Drücken der <keycap
>Strg</keycap
>-Taste und Klick mit der linken Maustaste ausgewählt werden. Das Klicken mit der linken oder rechten Maustaste ohne Drücken der <keycap
>Strg</keycap
>-Taste öffnet das jeweils angeklickte Puzzle auf dem Puzzletisch.</para
></note>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Neues Puzzle erstellen</guiicon
></term>
					<listitem>
						<para
>Öffnet einen Dialog zum Erstellen eines neuen Puzzles aus einem Bild auf der lokalen Festplatte. Die Eingabe der richtigen Metadaten des Bildes (z. B. Ersteller oder Kopierrechte) sollten dabei sichergestellt sein.</para>
						<para
>Es muss auch die Form der Puzzleteile festgelegt werden. &palapeli; beschränkt sich dabei nicht nur auf die vorgegebenen Formen der Puzzleteile - es können auf einfachste Art und Weise weitere Formen von Drittanbietern hinzugefügt werden. Jede Form bietet ggf. weitere Einstellungsmöglichkeiten (z. B. Anzahl der Puzzleteile).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Entfernen</guiicon
></term>
					<listitem
><para
><action
>Die ausgewählten Puzzles werden endgültig aus der Sammlung gelöscht. </action
></para
><warning
><para
>Diese Aktion kann nicht rückgängig gemacht werden.</para
></warning
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Aus Datei importieren</guiicon
></term>
					<listitem
><para
>&palapeli;-Puzzle (meist <filename
>*.puzzle</filename
>-Dateien) können hierdurch in die lokale Sammlung aufgenommen werden. Die Puzzledateien werden aber auch mittels entsprechendem Klick im Dateimanager geöffnet werden. Jedoch erscheinen sie nur nach dem Importieren in der Sammlung und die ursprüngliche Puzzledatei kann danach ohne weitere Auswirkungen auf &palapeli; gelöscht werden.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>In Datei exportieren</guiicon
></term>
					<listitem
><para
><action
>Exportiert die ausgewählten Puzzles in Dateien, damit sie an Freunde weitergegeben, im Internet veröffentlicht oder als Sicherungskopie der Sammlung gespeichert werden können.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="puzzletable">
		<title
>Puzzletisch</title>
		<screenshot
><mediaobject>
			<imageobject
><imagedata fileref="puzzletable1.png" format="PNG"/></imageobject>
			<textobject
><phrase
>Aufbau des Puzzletisches</phrase
></textobject>
		</mediaobject
></screenshot>
		<para
>Das Ziel besteht darin, die vorhandenen Stücke zu einem Bild zusammenzusetzen.</para>
		<para
>Die Puzzleteile können nach dem Anklicken mit gedrückter linker Maustaste auf dem Puzzletisch frei bewegt werden. Mit gedrückter Strg-Taste oder linker Maustaste können mehrere Puzzleteile mittels Fangband gleichzeitig ausgewählt werden.</para>
		<para
>Werden zusammengehörige Puzzleteile nebeneinander gelegt, so werden sie automatisch miteinander verbunden (1). Verbundene Puzzleteile können nicht wieder getrennt werden. Anders als beim realen Puzzle können hier keine Puzzleteile miteinander verbunden werden, die nicht tatsächlich zusammengehören.</para>
		<para
>Die <emphasis
>Fortschrittsanzeige</emphasis
> unterhalb des Puzzletisches (2) zeigt den aktuellen Fortschritt an. &palapeli; speichert den Fortschritt automatisch nach jedem Spielzug, sodass sich darum nicht mehr gekümmert werden muss.</para>
		<para
>Mit dem Mausrad oder dem Schieberegler rechts unten (3) kann die Ansicht des Puzzletisches vergrößert oder verkleinert werden. Mit gedrückter rechter Maustaste kann der Puzzletisch <emphasis
>verschoben</emphasis
> werden.</para>
		<para
>Die Puzzleteile können nur innerhalb des <emphasis
>Puzzlebereiches</emphasis
> auf dem Puzzletisch bewegt werden. Dieser wird durch ein leicht erhelltes Rechteck dargestellt. Werden die Puzzlestücke an den Rand (4) bewegt, so vergrößert sich der Puzzletisch, um mehr Platz zu schaffen. In der Nähe des schattierten Rahmens verwandelt sich der Mauszeiger in einen Doppelpfeil und die Größe des Puzzlebereiches kann sodann mit gedrückter Maustaste angepasst werden.</para>
		<para
>Die Größe des Puzzlebereiches kann mittels dem kleinen Knopf rechts neben der Fortschrittsanzeige (5) festgestellt werden. Die Schattierung um den Puzzlebereich (4) wird dunkler, der Puzzlebereich vergrößert sich nicht mehr automatisch und die Puzzleteile nur noch innerhalb des erhellten Bereiches bewegt werden. Die manuelle Anpassung der Größe des Puzzlebereiches ist weiterhin möglich.</para>
		<sect1 id="puzzletable-mouseactions">
			<title
>Maus-Funktionen</title>
			<para
>Wie im letzten Abschnitt beschrieben kann &palapeli;s Puzzletisch durch Verwenden der Maus auf verschiedene Arten bedient werden. Welche Maustaste welche Aktion auslösen soll kann frei festgelegt werden (siehe <link linkend="configuration-mouseactions"
>Spieleinstellungen</link
>). Die nachstehende Zusammenstellung zeigt alle möglichen Mausaktionen:</para>
			<variablelist>
				<varlistentry>
					<term
><action
>Größe des Puzzlebereiches durch Ziehen der Kanten ändern</action
></term>
					<listitem
><para
>Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Teile durch Ziehen bewegen</action
></term>
					<listitem
><para
>Nachdem ein Puzzleteil ausgewählt wurde kann dieses durch ständiges Drücken der entsprechenden Taste bewegt werden. Sofern mehrere Puzzleteile ausgewählt sind und eines davon bewegt wird, bewegen sich alle ausgewählten Teile. Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Ansicht durch Ziehen verschieben</action
></term>
					<listitem
><para
>Standardmäßig ist diese Aktion der rechten Maustaste zugeordnet.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Mehrere Puzzleteile gleichzeitig auswählen</action
></term>
					<listitem
><para
>Sofern in den freien Bereich des Puzzletisches geklickt wird, kann ein Fangband gezogen werden. Beim Lösen der Maustaste werden dann alle Puzzleteile innerhalb des Fangbandes ausgewählt. Alle anderen Stücke sind nicht ausgewählt. Standardmäßig ist diese Aktion der linken Maustaste zugeordnet.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Teile durch Anklicken auswählen</action
></term>
					<listitem
><para
>Sofern auf ein einzelnes Puzzleteil geklickt wird, ist nur dieses ausgewählt. War es bereits ausgewählt, wird die Auswahl aufgehoben. Standardmäßig ist diese Aktion der linken Maustaste (bei gedrückter Strg-Taste) zugeordnet.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Sperre für Größe des Puzzlebereiches umschalten</action
></term>
					<listitem
><para
>Diese Aktion ist mit dem Drücken des Knopfes (5) in der Statusleiste vergleichbar. Standardmäßig ist diese Aktion nicht zugeordnet und kann im <link linkend="configuration-mouseactions"
>Einrichtungsdialog</link
> entsprechend zugeordnet werden.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Ansicht waagerecht verschieben</action
> und <action
>Ansicht senkrecht verschieben</action
></term>
					<listitem
><para
>Standardmäßig ist diese Aktion nicht dem Mausrad zugeordnet. Über den <link linkend="configuration-mouseactions"
>Einrichtungsdialog</link
> ist eine entsprechende Zuordnung möglich.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Ansicht vergrößern</action
></term>
					<listitem
><para
>Diese Aktion ist identisch mit dem Bewegen des Schiebereglers (3) in der Statusleiste. Standardmäßig ist dieser Aktion das Mausrad zugeordnet.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="toolbars-puzzletable">
			<title
>Werkzeugleiste</title>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Puzzle neu starten</guiicon
></term>
					<listitem
><para
><action
>Der bisher gespeicherte Fortschritt wird verworfen und das Puzzle von neuem begonnen.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="interface">
		<title
>Benutzeroberfläche</title>
		<para
>Die beiden Bereiche von &palapeli; (Sammlung und Puzzletisch) sind durch Karteireiter in das Menü eingebunden. Die beiden anderen Standard-Menüs werden nachstehend beschrieben.</para>
		<sect1 id="settings-menu">
			<title
>Das Menü <guimenu
>Einstellungen</guimenu
></title>
			<variablelist>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>Statusleiste anzeigen</guimenuitem
></menuchoice
></term>
					<listitem
><para
>Zeigt die Fortschrittsanzeige und Knöpfe im unteren Bereich des <emphasis
>Puzzletisches</emphasis
> an bzw. blendet sie aus. In der <guimenu
>Sammlung</guimenu
> hat diese Einstellung keine Auswirkungen.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>Kurzbefehle festlegen ...</guimenuitem
></menuchoice
></term>
					<listitem
><para
>Öffnet einen Dialog zum Einstellen der Tastenkürzel für &palapeli;.</para
></listitem>
				</varlistentry>
				<varlistentry id="settings-menu-configure">
					<term
><menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>&palapeli; einrichten ...</guimenuitem
></menuchoice
></term>
					<listitem
><para
>Öffnet einen Dialog für die Spieleinstellungen. Eine nähere Beschreibung hierzu ist im Abschnitt <link linkend="configuration"
>Spieleinstellungen</link
> enthalten.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="help">
			<title
>Das Menü <guimenu
>Hilfe</guimenu
></title>
&help.menu.documentation; </sect1>
	</chapter>

	<chapter id="configuration">
		<title
>Spieleinstellungen</title>
		<para
>Der Einrichtungsdialog wird über das Menü <menuchoice
><guimenu
>Einstellungen</guimenu
><guimenuitem
>&palapeli; einrichten ...</guimenuitem
></menuchoice
> aufgerufen.</para>
		<sect1 id="configuration-general">
			<title
><guilabel
>Allgemeine Einstellungen</guilabel
></title>
			<variablelist>
				<varlistentry>
					<term
><guilabel
>Hintergrund</guilabel
></term>
					<listitem
><para
><action
>Ein anderer Hintergrund für den Puzzletisch kann gewählt werden.</action
> Bei Auswahl von <guilabel
>Einfarbig</guilabel
> kann die Farbe rechts neben dem Auswahlfeld festgelegt werden.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guilabel
>Einrastgenauigkeit</guilabel
></term>
					<listitem
><para
><action
>Legt fest, wie nahe die zusammenpassenden Teile beieinander sein müssen, damit sie miteinander verbunden werden (einrasten).</action
> Wird der Schieberegler weiter nach rechts bewegt, so werden sie schon bei größerer Entfernung miteinander verbunden. Dadurch wird die Bedienung ein bisschen einfacher.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configuration-mouseactions">
			<title
><guilabel
>Maus-Funktionen</guilabel
></title>
			<para
>Diese Seite des Einrichtungsdialoges ermöglicht die Zuordnung der Maustasten zu den Maus-Funktionen, welche im Abschnitt <link linkend="puzzletable-mouseactions"
>Puzzletisch</link
> beschrieben werden. Die Funktionen sind unterteilt in solche, die den Maustasten (z. B. <action
>Ansicht durch Ziehen verschieben</action
>) und jenen, die dem Mausrad (z. B. <action
>Ansicht waagerecht verschieben</action
>) zugeordnet werden können.</para>
			<sect2>
				<title
><guilabel
>Maustasten</guilabel
>-Karteireiter</title>
				<para
>Neben dem Namen der jeweiligen Aktion befindet sich ein Knopf mit einem Bild einer Computermaus, welche die aktuell zugeordnete Aktionzeigt. Das Festlegen der Aktionen geschieht durch Klicken zunächst mit der linken Maustaste auf diesen Knopf und nachfolgend der gewünschten Maustaste, welcher die Aktion zugeordnet werden soll. Sofern beim zweiten Klicken eine oder mehrere Modifizierungstasten (<keycap
>Strg</keycap
>, <keycap
>Alt</keycap
>, <keycap
>Umschalt</keycap
> oder <keycap
>Windows</keycap
>) gedrückt werden, können die Aktionen auf dem Puzzletisch nur ausgeführt werden, wenn auch die entsprechend festgelegten Modifizierungstasten gedrückt werden.</para>
				<tip
><para
><guilabel
>Keine Maustaste</guilabel
> kann dieser Aktion auch durch Drücken der <keycap
>Leertaste</keycap
> zugeordnet werden (sofern Modifizierungstasten dabei gedrückt werden). Bei <guilabel
>Keine Maustaste</guilabel
> übernehmen die Modifizierungstasten die Aufgabe der Maustaste: Die Aktion beginnt sobald eine Modifizierungstaste gedrückt wird und endet beim Lösen der Modifizierungstaste.</para
></tip>
			</sect2>
			<sect2>
				<title
><guilabel
>Mausrad</guilabel
>-Karteireiter</title>
				<para
>Dieser Karteireiter ist mit dem vorherigen vergleichbar. Wenn der Knopf auf der rechten Seite eine Eingabe erfordert muss hier das Mausrad betätigt werden. Auch hier können die Modifizierungstasten verwendet werden.</para>
				<tip
><para
>Sofern eine Maus mit Mausrad für zwei Richtungen verfügbar ist (meist beim Touchpad von Laptops), kann von dieser Möglichkeit Gebrauch gemacht werden: &palapeli; unterscheidet zwischen waagerechter und senkrechter Bewegung des Mausrades.</para
></tip>
			</sect2>
		</sect1>
	</chapter>

	<chapter id="credits">
		<title
>Danksagungen und Lizenz</title>
		<para
>&palapeli; soll den unaufgeregten Spaß und die Herausforderungen eines Bilderpuzzles auf die Arbeitsfläche von &kde; bringen.</para>
		<para
>Ursprünglich wurde die Idee von Bernhard Schiffner mit dem derzeitigen Hauptentwickler von &palapeli; Stefan Majewsky entwickelt.</para>
		<para
>Dokumentation © 2009, 2010 Stefan Majewsky.</para>
		<para
>Übersetzung: Johannes Obermayr <email
>johannesobermayr@gmx.de</email
></para
> 
&underFDL; &underGPL; </chapter>

	<appendix id="installation">
		<title
>Installieren</title>
		&install.intro.documentation;
		<sect1 id="Compilation">
			<title
>Kompilieren und Installieren</title>
&install.compile.documentation; </sect1>
	</appendix>
	&documentation.index;
</book>
