Files
inkscape.motif.DogBandana/PUBLICATION.md
T
2026-10-24 21:38:03 +02:00

135 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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!
```