This commit is contained in:
Alex committed 2026-09-24 18:42:22 +02:00
1 parent 5dc977f9dd
commit 41987f8ea8
17 files changed
+1258 -210

No files matched your search

+35 -15
View File
@@ -39,6 +39,7 @@ Extension Inkscape 1.x qui génère le patron d'une boîte à découper au laser
- Couleur et épaisseur du trait réglables (défaut : rouge, 0,1 mm)
- Étiquettes optionnelles (texte bleu). Désactivées par défaut : le laser graverait le texte
- Message d'erreur si une dimension est trop petite (minimum 5 × l'épaisseur en dimension extérieure)
- Interface **en français et en anglais** selon la langue d'Inkscape : libellés, onglet **Aide**, noms des pièces et messages d'erreur. Le schéma de l'onglet **Schéma** / **Diagram** est en anglais (Inkscape ne traduit pas les images)
## Installation
@@ -49,14 +50,14 @@ Inkscape fermé, depuis le dossier du projet (PowerShell) :
.\deploy.ps1 -Uninstall # désinstalle
```
Le script copie `box_maker.inx`, `box_maker.py`, `box_core.py` et le dossier `images\` (schéma de l'onglet « Schéma »). Options : `-ExtensionsDir`, `-FolderName`, `-Force` (déploie même si Inkscape est ouvert). Redémarrer ensuite Inkscape.
Le script copie `box_maker.inx`, `box_maker.py`, `box_core.py`, `images\parameters_en.png` (schéma de la boîte de dialogue) et le dossier `locale\` (traductions compilées). Options : `-ExtensionsDir`, `-FolderName`, `-Force` (déploie même si Inkscape est ouvert). Redémarrer ensuite Inkscape.
Installation manuelle : copier ces mêmes fichiers et le dossier `images\` dans `%APPDATA%\inkscape\extensions\boxMaker\`.
Installation manuelle : copier ces mêmes fichiers et dossiers, en gardant l'arborescence, dans `%APPDATA%\inkscape\extensions\boxMaker\`.
## Utilisation
1. Menu **Extensions > AlexDesign > Boîte à créneaux…**
2. Régler les paramètres (illustrés dans l'onglet **Schéma**), cocher **Aperçu en direct** si besoin
1. Menu **Extensions > AlexDesign > Boîte à créneaux…** (en anglais : _Finger-Joint Box…_)
2. Régler les paramètres (illustrés dans l'onglet **Schéma**, résumés dans l'onglet **Aide**), cocher **Aperçu en direct** si besoin
3. **Appliquer**
### En ligne de commande
@@ -133,39 +134,58 @@ Le kerf dépend de la matière : refaire la mesure en changeant de matériau ou
```
.
├── box_maker.inx # Interface de l'extension (paramètres, menu)
├── box_maker.py # Extension inkex : conversion en SVG, placement dans le calque
├── box_maker.inx # Interface de l'extension (textes source en anglais)
├── box_maker.py # Extension inkex : conversion en SVG, placement, textes traduits
├── box_core.py # Géométrie pure Python (mm) : créneaux, kerf, mise en page
├── i18n.py # Chaîne de traduction (extract / update / compile), Python pur
├── po/ # box_maker.pot, en.po, fr.po (seul fr.po se traduit à la main)
├── locale/ # Catalogues .mo compilés (générés, déployés)
├── deploy.ps1 # Installation / désinstallation dans Inkscape
├── images/
│ └── parametres.png # Schéma de l'onglet « Schéma » (déployé)
│ └── parameters_en.png # Schéma de l'onglet « Diagram » (déployé)
├── docs/ # Illustrations du README (non déployées)
│ ├── apercu-boite.png # Patron d'exemple
│ ├── parametres.png # Schéma des paramètres (+ sources .svg)
│ └── schema_parametres.py # Générateur des deux versions du schéma
│ ├── parametres.png # Schéma des paramètres en français
│ └── schema_parametres.py # Générateur du schéma fr et en
└── tests/
└── test_box_core.py # Tests unitaires de la géométrie
├── test_box_core.py # Tests unitaires de la géométrie
└── test_extension.py # Traductions, cohérence .inx, bout en bout avec inkex
```
## Développement
Environnement et tests (13 tests, géométrie pure, sans `inkex`) :
Environnement et tests :
```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install pytest
python -m pytest -q
python -m pytest -q # 18 réussis, 3 ignorés (sans inkex)
$env:PYTHONPATH = "C:\Program Files\Inkscape\share\inkscape\extensions"
python -m pytest -q # 21 réussis (avec inkex)
```
Les tests couvrent la géométrie (`box_core`), les catalogues de traduction (complets, `.mo` à jour, champs de format conservés), la cohérence `.inx` ↔ `add_argument`, la présence des images de la boîte de dialogue et l'extension de bout en bout (6 pièces nommées, message d'erreur).
### Traductions
Les textes source (`.inx` et appels `_("...")` de `box_maker.py`) sont en anglais ; Inkscape les affiche traduits grâce à l'attribut `translationdomain="box_maker"` du `.inx`.
```powershell
python i18n.py # extract + update + compile ; liste les chaînes à traduire
```
Après modification d'un texte : lancer `python i18n.py`, compléter les `msgstr` vides de `po/fr.po`, relancer `python i18n.py`, puis `.\deploy.ps1`. `po/en.po` se remplit tout seul ; ne jamais modifier les `.mo`. Pour une nouvelle langue : l'ajouter à `LANGUAGES` dans `i18n.py`, puis même démarche avec `po/<langue>.po`.
### Schéma des paramètres
`docs/schema_parametres.py` dessine le schéma avec les fonctions de `box_core.py` (il reste fidèle au rendu réel) et l'exporte en PNG via `C:\Program Files\Inkscape\bin\inkscape.com` :
```powershell
python docs/schema_parametres.py # les deux versions
python docs/schema_parametres.py readme # docs/parametres.png, 1400 px
python docs/schema_parametres.py dialogue # images/parametres.png, 900 px, textes agrandis
python docs/schema_parametres.py # les deux versions
python docs/schema_parametres.py fr # docs/parametres.png, 1400 px (README)
python docs/schema_parametres.py en # images/parameters_en.png, 900 px, textes agrandis (boîte de dialogue)
```
Relancer après toute modification de la géométrie ou des paramètres, puis `.\deploy.ps1`.