135 lines
6.1 KiB
Markdown
135 lines
6.1 KiB
Markdown
# Publication sur inkscape.org
|
||
|
||
Marche à suivre d'après
|
||
[Submitting and Publishing an Inkscape Extension](https://inkscape.gitlab.io/extensions/documentation/authors/submit.html),
|
||
et état de chaque point pour la version **1.0.0**.
|
||
|
||
## 1. Conditions de la page
|
||
|
||
| Exigence | État |
|
||
| -------- | ---- |
|
||
| Pas d'accès à Internet, pas d'auto-mise à jour, aucune écriture dans le dossier de configuration | ✅ aucun accès réseau ni fichier écrit (seule la variable `LANGUAGE` du processus est renseignée) |
|
||
| Code lisible, en anglais | ✅ commentaires et docstrings des `.py` et du `.inx` en anglais |
|
||
| Licence libre, pour le code et les dépendances | ✅ GPL-2.0-or-later (`LICENSE`, en-tête SPDX dans chaque `.py`) ; `numpy` et `lxml` (BSD) sont fournis avec Inkscape |
|
||
| Python 3.8 ou plus récent | ✅ grammaire 3.8 vérifiée par `package.py` ; exécuté avec le Python 3.12 d'Inkscape 1.4.4 |
|
||
| Dépendances absentes d'Inkscape embarquées | ✅ aucune : `inkex`, `numpy`, `lxml` sont livrés avec Inkscape |
|
||
| Un seul zip, toutes plates-formes, fichiers à la racine | ✅ `python package.py` |
|
||
| Fonctionne avec au moins une version d'Inkscape | ✅ Inkscape 1.4.4 (Windows) ; autres versions à essayer, voir § 3 |
|
||
|
||
Contrôles des relecteurs, déjà passés : `.inx` + `.py` présents, licence,
|
||
`pytest` (37 tests réussis), `pylint` **9,65/10** (restent des avertissements
|
||
« trop d'arguments / de variables locales » sur les fonctions de calcul et
|
||
deux suggestions de f-string).
|
||
|
||
## 2. Construire le paquet
|
||
|
||
```powershell
|
||
python i18n.py # traductions à jour (0 à traduire)
|
||
python -m pytest -q # avec PYTHONPATH vers les extensions d'Inkscape : 37 réussis
|
||
python docs/make_icon.py # docs/icon.png (256 px), si besoin
|
||
python package.py # dist/dog_bandana-1.0.0.zip + .md5
|
||
```
|
||
|
||
Contenu du zip : `dog_bandana.inx`, `dog_bandana.py`, `dog_bandana_core.py`,
|
||
`images/parameters_en.png`, `locale/{en,fr}/LC_MESSAGES/dogbandana.mo`,
|
||
`LICENSE`, `README.en.md`.
|
||
|
||
La version vient de `__version__` dans `dog_bandana_core.py` : l'augmenter à
|
||
chaque nouvelle publication.
|
||
|
||
## 3. Essayer le zip dans Inkscape (à faire pour chaque version annoncée)
|
||
|
||
Profil vierge, pour ne pas mélanger avec l'extension déjà déployée :
|
||
|
||
```powershell
|
||
$env:INKSCAPE_PROFILE_DIR = "$env:TEMP\inkscape-test-profile"
|
||
& 'C:\Program Files\Inkscape\bin\inkscape.exe'
|
||
```
|
||
|
||
Puis **Extensions › Gérer les extensions…**, deuxième onglet, bouton dossier
|
||
en bas, choisir `dist\dog_bandana-1.0.0.zip`. Redémarrer Inkscape (même
|
||
variable), dessiner une forme, lancer l'extension. Fermer, puis
|
||
`Remove-Item Env:INKSCAPE_PROFILE_DIR`.
|
||
|
||
Déjà vérifié : le zip installé dans un profil vierge d'Inkscape 1.4.4 est
|
||
chargé, ses paramètres sont transmis et ses messages sont en français ; le
|
||
calcul tourne avec le Python et le numpy d'Inkscape. Reste à faire à la main :
|
||
l'installation par le gestionnaire d'extensions et un essai sur la sélection
|
||
dans l'interface (Inkscape en ligne de commande ne transmet pas la sélection
|
||
aux effets). Si d'autres versions (1.2, 1.3…) sont disponibles, les essayer
|
||
et les noter pour les étiquettes de compatibilité.
|
||
|
||
## 4. Signer le zip
|
||
|
||
Méthode recommandée : signature GnuPG détachée, avec la clé publique déposée
|
||
dans le profil inkscape.org (aucune clé secrète n'existe encore sur ce poste) :
|
||
|
||
```powershell
|
||
gpg --full-generate-key # une seule fois
|
||
gpg --armor --export <ton e-mail> # à coller dans le profil inkscape.org
|
||
python package.py --sign # dist/dog_bandana-1.0.0.sig
|
||
```
|
||
|
||
À défaut (moins sûr) : l'empreinte md5 de `dist/dog_bandana-1.0.0.zip.md5`
|
||
(il faut alors un texte quelconque dans le champ signature de la clé GnuPG du
|
||
profil inkscape.org pour que le champ md5 apparaisse).
|
||
|
||
## 5. Déposer sur inkscape.org
|
||
|
||
Rubrique **Extensions** de la galerie, avec :
|
||
|
||
- le zip et sa signature (`.sig`, ou le md5) ;
|
||
- l'icône `docs/icon.png` et une capture : `docs/apercu.png`, idéalement
|
||
remplacée par une vraie capture d'Inkscape (boîte de dialogue + résultat) ;
|
||
- les versions d'Inkscape essayées (au moins **1.4**) ;
|
||
- le lien du dépôt : https://git.alex-design.fr/Alex/inkscape.motif.DogBandana
|
||
(le dépôt doit être public et contenir le code avant la demande de relecture) ;
|
||
- le titre et la description ci-dessous (en anglais, exigé).
|
||
|
||
**Titre**
|
||
|
||
```text
|
||
Dog Bandana Pattern Fill
|
||
```
|
||
|
||
**Description**
|
||
|
||
```text
|
||
Fills the selected shapes with a Turing maze: winding lines of constant width
|
||
that branch, sometimes close into loops, and end in round tips (the "noodle"
|
||
pattern often seen on dog bandanas).
|
||
|
||
The pattern is computed with the Swift-Hohenberg equation (labyrinth regime)
|
||
on a grid covering each shape, then reduced to the center line of every band:
|
||
one round-capped stroke per noodle, ready for line engraving on a laser
|
||
cutter. Strokes are chained and ordered by nearest neighbour to minimise idle
|
||
travel of the laser head (on a 300 x 200 mm rectangle, idle travel drops from
|
||
71.7 m to 4.2 m).
|
||
|
||
Works on paths, rectangles, circles, ellipses and polygons, also inside
|
||
groups, with holes respected. Settings: period (line spacing), line width,
|
||
margin from the edge, unit, iterations (few: dots and short lines; many: long
|
||
regular lines), random seed, and edge behaviour (lines cut like fabric, or
|
||
running along the edge). The result is placed in a group above each shape.
|
||
|
||
Menu: Extensions > AlexDesign > Dog Bandana Pattern Fill.
|
||
Interface in English and French. No extra dependency: uses inkex and numpy,
|
||
shipped with Inkscape. Tested with Inkscape 1.4.
|
||
License: GPL-2.0-or-later.
|
||
```
|
||
|
||
## 6. Demander la relecture
|
||
|
||
Message sur le canal RocketChat **inkscape_extensions**
|
||
(https://chat.inkscape.org/channel/inkscape_extensions), par exemple :
|
||
|
||
```text
|
||
Hello! I uploaded "Dog Bandana Pattern Fill" (version 1.0.0) to the extensions
|
||
gallery and would like to request a review. It fills shapes with a Turing maze
|
||
drawn as round-capped center lines, for laser engraving. Pure Python
|
||
(inkex + numpy), GPL-2.0-or-later, pytest suite included in the repository:
|
||
https://git.alex-design.fr/Alex/inkscape.motif.DogBandana
|
||
Gallery page: <link to the upload>
|
||
Thanks!
|
||
```
|