Présentation du projet

Le dépôt tamnd/riemann-handbook propose un ouvrage au format PDF et EPUB qui décrit, en texte naturel, la preuve de l’hypothèse de Riemann telle qu’elle est codée dans le projet tamnd/riemann-lean. Le texte ne constitue pas une vérification indépendante : aucune construction complète du projet Lean n’a été réalisée, et aucune comparaison entre les déclarations du livre et le code Lean n’a été effectuée. L’objectif principal est d’expliquer le code Lean, pas de certifier la validité mathématique de la preuve.

Les fichiers de l’ouvrage sont disponibles dans les releases du dépôt. Chaque déclaration du code Lean appartient à un sous‑arbre dominé par une déclaration unique, ce qui permet de structurer le livre en volumes et chapitres selon les branches de la preuve ou les dossiers Lean. Le système de « ledger » classe les sous‑arbres en fonction de leur taille : plus de 1 000 déclarations (591 entrées), plus de 300 (1 927 entrées) et plus de 100 (5 764 entrées).

Architecture du pipeline de génération

La construction du livre repose sur une chaîne d’outils précise. Il faut Python 3.11 ou supérieur, Pandoc 3.8+ et le moteur LaTeX Tectonic. Après installation du paquet Python via pip install ., plusieurs modules sont invoqués :

python -m rhb ledger --records /path/to/records --min 1000 --write
python -m rhb survey
python -m rhb check
python -m rhb build --volume 0,1,2 --formats pdf,epub

Le module rhb lit les métadonnées du ledger, génère des entrées Markdown, applique le filtre filters/rhb.lua avec Pandoc, puis compile le résultat avec le style LaTeX tex/handbook.sty. Le rendu final produit un PDF et un EPUB 3 contenant du MathML pour les formules.

Le texte du livre est sous licence Creative Commons BY 4.0, tandis que le code du générateur est distribué sous licence MIT, ce qui autorise une réutilisation large tant que les mentions de droits d’auteur sont conservées.

Analyse des limites et vérifications

Le principal point de vigilance réside dans l’absence de compilation complète du projet Lean. Sans exécution du graphe de dépendances, il n’est pas possible de garantir que chaque déclaration du livre correspond exactement à la définition Lean sous‑jacente. De plus, le ledger ne couvre que les sous‑arbres dépassant les seuils de taille spécifiés ; les petites déclarations restent non répertoriées, ce qui peut créer des lacunes dans la navigation du texte.

Sur le plan technique, la dépendance à Pandoc 3.8 et à Tectonic impose un environnement de compilation assez récent, limitant l’accessibilité pour les utilisateurs disposant de versions antérieures. Enfin, le processus de génération repose sur plusieurs scripts Python qui ne sont pas encore testés dans des environnements CI/CD, ce qui augmente le risque d’erreurs non détectées lors de la construction du livre.