Exportación e incrustación
Guarde y comparta figuras
Exportación e incrustación es una lección gratuita de Python Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Python Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Python Academy incluye 4 lecciones en total.
Compartir su trabajo
Un gráfico terminado solo resulta útil si otras personas pueden verlo. Las figuras de Plotly se pueden guardar como HTML interactivo, exportar como imágenes estáticas o incrustar en páginas web e informes.
La elección del formato adecuado depende de si el público necesita interactividad.
Guardar HTML interactivo
fig.write_html('chart.html') escribe un archivo independiente que conserva toda la interactividad. Al abrirlo en cualquier navegador, ofrece ampliación, información emergente y desplazamiento sin necesidad de Python.
Es el mejor formato para compartir un gráfico interactivo y explorable.
Elegir un nombre de archivo
El nombre es importante cuando se generan muchas exportaciones. Un nombre con marca temporal y convertido en slug evita las colisiones. Esto es simplemente manipulación de cadenas.
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')Exportación de imágenes estáticas
Para PDF, presentaciones o correos electrónicos necesita una imagen estática. fig.write_image('chart.png') produce archivos PNG, JPEG, SVG o PDF. Es necesario tener instalado el motor kaleido.
Las imágenes estáticas pierden la interactividad, pero se pueden incrustar en cualquier lugar.
Elegir un formato
Adapte el formato al uso:
- HTML exploración interactiva y páginas web
- PNG/JPEG mapa de bits, adecuado para presentaciones y correos electrónicos
- SVG vectorial, se amplía sin perder nitidez para impresión
- PDF documentos
Una pequeña tabla de decisión facilita la elección.
use_case = 'print'
format_map = {'web': 'html', 'slides': 'png', 'print': 'svg', 'document': 'pdf'}
print('Best format for', use_case, '->', format_map[use_case])Incrustar en una página
Para incrustar el gráfico en un sitio existente sin crear un archivo HTML completo, use fig.to_html(full_html=False, include_plotlyjs='cdn'). Devuelve solo el fragmento HTML del gráfico, que puede pegar en su plantilla.
Cargar plotly.js desde una CDN mantiene ligera la página.
Incluir la biblioteca
El HTML interactivo necesita la biblioteca plotly.js. Opciones para include_plotlyjs:
Trueincluirla en el archivo (grande, funciona sin conexión)'cdn'enlazarla desde una CDN (pequeño, necesita Internet)Falsesuponer que la página ya la ha cargado
Elija según sus necesidades de uso sin conexión y el peso de la página.
Resolución de exportación
Para las imágenes estáticas, controle el tamaño y la nitidez con width, height y scale. Un scale=2 duplica la densidad de píxeles para obtener imágenes nítidas en pantallas de alta resolución.
width, height, scale = 800, 600, 2
print('Output pixels:', width * scale, 'x', height * scale)Serialización y reconstrucción con JSON
Una figura se puede serializar con fig.to_json() y reconstruir con plotly.io.from_json(). Esto resulta útil para almacenar figuras en caché o enviarlas entre un servidor y un navegador.
El JSON describe completamente los datos y el diseño.
Reproducibilidad
Cuando comparta una exportación, conserve también el script que la produjo. Un PNG no se puede volver a editar, pero el código puede regenerar el gráfico con datos nuevos. Considere el código, no la imagen, como la fuente de verdad.
Incorporación en notebooks y Markdown
En Jupyter, una figura se muestra automáticamente en línea cuando es la última expresión de una celda. Para documentación estática, exporte una imagen y haga referencia a ella desde Markdown. Para documentación interactiva, incorpore el fragmento HTML en su lugar.
Elija HTML interactivo cuando al lector le resulte útil explorar, y una imagen estática cuando solo necesite observarla.
Comprobación rápida
Compruebe sus conocimientos sobre la exportación.
Repaso
Ha aprendido a compartir figuras:
write_htmlpara archivos independientes interactivoswrite_image(con kaleido) para PNG/SVG/PDFto_html(full_html=False)para incorporar un fragmento, coninclude_plotlyjspara controlar la biblioteca- Use
scalepara obtener imágenes de alta resolución y conserve el código fuente para garantizar la reproducibilidad
Preguntas frecuentes
¿La lección «Exportación e incrustación» es gratis?
Sí — el texto completo de «Exportación e incrustación» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Python Academy, actualiza a CoddyKit PRO. El curso de Python Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Exportación e incrustación»?
Guarde y comparta figuras Practicas Python Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Python Academy?
No se requiere experiencia previa. Python Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Exportación e incrustación»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Python Academy?
Sí. Cada lección de Python Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Conceptos básicos de Plotly Express
- Funciones interactivas
- Conceptos de dashboards
- Exportación e incrustación