6.1 KiB
Publication sur inkscape.org
Marche à suivre d'après Submitting and Publishing an Inkscape Extension, 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
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 :
$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) :
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.pnget 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
Dog Bandana Pattern Fill
Description
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 :
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!