Que fait imagen-infographic ?
Une bonne infographie transforme des informations complexes en quelque chose de clair, mémorisable et rapide à parcourir. Elle place la compréhension avant la décoration. Cette compétence en fait un processus reproductible : rédigez un cahier des charges, vérifiez-le, générez l'image et contrôlez le texte obtenu.
Les règles de conception (à lire avant d'écrire un cahier des charges)
-
Un message clair. Vous devez pouvoir résumer l'ensemble en une phrase. Écrivez d'abord cette phrase, en tant que
message. Leheadlineexpose l'essentiel, pour que le lecteur capte le point en environ cinq secondes. Deux idées concurrentes donnent deux infographies, ou une section d'article. -
Des données précises et crédibles. Utilisez uniquement des faits issus de la source. Chaque chiffre est accompagné d'une source, et le pied de page liste les sources. Une échelle trompeuse ou un chiffre choisi arbitrairement détruit la confiance plus vite qu'aucun graphique.
-
Un public clairement identifié. Adaptez la complexité et le vocabulaire à ce que ce lecteur connaît déjà. Un aperçu générique n'aide personne.
-
Hiérarchie et flux. La taille, le contraste et le placement guident le regard : d'abord le titre, puis les étiquettes des panneaux, puis les courtes phrases. Utilisez une séquence de haut en bas ou une grille modulaire claire.
-
Le bon visuel pour les données.
barpour les comparaisons.linepour les tendances temporelles.timelineouprocesspour les séquences.diagrampour les relations.comparisonpour le côte à côte.statpour un grand nombre.iconsouchecklistpour une courte liste.
Pas de 3D, pas de camemberts avec de nombreuses parts, pas de décoration sans signification. La vérification rejette
pie,donut,radar, et3d. -
Simplicité et retenue. Gardez les étiquettes courtes et les phrases encore plus courtes. Utilisez 2 ou 3 polices et 2 à 4 couleurs, avec un espace blanc généreux. Si une section a besoin d'un paragraphe, elle appartient à l'article, pas à l'infographie.
-
Accessibilité. Le contraste du texte doit être d'au moins 4.5:1, et le script le vérifie. N'utilisez jamais la couleur comme seul moyen de distinguer les éléments : étiquetez-les. L'image doit rester lisible sur un téléphone.
-
Cohérence. Utilisez un style d'icônes, un système typographique et un espacement uniformes. Le prompt demande cela, alors ne le contredis pas avec des instructions mélangées.
Modes d'échec. Vérifiez le cahier des charges pour ces points avant de générer :
- surcharge d'informations ou trop de sujets
- décoration jolie mais sans signification
- hiérarchie faible qui oblige le lecteur à chercher le point
- graphiques erronés ou déformés
- sources manquantes
- texte illisible
Flux de travail
- Trouver le message. Lisez la source (une section d'article, un rapport, des notes). Écrivez la phrase unique
messageet choisissez leaudience. Si vous ne pouvez pas écrire une phrase, le matériel n'est pas prêt pour une infographie. - Rédiger le cahier des charges, un fichier Markdown avec un en-tête YAML. Le format et un exemple complet se trouvent dans
references/spec-format.md. Utilisez 3 à 6 panneaux, chacun avec une courte étiquette, un type de visuel, et au maximum 3 phrases ou quelques points de données. - Vérifier le cahier des charges (lint) :
La vérification applique les limites des règles 1, 2, 5, 6 et 7, et imprime une ligne par problème. Corrigez le cahier des charges, pas les limites : chaque limite existe parce que les infographies passées ont échoué sans elle.python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - Générer l'infographie :
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--themeaccepte tout identifiant de thème imagen-diagrams, et remplit la palette et le style. Vous pouvez aussi définirpalette:dans le cahier des charges.- Le rapport d'aspect par défaut est 3:4, un poster portrait. Définissez
aspect: "16:9"pour une diapositive. - Le script écrit
out.prompt.txtà côté de l'image pour que vous puissiez voir ce qui a été demandé. Utilisez--dry-runpour afficher le prompt sans rien dépenser.
- La vérification finale. Le script relit l'image avec
imagen analyze. Le titre, chaque étiquette de panneau et le pied de page sources doivent apparaître, correctement orthographiés. Le script essaie jusqu'à 3 fois (--attempts) et supprime une image qui échoue, donc un échec est un trou visible, pas une image cassée. - Examinez le résultat vous-même. Ouvrez le PNG et vérifiez-le selon les huit règles. La vérification ne contrôle que l'orthographe. Elle ne peut pas vous dire que la hiérarchie est faible ou qu'un graphique est hors échelle. Si l'image ne satisfait pas une règle, modifiez le cahier des charges (moins de mots, un visuel différent) et générez à nouveau.
Lorsque vous intégrez l'image dans un article, donnez-lui une légende et un court paragraphe décrivant ce qu'elle montre. Un lecteur qui ne peut pas voir l'image doit quand même recevoir le message.
Scènes : une personne travaillant avec l'idée
Une scène est une illustration plate d'une personne au moment que l'article décrit : un développeur se grattant la tête devant un long historique de chat, soulagé quand un test réussit, esquissant un plan sur un tableau blanc. Les scènes rendent un article technique plus personnalisé. Une scène peut montrer l'un des diagrammes de l'article sur un moniteur ou un tableau blanc, ce qui lie la personne au concept. Utilisez environ une scène par article, à un moment de frustration ou de soulagement.
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox
Un cahier des charges de scène est un court bloc d'en-tête (voir references/spec-format.md) : person (qui, faisant quoi, ressentant quoi), setting, un diagram optionnel (un chemin PNG relatif au fichier, envoyé comme image de référence), theme ou palette, et aspect (par défaut 16:9). Les scènes ne portent pas de texte propre, donc elles n'ont pas de vérification orthographique. Examinez chaque scène : l'émotion doit se lire au premier coup d'œil, et l'image ne doit comporter ni titre, ni légende, ni bulle de dialogue.
Prérequis
- La CLI
imagen(gemini-imagen) accessible dans le PATH, avec une clé fonctionnelle. - Le plugin imagen-diagrams, pour
--themeet le basculement d'urgence de moteur dans songenerate.py. Sans le plugin, le script appelle directementimagen generate, et vous devez définirpalette:dans le cahier des charges. - Python 3 avec PyYAML.
Exécutez infographic.py --self-test après avoir modifié le script. Il vérifie les règles de lint et de contraste sans effectuer d'appel d'image.