TOP

كيفية تضمين نص Python البرمجي في ملف ODS

الوصف

يمنح LibreOffice Calc المستخدمين القدرة على إنشاء وحدات ماكرو خاصة بهم بلغة Python، ولكن هذه الوحدات لا يمكن حفظها إلا على جهاز الكمبيوتر الخاص بالمستخدم، أي في البرنامج نفسه. لسوء الحظ، لا يحتوي LO Calc على وظيفة مضمنة لحفظ نصوص Python البرمجية في ملف *.ods نفسه، مما يخلق إزعاجًا عند العمل مع هذه النصوص، حيث لا يمكن نقلها مع البيانات إلى مستخدم آخر.

يمكن حل هذه المشكلة يدويًا فقط، وذلك بإعادة تجميع ملف *.ods وإضافة نصوص Python البرمجية الضرورية.

إذن، دعنا نتعرف على كيفية تضمين نصوص Python البرمجية في ملف ODS لإتاحة إرسالها إلى مستخدمين آخرين.


مجلد Python

يتم حفظ جميع وحدات ماكرو Python في المجلد التالي:

%APPDATA%\LibreOffice\4\user\Scripts\python

إذا كانت المجلدات Scripts و python غير موجودة، فأنت بحاجة إلى إنشائها يدويًا.

رمز ماكرو Python

أدناه هو نص Python البرمجي لوحدة الماكرو HelloPython، الذي يكتب العبارة "Hello Python!" في الخلية "B8" في برنامج LibreOffice Calc.

لإضافة وحدة ماكرو جديدة، أنشئ ملفًا myPyScripts.py وافتحه باستخدام Notepad++ (أو Windows Notepad) وانسخ النص التالي إليه:

from scriptforge import CreateScriptService

def HelloPython():
    doc = CreateScriptService("Calc")
    doc.SetValue("B8", "Hello Python!")
    return None

ثم، أغلق Notepad++ وعُد إلى LibreOffice Calc. لتشغيل هذا النص البرمجي، افتح القائمة Tools - Macros - Organise Macros - Python...، اختر "My Macros"، افتح المجلد "myPyScripts" وبعد اختيار HelloPython اضغط على الزر Run.

نقل نص Python البرمجي إلى ملف ODS

لنقل نص Python البرمجي إلى ملف *.ods، يجب فك ضغطه باستخدام أي أداة أرشيف (7-zip, WinRAR وما إلى ذلك) إلى مجلد منفصل. نعم، هذا صحيح، ملف *.ods الخاص بك هو مجرد أرشيف لمجموعة من المجلدات والملفات.

بعد ذلك، في هذا المجلد المفكوك، أنشئ مجلدًا فرعيًا Scripts، وداخله مجلدًا فرعيًا python. الخطوة التالية، انسخ إلى المجلد python الملف myPyScripts.py.

يجب أيضًا تحديد مسار الملف الذي يوجد فيه ماكرو Python الخاص بك بشكل صريح. للقيام بذلك، في المجلد META-INF قم بتحرير الملف manifest.xml، بإضافة السطر التالي:

<manifest:file-entry manifest:full-path="Scripts/python/myPyScripts.py" manifest:media-type="application/binary"/>

الآن، قم بضغط محتويات المجلد الذي تم فك ضغطه مسبقًا مع تغييراتك في أرشيف *.zip. بعد ذلك، أعد تسمية هذا الأرشيف بتغيير اسمه (حتى لا يتم الكتابة فوق ملفك الأصلي) والامتداد من *.zip إلى *.ods.

استخدام الإضافة

يمكنك أيضًا استخدام مجموعة جاهزة من الوظائف و الأدوات المساعدة المكتوبة بلغة Python عن طريق تثبيت الإضافة YLC Utilities.

بعد ذلك، ستكون هذه الوظائف متاحة في جميع الملفات التي سيتم فتحها في LibreOffice Calc.

قائمة أدوات YLC في LO Calc

قائمة أدوات YLC في LO Calc

قائمة أدوات YLC في Excel

قائمة أدوات YLC في Excel