Documentation/Screenshots/he

צילומי מסך לתיעוד
This page describes how to create screenshots of LibreOffice dialogs and include them in LibreOffice documentation/help. The precondition is to have a git clone of LibreOffice help repository and/or to build core LibreOffice code including help ( switch). For screenshots in multiple languages, build with, where $language list is a list of two- or three-letter language codes separated by space, for example

עקרונות בסיסיים
לכל חלונית של LibreOffice יש מזהה עזרה שמבדיל אותה באופן ייחודי (כדי שסיירי עזרה ידעו איזו עזרה להציג למשתמש כשהמשתמש מבקש אותה לחלונית מסוימת). מזהה העזרה בדרך כלל נראה ככה:

i.e. it resembles a path where this dialog's .ui file is stored. We have decided to have IDs of dialog screenshots (and thus file paths where screenshot images are stored) copy their help IDs in order to avoid maintaining of alternate mapping. Given that, the screenshot of the dialog above will be found in the following path:

and its localized version (where $language_code is a two- or three-letter code of the given language) in:

Within LibreOffice (help) source tree, files with screenshot images that are included in help pages (.xhp files) are stored in the following folder:

in the paths corresponding to their screenshot IDs as outlined above.

יצירת סדרה של צילומי מסך אוטומטית
כדי ליצור צילומי מסך של כל חלונית שהיא ב־LibreOffice בבת אחת, יש להריץ את:

בתיקיית הבסיס של עץ קוד ה־LibreOffice שלך. ניתן גם ליצור צילומי מסך של מודולים פרטניים. למשל, הפקודה הבאה מייצרת צילומי מסך של כל החלוניות של LibreOffice Calc (sc):

לאחר השלמת הפקודה הזאת, צילומי המסך יופיעו בתיקייה הבאה בעץ קוד המקור של ה־LibreOffice שלך:

in the paths corresponding to their screenshot IDs as outlined above. If you have built LibreOffice with multiple language/locale support (, see above), this screenshot run will automatically create screenshots in all languages you are building with.

יצירת צילומי מסך ידנית
To create dialog screenshots from running LibreOffice, you need to activate screenshotting mode (akin to experimental mode) in, the relevant configuration key is. Once screenshotting mode is active, right mouse click into any dialog action area (where "OK", "Cancel" etc. buttons are) will make a context menu appear:



Click Screenshot item of the context menu to create screenshot of the current dialog. In the dialog that appears, you'll see a screenshot preview and a text area. If you're happy with the result, click Save Screenshot... button to store the screenshot into the folder of choice, preferably directly to  folder and the path corresponding to their screenshot ID.

הסבר בסרטון
יש להפעיל כתוביות באנגלית:

הוספת צילומי מסך לעמודי עזרה

 * 1) If you have created screenshot with the help of , copy the screenshot image from   folder to   folder
 * 2) If you have created screenshot manually, the best approach is to save it directly to , respecting screenshot ID path.

Now you can use your preferred way of editing help files (either manually or using HelpAuthoring extension). A .xhp snippet to be included in the help file can look for example like this (for the above area tab dialog, path to screenshot image highlighted):

Area dialog

לחלופין, בעת צילום המסך, ניתן להעתיק ולהדביק את מקטע הקוד כפי שנוצר שנוצר בחלונית ההערות על צילום המסך:



הגשת השינויים שלך
אין הבדל בין הגשת שינויים אחרים לתוכן העזרה, הדבר היחידי שיש לשים אליו לב הוא הוספת קובצי צילומי מסך תחת בקרת הגרסאות git: