Vérification — La version anglaise du guide

Fiche de traçabilité de la version anglaise du guide de rechargement : dix-sept pages (?lang=en) générées depuis le traité LaTeX par scripts/gen_rechargement_en.py. Voir l'index du chantier et 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.

verification/rechargement/version_anglaise.txt · Dernière modification : de 127.0.0.1