# Vérification — La version anglaise du guide

Fiche de traçabilité de la **version anglaise** du [guide de rechargement](https://www.tireur.org/rechargement/?lang=en) : dix-sept pages (`?lang=en`) générées depuis le traité LaTeX par `scripts/gen_rechargement_en.py`. Voir [[verification:rechargement:start|l'index du chantier]] et [[verification:start|la méthode]].

**Contrôle du 2026-09-25.**

## Source

Le guide a été vérifié dans son entier au 2026-08-19, dans trois supports : la page web française, la source LaTeX anglaise et le PDF. Le **2026-09-23**, un quatrième support est apparu : l'édition anglaise des pages web. Elle n'est pas traduite. Elle est **convertie** depuis le LaTeX, chapitre par chapitre, par un convertisseur de documents, puis ses formules sont rendues dans le navigateur par la bibliothèque mathématique du site.

Le texte en était donc déjà vérifié. Ce qui ne l'avait jamais été, c'est **la conversion** : un outil qui transforme un document n'a pas besoin de se tromper sur le fond pour faire dire autre chose à la page. Il suffit qu'il perde un signe, une référence ou une commande.

## Ce qui a été fait

* **Grandeurs chiffrées.** Toutes les valeurs à unité du LaTeX ont été extraites avec l'extracteur du détecteur de dérive, puis cherchées dans le HTML généré, fichier par fichier. Sur 339 faits, 29 manquaient au premier passage. Chacun a été rouvert à la main : les 29 étaient des artefacts de la mesure (valeur écrite dans une formule, espace fine U+2006, forme `0.2-grain`, unité `inches` que l'extracteur web ne lit pas). **Aucune valeur n'est perdue ni altérée.**
* **Texte.** Mots du LaTeX et mots du HTML comptés et comparés. Les seuls « perdus » sont des noms d'environnements (`tabular`, `enumerate`…) et les titres de chapitre, déplacés dans l'en-tête de page. Le journal détaillé du convertisseur (`--verbose`) a été relu pour chaque fichier.
* **Rendu.** Les dix-sept pages ont été ouvertes dans un vrai navigateur. On a relevé les erreurs de rendu des formules, les images et **tout résidu de balisage dans le texte affiché** : barre oblique inverse, accolade, clé de renvoi.
* **Renvois.** Chaque numéro a été confronté au sommaire du PDF publié, chaque ancre ouverte, et on a vérifié qu'un lien vers une section repliée l'ouvre bien.

## L'erreur principale : 32 renvois affichés comme des clés

Le lecteur anglophone lisait, dans la **section sécurité** :

> …an upper tolerance bound (see Appendix **[app:statistics]**, Section **[sec:lieberman]** for…

au lieu de //Appendix D, Section D.7//. Le même défaut revenait **32 fois** sur dix pages : chapitres, tableaux, sections et équations de l'annexe statistique.

**Le mécanisme.** Chaque chapitre est converti **seul**. Le convertisseur ne voit donc ni le numéro que LaTeX attribue à une étiquette (« D.7 » dépend de tout ce qui précède dans le livre), ni les étiquettes définies dans les autres chapitres. Faute de mieux, il imprime la clé. Le générateur retirait de plus **toutes** les étiquettes (`\label`), pour une raison juste mais locale : dans une formule, la bibliothèque mathématique les affichait en rouge. Même les renvois internes à une page restaient donc sans cible.

**La correction.** Les numéros sont lus dans les fichiers `.aux` de la dernière compilation, c'est-à-dire exactement ceux que le PDF imprime. Contrôle fait sur le sommaire : D.4 Student, D.5 χ², D.7 Lieberman–Resnikoff, D.8 t non centrée. Les étiquettes ne sont plus retirées que **dans les formules**. Ailleurs, elles deviennent des ancres, et chaque renvoi est un lien vers la bonne page et la bonne section.

## Les corrections secondaires

| Où | Ce qu'on lisait | Mécanisme | Correction |
| :--- | :--- | :--- | :--- |
| Ch. 8, seuils de stabilité des poudres | « below **0.15 m/s/C** », « above **0.40 m/s/C** » | commande `\textdegree` inconnue du convertisseur, **sautée sans avertissement** (niveau INFO) | `0.15 m/s/°C` |
| Ch. 3, capacité en eau d'un étui (deux formules) | « Full capacity (gr **H\textsubscript2O**) » | commande de texte dans une formule : la bibliothèque mathématique ne la connaît pas et **l'écrit en toutes lettres, sans l'erreur rouge** qui l'aurait signalée | `H₂O` |
| 26 tableaux | le même identifiant posé deux fois (HTML invalide) | l'étiquette d'un tableau produit à la fois un bloc et une balise vide | balise vide retirée |

## Le point commun : rien n'échouait

Les trois défauts ont la même forme : **chaque outil a fait un choix silencieux**. Le convertisseur saute une commande sans rien signaler, remplace un renvoi introuvable par sa clé, et la bibliothèque mathématique écrit en clair ce qu'elle ne comprend pas. Le contrôle nocturne (`--check`, étape 9bis) était au vert depuis le premier jour, parce qu'il ne mesurait que la **fraîcheur** des fragments, pas leur **justesse**.

Un contrôle d'erreurs de rendu n'aurait rien vu non plus : relancé sur les dix-sept pages, il ne trouve **aucune** erreur de formule. `H\textsubscript2O` n'en est pas une pour la bibliothèque. Seule la lecture du **texte affiché** l'a montré.

Le générateur refuse désormais une conversion qui :
- **saute une commande** autre que de la mise en page (`\centering`, `\bigskip`, `\noindent`, longueurs…) ;
- laisse un **renvoi non résolu** ;
- laisse une **commande dans le `\text{}` d'une formule**.

Le refus a été éprouvé sur l'ancienne sortie : il arrête les trois défauts d'origine. Les numéros viennent des `.aux`. S'ils manquent, la génération s'arrête : une nuit en échec vaut mieux qu'un guide publié avec des clés brutes.

## Ressorti intact

- **Toutes les valeurs chiffrées** : 339 faits, aucun perdu ni altéré ;
- **tout le texte**, y compris l'unique note de bas de page du traité (ch. 5) ;
- **les formules** : 409 rendues sur dix-sept pages, aucune en erreur ;
- **les deux photographies** (balance à fléau, amorces Berdan et Boxer), servies et affichées ;
- **les citations bibliographiques**, toutes résolues et reliées à leur entrée ;
- **les figures dessinées par LaTeX**, remplacées par un renvoi au PDF comme prévu, légende conservée.

## Ce qui n'a pas été vérifié

- **Les unités impériales.** Elles sont celles du texte d'origine, et la page le signale au lecteur. Aucune conversion n'a été ajoutée, donc aucune n'était à vérifier.

## Suite du 2026-09-25 : les deux points restés ouverts

**Les numéros de renvoi entre deux compilations.** La génération anglaise compare désormais chaque chapitre à son propre `.aux`, puisque chacun est inclus séparément. Un `.tex` plus récent que son `.aux` arrête la génération, et donc le contrôle de la nuit : ses numéros viendraient d'une compilation antérieure au texte. Le contrôle a été éprouvé en rajeunissant `chapter3.tex` : il s'arrête bien, puis se tait une fois la date rétablie.

**Les tableaux larges à 320 px**, mesurés dans Chromium sur les seize pages du guide qui en portent. Deux défauts se cumulaient :

| Défaut | Conséquence | Correction |
| :--- | :--- | :--- |
| les tableaux produits par pandoc n'étaient pas dans l'enveloppe à défilement horizontal de la version française | dans **quinze** pages anglaises, la colonne de droite était **coupée**, invisible et sans barre de défilement | le générateur enveloppe chaque tableau |
| KaTeX place une copie MathML de chaque formule en position absolue, qui échappe à ce défilement | trois pages (annexe D, chapitre 2, sécurité) défilaient **en entier** horizontalement, jusqu'à 474 px | l'enveloppe est positionnée (`position: relative`) ; la correction vaut aussi pour la version française |

Après correction, aucune des seize pages ne déborde, en anglais comme en français. La feuille de style du guide porte désormais un numéro de version, calculé d'après la date du fichier : un navigateur ne garde plus l'ancienne en cache.