פיתוח/הרחבת שלום עולם ל־LibreOffice

TDF LibreOffice Document Liberation Project בלוגים קהילתיים Weblate Nextcloud Redmine Ask LibreOffice תרומה

• דף הבית של הוויקי
• פיתוח
• עיצוב
• אבטחת איכות
• אירועים
• תיעוד
• אתר
• תרגום
• נגישות
• שיווק
• גיוון
• עזרה עם הוויקי

• הרחבות
• מאגר
• אתר
• תמיכה בשפות
• איך: לדווח על תקלה
• איך: להתקין הרחבה
• פיתוח הרחבה

במדריך הזה ניצור הרחבה ל־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).

Sub HelloWorldMacro
   MsgBox "Hello, World!"
End Sub

שלב 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) לך 2024.

שלב 6. הוספת רישיון

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

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

שלב 7. הוספת קובץ manifest

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

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

<?xml version="1.0" encoding="UTF-8"?>
<manifest:manifest>
 <manifest:file-entry manifest:full-path="HelloWorldLibrary/" manifest:media-type="application/vnd.sun.star.basic-library"/>
 <manifest:file-entry manifest:full-path="pkg-description/pkg-description.en" manifest:media-type="application/vnd.sun.star.package-bundle-description;locale=en"/>
 <manifest:file-entry manifest:full-path="Addons.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
</manifest:manifest>

שלב 8. הוספת תמונות

1) בתוך תיקיית helloworld, יש ליצור תת־תיקייה בשם icons.

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

שלב 9. הוספת קובץ התיאור

1) בתוך תיקיית helloworld, יש ליצור קובץ בשם description.xml.

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

<?xml version='1.0' encoding='UTF-8'?>
<description
 xmlns="http://openoffice.org/extensions/description/2006"
 xmlns:dep="http://openoffice.org/extensions/description/2006"
 xmlns:xlink="http://www.w3.org/1999/xlink">
    <identifier value="org.broffice.helloworldmacro"/>
    <icon>
        <default xlink:href="icons/image_42.png" />
    </icon>
    <version value="1.0"/>
    <registration>
        <simple-license  accept-by="admin" default-license-id="ID0" suppress-on-update="true" >
        <license-text xlink:href="registration/license.txt" lang="en" license-id="ID0" />
	</simple-license>
    </registration>
    <publisher>
        <name xlink:href="mailto:youremail@smt.com">Your Name</name>
    </publisher>
    <display-name>
        <name>Hello World</name>
    </display-name>
</description>

שלב 10. הוספת כפתור לסרגל הכלים של LibreOffice Calc

1) בתוך תיקיית helloworld, יש ליצור קובץ בשם Addons.xcu.

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

שלב 11. זה מבנה הקבצים שלנו עד כה

שלב 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 מחדש.

Note: if you get a "!link" warning error message when trying to install the extension, remove the HelloWorldLibrary before trying to install the extension, as LibreOffice cannot install an extension over a macro library of the same name:

• Open LibreOffice Calc. From the Menu Bar, choose Tools > Macros > Organize Macros> LibreOffice Basic
• Click the Organizer button, click the Libraries tab, select HelloWorldLibrary from the Library list, then click the Delete button, and confirm that you want to delete the library.
• You should now be able to install the extension using steps 1 to 4 above.

מסקנה

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