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:
co-authored by
Claude Opus 5.5
parent
d4faa4872c
commit
47528bae8d
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user