8. Utilisation du convertisseur Gemini 3

On rappelle que le dossier de travail peut être trouvé |ICI|.

Lançons PyCharm :

En [2], ouvrez un nouveau projet ;

En [1], sélectionner le dossier où vous avez sauvegardé le dossier de travail ;
En [2], validez ce choix ;

En [1], votre projet Python ;
En [2], validez pour ne pas être embêté par le système de sécurité de Windows ;
En [3], choisissez un interpréteur Python ;

En [1], choisissez l’interpréteur Python que vous avez installé au paragraphe 5 ;

Le convertisseur Gemini utilise des dépendances Python que vous devez installer. On va demander lesquelles à Gemini :

La réponse de Gemini est la suivante :

On va installer ces dépendances :

En [1], ouvrez un terminal ;

En [2], tapez la commande donnée par Gemini ;

La réponse est la suivante :

PS C:\Data\st-2025\GitHub Pages\word-odt-vers-html\v2> pip install odfpy unidecode mkdocs mkdocs-material
Defaulting to user installation because normal site-packages is not writeable
Requirement already satisfied: odfpy in c:\users\serge\appdata\roaming\python\python313\site-packages (1.4.1)
Requirement already satisfied: unidecode in c:\users\serge\appdata\roaming\python\python313\site-packages (1.4.0)
Requirement already satisfied: mkdocs in c:\users\serge\appdata\roaming\python\python313\site-packages (1.6.1)
Requirement already satisfied: mkdocs-material in c:\users\serge\appdata\roaming\python\python313\site-packages (9.7.0)
Requirement already satisfied: defusedxml in c:\users\serge\appdata\roaming\python\python313\site-packages (from odfpy) (0.7.1)
Requirement already satisfied: click>=7.0 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (8.3.1)
Requirement already satisfied: colorama>=0.4 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (0.4.6)
Requirement already satisfied: ghp-import>=1.0 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (2.1.0)
Requirement already satisfied: jinja2>=2.11.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (3.1.6)
Requirement already satisfied: markdown>=3.3.6 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (3.10)
Requirement already satisfied: markupsafe>=2.0.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (3.0.2)
Requirement already satisfied: mergedeep>=1.3.4 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (1.3.4)
Requirement already satisfied: mkdocs-get-deps>=0.2.0 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (0.2.0)
Requirement already satisfied: packaging>=20.5 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (25.0)
Requirement already satisfied: pathspec>=0.11.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (0.12.1)
Requirement already satisfied: pyyaml-env-tag>=0.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (1.1)
Requirement already satisfied: pyyaml>=5.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (6.0.2)
Requirement already satisfied: watchdog>=2.0 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs) (6.0.0)
Requirement already satisfied: babel>=2.10 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (2.17.0)
Requirement already satisfied: backrefs>=5.7.post1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (6.1)
Requirement already satisfied: mkdocs-material-extensions>=1.3 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (1.3.1)
Requirement already satisfied: paginate>=0.5 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (0.5.7)
Requirement already satisfied: pygments>=2.16 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (2.19.2)
Requirement already satisfied: pymdown-extensions>=10.2 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (10.17.2)
Requirement already satisfied: requests>=2.26 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-material) (2.32.5)
Requirement already satisfied: python-dateutil>=2.8.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from ghp-import>=1.0->mkdocs) (2.9.0.post0)
Requirement already satisfied: platformdirs>=2.2.0 in c:\users\serge\appdata\roaming\python\python313\site-packages (from mkdocs-get-deps>=0.2.0->mkdocs) (4.5.0)
Requirement already satisfied: six>=1.5 in c:\users\serge\appdata\roaming\python\python313\site-packages (from python-dateutil>=2.8.1->ghp-import>=1.0->mkdocs) (1.17.0)
Requirement already satisfied: charset_normalizer<4,>=2 in c:\users\serge\appdata\roaming\python\python313\site-packages (from requests>=2.26->mkdocs-material) (3.4.3)
Requirement already satisfied: idna<4,>=2.5 in c:\users\serge\appdata\roaming\python\python313\site-packages (from requests>=2.26->mkdocs-material) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in c:\users\serge\appdata\roaming\python\python313\site-packages (from requests>=2.26->mkdocs-material) (2.5.0)
Requirement already satisfied: certifi>=2017.4.17 in c:\users\serge\appdata\roaming\python\python313\site-packages (from requests>=2.26->mkdocs-material) (2025.8.3)
PS C:\Data\st-2025\GitHub Pages\word-odt-vers-html\v2> 

Sur mon PC, tout était déjà installé. Si ce n’est pas votre cas, toutes les dépendances demandées vont être installées.

Maintenant, nous pouvons utiliser le convertisseur. Dans le terminal ouvert, tapez la commande suivante :

PS C:\Data\st-2025\GitHub Pages\word-odt-vers-html\v2> python .\convert.py .\word-odt-vers-HTML.odt config.json
--- ODT to MkDocs Converter V288 ---
Traitement de .\word-odt-vers-HTML.odt avec config config.json...
Copié : googlexxxxxx.html
Copié : robots.txt
Génération Markdown...
>>> CHAPITRE: Introduction (Niv 1)
>>> CHAPITRE: Les exemples (Niv 1)
>>> CHAPITRE: Les listes (Niv 2)
>>> CHAPITRE: Les blocs de code (Niv 2)
>>> CHAPITRE: Les liens (Niv 2)
>>> CHAPITRE: L’enrichissement de texte (Niv 2)
>>> CHAPITRE: Les images (Niv 2)
>>> CHAPITRE: Ce qui existe (Niv 1)
>>> CHAPITRE: Le prompt initial (Niv 1)
>>> CHAPITRE: Créer un environnement de travail (Niv 1)
>>> CHAPITRE: Le dossier de travail (Niv 1)
>>> CHAPITRE: Le fichier de configuration [config.json] (Niv 1)
Terminé.

Ligne 1 : la commande qui convertit le document ODT en site MkDocs [python .\convert.py .\word-odt-vers-HTML.odt config.json]. Le premier paramètre du convertisseur est le document ODT à convertir, le second le fichier de configuration du convertisseur ;
lignes 4-5 : les deux fichiers que le convertisseur copie à la racine du site MkDocs qu’il crée ;
lignes 7-18 : j’ai demandé à Gemini de loguer tous les chapitres qu’il rencontrait ;

Cette exécution a modifié votre dossier de travail :

En [1], [docs] est le site MkDocs que le convertisseur Gemini a créé. Vous pouvez avoir la curiosité de le visiter ;
en [2], un dossier [overrides] a été créé. Il va être utilisé par le constructeur [build] du site HTML ;
en [3] : [analytics.html] sera utilisé pour le suivi du site par Google Analytics. [footer.html] est le bas de page que vous avez défini dans le fichier [config.json] ;

On pourrait utiliser le site MkDocs dès maintenant. La commande [python -m mkdocs serve] permet de le visualiser. Vous pouvez essayer :

PS C:\Data\st-2025\GitHub Pages\word-odt-vers-html\v2> python -m mkdocs serve
INFO    -  Building documentation...
INFO    -  Cleaning site directory
INFO    -  Doc file 'les-exemples.md' contains a link '#_Les_exemples', but there is no such anchor on this page.
INFO    -  Documentation built in 0.41 seconds
INFO    -  [15:46:06] Serving on http://127.0.0.1:8000/word-odt-vers-html-janv-2026/

Ctrl-cliquez sur le lien de la ligne 6. Le site MkDocs doit apparaître :

Voici le fruit d’un long travail. Pour arrêter le serveur de MkDocs, faites simplement Ctrl-C dans le terminal qui l’a lancé.