Python Academy · Leçon

Exporter et intégrer

Enregistrer et partager des figures

Exporter et intégrer est une leçon Python Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Python Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Python Academy comprend 4 leçons au total.

Partager votre travail

Un graphique terminé n'est utile que si d'autres personnes peuvent le consulter. Les figures Plotly peuvent être enregistrées au format HTML interactif, exportées sous forme d'images statiques ou intégrées à des pages web et à des rapports.

Le choix du bon format dépend du besoin d'interactivité du public.

Enregistrer du HTML interactif

fig.write_html('chart.html') écrit un fichier autonome qui conserve toute l'interactivité. Son ouverture dans n'importe quel navigateur permet de zoomer, de survoler et de se déplacer, sans avoir besoin de Python.

C'est le meilleur format pour partager un graphique interactif que l'on peut explorer.

Choisir un nom de fichier

Le nommage est important lorsque vous générez de nombreux exports. Un nom horodaté et normalisé évite les collisions. Il s'agit simplement de manipuler des chaînes de caractères.

title = 'Q3 Sales Report!'
slug = ''.join(ch.lower() if ch.isalnum() else '_' for ch in title)
slug = '_'.join(p for p in slug.split('_') if p)
print(slug + '.html')

Exporter une image statique

Pour les PDF, les diapositives ou les courriels, vous avez besoin d'une image statique. fig.write_image('chart.png') produit un fichier PNG, JPEG, SVG ou PDF. Le moteur kaleido doit être installé pour cela.

Les images statiques perdent leur interactivité, mais peuvent être intégrées partout.

Choisir un format

Adaptez le format à l'usage :

HTML exploration interactive, pages web
PNG/JPEG image matricielle, adaptée aux diapositives et aux courriels
SVG image vectorielle, qui s'agrandit sans devenir floue pour l'impression
PDF documents

Un petit tableau de décision permet de choisir rapidement.

use_case = 'print'
format_map = {'web': 'html', 'slides': 'png', 'print': 'svg', 'document': 'pdf'}
print('Best format for', use_case, '->', format_map[use_case])

Intégrer dans une page

Pour intégrer un graphique à un site existant sans créer un fichier HTML complet, utilisez fig.to_html(full_html=False, include_plotlyjs='cdn'). Cette fonction renvoie uniquement le fragment HTML du graphique, que vous pouvez coller dans votre modèle.

Charger plotly.js depuis un CDN permet de garder une page légère.

Inclure la bibliothèque

Le HTML interactif a besoin de la bibliothèque plotly.js. Options pour include_plotlyjs :

True l'intègre (volumineuse, mais fonctionne hors ligne)
'cdn' crée un lien vers un CDN (léger, mais nécessite Internet)
False suppose que la page l'a déjà chargée

Choisissez selon vos besoins hors ligne et le poids de la page.

Résolution de l'export

Pour les images statiques, contrôlez la taille et la netteté avec width, height et scale. Une valeur scale=2 double la densité de pixels pour obtenir des images nettes sur les écrans haute résolution.

width, height, scale = 800, 600, 2
print('Output pixels:', width * scale, 'x', height * scale)

Allers-retours JSON

Une figure peut être sérialisée avec fig.to_json(), puis reconstruite avec plotly.io.from_json(). C'est pratique pour mettre en cache des figures ou les transmettre entre un serveur et un navigateur.

Le JSON décrit complètement les données et la disposition.

Reproductibilité

Lorsque vous partagez un export, conservez également le script qui l'a produit. Un fichier PNG ne peut pas être modifié de nouveau, mais le code peut recréer le graphique avec de nouvelles données. Considérez le code, et non l'image, comme la source de vérité.

Intégration dans les carnets et Markdown

Dans Jupyter, une figure s’affiche automatiquement dans le carnet lorsqu’il s’agit de la dernière expression d’une cellule. Pour une documentation statique, exportez une image et référencez-la depuis Markdown. Pour une documentation interactive, intégrez plutôt le fragment HTML.

Choisissez le HTML interactif lorsque le lecteur tire avantage de l’exploration, et une image statique lorsqu’il a seulement besoin de regarder.

Vérification rapide

Vérifiez vos connaissances sur l’exportation.

Récapitulatif

Vous avez appris à partager des figures :

write_html pour des fichiers autonomes interactifs
write_image (avec kaleido) pour PNG/SVG/PDF
to_html(full_html=False) pour intégrer un fragment, avec include_plotlyjs qui contrôle la bibliothèque
Utilisez scale pour les images haute résolution et conservez le code source afin de garantir la reproductibilité

Questions Fréquemment Posées

La leçon « Exporter et intégrer » est-elle gratuite ?

Oui — le texte complet de « Exporter et intégrer » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Python Academy, passe à CoddyKit PRO. Le cours Python Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Exporter et intégrer » ?

Enregistrer et partager des figures Tu pratiques Python Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Python Academy ?

Aucune expérience préalable n'est requise. Python Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Exporter et intégrer » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Python Academy ?

Oui. Chaque leçon Python Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Python Academy