This file is indexed.

/usr/share/doc/kde/HTML/fr/kblackbox/index.docbook is in kde-l10n-fr 4:4.14.0-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
<?xml version="1.0" ?>
<!--IMPORTANT: please note that'do not change this!' notice does not apply to translators -->
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kblackbox;">
  <!ENTITY kappversion "0.4.0"
><!--Applicaion version. Use this variable everywhere it's needed.-->
  <!ENTITY package "kdegames"
>  <!-- do not change this! -->
  <!ENTITY % French "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE"
> <!-- do not change this! -->
]>
 
<book lang="&language;"
> <!-- do not change this! -->
<bookinfo>
	<title
>Manuel de &kblackbox;</title
> <!-- This is the title of the docbook. Leave as is unless change is necessary.-->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
<author
>&Nicolas.Roffet; &Nicolas.Roffet.mail; </author>

<author
>&Robert.Cimrman; &Robert.Cimrman.mail; </author>

<author
>&Philip.Rodrigues; &Philip.Rodrigues.mail; </author>

<othercredit role="reviewer"
>&Lauri.Watts; &Lauri.Watts.mail; </othercredit>

&traducteurEricBischoff; &traducteurLudovicGrossard; 

</authorgroup>

<copyright>
<year
>2007</year>
<holder
>&Nicolas.Roffet;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice
> 
<date
>16/08/2007</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
>Cette documentation décrit le jeu &kblackbox; version &kappversion;</para>
</abstract>
 
<!--List of relevan keywords-->
<keywordset>
	<keyword
>KDE</keyword
> <!-- do not change this! -->
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>jeu</keyword
> <!-- do not change this! -->
	<keyword
>KBlackBox</keyword>
	<keyword
>puzzle</keyword>
	<keyword
>plateau</keyword>
	<keyword
>billes</keyword>
	<keyword
>rayons</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>un joueur</keyword>
<!--All other relevant keywords-->
	<keyword
>billes cachées</keyword>
	<keyword
>trouver</keyword>
	<keyword
>chercher</keyword>
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Introduction</title
> <!-- do not change this! -->
	<note
><title
>Type de jeu : </title
><para
>Puzzle, plateau</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Nombre possible de joueurs : </title
><para
>Un</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
 
<!--Short game description starts here. 3-4 sentences (paragraphs)-->
	<para
>&kblackbox; est un superbe jeu de logique, inspiré du jeu Blackbox <application
>d'Emacs</application
>. La majeure partie de cette documentation est sur l'aide originale de la version <application
>emacs</application
>.</para>

<para
>&kblackbox; est un jeu consistant à localiser dans un quadrillage des objets cachés. L'ordinateur a caché plusieurs billes sur le plateau de jeu. En lançant des rayons sur celui ci et en regardant à quel endroit ils en ressortent, il est possible d'en déduire la position des billes cachées.</para>
<para
>Le score sera le plus élevé si vous utilisez le moins de rayons possibles et si vous trouvez les billes le plus vite possible.</para>
</chapter>
 
<chapter id="howto"
><title
>Comment jouer</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Objectif : </title
><para
>Utiliser les rayons laser pour déduire l'emplacement des billes sur le plateau de jeu.</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
>Utilisez les rayons laser et placez les billes et les repères sur le plateau de jeu pour en déduire la position des billes cachées.</para>
<para
>La partie démarre dès que vous utilisez un premier rayon laser. Avant cela, le temps n'est pas compté et aucun point de score n'est attribué. </para>
<para
>Le curseur peut être déplacé autour du plateau au moyen des touches standards de déplacement du curseur ou de la souris. Le déclenchement des lasers ou les repères s'effectue au moyen du &BGS;, ou en appuyant sur les touches <keycap
>Retour chariot</keycap
> ou &Enter;.</para>

<para
>Vous pouvez aussi déplacer les billes et les repères avec la souris.</para>

<para
>Vous pouvez également marquer les emplacements où aucune bille ne peut se trouver. Appuyez simplement sur le &BDS;. Ceci vous aidera souvent à trouver un endroit où une bille peut se trouver. Pour effacer toutes les repères, appuyez sur la même touche ou sur le bouton de souris.</para>

<para
>Si vous pensez que le placement des billes que vous avez effectué est correct, cliquez sur le bouton <guibutton
>Terminé ! </guibutton
>. Une boîte de dialogue vous indiquera si le placement des billes est correct ou non, et vous donnera votre score. </para>
<para
>Si vous placez des billes de manière incorrecte, la bonne solution sera affichée. </para>

<para
>Le score augmente avec le temps (un point par seconde) et avec l'utilisation des lasers : trois points si le rayon laser touche une bille ou une entrée valable à cet endroit, et neuf points si une entrée existe à un autre endroit. Si vous faites une erreur, le score s'affiche à la fin de la partie à 999, lequel est le score maximal. </para>
</chapter>
 
<chapter id="rules_and_tips"
><title
>Règles du jeu, stratégies et astuces</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="game-rules"
><title
>Règles du jeu</title>

<para
>Vous devez localiser les billes cachées sur le plateau de jeu. Vos moyens sont limités. Vous ne pouvez que déclencher les lasers situés autour du plateau. Il y a trois possibilités lorsque vous envoyez un rayon sur le plateau : </para>

<anchor id="detour"/>
<variablelist>

<varlistentry>
<term
>Déviation</term
> 
<listitem
><para
>Le rayon est dévié et ressort quelque part ailleurs. Sur le plateau de jeu, les déviations sont repérées par des paires de nombres : un à l'endroit où le rayon a été envoyé, et l'autre à l'endroit où il est ressorti.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Réflection</term>
<listitem
><para
>Le rayon est réfléchi et ressort à l'endroit même où il a été émis. Sur le plateau de jeu, les réflexions sont repérées par une lettre spéciale.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Collision</term>
<listitem
><para
>Le rayon frappe une bille de plein fouet et est absorbé. Il ne ressort pas du plateau. Sur le plateau de jeu, les collisions sont repérées par un caractère spécial.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Les règles qui régissent le cheminement des rayons sont simples et s'expliquent plus aisément en montrant quelques exemples.</para>

<para
>Lorsqu'un rayon arrive au voisinage d'une bille, il est dévié de quatre-vingt-dix degrés. Les rayons peuvent être déviés plusieurs fois. Sur le diagramme ci-dessous, les tirets représentent des positions vides et la lettre <guilabel
>O</guilabel
> représente une bille. Les points d'entrée et de sortie de chaque rayon sont marqués par des nombres comme décrit au paragraphe <link linkend="detour"
>Déviation</link
> ci-dessus. Remarquez que les points d'entrée et de sortie sont toujours interchangeables. Le signe <guilabel
>*</guilabel
> indique le chemin suivi par le rayon.</para>

<para
>Remarquez les positions de la bille et les déviations de quatre-vingt-dix degrés qu'elle cause.</para>

<screen
>1
  - * - - - - - -         - - - - - - - -         - - - - - - - -       
  - * - - - - - -         - - - - - - - -         - - - - - - - -       
1 * * - - - - - -         - - - - - - - -         - O - - - - O -       
  - - O - - - - -         - - O - - - - -         - - * * * * - -
  - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
  - - - - - - - -         - - - * - - - -         - - - O - * - -      
  - - - - - - - -         - - - * - - - -         - - - - * * - -       
  - - - - - - - -         - - - * - - - -         - - - - * - O -       
                                2                         3
</screen>

<para
>Comme mentionné précédemment, une réflexion se produit lorsqu'un rayon émerge à l'endroit même d'où il est parti. Ceci peut se produire pour différentes raisons : </para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - O - - -         - - O - O - - -          - - - - - - - -
R * * * * - - - -         - - - * - - - -          O - - - - - - -
  - - - - O - - -         - - - * - - - -        R - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -       R * * * * - - - -          - - - - - - - -
  - - - - - - - -         - - - - O - - -          - - - - - - - -

</screen>

<para
>Dans le premier exemple, le rayon est dévié vers le bas par la bille supérieure, puis immédiatement vers la gauche par celle du dessous, et, finalement, il revient jusqu'à son point de départ. Le deuxième exemple est similaire. Le troisième exemple est un peu curieux, mais s'explique si on prend en considération que le rayon ne peut tout simplement pas se placer sur le plateau. On peut aussi considérer que le rayon a été dévié vers le bas et est immédiatement ressorti du plateau.</para>

<para
>Une collision se produit lorsqu'un rayon frappe une bille de plein fouet :</para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - O - - -
  - - - - - - - -         - - - - O - - -        H * * * * - - - -
  - - - - - - - -       H * * * * O - - -          - - - * - - - -
  - - - - - - - -         - - - - O - - -          - - - O - - - -
H * * * O - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -

</screen>

<para
>Prenez soin de comparer le deuxième exemple de collision avec le premier exemple de réflexion.</para>

</sect1>
</chapter>
  
<chapter id="interface"
><title
>Vue d'ensemble de l'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-board-descritpion">
<title
>Description du plateau de jeu</title>

<para
>On trouve les types de cases suivants sur le plateau de jeu : </para>

<variablelist>
<varlistentry>
<term
><interface
>La grosse boîte noire sur le milieu</interface
></term>
<listitem
><para
>Vous y marquez les positions où vous pensez que les billes se trouvent.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Les lasers autour du plateau</interface
></term>
<listitem
><para
>Les lasers sont tirés sur les billes quand ils entrent en contact. Ils disparaissent ensuite et son remplacés par une information à propos des interactions du laser avec les billes sur le plateau de jeu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Billes</interface
></term>
<listitem
><para
>Vous pensez sans doute <quote
>Il fallait bien en mettre ! </quote
>. Elles indiquent les positions où vous suspectez qu'une bille se trouve dans le plateau.</para>
<para
>À la fin de la partie, les bonnes et mauvaises positions des billes sont aussi affichées avec « billes ».</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Repères pour « emplacement libre »</interface
></term>
<listitem
><para
>Vous pouvez les utiliser pour marquer les positions où vous êtes sur qu'il n'y a aucune bille.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="game-menu">
<title
>Le menu <guimenu
>Jeu</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Jeu</guimenu
> <guimenuitem
>Nouveau</guimenuitem
></menuchoice
></term>
<listitem
><para
>Démarre une nouvelle partie (et abandonne la précédente, s'il y en a une).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>P</keycap
></shortcut
> <guimenu
>Jeu</guimenu
> <guimenuitem
>Pause</guimenuitem
></menuchoice
></term>
<listitem
><para
>Mettre en pause ou continuer la partie courante</para
><para
>Remarquez que les résultats d'interaction sont cachés pendant une partie en pause.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Jeu</guimenu
> <guimenuitem
>Afficher les meilleurs scores</guimenuitem
></menuchoice
></term>
<listitem
><para
>Afficher les meilleurs scores.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Démarrer le tutoriel</guimenuitem
></menuchoice
></term>
<listitem
><para
>Démarrer le tutoriel du jeu. Une manière simple d'apprendre les règles du jeu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Nouveau</guimenuitem
></menuchoice
></term>
<listitem
><para
>Dans ce mode, la solution est affichée au démarrage de la partie. C'est utile pour comprendre les principes du jeu.</para
></listitem>
</varlistentry>

<varlistentry>
	<term>
		<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Jeu</guimenu
> <guimenuitem
>Quitter</guimenuitem
> </menuchoice>
	</term>
	<listitem>
		<para
>Cette action ferme la fenêtre et quitte &kblackbox;.</para>
	</listitem>
</varlistentry>
</variablelist>
</sect1>


<sect1 id="move-menu">
<title
>Le menu <guimenu
>Déplacer</guimenu
></title>

<variablelist>
<varlistentry>
	<term>
		<menuchoice
><guimenu
>Déplacer</guimenu
> <guimenuitem
>Résoudre</guimenuitem
> </menuchoice>
	</term>
	<listitem>
		<para
>Affiche la solution du jeu : la bonne position de toutes les billes.</para>
	</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacer</guimenu
> <guimenuitem
>Terminé !</guimenuitem
></menuchoice
></term>
<listitem
><para
>Quand vous avez placé toutes les billes, choisissez « Terminé ! » pour terminer la partie, calculer le score final et afficher les positions réelles des billes.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>


<sect1 id="settings-menu">
<title
>Le menu <guimenu
>Configuration</guimenu
></title>
<para
>Remarque : nous décrivons ici seulement les éléments du menu qui sont spécifiques au jeu et ignorons les éléments du menu &kde; standard.</para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guisubmenu
>Difficulté</guisubmenu
> </menuchoice>
</term>
<listitem>
<para
>Sélectionner la difficulté du jeu. Les parties en mode « difficile » ont plus de billes et un plateau de jeu plus grand que les autres modes de jeu. Vous pouvez aussi jouer avec un niveau de difficulté personnalisé que vous pouvez configurer dans le menu <guimenu
>Configuration</guimenu
> de &kblackbox;.</para>
<para
>Remarque : les parties avec quatre billes ou moins sont toujours sûr d'être résolues. Ce n'est pas le cas avec les parties de cinq billes ou plus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kblackbox;...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Dans cette boîte de dialogue, vous pouvez personnaliser le nombre de billes, les colonnes et les lignes du plateau de jeu d'un niveau de difficulté personnalisé.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="help"
><!--This is a standard Help menubar entry. Only change if needed.-->
<title
>Le menu <guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect1>
</chapter>

<chapter id="faq"
><title
>Foire aux questions</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
>Puis-je utiliser le clavier pour jouer à ce jeu ? </para
></question>
 <answer
><para
>Oui. Vous pouvez utiliser les touches directionnelles pour contrôler le curseur. &Enter; pour placer et supprimer les billes, et la <keycap
>barre d'espace</keycap
> pour placer des repères vides.</para
></answer>
</qandaentry>
<qandaentry>
 <question
><para
>Je veux quitter le jeu maintenant, mais ma partie n'est pas terminée. Puis je l'enregistrer ?</para
></question>
  <answer
><para
>&kblackbox; n'implante pas cette fonctionnalité pour le moment.</para
></answer>
</qandaentry>

</qandaset>
</chapter>

<chapter id="credits"
><title
>Remerciements et licence</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
 
<para
>&kblackbox; </para>
<!--List all the copyright holders here-->
<para
>Copyright du programme 1999-2000 &Robert.Cimrman; &Robert.Cimrman.mail; et 2007 &Nicolas.Roffet; &Nicolas.Roffet.mail; </para>
<para
>Copyright de la documentation par &Robert.Cimrman;. Mise à jour et converti vers Docbook pour &kde; 2.0 by &Lauri.Watts; &Lauri.Watts.mail;. Relu par &Philip.Rodrigues; &Philip.Rodrigues.mail; </para>

<para
>Traduction française par &EricBischoff; et &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>
  
<appendix id="installation">
<title
>Installation</title>
 
&install.intro.documentation;
 
 
<sect1 id="Compilation">
<title
>Compilation et installation</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:
-->