Python Academy · Pelajaran

Mengekspor dan Menyematkan

Simpan dan bagikan figur

Mengekspor dan Menyematkan adalah pelajaran Python Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Python Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Python Academy mencakup 4 pelajaran total.

Membagikan Hasil Kerja

Grafik yang sudah selesai hanya berguna jika dapat dilihat orang lain. Figure Plotly dapat disimpan sebagai HTML interaktif, diekspor sebagai gambar statis, atau disematkan di halaman web dan laporan.

Pemilihan format yang tepat bergantung pada apakah pemirsa memerlukan interaktivitas.

Menyimpan HTML Interaktif

fig.write_html('chart.html') menulis file mandiri yang mempertahankan semua interaktivitas. Membukanya di peramban apa pun akan menyediakan fitur memperbesar, mengarahkan kursor, dan menggeser tanpa memerlukan Python.

Ini adalah format terbaik untuk membagikan grafik langsung yang dapat dijelajahi.

Memilih Nama File

Penamaan penting saat Anda membuat banyak ekspor. Nama yang diberi stempel waktu dan diubah menjadi slug mencegah benturan nama. Ini hanyalah pengolahan string biasa.

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

Ekspor Gambar Statis

Untuk PDF, slide, atau email, Anda memerlukan gambar statis. fig.write_image('chart.png') menghasilkan PNG, JPEG, SVG, atau PDF. Fitur ini memerlukan mesin kaleido yang sudah terpasang.

Gambar statis kehilangan interaktivitas, tetapi dapat disematkan di mana saja.

Memilih Format

Sesuaikan format dengan penggunaannya:

HTML untuk penjelajahan langsung dan halaman web
PNG/JPEG berupa raster, cocok untuk slide dan email
SVG berupa vektor, dapat diperbesar tanpa buram untuk keperluan cetak
PDF untuk dokumen

Tabel keputusan kecil membuat pemilihan menjadi cepat.

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

Menyematkan di Halaman

Untuk menyematkan grafik di situs yang sudah ada tanpa file HTML lengkap, gunakan fig.to_html(full_html=False, include_plotlyjs='cdn'). Fungsi ini mengembalikan fragmen HTML grafik saja, yang kemudian Anda tempelkan ke templat.

Memuat plotly.js dari CDN membuat halaman tetap ringan.

Menyertakan Pustaka

HTML interaktif memerlukan pustaka plotly.js. Pilihan untuk include_plotlyjs:

True menyertakannya dalam satu paket (besar, dapat digunakan luring)
'cdn' menautkan ke CDN (kecil, memerlukan internet)
False menganggap halaman sudah memuatnya

Pilih berdasarkan kebutuhan luring dan ukuran halaman.

Resolusi Ekspor

Untuk gambar statis, kendalikan ukuran dan ketajamannya dengan width, height, dan scale. Nilai scale=2 menggandakan kepadatan piksel agar gambar tetap tajam pada layar beresolusi tinggi.

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

Serialisasi JSON Bolak-Balik

Figure dapat diserialisasi dengan fig.to_json() dan dibangun kembali dengan plotly.io.from_json(). Ini berguna untuk menyimpan Figure dalam cache atau mengirimkannya antara server dan peramban.

JSON menjelaskan data dan tata letak secara lengkap.

Reprodusibilitas

Saat membagikan hasil ekspor, simpan juga skrip yang membuatnya. PNG tidak dapat diedit kembali, tetapi kode dapat membuat ulang grafik dengan data baru. Perlakukan kode, bukan gambar, sebagai sumber kebenaran.

Penyematan di Notebook dan Markdown

Di Jupyter, gambar secara otomatis ditampilkan sebaris jika menjadi ekspresi terakhir dalam sebuah sel. Untuk dokumentasi statis, ekspor gambar lalu referensikan gambar tersebut dari Markdown. Untuk dokumentasi langsung, sematkan fragmen HTML sebagai gantinya.

Pilih HTML interaktif jika pembaca akan terbantu dengan menjelajahinya, dan pilih gambar statis jika mereka hanya perlu melihatnya.

Pemeriksaan Singkat

Uji pengetahuan Anda tentang ekspor.

Ringkasan

Anda telah mempelajari cara membagikan gambar:

write_html untuk berkas mandiri yang interaktif
write_image (dengan kaleido) untuk PNG/SVG/PDF
to_html(full_html=False) untuk menyematkan fragmen, dengan include_plotlyjs yang mengatur pustakanya
Gunakan scale untuk gambar beresolusi tinggi, dan simpan kode sumber agar hasilnya dapat dibuat ulang

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mengekspor dan Menyematkan” gratis?

Ya — teks lengkap “Mengekspor dan Menyematkan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Python Academy, upgrade ke CoddyKit PRO. Kursus Python Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mengekspor dan Menyematkan”?

Simpan dan bagikan figur Kamu berlatih Python Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Python Academy?

Tidak diperlukan pengalaman sebelumnya. Python Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Mengekspor dan Menyematkan” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Python Academy ini?

Ya. Setiap pelajaran Python Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Python Academy