Cinq premières leçons dans docs/lecons/ (1g)

Les ouvertures, construire ses cases, frapper ou non, la course et le
compte de points, sortir sans se faire frapper : seize exercices au
format du tutoriel, avec le compte de points en plus. Amendement de
l'ADR 0011 : pas de relecture préalable, garde-fous du moteur.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
2026-11-12 10:18:07 +01:00
co-authored by Claude Opus 5.5
parent cfb2e485c3
commit 635612a2a8
10 changed files with 481 additions and 36 deletions
+43
View File
@@ -0,0 +1,43 @@
// Lecture du texte des leçons (docs/lecons/lecon-<n>.md, format décrit dans
// docs/lecons/README.md), copié tel quel dans le site par make site
// (ADR 0008 : une seule source). Même format que le tutoriel, avec un titre
// en tête. Fonctions pures, testées sous Node.
//
// Copyright (C) 2026 les auteurs d'Ustagammon.
// Licence : GPLv3 ou ultérieure (voir LICENSE).
import type { LessonOutline } from "../domain/learning/lessons.js";
import { parseTutorial, type Tutorial } from "./tutorial-text.js";
/** Le nombre de leçons (fichiers lecon-1.md à lecon-<n>.md). */
export const LESSON_COUNT = 5;
/** Une leçon : son numéro, son titre, et ses écrans, comme le tutoriel. */
export interface Lesson extends Tutorial {
readonly number: number;
readonly title: string;
}
/** L'adresse, dans le site, du texte de la leçon number. */
export function lessonSource(number: number): string {
return `docs/lecons/lecon-${number}.md`;
}
/** Lit le texte d'une leçon. Erreur si le titre manque ou si les écrans
* sont mal formés (parseTutorial). */
export function parseLesson(number: number, text: string): Lesson {
const title = /^# (.+)$/m.exec(text)?.[1]?.trim();
if (title === undefined || title === "") {
throw new Error(`leçon ${number} : titre absent`);
}
return { ...parseTutorial(text), number, title };
}
/** Ce que la progression retient d'une leçon : les étapes de ses
* exercices. */
export function outlineOf(lesson: Lesson): LessonOutline {
return {
number: lesson.number,
exercises: lesson.steps.filter((s) => s.practice !== null).map((s) => s.number),
};
}
+15
View File
@@ -26,6 +26,9 @@ export interface TutorialScreen {
readonly move: string | null;
/** Explication : le sens du jeu, deux flèches circulaires. */
readonly path: boolean;
/** Les comptes de points de la position que cite le texte (vous,
* l'ordinateur), vérifiés par les tests ; null s'il n'en cite pas. */
readonly pips: readonly [number, number] | null;
/** « À vous » : les coups justes, en notation de gnubg. */
readonly expected: readonly string[];
/** « À vous » de videau : la bonne réponse au double. */
@@ -90,6 +93,17 @@ function rollOf(text: string | undefined, where: string): readonly [number, numb
return [Number(match[1]), Number(match[2])];
}
function pipsOf(text: string | undefined, where: string): readonly [number, number] | null {
if (text === undefined) {
return null;
}
const match = /^(\d+)\/(\d+)$/.exec(text);
if (match === null) {
throw new Error(`${where} : compte illisible « ${text} »`);
}
return [Number(match[1]), Number(match[2])];
}
function screenOf(raw: RawScreen, where: string): TutorialScreen {
const one = (key: string) => raw.keys.get(key)?.[0];
const position = one("position");
@@ -110,6 +124,7 @@ function screenOf(raw: RawScreen, where: string): TutorialScreen {
roll: rollOf(one("jet"), where),
move: one("coup") ?? null,
path: one("chemin") === "oui",
pips: pipsOf(one("compte"), where),
expected: raw.keys.get("attendu") ?? [],
answer: answer === undefined ? null : answer === "prendre" ? "take" : "pass",
right: parseInline(one("juste") ?? ""),