i18n
This commit is contained in:
1 parent
5dc977f9dd
commit
41987f8ea8
17 files changed
+1258
-210
No files matched your search
@@ -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`.
|
||||
|
||||
Reference in new issue
Block a user