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 |
|
| `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
|
||||||
|
|||||||
Reference in New Issue
Block a user