Python Academy · Урок

Экспорт и встраивание

Сохраняйте фигуры и делитесь ими

«Экспорт и встраивание» — бесплатный урок Python Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Python Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Python Academy содержит 4 уроков всего.

Как поделиться результатом

Готовая диаграмма полезна только тогда, когда её могут увидеть другие. Диаграммы Plotly можно сохранить как интерактивный HTML, экспортировать как статические изображения или встроить в веб-страницы и отчёты.

Выбор подходящего формата зависит от того, нужна ли аудитории интерактивность.

Сохранение интерактивного HTML

fig.write_html('chart.html') записывает отдельный файл, сохраняющий всю интерактивность. Открыв его в любом браузере, можно масштабировать диаграмму, наводить курсор и перемещаться по ней без Python.

Это лучший формат для публикации живой диаграммы, которую можно исследовать.

Выбор имени файла

Имена важны, когда Вы создаёте много экспортированных файлов. Имя с временной меткой, преобразованное в безопасный идентификатор, предотвращает совпадения. Это обычная работа со строками.

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')

Экспорт статического изображения

Для PDF, презентаций или электронных писем требуется статическое изображение. fig.write_image('chart.png') создаёт PNG, JPEG, SVG или PDF. Для этого необходимо установить движок kaleido.

Статические изображения теряют интерактивность, но их можно встроить куда угодно.

Выбор формата

Подбирайте формат под задачу:

HTML интерактивное исследование, веб-страницы
PNG/JPEG растровые изображения, подходят для презентаций и электронной почты
SVG векторное изображение, масштабируется без размытия для печати
PDF документы

Небольшая таблица решений помогает быстро сделать выбор.

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

Встраивание в страницу

Чтобы встроить диаграмму в существующий сайт без полного HTML-файла, используйте fig.to_html(full_html=False, include_plotlyjs='cdn'). Он возвращает только HTML-фрагмент диаграммы, который можно вставить в шаблон.

Загрузка plotly.js из CDN уменьшает размер страницы.

Подключение библиотеки

Для интерактивного HTML нужна библиотека plotly.js. Варианты для include_plotlyjs:

True встроить её (большой размер, работает без сети)
'cdn' подключить ссылку на CDN (малый размер, нужен интернет)
False предположить, что страница уже загрузила её

Выбирайте вариант с учётом необходимости работы без сети и размера страницы.

Разрешение при экспорте

Для статических изображений управляйте размером и чёткостью с помощью width, height и scale. Значение scale=2 удваивает плотность пикселей, поэтому изображение остаётся чётким на экранах с высоким разрешением.

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

Преобразование через JSON

Объект диаграммы можно сериализовать с помощью fig.to_json() и восстановить с помощью plotly.io.from_json(). Это удобно для кэширования диаграмм или их передачи между сервером и браузером.

JSON полностью описывает данные и макет.

Воспроизводимость

Когда Вы делитесь экспортированным результатом, сохраняйте и скрипт, который его создал. PNG нельзя отредактировать заново, но код может построить диаграмму ещё раз с новыми данными. Считайте источником истины код, а не изображение.

Встраивание в записные книжки и Markdown

В Jupyter график автоматически отображается внутри записной книжки, если он является последним выражением в ячейке. Для статической документации экспортируйте изображение и укажите ссылку на него из Markdown. Для интерактивной документации вместо этого встраивайте фрагмент HTML.

Выбирайте интерактивный HTML, если читателю полезно исследовать данные, а статическое изображение — если ему нужно только посмотреть на них.

Быстрая проверка

Проверьте свои знания об экспорте.

Итоги

Вы научились делиться графиками:

write_html для интерактивных автономных файлов
write_image с библиотекой kaleido для PNG/SVG/PDF
to_html(full_html=False) для встраивания фрагмента; include_plotlyjs управляет подключением библиотеки
Используйте scale для изображений высокого разрешения и сохраняйте исходный код для воспроизводимости

Часто задаваемые вопросы

Урок «Экспорт и встраивание» бесплатный?

Да — полный текст урока «Экспорт и встраивание» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Python Academy, подпишись на CoddyKit PRO. Курс Python Academy содержит 4 уроков всего.

Чему я научусь в уроке «Экспорт и встраивание»?

Сохраняйте фигуры и делитесь ими Ты практикуешь Python Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Python Academy?

Предыдущий опыт не требуется. Python Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Экспорт и встраивание»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Python Academy?

Да. Каждый урок Python Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Python Academy