Development/Create a Hello World LibreOffice extension/he

במדריך הזה ניצור הרחבה ל־LibreOffice Calc באמצעות שפת LibreOffice Basic. זו הרחבה פשוטה שנועדה להדגים את היסודות של הרחבה ב־LibreOffice. ההרחבה תוסיף כפתור (לצד הכפתור ייצוא כ־PDF) לסרגל הכלים הרגיל וכשלוחצים עליו תופיע חלונית עם Hello, World!‎. קוד המקור למדריך הזה נמצא ב־github.



שלב 1. יצירת תיקייה להרחבה שלנו
1) לבחור מיקום וליצור תיקייה בשם helloworld.



שלב 2. יצירת ספרייה למאקרו שלנו
1) לפתוח את LibreOffice Calc. מסרגל התפריטים לבחור כלים > תסריטי מאקרו > ארגון תסריטי מאקרו > LibreOffice Basic.

2) ללחוץ על הכפתור מארגן.



3) לבחור בלשונית ספריות וללחוץ על הכפתור חדש.



4) לקרוא לה HelloWorldLibrary וללחוץ על אישור. אפשר לראות את הספרייה שיצרנו ברשימת הספריות.





5) ללחוץ על הכפתור סגירה כדי לצאת מחלונית מארגן תסריטי המאקרו של LibreOffice Basic.

שלב 3. יצירת המאקרו
1) לבחור תסריטי המאקרו שלי > HelloWorldLibrary ‏> Module 1 וללחוץ על הכפתור עריכה.



2) להעתיק את המאקרו שלהלן ולהדביק אותו לסביבת הפיתוח של LibreOffice Basic, לאחר מכן לשמור (Ctrl+S).



שלב 4. ייצוא התיקייה שלך
1) מסרגל התפריטים של סביבת הפיתוח של LibreOffice Basic, יש לבחור בכלים > ארגון תסריטי מאקרו > LibreOffice Basic.

2) ללחוץ על הכפתור מארגן.



3) לבחור בלשונית ספריות ולבחור ב־HelloWorldLibrary מרשימת הספריות, לאחר מכן ללחוץ על הכפתור ייצוא.



4) לבחור בייצוא כספריית BASIC וללחוץ על אישור.



5) לשמור את הספריה בתוך תיקיית helloworld, לאחר מכן ללחוץ על סגירה כדי לצאת ממארגן תסריטי המאקרו של LibreOffice Basic ומתסריטי המאקרו של LibreOffice Basic. כפי שניתן לראות להלן, הספרייה שייוצאה מכילה 3 קבצים.



שלב 5. הוספת תיאור להרחבה שלנו
1) לעבור לתיקיית helloworld, בתוכה ליצור תת־תיקייה בשם pkg-description.



2) בתוך תיקיית pkg-description, יש ליצור קובץ בשם pkg-description.en.



3) להדביק את התוכן שלהלן לתוך הקובץ pkg-description.en, ללחוץ על שמירה (Ctrl+S) ולסגור את הקובץ.

הרחבת שלום עולם ל־LibreOffice. כל הזכויות שמורות (c) לך 2021.

שלב 6. הוספת רישיון
1) בתוך תיקיית helloworld,יש ליצור תיקייה בשם registration.

2) בתוך תיקיית registration, יש ליצור קובץ בשם license.txt ולהדביר לתוכו את התוכן מהקישור הזה. לאחר מכן לשמור (Ctrl+S) ולסגור את הקובץ.

שלב 7. הוספת קובץ manifest
1) בתוך תיקיית helloworld, יש ליצור תת־תיקייה בשם META-INF.

2) בתוך META-INF, יש ליצור קובץ בשם manifest.xml, לתוכו להדביק את התוכן שלהלן. לאחר מכן לשמור (Ctrl+S) ולסגור את הקובץ.

שלב 8. הוספת תמונות
1) בתוך תיקיית helloworld, יש ליצור תת־תיקייה בשם icons.



2) לגשת אל הקישור הזה ולהוריד את 2 התמונות שנמצאות שם, לשמור אותן לתיקיית icons.

שלב 9. הוספת קובץ התיאור
1) בתוך תיקיית helloworld, יש ליצור קובץ בשם description.xml.



2) יש להדביק את התוכן שלהלן לתוך הקובץ description.xml. לאחר מכן לשמור (Ctrl+S) ולסגור את הקובץ.

שלב 10. הוספת כפתור לסרגל הכלים של LibreOffice Calc
1) בתוך תיקיית helloworld, יש ליצור קובץ בשם Addons.xcu.

2) להעתיק את הקוד הזה ולהדביק אותו לתוך הקובץ Addons.xcu. לאחר מכן לשמור (Ctrl+S) ולסגור את הקובץ.

שלב 12. אריזת ההרחבה
1) בתוך תיקיית helloworld, יש לבחור את כל הקבצים (Ctrl+A).

2) מקש ימני ולכווץ לתוך helloworld.zip.



3) לשנות את השם של helloworld.zip ל־helloworld.oxt. כעת ההרחבה שלנו מוכנה ובצעד הבא אנחנו נתקין אותה ב־LibreOffice Calc.



שלב 13. התקנת ההרחבה שלנו ב־LibreOffice Calc
1) לפתוח את LibreOffice Calc ולבחור בכלים > מנהל הרחבות.

2) ללחוץ על כפתור ההוספה ולבחור את ההרחבה helloworld.oxt.

3) לאשר את הסכם הרישוי של הרחבת התוכנה.



4) ללחוץ על כפתור הסגירה ולהפעיל את LibreOffice Calc מחדש.

מסקנה
במדריך הזה, יצרנו הרחבת שלום עולם ל־LibreOffice Calc. את קוד המקור המלא ניתן למצוא ב־github.