Help:Extension:Translate/Page translation example/he

This page is a translated version of the page Help:Extension:Translate/Page translation example and the translation is 40% complete.
Outdated translations are marked like this.
סרטון של סדנה המדגימה את השימוש ברחבה:תרגום .

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

There is also a set of video tutorials that parallel part of this tutorial that you can use to help learn how to use the Translate extension:

Please note:
  • Consequently, we will consider that you are a Translation administrator on your wiki (...if you can, you should declare yourself now !), otherwise you may not access to some of the links/pages described here.
  • Remember also, that this is only a simple tutorial. Example of marked code prepared by best practices you can see here
Let's go!

שלב 1: לפני שמתחילים

 
עמוד התחלתי

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

דף זה מתאר את העירייה הדמיונית של פרוקינגה.

Here is the wikicode associated to it :

Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
  • 1. Go to the page [[Fréttinga]] in your wiki (or a draft page) and click create.
  • 2. Paste the above content and save it.

שלב 2: הכנה

 
הכנה: סימון הדף לתרגום

כעת יש לנו דף עם מעט טקסט.

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

The page is ready for translation ? So let's see how to request translation :

  • 3. Edit [[Fréttinga]]
  • 4. Wrap the whole content inside ‎<translate>...‎</translate> tags as shown below
  • 5. Save the page
<translate>
Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
</translate>

אינך צריך להוסיף תגי ‎<translate> לכל האלמנטים, או להוסיף סמנים כמו $2; התוסף עושה את זה בשבילך.

You should never add markers like <!--T:1--> yourself; the extension does it for you in the next step.

שלב 3: הפעלת תרגומים

לאחר שמירת הדף, תראה קישור בחלק העליון של הדף שאומר "סמן דף זה לתרגום" - או "דף זה מכיל שינויים שאינם מסומנים לתרגום" אם אינך מנהל תרגום. אם אתה מנהל תרגום, לחץ על הקישור "סמן דף זה לתרגום". הדף פוצל אוטומטית לארבע יחידות תרגום. היחידה הראשונה היא כותרת העמוד, השנייה היא הפסקה הראשונה, השלישית היא כותרת הפסקה השנייה, והרביעית היא הטקסט של הפסקה השנייה. אלה הם פריטי היסוד של דפים הניתנים לתרגום: כל יחידה אינה עצמאית; ניתן לתרגם אותו וחייב בכללותו; שינויים בתוכן העמוד עוקבים אחר רמת היחידה. ניתן לסדר מחדש את היחידות או למחוק אותן. If you are a translation administrator, then click on the "Mark this page for translation" link. The page has been automatically split into four translation units. The first unit is the title of the page, the second is the first paragraph, the third is the header of the second paragraph, and the fourth is the text of the second paragraph. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to the page content are tracked into the unit level. Units can be rearranged or deleted.

There is also a view of the page translation page template; this will be covered in later steps. You can give names to the translation units, but in this example, we choose to stick with the defaults.

  • 6. Click the "Mark this page for translation" link
  • 7. Ensure that the page body is split into three units correctly
  • 8. Click the "Mark this version for translation" button (reminder: you have to be a Translation administrator for this)
  • 9. Return to the page

Now you will see a new link at the top, "Translate this page", that lets translators translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

שלב 4: ביצוע שינויים

Understanding how changes are impacting translations and translations units

 
עיבוד שינויים

Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like <!--T:1-->. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too.

When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. Markers you have deleted will also be automatically deleted by the bot in the existing translations.

If you do minor changes to an existing translation unit (adding a few words or a link to a paragraph), keep the marker. If you change a whole paragraph (delete and rebuilt it), delete the marker. This way, translators will have different tasks, between reviewing a fuzzy translation or create a new translation.

let's modify something !

Here is what you will do :

<languages /> <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. It has marvelous beaches with a lot of seagulls. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively the following summer. </translate>

  • 10. Make some additions as highlighted above
  • 11. Click the "marked for translation" link at the top
  • 12. Observe the changes
  • 13. Click the "Mark for translation" button (reminder: you have to be a Translation administrator for this)
  • 14. Return to the original page

If you made translations as suggested in the previous step, you can now see those translations linked at the top of the page. You will also see that the translation is not 100 % up to date. If you go to the translation view, you see that the unit is marked as in need of updating.

תרגומים מיושנים יודגשו על ידי רקע ורוד; שמראה שהתרגום אינו שלם.

תצוגת תבנית התרגום עוזרת לך לראות אילו חלקים של הדף קבועים בכל גרסאות השפה ("תבנית עמוד התרגום", כלומר החלקים מחוץ לתגיות התרגום) ומראה לך גם אם יחידות הועברו או נמחקו.

יתכן שיהיה עיכוב קל לפני עדכון כל הגרסאות המתורגמות מכיוון שיכולים להיות דפים רבים לעדכון.

כעת אתה יודע את היסודות, אך הדרכה זו תמשיך עם דברים נוספים שאתה צפוי להיתקל בהם.

שלב 5: הוספת רכיבי וויקי אחרים

 
התוצאה הסופית

Adding an image, a category and a list with translation markers

You have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation.

הסרנו גם פיסקה, כולל סמן היחידות שלה, והחלפנו אותה ברשימה, כך שתוכל לראות מה קורה.

  • 15. Add an image, a category and a list to the page as shown below
  • 16. Save the page
  • 17. Click the link "marked for translation" at the top of the page
  • 18. Verify that the changes look as intended
  • 19. Click the "Mark this version for translation" button
  • 20. Return to the translatable page

<languages /> [[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]] <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summertime. It has marvelous beaches with a lot of [[Special:MyLanguage/Seagull|seagulls]]. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 [[Category:Municipalities]] </translate>

תיעוד תרגום

Allowing to translate only the picture title:

[[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]]

Or allowing to change the image file in the translated page (for localized version for example) and the title:

<translate>[[File:Torsö.jpg|thumb|A typical view of Fréttinga]]</translate>

כאן תוכלו לראות שהשארנו את רוב סימון התמונה מחוץ ליחידת תרגום ויש לנו זאת בתבנית דף התרגום. (reminder: the translation page template doesn't change between the different translated pages) זה בדרך כלל בסדר, אך לפעמים מתרגמים עשויים לרצות לשנות את התמונה, במיוחד אם היא מכילה תוכן לשוני (טקסט). במקרים אלה בדרך כלל הכי קל לכלול את כל הסימון ביחידה (כפי שעשינו בקטגוריה).

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

 
התיעוד שהוספת מוצג כך למתרגם
  • 21. Click "Translate this page" link at the top
  • 22. Select "qqq - Page documentation" language
  • 23. Click the message name which contains the message "A typical view of Fréttinga"
  • 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

Content of the message not translate. Use only generally understanding language (english).

מידע על קישורים

[[Special:MyLanguage/Seagull]]

באופן דומה, עבור קישורים ישנן דרכים רבות לעשות זאת. השתמשנו ב- "[[Special:MyLanguage/Seagull]]", שמפנה אוטומטית לגרסה המתורגמת של הדף בהתאם לשפת הממשק של המשתמשים (אם תרגום זה קיים). זה לא פיתרון אולטימטיבי מכיוון שמשתמשים תמיד יופנו לשפת הממשק שבה הם משתמשים ולא לשפה שהם קוראים כרגע. Special:MyLanguage מפריע גם לSpecial:WhatLinksHere וגורם לו לא לעבוד. הדבר הטוב ב- Special:MyLanguage הוא שתמיד תקבל גרסה כלשהי של הדף, גם אם התרגום המבוקש אינו קיים.

אודות קטגוריות

בדוגמה זו, כל הקטגוריה היא יחידת תרגום. זה מאפשר למתרגמים לשנות אותו ל-[[Category:Municipalities/de]] או לכל מוסכמת שמות שתרצה להשתמש בה. אם זה היה מחוץ לתבנית התרגום, היית כולל את כל העמודים Foo, Foo / de, Foo / ru, Foo / ta וכן הלאה באותה קטגוריה. לפעמים זה בסדר, אבל בדרך כלל זה מסיח את תשומת הלב של המשתמשים. ודא שהמתרגמים שלך יודעים מה הכנס המקומי.

מידע על כותרות

כדי שהכותרות ייחשבו כאלמנטים מופרדים מאשר טקסט, אל תשכח להוסיף שורה ריקה (אם כבר אין כזו) בין הכותרת לפסקה שבאה אחריה.

הדוגמה הבאה תיצור רק יחידת תרגום אחת:

== Services ==
It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

זה ייצור שתי יחידות תרגום, כולל אחת לכותרת.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

הוספת שורה ריקה מאפשרת למתרגמים לדעת מתי הם יכולים לקחת הפסקה. בנוסף זה מונע בעיות עם ויקיטקסט.

מילים אחרונות

Operating on the whole page and its translations

It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages

Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !

כעת יצרת דף לתרגום וניסית את כל הפעולות הנפוצות שניתן לבצע בדפים הניתנים לתרגום.

Going deeper ?

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

ראו גם