Довідка:Розширення:Переклад/Приклад перекладу сторінки

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 уже встановлено і налаштовано. Може, у Вас уже є на думці сторінка, яка потребує перекладу, або ж можете використати сторінку прикладу, наведену нижче, щоб спробувати зробити описані тут кроки у Вашій власній вікі.

Це сторінка, що описує вигаданий муніципалітет Fréttinga.

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>

You don't need to add ‎<translate> tags to all elements.

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

Крок 3: Увімкнення перекладів

Після збереження сторінки, ви побачите посилання зверху із фразою «Позначити сторінку для перекладу» (або «На цій сторінці було здійснено зміни, які не відмічені для перекладу», якщо Ви не адміністратор перекладів). Якщо Ви не адміністратор перекладів, натисніть на це посилання. Сторінку було автоматично поділено на 4 блоки перекладу. Перший блок — назва сторінки, другий — перший розділ, третій — заголовок другого розділу, четвертий — текст другого розділу. Це основні частини перекладабельної сторінки: кожен блок незалежний, його можна і треба перекладати, як одне ціле; зміни вмісту сторінки відстежуються на рівні блоків. Блоки можна переставляти місцями і видаляти.

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.

Застарілі переклади підсвічуються рожевим фоном; користувачу вказується, що переклад незавершений.

Шаблон перекладу допомагає побачити, які частини сторінки стабільні в усіх мовних версіях («шаблон перекладу сторінки», тобто частини поза тегами translate), а ще показує, чи блоки були переміщені або видалені.

Може виникнути невелика затримка із оновленням перекладених версій, оскільки сторінок до оновлення може бути багато.

Зараз Ви знаєте основне, але далі у цьому посібнику ще є речі, з якими Ви, імовірно, зіткнетесь.

Крок 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 і не дає їй працювати. Добре те, що Ви завжди отримуєте якусь версію сторінки, навіть якщо запитаного перекладу не існує.

Про категорії

У цьому прикладі категорія повністю включена в блок перекладу. Це дозволяє перекладачам змінити її на [[Category:Municipalities/de]] або відповідно до домовленості щодо категорій. Якщо б категорії були поза шаблоном перекладу, усі сторінки Foo, Foo/de, Foo/ru, Foo/ta і под. були б в одній і тій же категорії. Інколи це добре, але зазвичай відволікає користувачів. Переконайтесь, що Ваші перекладачі знають про локальну домовленість.

About titles

To have titles considered as separated elements than text, don't forget to add a blank line (if there isn't one already) between the title and the paragraph following it.

The following example will only create one translation unit:

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

The next one will create two translation units, including one for the title.

== Services ==

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

Adding a blank line allows translators to know when they can take a break. Plus it prevents issues with wikitext.

На завершення

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 ?

Для детальної інформації або якщо Ви хочете зрозуміти розширення глибше продовжуйте читання на сторінці детальної документації можливості перекладу сторінок. На ній знайдете можливі варіанти підходів до посилань, категорій та шаблонів, а також за і проти використання більших і менших блоків перекладу.

Див. також