6. Le dossier de travail du convertisseur

Vous pouvez télécharger le dossier de travail |ICI|.

Le dossier de travail est le suivant :

Nous allons ignorer pour l’instant les fichiers suivants [.gitignore, deploy.txt, google*.html, README.md, robots.txt, deploy.txt]. Ce sont des fichiers qui nous serviront au déploiement sur GitHub du site HTML généré localement ;
[prompt User.txt] est le prompt avec lequel j’ai commencé les itérations avec Gemini ;
Le fichier [word-odt-vers-html-janv-2026.odt] est le document ODT de cet article. Il est converti en HTML par le script [convert_odt_v356.py] ;
Le fichier [word-odt-vers-html-janv-2026.docx] est le document DOCX de ce même article. Il est converti en HTML par le script [convert_docx_v18.py] ;
Les scripts [convert*.py] et [build.py] sont les deux scripts Python générés par les IA ;
- [convert*] convertit un document ODT ou DOCX en site [MkDocs]. Un site MkDocs est un site statique dont les pages sont écrites selon la syntaxe [MarkDown]. [MkDocs] fournit un serveur capable d’afficher les sites MkDocs ;
- [build] convertit le site MkDocs en site statique HTML standard. A la fin de cette conversion, il ouvre un navigateur pour afficher la racine du site ;

A aucun moment nous ne regarderons le code Python généré. On considérera les deux scripts comme deux boîtes noires. A aucun moment je n’ai modifié du code à la main. J’ai toujours demandé à Gemini / ChatGPT de corriger lui-même son script. C’est pourquoi il n’est pas nécessaire de connaître Python pour utiliser le convertisseur.

[config.py] est un fichier de configuration pour les scripts [convert*]. Au départ [convert*] n’avait pas de fichier de configuration. Puis en changeant de documents à convertir, je me suis aperçu peu à peu qu’il y avait des éléments que je demandais à l’IA de générer (par exemple le nom du site qui change pour chaque document) qui seraient mieux placés dans un fichier de configuration que l’utilisateur pourrait modifier lui-même. Je l’ai construit lui aussi par itérations avec l’IA ;