pdulvp.fr

Commentaires, README et aide en prose simple, sans les jeux privés has been fixed.

See more details at : https://github.com/pdulvp/pdcartes-barquette/issues/3

.desktop réécrits en français simple : le propos et les raisons techniques
sont conservés, le registre imagé est abandonné

  • plus aucune mention des jeux privés : le format est décrit comme lu par

« les programmes de jeu », et l'exemple d'export ne nomme plus de binaire

  • commentaires de lib/ et de src/ uniformisés en français ;

lib/Palette.*, lib/DialogChrome.* et src/Version.h, jusque-là en
anglais, sont traduits

  • vocabulaire fixé et appliqué partout : une case de la grille, la *liste

des images ouvertes, *sélectionner, aligné ; les libellés d'interface qui
contredisaient l'aide sont alignés sur elle

grille vide, placée en tête du README

Commentaires et README en prose simple, sans les noms des jeux privés

<sub>2026-10-25-2306-commentaires-et-readme-en-prose-simple.md — 2026-10-25 23:22</sub>

Deux demandes :

  1. Réécrire les commentaires et le README dans une langue simple et

correcte. L'existant est écrit dans un registre littéraire et imagé
(« la cartothèque », « sous la main », « d'aplomb », « ce qui est enfermé
dans une archive n'en sort pas »), et une partie des fichiers est en
anglais, lui aussi imagé (« the cloth », « a spreadsheet », « braid »).

  1. Retirer les références aux jeux privés card-sol / belottesol

(le rami et la belote), partout : README, aide de la fenêtre, description
du paquet, fichier .desktop.

Décisions

  • Tout en français. Le projet est français : README, interface, et la

majeure partie des commentaires. Les fichiers encore en anglais
(lib/Palette.*, lib/DialogChrome.*, src/Version.h) passent en
français pour que la lecture ne change pas de langue d'un fichier à
l'autre.

  • Le propos est conservé, la tournure non. Chaque commentaire garde ce

qu'il explique — en particulier le pourquoi d'un choix technique, qui ne
se relit pas dans le code — mais le dit en phrases simples, sans métaphore
filée ni effet de style.

  • Le vocabulaire est fixé et employé partout de la même façon :

| registre imagé | terme retenu |
|---|---|
| la cartothèque | la bibliothèque cartotheque |
| une place (du jeu) | une case de la grille |
| sous la main / la corbeille | la liste des images ouvertes |
| une planche | une planche (conservé : c'est le terme juste) |
| la table, le tapis, le drap | la fenêtre, le fond, la couleur du thème |
| désigner | sélectionner |
| d'aplomb | aligné |

même contenu ; le laisser dans l'ancien registre le mettrait en
contradiction avec le README.

  • La copie d'écran montre la fenêtre vide. Au lancement, aucun jeu

ouvert : la grille des cinquante-trois cases et la liste d'images vide.
Demandé ainsi pour ne pas y faire figurer les cartes d'un jeu.

  • Les jeux ne sont plus nommés. Le README parle des « programmes qui

lisent ce format ». L'exemple d'export (ramisol --exporter-cartes) est
reformulé sans nom de programme.

Étapes

  1. [x] README.md — réécriture complète, sans les noms des jeux.
  2. [x] src/HelpDialog.cpp — le texte de l'aide, au même niveau de langue.
  3. [x] CMakeLists.txt (description du paquet) et

data/pdcartes-barquette.desktop (Comment) — sans les noms des jeux.

  1. [x] lib/ — CardSet.*, CardDeck.*, DllResources.*, Palette.*,

DialogChrome.*.

  1. [x] src/ — Version.h, main.cpp, AtelierWindow.*, FaceGrid.*,

SourceTray.*, SplitDialog.*, ImageJoin.*, HelpDialog.h.

  1. [x] Bâtir, et vérifier qu'il ne reste aucune occurrence des noms retirés.
  2. [x] Une copie d'écran de la fenêtre au lancement — grille vide, aucune

carte d'exemple — rangée dans docs/, et placée en tête du README.

Vérifié

belotesol, belottesol, card-sol, « rami » ni « belote ».

  • Plus aucun commentaire en anglais dans lib/ ni dans src/.
  • Copie d'écran prise sur le binaire reconstruit, fenêtre au lancement, grille

vide : docs/fenetre-au-lancement.png (1300 × 917). On y lit les libellés
revus, « Aucune image ouverte. » et « Case choisie : l'as de pique. ».

Au-delà du demandé

Quelques textes d'interface employaient le même registre imagé que les
commentaires et contredisaient l'aide réécrite ; ils ont été alignés sur
elle :

  • « Rien sous la main. » → « Aucune image ouverte. » ;
  • « Place choisie : … » → « Case choisie : … » ;
  • « Sortir les images d'une DLL pour Windows » → « Extraire les images d'une

DLL Windows » ;

  • « Débiter l'image choisie » → « Découper l'image choisie » ;
  • « Le collage ferait une image de %1 × %2 pixels, qui ne sert à rien. » →

« … ce qui est trop grand. ».

<sub>Filed by prel from the completed plans at commit time.</sub>