Amélioration de la mise en page avec Markdown du fichier README.md

This commit is contained in:
2026-02-26 23:17:12 +01:00
parent ff87d27ef5
commit f03a10466b

123
README.md
View File

@@ -1,42 +1,107 @@
# wgamesolv
WARNING : le dictionnaire fr_FR.json n'est plus à jour. Il doit soit être mis à jour soit remplacé par des dictionnaires de mots en x lettres, comme le nouveau fr_A_10letters.json (mots de 10 lettres commençants par la letre A) qui lui est à jour (le 26 fév. 2026).
> **Words Games Solver** — Script d'aide à la résolution des jeux de mots style Wordle, SUTOM, mots-croisés, Scrabble...
> On a fait ça pour s'amuser, pas spécialement pour tricher aux jeux de mots.
Words Games Solver.
Script d'aide à la résolution des jeux de mots style Wordle, SUTOM, mots-croisés, Scrabble...
On a fait ça pour s'amuser, pas spécialement pour tricher aux jeux de mots.
Auteurs : AntoineVe, Brunus.
Courageux testeur des 1ères versions et précieux apporteur d'idées: DarKou.
Licence : MIT
**Auteurs :** AntoineVe, Brunus
**Courageux testeur des 1ères versions et précieux apporteur d'idées :** DarKou
**Licence :** MIT
Utilisation : wgamesolv.py -d dictionnaire.json -nb 7 (autres options)
---
-d, --dictionary : dictionnaire à utiliser
ex : -d fr_Fc.json
Trois dictionnaires ont été fusionnés pour n'en faire qu'un : Wordle, SUTOM et l'officiel du Scrabble
> [!WARNING]
> Le dictionnaire `fr_FR.json` n'est plus à jour. Il doit soit être mis à jour soit remplacé par des dictionnaires de mots en x lettres, comme le nouveau `fr_A_10letters.json` (mots de 10 lettres commençant par la lettre A) qui lui est à jour (le 26 fév. 2026).
-fl, --firstLetter : première lettre du mot
ex : -fl C
Cette option est intéressante que l'on connaisse ou non la première lettre, il faut en choisir une pour limiter la liste de mots possibles.
---
-nb, --nbLetters : nombre de lettres qui composent le mot
ex : -nb 7
## Utilisation
-ft, --firstTry : optimise le premier essai en sortant les mots de -nb lettres, commençant par -fl lettre, ne contenant aucune lettre en plusieurs occurence et contenant -ft voyelles.
ex : -ft 4
Cette option peut être utilisée pour le tout premier essai, pour optimiser les chances d'avoir des lettres validées.
Cette option est ensuite inutile ou contre-productive pour les essais suivants et ne peut pas être utilisée avec la pattern.
```
wgamesolv.py -d dictionnaire.json -nb 7 [autres options]
```
-nd, --noDoubleLetters : filtre les mots composé d'une seule occurence de chaque lettre.
## Options
-kl, --knownLetters : lettres déjà validées
ex : -kl AEP
### `-d`, `--dictionary` — dictionnaire à utiliser
-bl, --badLetters : lettres déjà invalidées
ex : -bl ZTOR
```
-d fr_FR.json
```
-p, --pattern : lettres validées et bien placées, lettres connues et mal placées, séparée par des '.' pour les lettres non validées
Les lettres en caps sont les lettres connues et bien placées, les lettres en minuscules sont les lettres connues mais mal placées
ex : -p L.uI... (le mots était LUCIOLE)
Trois dictionnaires ont été fusionnés pour n'en faire qu'un : Wordle, SUTOM et l'officiel du Scrabble.
Exemple complet : wgamesolv.py -d fr_FR.json -nb 7 -fl L -p L.uI... -kl U -bl AMNR
---
### `-nb`, `--nbLetters` — nombre de lettres du mot
```
-nb 7
```
---
### `-fl`, `--firstLetter` — première lettre du mot
```
-fl C
```
Cette option est intéressante que l'on connaisse ou non la première lettre : il faut en choisir une pour limiter la liste de mots possibles.
---
### `-ft`, `--firstTry` — optimisation du premier essai
```
-ft 4
```
Optimise le premier essai en sortant les mots de `-nb` lettres, commençant par `-fl`, ne contenant aucune lettre en plusieurs occurrences et contenant `-ft` voyelles.
> Cette option peut être utilisée pour le tout premier essai, pour optimiser les chances d'avoir des lettres validées. Elle est ensuite inutile ou contre-productive pour les essais suivants et **ne peut pas être utilisée avec la pattern**.
---
### `-nd`, `--noDoubleLetters` — sans lettres doublées
Filtre les mots composés d'une seule occurrence de chaque lettre.
---
### `-kl`, `--knownLetters` — lettres déjà validées
```
-kl AEP
```
---
### `-bl`, `--badLetters` — lettres déjà invalidées
```
-bl ZTOR
```
---
### `-p`, `--pattern` — lettres placées et mal placées
```
-p L.uI...
```
| Casse | Signification |
|-------|---------------|
| Majuscule | Lettre connue et **bien placée** |
| minuscule | Lettre connue mais **mal placée** |
| `.` | Position non validée |
*Exemple : `-p L.uI...` pour le mot LUCIOLE*
---
## Exemple complet
```
wgamesolv.py -d fr_FR.json -nb 7 -fl L -p L.uI... -kl U -bl AMNR
```