voila
v0.5.8
عرض دفاتر ملاحظات Jupyter الحية باستخدام عناصر واجهة المستخدم التفاعلية.
يقوم Voilà بتحويل دفاتر ملاحظات Jupyter إلى تطبيقات ويب مستقلة.
على عكس دفاتر الملاحظات المعتادة المحولة إلى HTML، يحصل كل مستخدم يتصل بتطبيق Voilà tornado على نواة Jupyter مخصصة يمكنها تنفيذ عمليات الاسترجاعات للتغييرات في عناصر واجهة مستخدم Jupyter التفاعلية.
افتراضيًا، لا يسمح Voilà بتنفيذ الطلبات من الواجهة الأمامية، مما يمنع تنفيذ تعليمات برمجية عشوائية.
افتراضيًا، يتم تشغيل Voilà باستخدام خيار strip_sources ، الذي يزيل خلايا الإدخال من دفتر الملاحظات المعروض.
يمكن تثبيت Voilà باستخدام مدير الحزم mamba (أو conda) من conda-forge
mamba install -c conda-forge voila
أو من باي بي آي
pip install voila
يوفر Voilà ملحق JupyterLab الذي يعرض معاينة Voilà للكمبيوتر الدفتري الخاص بك في جزء جانبي.
بدءًا من JupyterLab 3.0، يتم تثبيت الامتداد تلقائيًا بعد تثبيت voila باستخدام pip install voila .
إذا كنت ترغب في تثبيت الامتداد من المصدر، فقم بتشغيل الأمر التالي.
jupyter labextension install @voila-dashboards/jupyterlab-preview
لعرض مثال bqplot على دفتر الملاحظات كتطبيق مستقل، قم بتشغيل voila bqplot.ipynb . لخدمة دليل دفاتر ملاحظات jupyter، قم بتشغيل voila بدون أي وسيطة.
على سبيل المثال، لعرض مثال دفتر الملاحظات bqplot.ipynb من هذا المستودع باستخدام Voilà، يمكنك أولاً تحديث بيئتك الحالية بمتطلبات هذا الكمبيوتر الدفتري (في هذه الحالة في بيئة conda وعرض دفتر الملاحظات باستخدام
mamba env update -f .binder/environment.yml cd notebooks/ voila bqplot.ipynb
لمزيد من خيارات سطر الأوامر (على سبيل المثال، لتحديد رقم منفذ بديل)، قم بتشغيل voila --help .
notebook أو jupyter_serverيمكن أيضًا استخدام Voilà كملحق لخادم Jupyter، سواء مع خادم الكمبيوتر المحمول أو مع jupyter_server.
لتثبيت ملحق خادم Jupyter، قم بتشغيل
jupyter serverextension enable voila jupyter server extension enable voila
عند تشغيل خادم Jupyter، يمكن الوصول إلى تطبيق Voilà من عنوان url الأساسي المضاف إليه voila .
للبدء في استخدام Voilà، راجع الوثائق الكاملة:
https://voila.readthedocs.io/
يوضح المثالان التاليان كيف يمكن تحويل دفتر ملاحظات Jupyter المستقل إلى تطبيق منفصل، من خلال تكامل سطر الأوامر.
يمكن عرض مصادر دفتر Jupyter في تطبيق Voilà إذا تم ضبط الخيار strip_sources على False .
تم بناء Voilà على تنسيقات وبروتوكولات Jupyter القياسية، وهو لا يلتزم بلغة برمجة الكمبيوتر المحمول. في هذا المثال، نقدم مثالًا لتطبيق Voilà المدعوم من C++ Jupyter kernel xeus-cling ومشروع xleaflet.
معرض Voilà عبارة عن مجموعة من لوحات المعلومات والتطبيقات المباشرة التي تم إنشاؤها باستخدام أدوات Voilà وJupyter.
تعتمد معظم الأمثلة على مكتبات عناصر واجهة المستخدم مثل ipywidgets وipyleaflet وipyvolume وbqplot وipympl، وتعرض كيفية إنشاء تطبيقات ويب معقدة تعتمد بالكامل على دفاتر الملاحظات.
يمكن إضافة أمثلة جديدة إلى المعرض باتباع الخطوات المذكورة في مستودع معرض/معرض voila.
راجع CONTRIBUTING.md لمعرفة كيفية المساهمة وتهيئة بيئة التطوير.
يعتمد Voilà على nbconvert وjupyter_server.
نحن نستخدم نموذج حقوق الطبع والنشر المشترك الذي يمكّن جميع المساهمين من الحفاظ على حقوق الطبع والنشر لمساهماتهم.
تم ترخيص هذا البرنامج بموجب ترخيص BSD-3-Clause. راجع ملف الترخيص للحصول على التفاصيل.
