2
<!--IMPORTANT: please note that'do not change this!' notice does not apply to translators -->
3
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
4
<!ENTITY klickety "<application>Klickety</application>">
5
<!ENTITY kappname "&klickety;">
6
<!ENTITY package "kdegames"><!-- do not change this! -->
7
<!ENTITY kappversion "2.0"><!--Applicaion version. Use this variable everywhere it's needed.-->
8
<!ENTITY % addindex "IGNORE"><!-- do not change this! -->
9
<!ENTITY % English "INCLUDE"><!-- change language only here -->
12
<book lang="&language;"><!-- do not change this! -->
14
<title>The &klickety; Handbook</title><!-- This is the title of the docbook. Leave as is unless change is necessary.-->
15
<!-- List of immediate authors begins here. -->
19
<firstname>Thomas</firstname>
20
<surname>Davey</surname>
22
<email>thomas.davey@gmail.com</email>
26
<firstname>Hui</firstname>
29
<email>shuizhuyuanluo@126.com</email>
31
<!-- TRANS:ROLES_OF_TRANSLATORS -->
36
<holder>Thomas Davey</holder>
40
<holder>Ni Hui</holder>
43
<legalnotice>&FDLNotice;</legalnotice>
45
<date>2010-09-25</date><!-- Date of (re)writing, or update.-->
46
<releaseinfo>&kappversion;</releaseinfo><!-- Application version number. Use the variable definitions within header to change this value.-->
49
<para>&klickety; is a strategy game for &kde;, an adaption of the <application>Clickomania</application> game.</para>
52
<!--List of relevan keywords-->
54
<keyword>KDE</keyword><!-- do not change this! -->
55
<keyword>kdegames</keyword><!-- do not change this! -->
56
<keyword>game</keyword><!-- do not change this! -->
57
<keyword>Klickety</keyword><!--Application name goes here-->
58
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
59
<keyword>board</keyword>
60
<keyword>logic</keyword>
61
<keyword>strategy</keyword>
62
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
63
<keyword>one player</keyword>
64
<!--All other relevant keywords-->
68
<!--Content begins here: -->
69
<chapter id="introduction">
70
<title>Introduction</title><!-- do not change this! -->
71
<note><title>Gametype:</title><para>Board</para></note>
72
<note><title>Number of possible players:</title><para>One</para></note>
74
&klickety; is an adaptation of the Clickomania game. The rules are similar to
75
those of the Same game: your goal is to clear the board by clicking on groups
76
to destroy them. The overall aim is to get the lowest score
77
possible. It will provide entertainment for all abilities, but a
78
challenge in logical thought if you want to get a really low score.
82
<chapter id="how-to-play">
83
<title>How to Play</title><!-- do not change this! -->
84
<note><title>Objective:</title><para>Clear the game board of all the colored blocks in the least possible time.</para></note>
85
<!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
87
When you start the program you will get a screen that looks
88
something like the screenshot in the previous section. The idea of the
89
game is to remove blocks, which you do by clicking on them.
92
However, you can only remove a block if it is adjacent to one or
93
more other blocks of the same color on one or more of its
94
sides. Diagonal connections do not count. You get a random board every
95
time you start a new game.
98
If you click on a block which is connected as described, it will
99
disappear. Any adjacent blocks of the same color will also disappear,
100
along with all of the same color adjacent to <emphasis>them</emphasis>, and so
101
on. Any blocks above them drop down to fill the gaps left by the
102
disappeared pieces. If you clear an entire column, all the columns to
103
the right move across to fill the gap.
106
The game ends when there are no blocks adjacent to other blocks
110
<sect1 id="game-screen">
111
<title>The Game Screen</title>
114
<screeninfo>A screenshot of &klickety;</screeninfo>
116
<imageobject><imagedata fileref="gamescreen.png" format="PNG"/></imageobject>
117
<textobject><phrase>Screenshot</phrase></textobject>
120
A quick explanation of the parts of the game screen.
124
<term>Game Screen</term>
126
The Game screen is in the center of the screen and is the largest section of the window.
130
<term>Statusbar</term>
132
The Status bar is located at the bottom of the screen.
133
It displays how many pieces are left currently and
134
the game timer, which keeps track of the elapsed time from
135
the start of the game until the game is finished.
143
<chapter id="ksame_mode">
144
<title>The KSame Mode</title><!-- do not change this! -->
146
&klickety; provides a &ksame; scoring mode.
148
<para>The score is calculated as follows:</para>
149
<para>Subtract 2 from the number of marbles erased, and square the result.
151
<para>As an example, if you erase 7 balls, then you get 25 points
152
(7 minus 2 = 5. 5 squared is 25 points).If you erase 8
153
balls, then you get 36 points (8 minus 2 = 6. 6 squared is 36 points.
156
Get as many of the same pieces as you can, and then erase them
157
in one click. That way you will get a higher score. The game is
158
over when there are no pieces that can be erased.
161
The score will then be decreased according to the number of remaining
162
pieces. If you erase all pieces 1,000 bonus points will be added to the final
166
<screeninfo>A screenshot of &klickety; in KSame mode</screeninfo>
168
<imageobject><imagedata fileref="ksamemode.png" format="PNG"/></imageobject>
169
<textobject><phrase>Screenshot</phrase></textobject>
174
<chapter id="interface">
175
<title>Interface Overview</title><!-- do not change this! -->
176
<!-- 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.-->
177
<sect1 id="default-keybindings">
178
<title id="keybindings-title">Default Keybindings</title>
180
<screeninfo>Keybindings Configure Dialog</screeninfo>
182
<imageobject><imagedata fileref="shortcuts.png" format="PNG"/></imageobject>
183
<textobject><phrase>Keybindings Configure Dialog</phrase></textobject>
187
<para>Default shortcuts are:</para>
190
<title>Shortcuts</title>
195
<entry><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></entry>
198
<entry>Restart Game</entry>
199
<entry><keycap>F5</keycap></entry>
203
<entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry>
207
<entry><keycap>P</keycap></entry>
211
<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry>
215
<entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry>
219
<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry>
223
<entry><keycap>F1</keycap></entry>
226
<entry>What's this?</entry>
227
<entry><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></entry>
234
<sect1 id="game-menu">
235
<title>The Game Menu</title>
240
<shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
241
<guimenu>Game</guimenu>
242
<guimenuitem>Load...</guimenuitem>
244
<listitem><para>Loads a previously saved game.</para></listitem>
249
<shortcut><keycap>F5</keycap></shortcut>
250
<guimenu>Game</guimenu>
251
<guimenuitem>Restart Game</guimenuitem>
253
<listitem><para>This will restart the current game.</para></listitem>
258
<guimenu>Game</guimenu>
259
<guimenuitem>New Numbered Game...</guimenuitem>
261
<listitem><para><action>Starts a specifically numbered game.</action>
263
<screeninfo>Start a Numbered Game Dialog</screeninfo>
265
<imageobject><imagedata fileref="numbered.png" format="PNG"/></imageobject>
266
<textobject><phrase>Start a Numbered Game Dialog</phrase></textobject>
274
<shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
275
<guimenu>Game</guimenu>
276
<guimenuitem>Save</guimenuitem>
278
<listitem><para>Saves the current state of the game to the disk.</para></listitem>
283
<shortcut><keycap>P</keycap></shortcut>
284
<guimenu>Game</guimenu>
285
<guimenuitem>Pause</guimenuitem>
287
<listitem><para><action>Pauses or resumes the game. While the game is paused, all tiles are hidden.</action></para></listitem>
292
<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
293
<guimenu>Game</guimenu>
294
<guimenuitem>Show High Scores</guimenuitem>
296
<listitem><para><action>Shows the high score list.</action>
298
<screeninfo>Show High scores</screeninfo>
300
<imageobject><imagedata fileref="highscore.png" format="PNG"/></imageobject>
301
<textobject><phrase>Show High scores</phrase></textobject>
306
When your game scores exceed the top ten scores listed, you are prompted to enter your name.
312
<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
313
<guimenu>Game</guimenu>
314
<guimenuitem>Quit</guimenuitem>
316
<listitem><para>Selecting this item will end your current game, and exit &klickety;.</para></listitem>
322
<sect1 id="move-menu">
323
<title>The Move Menu</title>
328
<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
329
<guimenu>Move</guimenu>
330
<guimenuitem>Undo</guimenuitem>
332
<listitem><para><action>Undo the last move you made.</action></para></listitem>
337
<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
338
<guimenu>Move</guimenu>
339
<guimenuitem>Redo</guimenuitem>
341
<listitem><para><action>If you have previously undone a move, you can redo it here.</action></para></listitem>
346
<guimenu>Move</guimenu>
347
<guimenuitem>Undo All</guimenuitem>
349
<listitem><para><action>Undo</action> all moves you made.</para></listitem>
354
<guimenu>Move</guimenu>
355
<guimenuitem>Redo All</guimenuitem>
357
<listitem><para><action>Redo</action> all undone moves.</para></listitem>
363
<sect1 id="settings-menu">
364
<title>The Settings Menu</title>
369
<guimenu>Settings</guimenu>
370
<guimenuitem>Show Toolbar</guimenuitem>
372
<listitem><para>Shows or hides the Toolbar.</para></listitem>
377
<guimenu>Settings</guimenu>
378
<guimenuitem>Show Statusbar</guimenuitem>
380
<listitem><para>Shows or hides the Statusbar.</para></listitem>
385
<guimenu>Settings</guimenu>
386
<guisubmenu>Difficulty</guisubmenu>
389
<para>Lets you set the difficulty level from a sub-menu.</para>
390
<para>There are four levels of difficulty:
392
<listitem><para><guimenuitem>Very easy</guimenuitem>: 16 rows, 10 columns, 3 types of pieces.</para></listitem>
393
<listitem><para><guimenuitem>Easy</guimenuitem>: 16 rows, 10 columns, 4 types of pieces.</para></listitem>
394
<listitem><para><guimenuitem>Medium</guimenuitem>: 16 rows, 10 columns, 5 types of pieces.</para></listitem>
395
<listitem><para><guimenuitem>Hard</guimenuitem>: 16 rows, 10 columns, 6 types of pieces.</para></listitem>
398
<para>There is also a <guimenuitem>Custom</guimenuitem> level settings.</para>
399
<para>If you select <guimenuitem>Custom</guimenuitem>, then the
400
settings you have configured in the <guimenuitem>Configure &klickety;</guimenuitem> dialog will be used.</para>
407
<guimenu>Settings</guimenu>
408
<guimenuitem>Configure Shortcuts...</guimenuitem>
410
<listitem><para><action>Displays a standard &kde; shortcut configuration dialog</action> to change the <link linkend="default-keybindings">keyboard shortcuts</link> for &klickety;.</para></listitem>
415
<guimenu>Settings</guimenu>
416
<guimenuitem>Configure Toolbars...</guimenuitem>
418
<listitem><para>Displays a standard &kde; dialog where you can configure the toolbar icons.</para></listitem>
423
<guimenu>Settings</guimenu>
424
<guimenuitem>Configure Notifications...</guimenuitem>
426
<listitem><para>This item displays a standard &kde; notifications configuration
427
dialog, where you can change the notifications (sounds, visible messages,
428
&etc;) used by &klickety;.</para></listitem>
433
<guimenu>Settings</guimenu>
434
<guimenuitem>Configure &klickety;...</guimenuitem>
436
<listitem><para><action>Opens a dialog to configure &klickety;.</action> For details, see <link linkend="configuration">here</link>.</para></listitem>
443
<sect1 id="help"><!--This is a standard Help menubar entry. Only change if needed.-->
444
<title>The Help Menu</title>
445
&help.menu.documentation;
451
<title>Frequently asked questions</title> <!-- do not change this! -->
452
<!--This chapter is for frequently asked questions. Please use <qandaset> <qandaentry> only!-->
455
<!--Following is a standard list of FAQ questions.-->
457
<question><para>I want to change the way this game looks. Can I? </para></question>
458
<answer><para>Yes. To change the way &klickety; looks use the <link linkend="settings-menu">menubar</link> to open the <link linkend="configuration">configuration utility</link>.</para></answer>
461
<question><para>Can I use the keyboard to play the game?</para></question>
462
<answer><para>No. This game does not feature a keyboard play mode yet.</para></answer>
465
<question><para>How to start the game in KSame mode?</para></question>
466
<answer><para>You can launch &klickety; with command <userinput>klickety --KSameMode</userinput> or &ksame; menu entry in K menu.</para></answer>
472
<chapter id="configuration">
473
<title>Game Configuration</title><!-- do not change this! -->
474
<!--This section describes configuration &GUI;. If your game is configured using menubar exclusively, please remove this section.-->
476
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &klickety;...</guimenuitem></menuchoice> opens
477
the <guilabel>Configure - &klickety;</guilabel> dialog.</para>
479
<sect1 id="general-options">
480
<title>General options</title>
483
<term><guilabel>Show bound lines</guilabel></term>
485
This option will show bound lines between pieces with different color.
489
<term><guilabel>Enable animation</guilabel></term>
491
This option will enable the falling and merging animation when pieces are removed.
495
<term><guilabel>Enable highlight</guilabel></term>
497
This option will enable highlighting on pieces hovered if they can be removed.
502
<screeninfo>General options</screeninfo>
504
<imageobject><imagedata fileref="config-general.png" format="PNG"/></imageobject>
505
<textobject><phrase>General options</phrase></textobject>
510
<sect1 id="theme-options">
511
<title>Theme options</title>
514
<term><guilabel>Theme</guilabel> selector</term>
515
<listitem><para>Use the <guilabel>Theme</guilabel> selector to set a theme for the game.</para></listitem>
519
<screeninfo>Theme options</screeninfo>
521
<imageobject><imagedata fileref="config-theme.png" format="PNG"/></imageobject>
522
<textobject><phrase>Theme options</phrase></textobject>
527
<sect1 id="background-options">
528
<title>Background options</title>
530
You can choose a background graphic for the game. There are three kinds of background type you can use.
533
<term><guilabel>Theme</guilabel></term>
534
<listitem><para>Use the background shipped with the current theme.</para></listitem>
537
<term><guilabel>Color</guilabel></term>
538
<listitem><para>Use a custom solid color for the background.</para></listitem>
541
<term><guilabel>Image</guilabel></term>
542
<listitem><para>Use an image for the background graphic.</para></listitem>
547
<screeninfo>Background options</screeninfo>
549
<imageobject><imagedata fileref="config-background.png" format="PNG"/></imageobject>
550
<textobject><phrase>Background options</phrase></textobject>
555
<sect1 id="customgame-options">
556
<title>Custom Game options</title>
558
You can set the <guilabel>Height</guilabel> and <guilabel>Width</guilabel> of the board
559
and the <guilabel>Color count</guilabel> used in your custom level.
562
<screeninfo>Custom game options</screeninfo>
564
<imageobject><imagedata fileref="config-customgame.png" format="PNG"/></imageobject>
565
<textobject><phrase>Custom game options</phrase></textobject>
572
<chapter id="credits">
573
<title>Credits and License</title>
574
<para>&klickety;</para>
575
<para>Program Copyright © 1995, Eirik Eng</para>
576
<para>Program Copyright © 1996–2004, &Nicolas.Hadacek; &Nicolas.Hadacek.mail;</para>
577
<para>Program Copyright © 2010, Ni Hui <email>shuizhuyuanluo@126.com</email></para>
578
<para>Documentation Copyright © 2005, Thomas Davey</para>
579
<para>Documentation Copyright © 2010, Ni Hui <email>shuizhuyuanluo@126.com</email></para>
580
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
585
<appendix id="installation">
586
<title>Installation</title>
587
&install.intro.documentation;
588
<sect1 id="Compilation">
589
<title>Compilation and Installation</title>
590
&install.compile.documentation;
594
&documentation.index;
added
removed
klickety/doc/index.docbook
