<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY ksudoku "Ksudoku">
<!ENTITY kappname "&ksudoku;"
> 
  <!ENTITY kappversion "0.5"
><!--Applicaion version. Use this variable everywhere it's needed.-->
  <!ENTITY package "kdegames"
>  <!-- do not change this! -->
  <!ENTITY % Dutch "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"
> <!-- do not change this! -->
]>
 
<book lang="&language;"
> <!-- do not change this! -->
<bookinfo>
	<title
>De handboek van &kappname;</title
> <!-- This is the title of this docbook. -->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
	<author
><firstname
>Mick</firstname
> <surname
>Kappenburg</surname
> <affiliation
><address
><email
>ksudoku@kappenburg.net</email
></address
></affiliation>
	</author>
	<author
><firstname
>Eugene</firstname
> <surname
>Trounev</surname
> <affiliation
><address
><email
>eugene.trounev@gmail.com</email
></address
></affiliation>
	</author>
&Freek.de.Kruijf; 
</authorgroup>

<copyright>
	<year
>2007</year>
	<holder
>Mick Kappenburg</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>
 
<date
>2007-11-14</date
><!-- Date of (re)writing, or update.-->
<releaseinfo
>&kappversion;</releaseinfo
><!-- Application version number. Use the variable definitions within header to change this value.-->
 
<!--Short description of this document. Do not change unless necessary!-->
<abstract>
	<para
>Deze documentatie beschrijft het spel van &kappname; versie &kappversion;</para>
</abstract>
 
<!--List of relevan keywords-->
<keywordset>
	<keyword
>KDE</keyword
> <!-- do not change this! -->
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>spel</keyword
> <!-- do not change this! -->
	<keyword
>ksudoku</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>logica</keyword>
	<keyword
>bord</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>één speler</keyword>
<!--All other relevant keywords-->
	<keyword
>puzzel</keyword>
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Inleiding</title
> <!-- do not change this! -->
	<note
><title
>Speltype:</title
><para
>Logisch, bord</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Aantal mogelijke spelers:</title
><para
>Eén</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
 	<para
>&kappname; is a logic-based symbol placement puzzle.</para>
<para
>The player has to fill a grid so that each column, row as well as each square block on the game field contains only one instance of each symbol.</para>
<para
>Depending on the preferences and the difficulty level some games start with a partially completed game field, while the others start with a blank one.</para>
<para
>There are hundreds of different variations of sudoku in existence. The most common variant of the game has a 9x9 squares grid and uses Arabic numerals for symbols. As an extra constraint, the grid is divided into 9 sectors of 3x3 squares. The problem is – each symbol can only be used once per row, column and sector. </para>
	<note>
		<title
>Notitie:</title>
		<para
>It takes a lot of time and concentration to complete each game. However, solving sudoku puzzles helps to increase the overall brain activity and therefore is highly recommended.</para>
	</note>
</chapter>
 
<chapter id="howto"
><title
>Hoe te spelen</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Doel:</title
><para
>Fill the grid so that each column, row as well as each square sector on the game field contains only one instance of each symbol.</para
></note
><!--Describe the objective of the game.-->
<!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
	<para
>At the game start you are prompted to choose which game type you are interested in.</para>
<note
><title
>Notitie:</title
><para
>The game experience may change slightly depending on the game type you choose.</para
></note>
<para
>Take a look at left hand side of the game field. There is a selection list which contains all the symbols available for you to use in the current game.</para>
<note
><title
>Notitie:</title
><para
>The set of symbols varies depending on the game type you choose.</para
></note>
<para
>First, note the boundaries of the game field. The thick black lines outline the sectors. Every one of this sectors has to be completed using the symbols available, in such a way that each symbol is used within the sector area once and only once.</para>
<para
>Now you can start entering the symbols into the vacant squares on the game field. You can do that by selecting the symbol you wish to enter from the selection list on the left, and then using your mouse to click on the vacant square on the game field.</para>
<para
>Notice that the squares change color while you hover your mouse over them. It is done to help you keep up with the rules of &kappname;. Use the vertical and horizontal lines to check if the symbol, you are about to enter into the vacant spot, is already in use anywhere in the vertical or horizontal line that square is a part of. The coloring also highlights the sector which, if you remember, must also contain only one instance of each symbol.</para>
<para
>Keep entering the symbols in accordance with the rules until the whole game field is filled up. At this point the application will check if all the entries are valid and either correct you, or except the solution. </para>
</chapter>
 
<chapter id="rules_and_tips"
><title
>Spelregels, strategieën en tips</title
> <!-- do not change this! -->
	<!--This section has to do with game rules. Please give a detailed description of those using lists or paragraphs.-->
	<sect1 id="rules">
		<title
>General Game Rules</title>
		<para
>The rules of &kappname; are quite simple.</para>
		<itemizedlist>
		<listitem
><para
>Depending on the size of the game board and the difficulty level chosen each individual &kappname; puzzle may take up to a few hours to solve.</para
></listitem>
		<listitem
><para
>Each square may hold one and only one symbol.</para
></listitem>
		<listitem
><para
>Each horizontal row (as defined by the game board) can contain each symbol exactly once.</para
></listitem>
		<listitem
><para
>Each vertical row (as defined by the game board) can contain each symbol exactly once.</para
></listitem>
		<listitem
><para
>Each subgrid or section (as defined by the game board) can contain each symbol exactly once</para
></listitem>
		</itemizedlist>
		<note
><title
>Notitie:</title
><para
>The set of symbols varies depending on the game type you choose.</para
></note>
		<itemizedlist>
			<listitem
><para
>Knowledge of mathematics, or language is not required to solve &kappname; puzzles.</para
></listitem>
			<listitem
><para
>Depending on the difficulty chosen the puzzles may appear partially solved. In such case the symbols already on the game board cannot be changed.</para
></listitem>
			<listitem
><para
>You can only modify the symbols you have previously entered.</para
></listitem>
			<listitem
><para
>&kappname; generated puzzles have one solution only.</para
></listitem>
		</itemizedlist>
	</sect1>
	<sect1 id="tips">
		<title
>Strategieën en tips</title>
		<itemizedlist>
			<listitem
><para
>Take your time and do not rush. &kappname; is not a 'quick' game to play.</para
></listitem>
		<listitem
><para
>Pay attention to the row, column, and section colorings. They are here to aid you in the game.</para
></listitem>
		<listitem
><para
>Make sure that so duplicate symbol exists already in the row/column/section you are entering it to.</para
></listitem>
		<listitem
><para
>If in doubt, try to foresee if a square you are entering a symbol into maybe needed by some other symbol, which otherwise cannot go anywhere else due to the row/column/section rule violation.</para
></listitem>
		<listitem
><para
>If you are having troubles, try to retrace your steps and see exactly where you have made an error.</para
></listitem>
		<listitem
><para
>Even though &kappname; provides a 'Hint' option for you, try not to use it often. Remember solving the puzzle all by yourself enhances your brain activity, while using the 'Hint' feature too often is cheating.</para
></listitem>
			<listitem
><para
>If you have much trouble solving a certain puzzle, and simply must use the 'Hint' feature, then maybe you should try to decrease the difficulty level, or try a simpler, more basic puzzle.</para
></listitem>
		<listitem
><para
>Some puzzle layouts feature very specific game board shapes. It is a good idea to have the coloring option enabled even if you consider yourself an experienced player.</para
></listitem>
		</itemizedlist>
	</sect1>
</chapter>
  
<chapter id="interface"
><title
>Overzicht van het interface</title
> <!-- do not change this! -->
<!-- This section has to do with menubar. Describe every single entry in order. Use <variablelist
> and <varlistentry
>. Split the chapter into sections using <sect1(2,3)
> for better viewing.-->
<sect1 id="game-menu">
	<title
>Het menu <guimenu
>Spel</guimenu
></title>
		<variablelist>
			<varlistentry id="game-menu-new">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Nieuw</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Start een nieuw spel.</action
></para
></listitem>
			</varlistentry>
			<varlistentry  id="game-menu-load">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Laden...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Laadt een opgeslagen spel.</action
></para
></listitem>
			</varlistentry>
			<varlistentry id="game-menu-save">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Opslaan</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Saves</action
> the current game as a default save file.</para
></listitem>
			</varlistentry>
			<varlistentry id="game-menu-save-as">
				<term
><menuchoice
><guimenu
>Spel</guimenu
><guimenuitem
>Opslaan als...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Saves</action
> the current game as a file of your choice.</para
></listitem>
			</varlistentry>
			<varlistentry>
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Afsluiten</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Beëindigt</action
> &kappname;.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="move-menu">
	<title
>Het menu <guimenu
>Zet</guimenu
></title>
		<variablelist>
			<varlistentry id="move-menu-undo">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
> </keycombo
> </shortcut
> <guimenu
>Zet</guimenu
> <guimenuitem
>Ongedaan maken</guimenuitem
> </menuchoice
></term>
				<listitem
><para
>Uw laatste zet wordt <action
>ongedaan gemaakt</action
>.</para
></listitem>
			</varlistentry>
			<varlistentry id="move-menu-redo">
				<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Zet</guimenu
> <guimenuitem
>Opnieuw</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Redo</action
> a move that was undone.</para
></listitem>
			</varlistentry>
			<varlistentry id="move-menu-hint">
				<term
><menuchoice
><shortcut
><keycap
>H</keycap
></shortcut
><guimenu
>Zet</guimenu
><guimenuitem
>Tip</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Geeft een hint</action
> door een paar overeenkomende en vrijliggende stenen te laten knipperen.</para
></listitem>
			</varlistentry>
			<varlistentry id="move-menu-demo">
				<term
><menuchoice
><guimenu
>Move</guimenu
> <guimenuitem
>Solve</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Instantly solve</action
> the puzzle.</para
></listitem>
			</varlistentry>
			<varlistentry id="move-menu-shuffle">
				<term
><menuchoice
><guimenu
>Move</guimenu
> <guimenuitem
>Check</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Check</action
> the entry for validity.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="settings-menu">
	<title
>Het menu <guimenu
>Instellingen</guimenu
></title>
		<variablelist>
			<varlistentry>
				<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalken</guimenuitem
> <guimenuitem
>Hoofdwerkbalk</guimenuitem
> </menuchoice
></term>
				<listitem
><para
>Shows or hides the Main Toolbar.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-hide-matching">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guisubmenu
>Toolbars</guisubmenu
> <guimenuitem
>Actions Toolbar</guimenuitem
> </menuchoice
></term>
				<listitem
><para
>Shows or hides the Actions Toolbar.</para
></listitem>
			</varlistentry>

			<varlistentry id="settings-menu-statusbar">
				<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Statusbalk tonen</guimenuitem
> </menuchoice
></term>
				<listitem
><para
>Toont of verbergt de statusbalk.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-shortcuts">
				<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Sneltoetsen instellen...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Displays a standard &kde; shortcut configuration dialog</action
> to change the keyboard shortcuts for &kappname;.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-toolbar">
				<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalken instellen...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
>Opent een standaard &kde;-dialoog waarin u de pictogrammen op de werkbalken kunt instellen.</para
></listitem>
			</varlistentry>
			<varlistentry id="settings-menu-settings">
				<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kappname;...</guimenuitem
> </menuchoice
></term>
				<listitem
><para
><action
>Opens a dialog to configure &kappname;.</action
> See <link linkend="configuration"
>Game Configuration</link
> section for details.</para
></listitem>
			</varlistentry>
		</variablelist>
</sect1>
<sect1 id="help"
><!--This is a standard Help menubar entry. Only change if needed.-->
<title
>Het <guimenu
>Help</guimenu
>-menu</title>
<para
>&kappname; heeft een standaard &kde;-<guimenu
>Help</guimenu
>menu zoals hieronder beschreven,  met één toevoeging:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Help</guimenu
> <guimenuitem
>Home Page</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Opens the &kappname; website on sourceforge.net in &konqueror;.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>In het <guimenu
>Help</guimenu
>-menu van &kde; komt standaard voor:</para>
&help.menu.documentation; </sect1>
</chapter>
  
<chapter id="faq"
><title
>Veel voorkomende vragen</title
> <!-- do not change this! -->
<!--This chapter is for frequently asked questions. Please use <qandaset
> <qandaentry
> only!-->
<qandaset>
<!--Following is a standard list of FAQ questions.-->
<qandaentry>
 <question
><para
>Ik wil het uiterlijk van dit spel wijzigen. Kan dat? </para
></question>
 <answer
><para
>Sudoku games are traditionally played using square grid. Themes would not make much sense here. However, you can select the set of symbols used in game. To do so use <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure &kappname;...</guimenuitem
></menuchoice
> on menubar.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Ik heb de symbolen in de configuratiedialoog gewijzigd en nu is mijn gehele speelbord is gevuld met vraagtekens. Wat is het probleem?</para
></question>
 <answer
><para
>Elke set bevat een beperkt aantal mogelijke symbolen. Als u de set hebt gekozen met minder symbolen dan uw huidige spel vereist, de toepassing zal reageren door vraagtekens te tonen. Wijzig de set om het probleem op te lossen.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Kan ik het toetsenbord gebruiken om dit spel te spelen? </para
></question>
 <answer
><para
>Ja. In &kappname; is het speelbord altijd ingeschakeld. Gaarne de cursortoetsen gebruiken om de selectie te verplaatsen, numerieke tekens in de symbolen in te voeren en de &Shift;-toets om markeringen toe te passen.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Waar zijn de topscores?</para
></question>
 <answer
><para
>&kappname; heeft deze functie niet.</para
></answer>
</qandaentry>
<!--Please add more Q&As if needed-->
 
</qandaset>
</chapter>
 
<chapter id="configuration"
><title
>Spelconfiguratie</title
> <!-- do not change this! -->
<!--This section describes configuration GUI. If your game is configured using menubar exclusively, please remove this section.-->

<sect1 id="general-options"
><title
><guilabel
>Spel</guilabel
>-opties</title>
	<variablelist>
		<varlistentry>
			<term
><guilabel
>Accentueringen tonen</guilabel
></term>
			<listitem
><para
>De accentueringsoptie van &kappname; omschakelen.</para>
					<note
><title
>Notitie:</title
><para
>Het is aanbevolen om deze optie in te schakelen zelfs voor de meest ervaren spelers, omdat het helpt om de vakken van het speelbord te zien.</para
></note
></listitem>
		</varlistentry>
		<varlistentry>
			<term
><guilabel
>Fouten tonen</guilabel
></term>
			<listitem
><para
>Ongeldige invoer accentueren omschakelen.</para
></listitem>
		</varlistentry>
	</variablelist>
</sect1>

<sect1 id="layout-options"
><title
>Opties voor <guilabel
>Symboolthema's</guilabel
></title>
	<variablelist>
		<varlistentry>
			<term
><guilabel
>Eenvoudige formulieren</guilabel
></term>
			<listitem
><para
>Aan- of uitschakelen van het gebruiken van eenvoudige vormen voor pictogrammen in het spel.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
><guilabel
>Dobbelstenen</guilabel
></term>
			<listitem
><para
>Aan- of uitschakelen van het gebruiken van dobbelstenen voor pictogrammen in het spel.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
><guilabel
>Cijfers</guilabel
></term>
			<listitem
><para
>Aan- of uitschakelen van het gebruiken van Arabische cijfers voor pictogrammen in het spel.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
><guilabel
>Kleine letters</guilabel
></term>
			<listitem
><para
>Aan- of uitschakelen van het gebruiken van Latijnse letters voor pictogrammen in het spel.</para
></listitem>
		</varlistentry>
		<varlistentry>
			<term
><guilabel
>Hoofdletters</guilabel
></term>
			<listitem
><para
>Aan- of uitschakelen van het gebruiken van Latijnse hoofdletters voor pictogrammen in het spel.</para
></listitem>
		</varlistentry>
	</variablelist>
	<note
><title
>Notitie:</title
><para
>Elke set bevat een beperkt aantal mogelijke symbolen. Als u de set hebt gekozen met minder symbolen dan uw huidige spel vereist, de toepassing zal reageren door vraagtekens te tonen. Wijzig de set om het probleem op te lossen.</para
></note>
</sect1>
</chapter>
 
<chapter id="credits"
><title
>Dankbetuiging en licentie</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
 
<para
>&kappname; </para>

<!--List all the copyright holders here-->
<para
>&kappname; copyright 2005-2007 Francesco Rossi <email
>redsh@email.it</email
> </para>
<para
>Copyright 2006-2007 Mick Kappenburg <email
>ksudoku@kappenburg.net</email
>, Johannes Bergmeier <email
>johannes.bergmeier@gmx.net</email
> </para>
<para
>Documentatie copyright 2005 Francesco Rossi <email
>redsh@email.it</email
> </para>
<para
>Documentatie copyright 2007 Mick Kappenburg <email
>ksudoku@kappenburg.net</email
>, Eugene Trounev <email
>eugene.trounev@gmail.com</email
> </para>

&meld.fouten;&vertaling.freek; 
&underFDL; &underGPL; </chapter>
  
<appendix id="installation">
<title
>Installatie</title>
 
&install.intro.documentation;
 
 
<sect1 id="Compilation">
<title
>Compilatie en installatie</title>
&install.compile.documentation; </sect1>
</appendix>
 
&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
