Python Academy · درس

التصدير والتضمين

احفظ الأشكال وشاركها

التصدير والتضمين درس مجاني في Python Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Python Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Python Academy 4 دروس في المجموع.

مشاركة عملك

لا يكون المخطط المكتمل مفيدًا إلا إذا تمكن الآخرون من رؤيته. ويمكن حفظ أشكال Plotly بتنسيق HTML تفاعلي، أو تصديرها كـ صور ثابتة، أو تضمينها في صفحات الويب والتقارير.

يعتمد اختيار التنسيق المناسب على حاجة الجمهور إلى التفاعلية.

حفظ HTML التفاعلي

ينشئ fig.write_html('chart.html') ملفًا مستقلًا يحتفظ بكل التفاعلية. ويؤدي فتحه في أي متصفح إلى توفير التكبير والتحويم والتحريك دون الحاجة إلى Python.

وهذا هو أفضل تنسيق لمشاركة مخطط حي قابل للاستكشاف.

اختيار اسم الملف

تكتسب التسمية أهمية عند إنشاء العديد من الملفات المصدّرة. فالاسم المرفق بطابع زمني والمحوّل إلى slug يتجنب تعارض الأسماء. وهذا مجرد تعامل عادي مع السلاسل النصية.

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 مجددًا، لكن يمكن للكود إعادة إنشاء المخطط ببيانات جديدة. تعامل مع الكود، لا الصورة، باعتباره مصدر الحقيقة.

التضمين في دفاتر Jupyter و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 يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Python Academy