Tutoriel : texte source, lecture, vérification par le moteur, adresses
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
co-authored by
Claude Opus 5.5
Claude Opus 5.5
parent
f1c589eff1
commit
3f5b00133d
@@ -0,0 +1,65 @@
|
||||
# Tutoriel des règles
|
||||
|
||||
Le texte du tutoriel de l'application, en une seule source (ADR 0008) :
|
||||
`regles.md`. `make site` copie ce dossier dans le site publié
|
||||
(`docs/tutoriel/`) ; l'application le lit à l'exécution
|
||||
(`app/src/ui/tutorial-text.ts`), et `make test` vérifie chaque position et
|
||||
chaque coup avec le vrai moteur (`app/tests/tutorial.test.ts`).
|
||||
|
||||
Texte sous licence **CC BY-SA 4.0**. Première version, rédigée par Claude
|
||||
Code d'après la charte (`docs/identite/charte/accueil-tutoriel-aide.md`),
|
||||
**à valider par Pierre**.
|
||||
|
||||
## Format
|
||||
|
||||
Tout ce qui précède la première étape (ce titre, cette notice) n'est pas
|
||||
affiché.
|
||||
|
||||
```markdown
|
||||
## 3. Les dés et les doubles
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
- jet: 5-2
|
||||
- coup: 13/11 13/8
|
||||
|
||||
Un paragraphe, avec un [mot du glossaire](pion.md) et du **gras**.
|
||||
|
||||
### À vous
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
- jet: 3-1
|
||||
- attendu: 8/5 6/5
|
||||
- juste: La phrase affichée quand le coup est juste.
|
||||
- refus: La phrase affichée quand le coup est refusé.
|
||||
|
||||
La consigne de l'écran.
|
||||
|
||||
## Fin
|
||||
|
||||
- action: Jouer ma première partie
|
||||
|
||||
Le texte de la fin du tutoriel.
|
||||
```
|
||||
|
||||
- `## <n>. <titre>` commence l'étape *n* (huit au plus, dans l'ordre) ;
|
||||
`### À vous` commence son écran « à vous », facultatif ; `## Fin`, l'écran
|
||||
qui suit la dernière étape.
|
||||
- Les lignes `- clé: valeur` en tête d'écran le décrivent :
|
||||
- `position` : l'identifiant de position de GNU Backgammon (ADR 0013), vu
|
||||
du camp au trait ;
|
||||
- `trait` : `ordinateur` si c'est l'ordinateur qui a la main dans cette
|
||||
position (par défaut, vous) ;
|
||||
- `jet` et `coup` : sur un écran d'explication, le coup illustré, qui se
|
||||
joue tout seul (notation de gnubg) ;
|
||||
- `chemin: oui` : le sens du jeu, dessiné en pointillés sur le plateau ;
|
||||
- `attendu` (une ligne par coup accepté) : sur un écran « à vous », les
|
||||
coups justes, en notation de gnubg, tels que le moteur les écrit ;
|
||||
- `réponse` : `prendre` ou `passer`, pour un écran « à vous » où
|
||||
l'ordinateur double ; le moteur doit donner la même réponse ;
|
||||
- `juste` et `refus` : les phrases qui suivent un geste juste, ou refusé ;
|
||||
- `action` : le libellé du bouton de la fin.
|
||||
- Les autres lignes forment les paragraphes. `[mot](fiche.md)` renvoie à une
|
||||
fiche du glossaire, à la première apparition du mot.
|
||||
|
||||
Aucune règle n'est écrite dans le code : le moteur lit les positions,
|
||||
illustre les coups, juge les coups joués et les décisions de videau.
|
||||
@@ -0,0 +1,130 @@
|
||||
# Les règles du backgammon
|
||||
|
||||
Tutoriel d'Ustagammon, en huit étapes. Texte sous licence CC BY-SA 4.0,
|
||||
première version à valider par Pierre. Format : voir README.md.
|
||||
|
||||
## 1. Le but du jeu
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
|
||||
Vous avez quinze [pions](pion.md) ivoire, l'ordinateur quinze pions noyer. Chacun fait faire le tour du [plateau](plateau.md) à ses pions, puis les [sort](sortie.md).
|
||||
|
||||
Le premier qui a sorti tous les siens gagne la [partie](partie.md).
|
||||
|
||||
## 2. Dans quel sens avancer
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
- chemin: oui
|
||||
|
||||
Vos pions ivoire font le tour du plateau dans le sens des pointillés : ils partent d'en haut à droite, passent à gauche, puis reviennent en bas jusqu'aux **six dernières flèches**, en bas à droite. C'est là que vous les rassemblerez avant de les sortir.
|
||||
|
||||
Les pions noyer de l'ordinateur font le même chemin, en sens inverse.
|
||||
|
||||
## 3. Les dés et les doubles
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
- jet: 5-2
|
||||
- coup: 13/11 13/8
|
||||
|
||||
Chaque dé déplace un pion d'autant de flèches. Avec 5 et 2, vous jouez un pion de 5 et un pion de 2, ou le même pion de 5 puis de 2.
|
||||
|
||||
Un double se joue quatre fois : avec 4-4, vous avancez quatre fois de 4.
|
||||
|
||||
### À vous
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
- jet: 3-1
|
||||
- attendu: 8/5 6/5
|
||||
- juste: Deux pions sur la flèche 5 : elle est à vous, l'ordinateur ne peut plus s'y poser.
|
||||
- refus: Ce coup est permis, mais il ne réunit pas deux pions sur la flèche 5. Jouez un pion de la flèche 8 avec le 3, et un de la flèche 6 avec le 1.
|
||||
|
||||
Vous avez 3 et 1. Réunissez deux pions sur la flèche 5 : touchez un pion, puis sa case d'arrivée.
|
||||
|
||||
## 4. Frapper un pion seul
|
||||
|
||||
- position: 4HPwESDgc/ABMA
|
||||
- jet: 4-2
|
||||
- coup: 13/11 13/9*
|
||||
|
||||
Un pion seul sur une flèche s'appelle un [blot](blot.md). Si vous vous posez dessus, vous le frappez : il part sur la [barre](barre.md) et devra refaire tout le chemin.
|
||||
|
||||
Une flèche où l'adversaire a deux pions ou plus est fermée : vous ne pouvez pas vous y poser.
|
||||
|
||||
### À vous
|
||||
|
||||
- position: 4HPwIDDgc/ABMA
|
||||
- jet: 6-1
|
||||
- attendu: 13/7* 8/7
|
||||
- attendu: 13/7*/6
|
||||
- attendu: 13/7* 6/5
|
||||
- attendu: 24/23 13/7*
|
||||
- attendu: 24/18 8/7*
|
||||
- attendu: 8/7* 8/2
|
||||
- juste: Touché : le pion noyer part sur la barre, il devra refaire tout le chemin.
|
||||
- refus: Ce coup ne frappe pas le pion seul de la flèche 7. Un pion qui s'y pose le frappe : celui de la flèche 13 avec le 6, ou celui de la flèche 8 avec le 1.
|
||||
|
||||
Vous avez 6 et 1. Le pion noyer de la flèche 7 est seul : frappez-le.
|
||||
|
||||
## 5. Rentrer depuis la barre
|
||||
|
||||
- position: 4HPwATDgc/ABUA
|
||||
- jet: 4-3
|
||||
- coup: bar/22 13/9
|
||||
|
||||
Votre pion frappé attend sur la barre, au milieu. Avant de jouer quoi que ce soit d'autre, il doit rentrer dans le [camp](camp.md) adverse, en haut à droite.
|
||||
|
||||
Chaque dé indique une flèche d'entrée : avec 3 et 4, la 22 ou la 21. Si les deux flèches sont fermées, votre tour passe.
|
||||
|
||||
## 6. Sortir ses pions
|
||||
|
||||
- position: bHcAANh2dwAAAA
|
||||
- jet: 5-2
|
||||
- coup: 5/off 2/off
|
||||
|
||||
Quand vos quinze pions sont dans les six dernières flèches, vous pouvez commencer à les sortir : un 6 sort un pion de la flèche 6, un 1 un pion de la flèche 1.
|
||||
|
||||
Touchez le pion, puis la sortie à droite.
|
||||
|
||||
### À vous
|
||||
|
||||
- position: bHcAANh2dwAAAA
|
||||
- jet: 6-3
|
||||
- attendu: 6/off 3/off
|
||||
- juste: Deux pions sortis. Plus que treize !
|
||||
- refus: Ce coup est permis, mais il ne sort qu'un pion. Le 6 sort un pion de la flèche 6, le 3 un pion de la flèche 3.
|
||||
|
||||
Vous avez 6 et 3 : sortez deux pions.
|
||||
|
||||
## 7. Gammon et backgammon
|
||||
|
||||
- position: 8J4HBwAFAAAAAA
|
||||
- jet: 2-1
|
||||
- coup: 2/off 1/off
|
||||
|
||||
Une partie gagnée vaut 1 point. Si l'adversaire n'a sorti aucun pion quand vous finissez, c'est un [gammon](gammon.md) : 2 points. S'il lui reste en plus un pion sur la barre ou dans votre camp, c'est un [backgammon](backgammon.md) : 3 points.
|
||||
|
||||
Dans une partie libre contre l'ordinateur, le gammon et le backgammon ne comptent double ou triple qu'une fois le videau doublé : c'est la [règle de Jacoby](regle-de-jacoby.md).
|
||||
|
||||
## 8. Le videau
|
||||
|
||||
- position: 4HPwATDgc/ABMA
|
||||
|
||||
Le cube aux faces 2, 4, 8, 16, 32 et 64 s'appelle le [videau](videau.md) : il sert à miser. Avant de lancer vos dés, vous pouvez proposer de [doubler](doubler.md) la valeur de la partie.
|
||||
|
||||
L'ordinateur [prend](prendre.md), et la partie continue en valant le double, ou il [passe](passer.md), et vous gagnez tout de suite. Celui qui a pris garde le cube : lui seul pourra redoubler.
|
||||
|
||||
### À vous
|
||||
|
||||
- position: 7O7YAADs7jYAAA
|
||||
- trait: ordinateur
|
||||
- réponse: prendre
|
||||
- juste: Le maître prend aussi. L'ordinateur mène la course, mais vous gagnez encore assez souvent pour que prendre vous coûte moins cher, en moyenne, que passer.
|
||||
- refus: Le maître prendrait. Passer vous coûte un point tout de suite ; en prenant, vous gardez vos chances de gagner, et le videau est chez vous.
|
||||
|
||||
C'est à l'ordinateur de jouer, et il mène la course. Il vous propose de doubler : prenez-vous, ou passez-vous ?
|
||||
|
||||
## Fin
|
||||
|
||||
- action: Jouer ma première partie
|
||||
|
||||
Vous connaissez les règles. Le reste s'apprend en jouant, et le maître vous accompagne.
|
||||
Reference in New Issue
Block a user