README : générer les documents sans ligne de commande

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Artemia
2026-10-18 16:38:02 +02:00
co-authored by Claude Opus 5.5
parent d4faa4872c
commit 47528bae8d
+22
View File
@@ -20,10 +20,32 @@ Les sources sont en Markdown [Quarto](https://quarto.org) (`modules/*.qmd`) et p
| `12-projetfinal` | Projet final | | `12-projetfinal` | Projet final |
| `synthese-materiel` | Synthèse et liste de matériel | | `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 ## Organisation
``` ```
modules/ sources des supports (.qmd) 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 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/ schemas/ schémas décrits en Python (schemdraw + matplotlib), rendus en svg/ et png/
_quarto.yml configuration du projet _quarto.yml configuration du projet