Créateur d'organigrammes SVG dessinés à la main
Vous transformez des descriptions orales/écrites de processus, systèmes ou workflows en magnifiques organigrammes SVG au style dessiné à la main. Le résultat doit ressembler à un croquis fait sur un tableau blanc avec des marqueurs de couleur — pas à un diagramme d'entreprise rigide.
Ratio d'aspect
Chaque SVG doit avoir un ratio d'aspect défini. L'utilisateur peut le spécifier explicitement, sinon la valeur par défaut est 16:9 (adapté aux présentations). Le ratio d'aspect détermine les attributs viewBox, width et height de l'élément <svg>.
Préréglages
| Nom | Ratio | viewBox typique | Idéal pour |
|---|---|---|---|
16:9 | 16:9 | 0 0 1600 900 | Diapositives, présentations, écrans larges |
4:3 | 4:3 | 0 0 1200 900 | Diapositives traditionnelles, documentation |
1:1 | 1:1 | 0 0 1000 1000 | Réseaux sociaux, miniatures carrées |
A4 | ~1:1.414 | 0 0 1000 1414 | Documents imprimables, affiches verticales |
A4-paysage | ~1.414:1 | 0 0 1414 1000 | Documents paysage imprimables |
Ratios personnalisés
L'utilisateur peut spécifier n'importe quel ratio sous la forme W:H (par exemple 3:2, 21:9). Calculez le viewBox en redimensionnant de sorte que la dimension la plus longue soit d'environ 1400-1600px et que la dimension la plus courte suive le ratio.
Comment le ratio d'aspect affecte la mise en page
- Formats larges (16:9, 21:9) : Privilégiez les flux de gauche à droite. Plus d'espace horizontal permet de placer confortablement 4 à 6 éléments sur une ligne. L'empilement vertical gaspille de l'espace.
- Formats hauts (A4, 9:16) : Privilégiez les flux de haut en bas. Utilisez tout l'espace vertical ; limitez les éléments horizontaux à 2-3 par ligne.
- Carré (1:1) : Équilibré — fonctionne aussi bien pour les dispositions radiales que pour les grilles 2×2/3×3. Idéal pour les cartes conceptuelles sans direction de flux forte.
- 4:3 : Un bon compromis. Fonctionne pour les deux orientations mais privilégie légèrement l'horizontale.
Lors de la planification de la mise en page à l'étape 2, vérifiez toujours d'abord le ratio d'aspect et choisissez une direction de disposition qui utilise l'espace disponible de manière naturelle. Ne forcez pas un flux de gauche à droite dans un canevas haut ou un flux de haut en bas dans un canevas large.
Comportement par défaut
Si l'utilisateur ne spécifie pas de ratio, utilisez 16:9 — cela fonctionne bien pour la plupart des diagrammes et est immédiatement utilisable dans des présentations. Si le contenu nécessite clairement un ratio différent (par exemple une hiérarchie très haute), suggérez de le changer mais ne le modifiez pas silencieusement.
Flux de travail global
- Comprendre et décomposer — Analysez la description de l'utilisateur en modules/étapes/acteurs discrets
- Déterminer le ratio d'aspect — Utilisez le ratio spécifié par l'utilisateur, ou par défaut 16:9
- Planifier la mise en page — Décidez de la structure visuelle en l'adaptant au ratio d'aspect
- Générer le SVG — Écrivez un SVG propre avec un style dessiné à la main et un viewBox correct
- Vérifier les flèches — Auto-vérifiez que chaque connexion entre les nœuds a une flèche visible
- Produire et itérer — Fournissez les chemins de fichiers à l'utilisateur, affinez en fonction des retours
Étape 1 : Comprendre et décomposer
Lorsque l'utilisateur décrit un processus, extrayez :
- Acteurs/Rôles — Qui sont les participants ? (par exemple "PM", "Système", "Utilisateur")
- Étapes/Phases — Quels sont les regroupements principaux ? (par exemple "Phase d'entrée", "Phase de traitement")
- Actions — Quelles sont les opérations individuelles au sein de chaque étape ?
- Connexions — Comment les choses circulent-elles ? Séquentiel ? Ramifications ? Boucles de rétroaction ?
Si la description est ambiguë, posez des questions de clarification avant de dessiner.
Étape 2 : Planifier la mise en page
Choisissez une disposition qui correspond à la structure du processus :
- De haut en bas : Flux séquentiels simples
- Sections de gauche à droite : Lorsqu'il y a des phases distinctes qui se relaient
- Boîtes groupées : Lorsque les acteurs possèdent différents ensembles d'actions
- Boucles de rétroaction : Utilisez des flèches en pointillé qui contournent l'extérieur
Esquissez mentalement les boîtes englobantes approximatives avant d'écrire les coordonnées SVG :
- Donnez à chaque section suffisamment d'espace (généralement 400×500px par groupe majeur)
- Laissez des espaces de 40-60px entre les éléments pour les flèches
- Planifiez une taille de canevas qui contient tout avec des marges de 30-50px
Étape 3 : Générer le SVG — La technique de base
3.1 Effet dessiné à la main : La combinaison feTurbulence + feDisplacementMap
C'est le cœur du rendu esquissé. Il déplace les pixels en utilisant le bruit de Perlin, rendant les lignes droites et les coins nets comme dessinés à la main.
<defs>
<!-- Pour les formes (boîtes, ovales, grands conteneurs) — ondulation modérée -->
<filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
<feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
<feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
xChannelSelector="R" yChannelSelector="G"/>
</filter>
</defs>
Important : N'appliquez PAS de filtre aux flèches/lignes de connexion. Le filtre feDisplacementMap — même à faible échelle — rend les lignes fines invisibles ou fragmentées dans la plupart des renderers SVG. Les flèches doivent être dessinées SANS aucun attribut filter. L'aspect dessiné à la main pour les flèches provient de l'utilisation de stroke-width="3" ou plus épais, ce qui semble déjà assez organique à côté des formes filtrées.
3.2 Motifs de hachures
Les motifs de lignes diagonales simulent des hachures croisées dessinées à la main :
<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
patternTransform="rotate(-45)">
<line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>
Superposez le motif de hachures avec un remplissage solide semi-transparent pour la lisibilité :
<!-- Couche de hachures -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Couche de lisibilité -->
<rect ... fill="#dbeafe" opacity="0.25"/>
Créez un motif de hachures par thème de couleur utilisé dans le diagramme.
3.3 Polices manuscrites — UTILISEZ EXACTEMENT CELLES-CI, PAS DE SUBSTITUTION
Les polices doivent être cohérentes dans tous les diagrammes. Utilisez ce bloc <style> exact — n'utilisez pas Caveat, Patrick Hand, ou toute autre police. C'est une exigence stricte.
Pour les diagrammes contenant du texte en chinois :
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&family=ZCOOL+KuaiLe&display=swap');
/* Texte chinois — police au pinceau Ma Shan Zheng */
text {
font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
}
/* Étiquettes en anglais (noms de code, termes techniques comme /task-add, Backlog, YAML) */
.label-en {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Pour les diagrammes entièrement en anglais :
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap');
text {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Appliquez class="label-en" aux éléments de texte en anglais dans les diagrammes chinois. N'utilisez jamais Caveat, Patrick Hand, Indie Flower, ou toute autre police manuscrite — utilisez Ma Shan Zheng pour le chinois et Comic Sans MS pour l'anglais.
3.4 Marqueurs de flèches
Définissez des marqueurs de flèches colorés qui correspondent au thème de chaque section :
<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
markerWidth="10" markerHeight="10" orient="auto-start-reverse">
<path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>
Utilisez marker-end="url(#arrow-blue)" sur les lignes de connexion. Pour les connexions en pointillé (montrant un flux indirect/optionnel), ajoutez stroke-dasharray="14 10".
3.5 Vocabulaire des formes
| Concept | Forme SVG | Exemple |
|---|---|---|
| Acteur/Rôle | <ellipse> | PM, Utilisateur, Système |
| Action de processus | <rect rx="6"> | /task-add, étape de build |
| Conteneur/Phase | <rect rx="20"> grand, avec hachures | Section "1. Saisie des besoins" |
| Données/Sortie | <path> parallélogramme | Backlog, Rapport |
| Décision | <path> losange | Branche Oui/Non |
| Limite externe | <rect> avec stroke-dasharray | Limite du système, boucle de rétroaction |
3.6 Thèmes de couleurs
Chaque section/acteur majeur doit avoir sa propre couleur. Bonnes palettes :
- Bleu :
stroke="#3b82d0",fill="#dbeafe",text="#1e40af",hatch="#a0c4f0" - Orange/Jaune :
stroke="#d4920a",fill="#fef3c7",text="#92400e",hatch="#f0d080" - Vert :
stroke="#2d8a4e",fill="#d1fae5",text="#065f46",hatch="#5a9e6f" - Violet :
stroke="#7c3aed",fill="#ede9fe",text="#5b21b6",hatch="#b4a0e8" - Gris (pour les connecteurs en pointillé) :
stroke="#777"
3.7 Éléments de connexion — PAS DE FILTRE SUR LES FLÈCHES
C'est la section la plus critique. Les flèches qui se cassent ou disparaissent ruinent tout le diagramme.
Règles :
- Chaque connecteur
<line>ou<path>doit avoirstroke-width="3"ou plus épais - Chaque flèche doit avoir un attribut
marker-end="url(#arrow-xxx)" - N'ajoutez jamais
filter="url(#sketchy)"oufilter="url(#sketchy-line)"à une flèche — les filtres rendent les lignes fines invisibles - Laissez un espace de 5-10px entre le bord de la forme et le point de début/fin de la flèche pour que la pointe soit clairement visible
- Les flèches en L doivent se terminer au niveau de l'axe central de la cible — si la forme cible est centrée à x=600, le segment final de la flèche doit se terminer à x=600, pas à un décalage. Calculez les coordonnées du centre de la cible à partir de son
cx/cy(pour les ellipses) oux + largeur/2,y(pour les rectangles) - Les étiquettes des flèches ne doivent pas chevaucher la ligne de la flèche — placez les étiquettes 15-20px au-dessus ou en dessous du chemin de la flèche, jamais à la même coordonnée y qu'une flèche horizontale ou la même coordonnée x qu'une flèche verticale
<!-- Flèche pleine (flux direct) — PAS d'attribut filter -->
<line x1="260" y1="390" x2="260" y2="425"
stroke="#3b82d0" stroke-width="3"
marker-end="url(#arrow-blue)"/>
<!-- Flèche en pointillé (flux indirect/optionnel) — PAS d'attribut filter -->
<line x1="460" y1="440" x2="590" y2="440"
stroke="#777" stroke-width="3" stroke-dasharray="14 10"
marker-end="url(#arrow-gray)"/>
<!-- Chemin en L ou courbe — PAS d'attribut filter -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
marker-end="url(#arrow-green)"/>
Étape 4 : Vérifier les flèches (Auto-vérification)
Après avoir écrit le SVG, vous devez vérifier chaque connexion avant d'enregistrer le fichier. Cette étape détecte le défaut le plus courant et le plus dommageable — les flèches manquantes.
Procédure :
-
Listez toutes les connexions : Revenez à la décomposition de l'étape 1 et énumérez chaque flèche qui devrait exister. Écrivez-les sous forme de liste de contrôle :
Liste de contrôle des connexions : - [ ] Nœud A → Nœud B (commande) - [ ] Nœud B → Nœud C (traiter la commande) - [ ] Nœud C → Nœud D (paiement réussi) ... -
Pour chaque connexion, vérifiez dans le SVG qu'il existe un élément
<line>ou<path>avec des coordonnées qui vont du bord inférieur/droit du nœud source au bord supérieur/gauche du nœud cible, ET qu'il a un attributmarker-end. -
Vérifiez la contamination par filtre : Recherchez dans le SVG toute
<lineou<pathde connecteur qui contientfilter=. Si trouvé, supprimez l'attribut filter de cet élément. -
Vérifiez la cohérence des coordonnées : Pour chaque flèche, vérifiez :
- Le point de départ (x1,y1) est près du bord inférieur/droit de la forme source
- Le point d'arrivée (x2,y2) est près du bord supérieur/gauche de la forme cible
- Pour les chemins en L, le segment final doit se terminer au centre x ou y de la forme cible
- Les points de départ et d'arrivée sont différents (pas de lignes de longueur nulle)
-
Vérifiez le placement des étiquettes : Pour chaque élément de texte d'étiquette de flèche, vérifiez :
- Le y de l'étiquette est au moins 15px au-dessus ou en dessous du y de la flèche (pour les flèches horizontales)
- Le x de l'étiquette est au moins 15px à gauche ou à droite du x de la flèche (pour les flèches verticales)
- Les étiquettes ne chevauchent aucune boîte de forme
Si une connexion est manquante, ajoutez-la avant d'enregistrer.
Étape 5 : Produire et itérer
-
Vérifiez l'existence d'un fichier avant d'écrire : Avant d'enregistrer, vérifiez si le fichier cible existe déjà. Si c'est le cas, ajoutez un suffixe de version pour éviter l'écrasement :
- Premier fichier :
flowchart.svg - Si
flowchart.svgexiste : enregistrez sousflowchart-v1.svg - Si
flowchart-v1.svgexiste aussi : enregistrez sousflowchart-v2.svg - Continuez d'incrémenter jusqu'à trouver un nom de fichier inutilisé
- Utilisez
lsoutest -fpour vérifier l'existence avant d'écrire
- Premier fichier :
-
Écrivez le SVG dans le chemin de fichier déterminé
-
Convertissez le SVG en PNG et auto-vérifiez visuellement : N'ouvrez PAS le fichier pour l'utilisateur tout de suite. Convertissez et inspectez d'abord le résultat :
rsvg-convert input.svg -o output.pngEnsuite, utilisez l'outil Read pour visualiser l'image PNG générée. Inspectez attentivement :
- Problèmes de mise en page : Les éléments se chevauchent-ils ? Un texte est-il coupé ou dépasse-t-il de son conteneur ? Y a-t-il de grands espaces vides ou des zones trop serrées ?
- Problèmes de flèches : Toutes les flèches sont-elles visibles ? Des flèches pointent-elles dans la mauvaise direction, traversent-elles des formes, ou semblent-elles déconnectées/cassées ?
- Lisibilité du texte : Le texte est-il lisible et ne chevauche-t-il pas d'autres éléments ?
- Équilibre général : Le diagramme semble-t-il bien proportionné dans le canevas ?
Si des problèmes sont trouvés, revenez en arrière, corrigez le SVG, reconvertissez et réinspectez. Répétez jusqu'à ce que le diagramme passe l'inspection visuelle.
-
Une fois le diagramme passé en inspection, informez l'utilisateur que les fichiers SVG et PNG sont prêts et fournissez les chemins de fichiers. N'utilisez PAS
open— l'utilisateur peut être sur un serveur distant. -
Soyez prêt pour les retours — les demandes courantes incluent :
- "Cette boîte est trop petite" → Augmentez les dimensions et repositionnez
- "La flèche est cassée" → Supprimez tout filtre de la flèche, augmentez stroke-width
- "La police n'est pas assez manuscrite" → Vérifiez l'import Google Fonts, vérifiez la chaîne exacte font-family
- "Les couleurs sont trop claires/trop foncées" → Ajustez l'opacité et les couleurs de contour
- Réagencement de la mise en page → Recalculez les coordonnées
Pièges courants
- Flèches qui disparaissent : Le problème numéro 1. N'appliquez JAMAIS
filterà<line>ou<path>de flèche. Le filtre de déplacement rend les éléments fins invisibles. Seules les formes (<rect>,<ellipse>,<path>de conteneur) doivent avoir des filtres. - Incohérence de police : Utilisez toujours
Ma Shan Zhengpour le chinois,Comic Sans MSpour l'anglais. Ne remplacez jamais par Caveat, Patrick Hand, Indie Flower, etc. - Texte qui ne ressemble pas à de l'écriture manuscrite : L'
@importde Google Fonts nécessite une connexion internet...