From 47528bae8db18b2015033a5d03b991d13d5ea9de Mon Sep 17 00:00:00 2001 From: Artemia Date: Sun, 18 Oct 2026 16:38:02 +0200 Subject: [PATCH] =?UTF-8?q?README=20:=20g=C3=A9n=C3=A9rer=20les=20document?= =?UTF-8?q?s=20sans=20ligne=20de=20commande?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index 9eed0fb..3bad7f3 100644 --- a/README.md +++ b/README.md @@ -20,10 +20,32 @@ Les sources sont en Markdown [Quarto](https://quarto.org) (`modules/*.qmd`) et p | `12-projetfinal` | Projet final | | `synthese-materiel` | Synthèse et liste de matériel | +## Générer les documents sans ligne de commande + +Après avoir téléchargé le dépôt (bouton « Télécharger » → ZIP, puis décompresser), double-cliquez sur le fichier +correspondant à votre système : + +| Système | Fichier à lancer | +|---|---| +| Windows | `Generer-documents.bat` | +| macOS | `Generer-documents.command` (la première fois : clic droit → Ouvrir, pour passer l'avertissement de sécurité) | +| Linux | `generer-documents.sh` (clic droit → « Exécuter comme un programme », ou `./generer-documents.sh` dans un terminal) | + +Une fenêtre s'ouvre et vous guide : + +1. elle vérifie que **Python** et **Quarto** sont installés, et propose de les installer automatiquement sinon ; +2. elle prépare l'environnement Python des schémas (dossier `.venv`, une seule fois) ; +3. elle vous demande le **format** (PDF, LibreOffice .odt ou site web HTML) et les **supports** à produire + (tous, ou un seul module) ; +4. elle génère les documents et ouvre le dossier `_output/modules` qui les contient. + +Il suffit de taper le numéro de votre choix puis Entrée (Entrée seul = choix par défaut). + ## Organisation ``` modules/ sources des supports (.qmd) +scripts/ assistant de génération (appelé par les fichiers Generer-documents.*) modele/ gabarit PDF (Typst) et thème de coloration du code schemas/ schémas décrits en Python (schemdraw + matplotlib), rendus en svg/ et png/ _quarto.yml configuration du projet