summaryrefslogtreecommitdiffstats
path: root/doc/katomic/index.docbook
blob: c1ffb2c718f80a620d19f6461e8347284baa038b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&katomic;">
 <!ENTITY package "kdegames">
 <!ENTITY % English "INCLUDE">
 <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title>The Atomic Entertainment Handbook</title>

<authorgroup>
<author>
<firstname>Dirk</firstname>
<surname>Doerflinger</surname>
</author>

<othercredit role="developer">
<firstname>Stephan</firstname><surname>Kulow</surname><contrib>Developer</contrib><affiliation><address>&Stephan.Kulow.mail;</address>
</affiliation></othercredit>
<othercredit role="developer">
<firstname>Cristian</firstname><surname>Tibirna</surname><contrib>Developer</contrib><affiliation><address>&Cristian.Tibirna.mail;</address>
</affiliation></othercredit>
<othercredit role="reviewer">
<firstname>Mike</firstname><surname>McBride</surname>
<contrib>Reviewer</contrib>
<affiliation><address>&Mike.McBride.mail;</address></affiliation>
</othercredit>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2005-12-14</date>
<releaseinfo>2.0</releaseinfo>

<abstract>
<para>This Handbook describes &katomic; Version 2.0</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdegames</keyword>
<keyword>KAtomic</keyword>
<keyword>game</keyword>
<keyword>atomic entertainment</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>
<para>
<application>Atomic Entertainment</application> is a small game which resembles
<application>Sokoban</application>. The object of the game is to build chemical
molecules on a <application>Sokoban</application> like board.</para>
</chapter>


<chapter id="playing-katomic">
<title>Playing <application>Atomic Entertainment</application></title>

<sect1 id="rules">
<title>Rules</title>

<para>The aim of <application>Atomic Entertainment</application> is to build
chemical molecules using basic atoms you are given.  The molecule being built is
shown in a frame in the main window.</para>

<para>Clicking on an atom will cause arrows to appear beside it.  These arrows
show the direction the atom can be moved. After an arrow is clicked, the atom
will move in this direction until it reaches the next border or another atom. If
two atoms touch each other with the corresponding connectors, they form a
molecule. The atoms can only be moved one at a time. </para>

<para>The level is solved when the new molecule has the same structure as shown
in the preview window.</para>

<para>In the higher levels, some tactical skill will be necessary for solving
the puzzle.</para>

<para>The best score in this game is actually the lower score, because the
goal is to solve a level with as few moves as
possible. <guilabel>Highscore:</guilabel> in the main-window shows
the lowest number of moves used for this level. <guilabel>Your score
so far:</guilabel> shows the current number of moves.</para>

<para>The scrollbar on the top right of the main window changes the game
level.</para>

</sect1>

</chapter>

<chapter id="configuration">
<title>Menu Reference</title>

<sect1 id="game-menu">
<title>The <guimenu>Game</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycap>F5</keycap></shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Restart Game</guimenuitem></menuchoice></term>
<listitem><para>This will restart the current level.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Show Highscores</guimenuitem></menuchoice></term>
<listitem><para>This will show the best scores for the current level.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Quit</guimenuitem></menuchoice></term>
<listitem><para>Selecting this item will end your current game, and exit the
&katomic;.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="move-menu">
<title>The <guimenu>Move</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap>
</keycombo>
</shortcut>
<guimenu>Move</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice>
</term>
<listitem>
<para><action>Undo the last move you made.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Move</guimenu>
<guimenuitem>Redo</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>If you have previously undone a move, you can redo it
here.</action></para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="settings-menu">
<title>The <guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Shortcuts...</guimenuitem></menuchoice></term>
<listitem><para>This item lets you change the key settings of
<application>Atomic Entertainment</application>. See the section <link
linkend="keybindings" endterm="keybindings-title"></link> for a list of the
defaults.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &katomic;...</guimenuitem></menuchoice></term>
<listitem><para>In the dialog box that appears, the animation-speed of the
atomic movement can be set.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="help">
<title>The <guimenu>Help</guimenu> Menu</title>

&help.menu.documentation;

</sect1>

<sect1 id="keybindings">
<title id="keybindings-title">Shortcuts</title>

<para>Default shortcuts are:</para>

<table>
<title>Shortcuts</title>
<tgroup cols="2">
<tbody>
<row>
<entry>Restart Game</entry>
<entry>
<keycap>F5</keycap>
</entry>
</row>
<row>
<entry>Quit</entry>
<entry>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</entry>
</row>
<row>
<entry>Show Highscores</entry>
<entry>
<keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
</entry>
</row>
<row>
<entry>Undo</entry>
<entry>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
</entry>
</row>
<row>
<entry>Redo</entry>
<entry>
<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
</entry>
</row>
<row>
<entry>Atom Down</entry>
<entry>
<keycap>Down Arrow</keycap>
</entry>
</row>
<row>
<entry>Atom Left</entry>
<entry>
<keycap>Left Arrow</keycap>
</entry>
</row>
<row>
<entry>Atom Right</entry>
<entry>
<keycap>Right Arrow</keycap>
</entry>
</row>
<row>
<entry>Atom Up</entry>
<entry>
<keycap>Up Arrow</keycap>
</entry>
</row>
<row>
<entry>Next Atom</entry>
<entry><keycap>Tab</keycap></entry>
</row>
<row>
<entry>Previous Atom</entry>
<entry><keycombo action="simul">&Shift;&Tab;</keycombo></entry>
</row>
<row>
<entry>Help</entry>
<entry><keycap>F1</keycap></entry>
</row>
<row>
<entry>What's this?</entry>
<entry>
<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>
</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>
</chapter>


<chapter id="credits">
<title>Credits and License</title>

<para>
<application>Atomic Entertainment</application> Copyright 1999 &Stephan.Kulow;
&Stephan.Kulow.mail; and Cristian Tibirna
&Cristian.Tibirna.mail;.
</para>
<para>
Atomic Copyright Andreas Wuest <email>Andreas Wuest@gmx.de</email>.
</para>
<para>
Documentation Copyright 2000 &Dirk.Doerflinger;
<email>ddoerflinger@gmx.net</email>
</para>
<para>
Proofreading by Michael McBride
&Mike.McBride.mail;
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>
<sect1 id="getting-katomic">
<title>How to obtain <application>Atomic Entertainment</application></title>

<para>
<application>Atomic Entertainment</application> (&katomic;) is written for the &kde; project
<ulink url="http://www.kde.org">http://www.kde.org</ulink> by &Stephan.Kulow;
&Stephan.Kulow.mail; and Cristian Tiberna
&Cristian.Tibirna.mail;.
It is based on Atomic 1.0.67 by Andreas Wuest
<email>AndreasWuest@gmx.de</email>.
</para>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title>Requirements</title>
<para>
In order to successfully compile <application>Atomic Entertainment</application>, you need &kde; 3.0 </para>
<para>
All required libraries as well as <application>Atomic Entertainment</application> itself can be found on
&kde-ftp;.</para>
</sect1>


<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>
</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->