Help:Extension:Translate/Page translation administration/uk

Що. Функція перекладу сторінок дозволяє контрольований переклад вікісторінок іншими мовами. Це означає, що вміст кожного перекладу буде зазвичай ідентичний оригінальній сторінці. This is opposed to, for example, the different language version of articles in different Wikipedias, which are fully independent of each other. It is assumed that pages are only translated from one primary language to other languages, but translators can take advantage of translations in other languages too if they exist.

Чому. Без жодної допомоги, перекладання більш ніж кількох сторінок іншими мовами стає в кращому випадку убиванням часу, в гіршому — марне казна-що. З функцією перекладу сторінок ви можете уникнути безладу і внести структурованість у процес перекладу. Ключова ідея полягає у тому, що вихідний текст поділяється на менші шматки, кожен з яких можна перекласти окремо. Коли вихідних текст сегментований, усі зміни можуть бути розмежовані і перекладачам просто треба оновити переклад тих частин, у вихідному тексті яких стались зміни. Це також дає змогу перекладачам працювати з блоком посильного розміру і ділити роботу між кількома людьми або продовжувати переклад іншим разом, оскільки їм не треба робити усе одразу. With the page translation feature you can avoid the mess and bring structure to the translation process. The core idea is that the source text is segmented into smaller units, each of which will be translated individually. When the source text is segmented into units, all changes can be isolated and translators only need to update the translations of units which have had changes in source text. This also enables translators to work on units of manageable size and share the work between multiple translators or continue the translation in later sessions, because they don't need to do all at once.

Хто. Ця сторінка детальніше розвиває посібник з перекладу сторінок, показуючи глибше бачення того, як працює система, і пропонує кращі рішення для широкого спектру випадків. Ця сторінка призначена для адміністраторів перекладу і загалом усіх, хто редагує вихідний текст перекладабельних сторінок, навіть якщо у них немає доступу до адміністраторських функцій позначення змін для перекладу. This page is intended for page translation administrators and generally for everyone who edits the source text of translatable pages, even if they don't have the access to the administrative features of approving changes for translation.

To apply for extended rights as a translation administrator, go to Project:Requests.

Життя перекладабельної сторінки
Ролі. Численні люди задіяні у процесі написання і перекладу вікісторінки: початковий автор створює сторінку, хтось виправляє орфографічні помилки, адміністратор перекладу позначає сторінку на переклад, перекладачі перекладають, хтось вносить зміни на сторінки, адміністратор перекладу позначає ці зміни до перекладу, а перекладачі оновлюють переклади. Ці ролі можуть накладатися більше чи менше, але кінцева відповідальність за безпроблемний переклад лежить на адміністраторі перекладу. Адміністратор вирішує, коли сторінка готова для першого перекладу, перевіряє, щоб поділ на блоки відповідав цілям і підтверджує (або виправляє) зміни. Those roles may overlap more or less, but the ultimate responsibility for a hassle-free translation is left for the page translation administrator. The administrator decides when the page is ready for translation the first time, ensures that the segmentation serves a purpose and approves (or corrects) changes.

Підготовка. Аби щось було перекладено, його спершу треба написати. Якщо Ви маєте вже готові переклади, виконані без використання розширення Translate, див. нижче розділ про міграцію перекладів. Якщо потрібно багато перекладів і швидко, дуже важливо, щоб вихідний текст був у гарній формі. До того, як позначати сторінку на переклад, попросіть когось вичитати її текст і, якщо це можливо, попросіть спеціаліста-мовника зробити його більш чітким і зрозумілим. Складні слова і незрозумілі речення стають перешкодою для багатьох волонтерських перекладів. Вікірозмітка також може викликати проблеми у перекладачів, але як адміністратор перекладу, Ви можете уникнути цих складнощів, див. розділ про поводження з вікірозміткою. Зміни, які Ви вносите у вихідний текст, спричиняють оновлення усіх існуючих перекладів, тому краще почекати, поки вміст сторінки стабілізується. З іншого боку, зміни трапляються, і система з ними справляється, тому перегляньте нижче розділ про поводження зі змінами. If you already have done translation without the Translate extension, see below the section about migrating translations. If you want lots of translations quickly, it is crucial for the source text to be in good shape. Before marking a page for translation, ask someone else to proofread it and if possible ask a language specialist to make the text clearer and more concise. Difficult vocabulary and hard to understand sentences are a show stopper to many volunteer translations. Markup, too, can cause problems for translators, but as a translation administrator you can avoid those issues, see the section about handling markup below. Naturally the changes you make to the source text of translations require updates of all existing translations, so it is better to wait until the contents of the page have stabilized. On the other hand, changes do happen, and the system handles that well, so check out the section about handling changes below.

Теґування. Коли текст готовий до перекладу, будь-хто може позначити частини, що можуть бути перекладені, взявши їх у теґи і додавши на сторінку панель. Остання додає список усіх перекладів сторінки, з відсотками їх завершеності і актуальності. Іншої вказівки на наявні переклади немає. Див. нижче, як, власне, робиться теґування. Система виявить, що на сторінку було додано теґи, і на ній з'явиться посилання для позначення її до перекладу. Вона також сповістить і не дозволить зберегти сторінку, якщо Ви, наприклад, забули додати закривальний теґ. Перекладабельна сторінка також буде у списку на $PageTranslation як готова до позначення. The latter adds a list of all translations of the page, with their completion and up-to-date percentages. There is no other indication that translations exist. See below how to actually do the tagging. The system will detect when the tags are placed on the translatable page, and the page will have a link to mark it for translation. It will also complain and prevent saving if you for example forgot to add a closing tag. The translatable page will also be listed on Special:PageTranslation as ready for marking.

Позначення. Після теґування, адміністратор перекладу позначає сторінку для перекладу. Інтерфейс пояснено на сторінці Приклад перекладу сторінки. Обов'язок адміністратора перекладу переконатись, що сегментування логічне, і що теґування зроблене правильно. Сторінка може бути позначена знову, якщо її між тим було змінено. Див. нижче, як робити зміни, що спричиняють мінімальні збої. Позначення сторінки запускає фоновий процес, що використовує чергу задач MediaWiki. Цей процес проходить по кожній сторінці перекладу і регенерує її: зміни у шаблоні сторінки перекладу відобразяться і застарілі переклади будуть тимчасово замінені вихідним текстом. Натомість, перекладацький інтерфейс оновлюється миттєво. The interface is explained in Page translation example. The translation administrator's responsibility is to make sure that the segmentation makes sense and that tagging has been proper. The page can be marked again if it has changed in the meanwhile. See below how to make changes that cause minimal disruptions. The marking of the page starts a background process that uses MediaWiki's job queue. This process goes over each translation page and regenerates it: changes in the translation page template will be reflected and outdated translations will highlighted with a pink background. On the contrary, the translation interface is updated immediately.

Зміни. Користувачі можуть продовжувати робити зміни у вікірозмітці перекладабельної сторінки. Зміни будуть видимими для користувачів, що переглядають її вихідною мовою, але переклади будуть зроблені до блоків перекладу останньої версії перекладабельної сторінки, що була позначена на переклад: сторінки перекладу будуть відображатись як 100% актуальні, якщо перекладені усі блоки, навіть якщо вихідна сторінка містить нові зміни. Ви легко можете побачити, чи є непозначені зміни, коли переглядаєте перекладабельну сторінку вихідною мовою: у верхній частині є сповіщення, у якому сказано, що Ви можете перекладати цю сторінку, і є посилання на зміни, якщо такі були.

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

Вихідна мова. Також є сторінка перекладу з мовним кодом вихідної мови: вона не містить додаткових теґів та іншої вікірозмітки, що стосується перекладу сторінки, які використані у початковій перекладабельній сторінці. На цю сторінку немає посилань з інтерфейсу, але вона зручна, якщо ви, наприклад, хочете зробити її включення (зазвичай для перекладабельних шаблонів) або експортувати її. Наприклад, ця сторінка доступна як Help:Extension:Translate/Page translation administration/en.

Зміна вихідної мови. У звичайній ситуації це розширення вважатиме, що джерело перекладу — це сторінка мовою, яка у цій вікі за замовчуванням. Адміністратори можуть змінити мовні налаштування конкретної сторінки на сторінці Special:PageLanguage, так щоб вона використовувалася як джерело для перекладу. Див. детальніше на сторінці Page content language.

Translation language. Translation pages may contain text in different languages if it is not fully translated. On translation pages, untranslated translation units will be tagged with appropriate language and text direction so that CSS rules are applied correctly. MediaWiki, however, does not currently allow setting the language for parsing other than at the page level. All magic words and parser functions use the translation target language, even if the surrounding text is not translated. This can create an unwanted mismatch for example when formatting numbers or dates. Some magic functions and parser tags allow setting the output language, in which case you can use magic words en that returns either the source language for untranslated units or the target language for translated units.

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

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

Групування. Є можливість групувати пов'язані між собою сторінки. Ці групи працюють як і всі інші групи повідомлень. Вони мають свою статистику і містять усі повідомлення із підгруп: у цьому випадку — перекладабельних сторінок. Цей функціонал зараз на Special:AggregateGroups. Агреговані групи повідомлень за замовчуванням згорнуті на $LanguageStats у виборі груп на $Translate. It is possible to group related pages together. These groups work like all the other message groups. They have their own statistics and contain all the messages of the subgroups: in this case translatable pages. This functionality is currently in Special:AggregateGroups. Aggregate message groups are collapsed by default in Special:LanguageStats in the group selector at Special:Translate.

Перейменування. Ви можете перейменовувати перекладабельні сторінки так само, як би ви це робили з будь-якою іншою сторінкою. При перейменуванні ви можете вказати, чи бажаєте перейменувати також кожну неперекладну сторінку. Перейменування використовує фонову задачу для перейменування багатьох пов'язаних сторінок. Поки іде процес перейменування, сторінку перекладати не можна. Його завершення відмічається у журналі перекладу сторінки.

Вилучення. Як і перейменування, вилучення здійснюється у звичному місці. Ви можете вилучити або усю перекладабельну сторінку, або лише одну сторінку перекладу, натиснувши кнопку вилучення на такій сторінці. Вилучення сторінки також спричиниться до вилучення усіх пов'язаних блоків перекладу. Як і з перейменуванням, фоновий процес вилучить сторінки з часом, а завершення цього процесу буде відмічене в журналі перекладу сторінки. Вилучення потребує прав «delete» та «pagetranslation», однак окремі сторінки блоків перекладу можна видалити, використовуючи стандартну кнопку «вилучити».

Відкидання. Аналогічно, відкидання некоректних редагувань працює, як звичайно (включно з кнопкою відкоту): Вам треба тільки відредагувати відповідний блок перекладу, а сторінка з перекладом також оновиться. Щоб знайти редагування блоку перекладу з історії редагувань сторінки перекладу, просто клацніть на посилання «$contribslink» редактора, і знайдіть редагування, виконане в той же час.

Захист. Перекладабельну сторінку можна захистити. Сторінки перекладу захищеними бути не можуть, і на них не поширюється захист перекладабельної сторінки. Щоб унеможливити подальші редагування перекладів, Вам треба вказати вихідну мову єдиною пріоритетною і вимкнути можливість перекладу іншими мовами, див. встановлення пріоритетних мов вище. Ці дві дії разом ефективно захищають від редагувань і вихідну сторінку, і сторінки перекладів разом зі сторінками блоків перекладу. Можна захистити окремі сторінки блоків перекладу, але це робити не рекомендується.

Припинення перекладу. Також можна зняти позначення сторінки на переклад. Спочатку Вам треба видалити усі $translate теґи зі сторінки. Далі Ви можете скористатись Special:PageTranslation або перейти за посиланням угорі перекладабельної сторінки, щоб вилучити її з перекладу. Це вилучить усі структури, пов'язані з перекладом сторінки, але залишить на місці усі існуючі сторінки, доступні для редагування. Цю дію виконувати не рекомендується.

Анатомія перекладабельної сторінки
Переклад перекладабельної сторінки продукуватиме багато сторінок, які усі разом складають перекладабельну сторінку latu sensu: їхня назва визначається назвою перекладабельної :


 * (вихідна сторінка)
 * (сторінки перекладу, плюс копія вихідної сторінки без вікірозмітки)
 * (усі сторінки блоків перекладу)

На додачу, також є шаблон сторінки перекладу і вихідні тексти для блоків перекладу, виокремлені з вихідної сторінки і збережені у базі даних. Система слідкує за тим, які версії вихідної сторінки містять теґи перекладу і яка версія була позначена для перекладу.

Кожного разу, як оновлюється сторінка блоку перекладу, система також регенерує відповідну сторінку перекладу. В результаті відбувається два редагування. Редагування сторінки блоку перекладу за замовчуванням приховується у нових редагуваннях і показуватиметься, якщо вибрати показувати переклади у фільтрі перекладів. Будь-яка інша дія, крім редагування (наприклад, вилучення чи перейменування) сторінок блоків перекладу, не буде спричиняти регенерацію відповідної сторінки перекладу.

Якщо Вам потрібна копія вихідної сторінки без вікірозмітки, скажімо, для того, аби вставити її текст у іншу вікі без тегів розширення Translate, текст відобразиться або збережеться.
 * визначте вихідний код мови (для англійської це буде $en), та перейдіть на сторінку ;
 * клацніть кнопку «$history», аби дістатися до адреси на кшталт [$hist-url цієї], та замініть $action-hist на $action-raw в адресному рядку браузера, після чого натисніть кнопку Enter:


 * identify the source language code (for English, en ) and visit ;
 * click the "" button to reach an address like this and replace  with   in the address bar, press enter:
 * the text will be displayed or saved.

Сегментування
Загальні принципи:


 * 1) Увесь текст, призначений для перекладу, повинен бути взятий у теґи . На одній сторінці може бути багато пар теґів.
 * 2) Усе, що поза цими теґами, не зміниться на жодній сторінці перекладу. Цей статичний текст, разом із заповнювачами, які позначають місце, де будуть замінені переклади кожного блоку перекладу, називається шаблоном перекладабельної сторінки.
 * 3) Надмір вікірозмітки у тексті робить його складним для перекладу перекладачами. Якщо вікірозмітки багато, ставте теґи  частіше.
 * 4) Текст всередині теґів  розбивається на блоки перекладу там, де є один чи кілька пустих рядків.

Застереження. Функція перекладу сторінок має деякі застереження до тексту. Не має бути вікірозмітки, що поширюється на два і більше блоків перекладу. Іншими словами, кожен абзац має бути самодостатнім. Програмне забезпечення до цього не примушує, але порушення цього принципу призведе до невідповідного відображення сторінки, його серйозність залежатиме від того, чи може MediaWiki обробити html, який буде в результаті, чи ні. There should not be any markup that spans over two or more translation units. In other words, each paragraph should be self-contained. This is currently not enforced in the software, but violating it will cause invalid rendering of the page, the severity depending on whether MediaWiki itself is able to fix the resulting html output or not.

Parsing order. Beware, the tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like or, with the exception of  which is recognized by the Translate extension.

Розміщення теґів. Якщо можна, то намагайтесь ставити теґи в окремих рядках, без пустих рядків між вмістом і теґами. Інколи це зробити неможливо, наприклад, якщо Ви хочете перекласти якийсь вміст всередині вікірозмітки, але не саму розмітку. Це також спрацює, наприклад:

Щоб це працювало, розширення просто працює з пробілами: пробіл зберігається, тільки якщо відкриваючий чи закриваючий теґ  — не єдине, що є у рядку. У такому разі новий рядок після відкриваючого теґу або перед закриваючим з'їдається. Це означає, що вони не спричиняють додаткового рядка у відображеній версії сторінки.

Змінні. Є можливість використання змінних, подібних до змінних у шаблонах. Синтаксис цього такий:. Для перекладачів це відобразиться лише як, і на сторінках перекладу буде автоматично замінене значенням, вказаним на перекладабельній сторінці (таким чином воно є глобальною «константою» на всіх сторінках перекладу). Змінні можна використовувати, щоб приховати неперекладабельний вміст всередині блоку перекладу. Це також працює для таких речей, як числа, які треба часто оновлювати. Ви можете оновити число у всіх перекладах, змінивши його у вихідному тексті перекладабельної сторінки і позначивши її знову. Вам не треба позначати переклади застарілими, бо число не є частиною сторінок блоків перекладу.

Значення, розділені комою (CSV). Для вмісту на зразок даних Graph, які мають аналізуватися програмним забезпеченням, як значення, розділені комою, вам треба розділяти блоки перекладу між кожною комою, щоб перекладачі не використовували локалізовані коми, що заплутає програмне забезпечення.

Plain-text values. To prevent any kind of modification of the translation value, use  attribute like this: ....  By default outdated and untranslated values are modified in order to support highlighting and language tagging.

Приклади розмітки
Нижче перераховані деякі альтернативи і пропоновані шляхи поводження з різними видами вікірозмітки.

{| class=wikitable Переклад з додаванням мовного суфікса: Category:Cars/fi (рекомендується)
 * Категорії
 * width=40% | Категорії можна додавати двома способами: у шаблон сторінки перекладу або в один з блоків перекладу. Якщо у вас категорії в шаблоні сторінки перекладу, усі переклади опиняться в одній категорії. Якщо категорії у блоках перекладу, ви маєте пояснити користувачам схему їх називання. Справа показано дві можливі схеми, незалежні від технічних засобів їх впровадження.

[...] &lt;/translate>


 * Назва категорії не перекладається (так само, як назви сторінок).
 * Одна категорія для кожної мови.
 * Переклад сторінок можна використовувати і для самої категорії: категорії будуть пов'язані між собою і заголовки будуть перекладені (але не назва категорії у посиланнях і под.).

Без перекладу: Category:Cars

Неправильно: == Культура ==
 * Усі переклади в тій самій категорії (годиться, якщо мов мало, незручно, якщо їх багато).
 * Назва категорії не перекладається (можна залишити як є у шаблоні перекладу).
 * Заголовки
 * Заголовки можуть бути, в принципі, приєднані до наступного абзацу, але краще, щоб вони були відокремленими пустим рядком. Таким чином хтось зможе швидко перекласти зміст, перед тим як братись до тексту. Теґуючи заголовки, важливо включати розмітку заголовків у теґи і додавати новий рядок між відкриваючим тегом translate та розміткою заголовка, бо MediaWiki більше не буде коректно їх розпізнавати. Наприклад редагування розділу працює лише з рекомендованою вікірозміткою, поданою у прикладі. Також вікірозмітка одразу дає перекладачам контекст: вони перекладають заголовок.
 * Заголовки можуть бути, в принципі, приєднані до наступного абзацу, але краще, щоб вони були відокремленими пустим рядком. Таким чином хтось зможе швидко перекласти зміст, перед тим як братись до тексту. Теґуючи заголовки, важливо включати розмітку заголовків у теґи і додавати новий рядок між відкриваючим тегом translate та розміткою заголовка, бо MediaWiki більше не буде коректно їх розпізнавати. Наприклад редагування розділу працює лише з рекомендованою вікірозміткою, поданою у прикладі. Також вікірозмітка одразу дає перекладачам контекст: вони перекладають заголовок.

Неправильно: == Культура==

Рекомендоване сегментування: &lt;translate>

Культура
Lorem ipsum dolor. &lt;/translate>

&lt;translate> &lt;/translate>
 * Зображення
 * Для зображень, вміст яких залежить від мови, наприклад, текст, блок перекладу має містити повний синтаксис зображення. Для інших зображень можна теґувати тільки опис із необов'язковою підказкою у документації повідомлення сторінки після її позначення.
 * Для зображень, вміст яких залежить від мови, наприклад, текст, блок перекладу має містити повний синтаксис зображення. Для інших зображень можна теґувати тільки опис із необов'язковою підказкою у документації повідомлення сторінки після її позначення.


 * Посилання
 * Посилання можна включати в абзац, у якому вони є. Це дозволить змінити мітку посилання, і також призначення посилання на локалізовану версію, якщо така існує.
 * Посилання можна включати в абзац, у якому вони є. Це дозволить змінити мітку посилання, і також призначення посилання на локалізовану версію, якщо така існує.

Якщо цільова сторінка є (або повинна бути) доступною для перекладу, Вам треба дати посилання на неї, додавши  на початку її назви. Перекласти треба буди лише текст посилання, оскільки отаке оформлення посилання автоматично перенаправлятиме користувачів на перекладену сторінку їхньою мовою інтерфейсу, яка могла бути обрана, скажімо, через Універсальний мовний селектор. Проте, аби досягти стабільної поведінки посилань, цей синтаксис має використовуватися в усіх посиланнях.

Оскільки заголовки перекладаються, ви не можете покладатись на автоматично генеровані ідентифікатори заголовків. Можна додавати свої власні якірці. Щоб вони були поза шаблоном перекладу, вам треба розбити сторінку на декілька пар теґів навколо кожного заголовка, на який ви хочете поставити якірець. Внутрішні посилання: &lt;translate> Гельсінкі — столиця Фінляндії. &lt;/translate>

Посилання на сторінки, доступні для перекладу: &lt;translate> Тут є чудові пляжі з великою кількістю мартинів. &lt;/translate> Зовнішні посилання: &lt;translate> PHP (вебсайт) — це мова програмування. &lt;/translate> Посилання всередині сторінки: &lt;translate>

Культура
Lorem ipsum dolor.

...

Детальніше про їжу див. у розділі про культуру. &lt;/translate>

Do so only if the items are sufficiently independent to be translated separately in all languages: don't create "lego messages". For instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags for each item without including leading asterisks/hashes/semicolons. Do not insert blank lines as this will break the HTML output.
 * Списки
 * Списки можуть бути довгими, тому можна розділити їх на кілька частин з, наприклад, п'ятьма чи менше пунктами в кожній. Робіть так, тільки якщо пункти повністю не залежні, щоб перекладатись окремо усіма мовами, не створюйте "повідомлень лего": наприклад, вам треба уникати поділу одного речення на кілька шматків, поділу логічно залежних частин, що можуть впливати одна на одну (залежно від пунктуації чи стилю списку, наприклад). Щоб розбити список, використайте теґи $translate. Не вставляйте нові рядки, оскільки це ламає будову HTML.
 * Списки можуть бути довгими, тому можна розділити їх на кілька частин з, наприклад, п'ятьма чи менше пунктами в кожній. Робіть так, тільки якщо пункти повністю не залежні, щоб перекладатись окремо усіма мовами, не створюйте "повідомлень лего": наприклад, вам треба уникати поділу одного речення на кілька шматків, поділу логічно залежних частин, що можуть впливати одна на одну (залежно від пунктуації чи стилю списку, наприклад). Щоб розбити список, використайте теґи $translate. Не вставляйте нові рядки, оскільки це ламає будову HTML.
 * &lt;translate>* Загальні принципи&lt;/translate>
 * &lt;translate>* Заголовки&lt;/translate>
 * &lt;translate>* Зображення&lt;/translate>
 * &lt;translate>* Таблиці&lt;/translate>

or

&lt;translate> Please visit: &lt;/translate>
 * our main page
 * then the FAQ page.


 * Числа
 * У ситуації з числами та іншими нелінгвістичними елементами можна виносити самі числа поза переклад і позначати їх змінними. Це має декілька переваг:
 * У ситуації з числами та іншими нелінгвістичними елементами можна виносити самі числа поза переклад і позначати їх змінними. Це має декілька переваг:

&lt;translate> Дохід цього місяця:  EUR &lt;/translate> Майте на увазі, що це не дасть перекладачам локалізувати число, зробивши конвертацію валют. Викликання  упевнює, що число відформатовано коректно кінцевою мовою.
 * Ви можете оновлювати число без позначення перекладів застарілими.
 * Пам'ять перекладів може працювати краще, якщо змінне число ігноруватиметься.


 * Шаблони
 * Шаблони мають різні функції і цілі, тому найкраще рішення залежить від призначення шаблону. Якщо шаблон не є частиною більшого абзацу, його варто залишити поза перекладом, якщо тільки його параметри не потребують перекладу. Якщо шаблон не має ніякого лінгвістичного вмісту, Вам не треба робити щось із самим шаблоном.
 * Приклади шаблонів, що перекладаються перекладом сторінок, див. Template:Extension-Translate. Щоб використати цей шаблон, Вам треба мати інший шаблон, подібний до Translatable navigation template, оскільки Ви більше не зможете просто включити шаблон як  Це поки що не передбачено самим розширенням Translate, але є у планах.
 * Приклади шаблонів, що перекладаються перекладом сторінок, див. Template:Extension-Translate. Щоб використати цей шаблон, Вам треба мати інший шаблон, подібний до Translatable navigation template, оскільки Ви більше не зможете просто включити шаблон як  Це поки що не передбачено самим розширенням Translate, але є у планах.

Іншим способом є використання для перекладу шаблону можливості перекладу неструктурованих елементів, але в такому разі мова шаблону буде залежати від мови інтерфейсу користувача, а не мови сторінки, яку він переглядає.

In some circumstances the additional markup added by this wrapping is not suitable. Frequently asked questions&lt;/translate>">&lt;translate>FAQ&lt;/translate> can be used to avoid that. 2020-09-15 is The above input may render as:
 *  Attributes 
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.
 *  Translation language 
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * : 2020-09-15 is Tuesday.
 * : 2020-09-15 on tiistai.

Without the magic word, untranslated text on a Finnish translation page would render as:
 * 2020-09-15 is tiistai
 * }

Зміна вихідного тексту
Загальні принципи:


 * Уникати змін
 * Робити зміни за можливості ізольованими
 * Не додавати маркери блоків перекладу самостійно

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

&lt;translate>

Birds
&lt;!--T:1--> Birds are animals which....

&lt;!--T:2--> Birds can fly and... &lt;/translate> Зміна тексту в блоці. Зміна є найчастішою дією щодо блоків перекладу. Ви можете виправити орфографічні чи граматичні помилки або вносити у блок інші зміни. Коли Ви будете позначати сторінку на переклад знову, то побачите зміни у тексті блоку. Ця ж різниця показується перекладачам, коли вони оновлюють свої переклади. Якщо Ви робите прості виправлення написання і не хочете, щоб наявні переклади були підсвічені на сторінках перекладів, можна уникнути позначення перекладів застарілими: перекладачі все одно бачитимуть різницю, якщо колись з певної причини оновлюватимуть переклад.

Додавання нового тексту. Ви можете вільно додавати новий текст усередині теґів. Переконайтесь, щоб між сусідніми блоками був пустий рядок, так щоб система розпізнала новий блок. Ви можете також додати теґи навколо нового тексту, якщо він знаходиться не всередині існуючих теґів. Знову ж таки, не додавайте маркери блоків самостійно, система сама це зробить.

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

Поділ блоків. Ви можете розбити існуючі блоки, додавши пустий рядок всередині блоку чи вставивши теґи так, щоб вони розбили блок. Ви можете або залишити маркер біля першого блоку, або вилучити його зовсім. У першому випадку, перекладачі побачать старий текст, коли оновлюватимуть переклад. Якщо Ви вилучите маркер блоку, після перепозначення сторінки на переклад обидва блоки поводитимуться, як ніби перекладу ніколи не існувало.

Об'єднання блоків. Якщо Ви об'єднуєте блоки, Вам треба вилучити всі маркери, крім одного.

Переміщення блоків. Ви можете переміщувати блоки без впливу на переклади: просто перемістіть маркер блоку разом з рештою блоку.

Перед позначенням нової версії сторінки на переклад, переконайтесь, що дотримано рекомендацій, особливо, що перекладачі отримають новий блок перекладу, якщо змінився вміст. Також переконайтесь, що не було не необхідних змін, щоб уникнути марної трати часу перекладачів. Якщо вихідну сторінку чекають численні зміни, варто почекати, поки вона стабілізується, і вже після цього дати роботу перекладачам.

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

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

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

Це ручне завдання було частково автоматизоване завдяки сторінці Special:PageMigration, яка відображає вихідний та цільовий блоки поряд один з одним, і дозволяє користувачеві коригувати ці блоки, використовуючи функції, описані нижче на цій сторінці.

Як використовувати?
500px| Скріншот, що демонструє приклад використання сторінки Special:PageMigration, де «Help:Special pages» — назва сторінки, і «fr» — код мови.
 * 1) Перейдіть на Special:PageMigration
 * 2) Введіть назву сторінки та код мови. Наприклад, «Help:Special pages» та «fr»
 * 3) Вихідний текст був розділений на блоки розширенням Translate, а імпортовані переклади будуть відображені поряд один з одним із тим же початковим вирівнюванням.
 * 4) Використайтедоступні дії для кожного блоку, аби виконати решту вирівнювання вручну
 * 5) Оскільки перекладені блоки можна редагувати, виконайте одразу всі необхідні ручні виправлення (додайте змінні перекладу, виправте посилання та розмітку тощо)
 * 6) Клацніть кнопку «». Цим Ви створите сторінки у просторі назв Translations, що матимуть вигляд  . Таким чином, старі переклади будуть імпортовані у розширення Translate.
 * 7) Також, якщо Ви бажаєте скасувати імпортування, клацніть кнопку «Скасувати».

Доступні дії
Кожен рядок, що містить вихідний та цільовий блок тексту, має набір іконок дій. Вони використовуються таким чином:
 * 1) Додати: клацання на цій іконці дії додасть новий порожній блок нижче поточного. Використовуйте цю функцію, якщо Ви хочете розділити поточний блок, і потребуєте ще одного блоку нижче.
 * 2) Поміняти: клацання на цю іконку дії поміняє місцями вміст поточного блоку із блоком нижче нього. Ви можете використати цю функцію, коли вирівнювання блоків є невідповідним внаслідок відмінного порядку розділів. Або ж коли Вам треба перемістити блок нижче або вище. В будь-якому з цих випадків, пам'ятайте, що поточний блок завжди міняється місцями із блоком внизу, і не створює ніяких додаткових блоків.
 * 3) Вилучити: клацання на цю іконку дії цілковито усуне відповідний цільовий блок тексту зі сторінки, і змістить всі інші цільові блоки на один блок вгору. Використовуйте це для вилучення небажаного контенту на кшталт коду чи імпортованих перекладів, які повністю містяться у вихідному тексті, і не мають перекладатися. Примітка: це — невідворотна дія (у поточній сесії).

Виправлення проблем

 * 1) Якщо Ви позначите сторінку до перекладу, і одразу ж перейдете на спеціальну сторінку та спробуєте імпортувати переклади, Ви можете отримати повідомлення про помилку на кшталт «». Це спричинено тим, що FuzzyBot ще не оновив («fuzzy») відповідні повідомлення на старій сторінці: інструмент не зможе відшукати редагування бота FuzzyBot на сторінці перекладу. У цьому випадку, просто почекайте, поки FuzzyBot виконає свою роботу. Як тільки Ви побачите його редагування, можна буде продовжити роботу з імпортуванням.
 * 2) Будь ласка, почекайте трохи після натискання кнопки «». Поки фон кнопки залишається сірим, триває процес імпортування непорожніх блоків. Як тільки кнопка відновить свій колір, імпортування завершиться.

Поради

 * 1) Міграція буде простішою, якщо Ви спершу (перед тим, як позначати сторінку до перекладу) перевірите, чи існуючі переклади відповідають оригінальному англомовному текстові, і вручну відредагуєте структуру сторінок: розіб'єте параграфи та списки, додасте відсутні заголовки (навіть якщо вони порожні).
 * 2) Було б корисно перевірити результат у базовому інтерфейсі перекладу — деякі блоки можуть бути миттєво позначені як застарілі через помилки у розмітці, або ж якщо не всі змінні перекладу були додані.
 * 3) Переклад назви сторінки треба буде додати вручну. Якщо Ви погано володієте мовою імпортованої сторінки, можна спробувати знайти переклад назви сторінки серед сторінок, що посилаються на неї («посилання сюди»), а іноді й серед перенаправлень.  Примітка: Будь ласка, не перекладайте простір назв, залишайте його неперекладеним.