TDF Wiki/Багатомовна

From The Document Foundation Wiki
Jump to navigation Jump to search
This page is a translated version of the page TDF Wiki/Multilingual and the translation is 95% complete.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎Jawa • ‎Nederlands • ‎dansk • ‎español • ‎français • ‎galego • ‎italiano • ‎lietuvių • ‎português • ‎português do Brasil • ‎română • ‎slovenčina • ‎Ελληνικά • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎中文(台灣)‎ • ‎日本語 • ‎한국어

Ця сторінка стосується вмісту Багатомовної Wiki, розміщеної на TDF Wiki.

Warning.svg

Інформація
Не використовуйте тип перекладу OrigLang для новостворених сторінок. В даний час ми переходимо на Розширення перекладу MediaWiki.

Про що це

Ця сторінка містить кілька важливих підказок для редакторів wiki. Будь ласка, прочитайте цю сторінку, перш ніж додавати перекладений або локалізований вміст у wiki.

Розставлення акцентів для земляків

Сторінки написані лише місцевою мовою і не перекладаються. Вони є варіантами сторінки, названої кодом мови у верхньому регістрі.

Приклади:


 https://wiki.documentfoundation.org/DE/Team
 https://wiki.documentfoundation.org/DE/Veranstaltungen
 ...
 https://wiki.documentfoundation.org/FR/Documentation/Publications
 

Інформація, важлива для перекладачів

Сторінки налаштовані англійською мовою та перекладаються різними мовами. Перекладені сторінки є варіантами, названими їх кодом мови. Процесом перекладу керує Розширення перекладу.

Виконайте наступні кроки, щоб зробити сторінку доступною для перекладу:

  1. Помістіть текст, який потрібно перекласти, всередині блоків <translate></translate>
  2. Використовуйте шаблон {{#translation:}}, щоб додавати мовні суфікси до елементів типу меню
  3. Використовуйте префікс Special:MyLanguage, коли посилаєтесь на сторінки перекладів
  4. Додайте блок мовного меню <languages/>
  5. Після збереження сторінки натисніть посилання вгорі з написом "Позначити цю сторінку для перекладу"
  6. Перевірте, чи все в порядку, і натисніть кнопку внизу з написом "Позначити цю версію для перекладу"

Після того, як сторінку буде позначено для перекладу, розширення перекладу автоматично додасть маркери у вигляді <!--T:1--> для позначення рядків, які можна перекладати. Щоб автоматично розділятися по рядках, блок тексту має бути оточений порожніми рядками. Щоб примусово розділити рядки, ви можете додати більше блоків <translate></translate>. Особливо зверніть увагу на марковані або нумеровані списки.

Коли ви додаєте або змінюєте вміст початкової сторінки, у верхній частині сторінки з’явиться таке: Ця сторінка змінилася з моменту останнього позначення для перекладу. Натисніть посилання «позначено для перекладу», щоб оновити систему перекладу, дотримуючись того самого процесу, що й під час початкового позначення для перекладу.

Tips

В ідеальному випадку перекладач має бачити мінімальну кількість вікі-розмітки. Наявність розмітки для таблиці або шаблону в перекладному рядку засмучує та заплутує перекладача. Спробуйте залишити таку розмітку за межами блоків <translate></translate>.

За промовчанням заголовок сторінки можна перекласти, але Ви можете керувати цим, відмітивши галочку «Дозволити переклад заголовка сторінки», коли позначаєте сторінку для перекладу. Заголовок сторінки – це перший рядок у списку рядків, який можна перекладати. У системі перекладу та інтерфейсі рядок має назву на кшталт "Translations:Faq/General/127/Page display title/ua", тоді як інші назви рядків мають числові ідентифікатори, наприклад "4" в "Translations:Faq/General/127 /4/ua".

Іноді виникає потреба надати сторінці заголовок, який відрізняється від назви в шляху до сторінки. Зауважте, що це не рекомендовано і такого слід уникати. У цих випадках використовуйте такий шаблон перейменування: {{Перейменувати|Моя нова назва}}. Шаблон гарантує, що на перекладених сторінках немає помилок щодо заголовка.

Іноді вам потрібно отримати доступ до джерела англійської вікі без маркерів <!--T:1-->. Це можна зробити, додавши /en в кінці шляху до сторінки, а потім відредагувавши джерело. Це дозволить вам скопіювати структуру сторінки на нову сторінку (наприклад, зауваги до випуску).

Коли ви використовуєте шаблон {{#translation:}} для додавання мовних суфіксів до меню, обов’язково використовуйте абсолютні шляхи, а не відносні, які починаються з /. Якщо Ви використаєте цей знак у відносних шляхах, Ви отримаєте два коди мов і неробоче посилання.

When working on a page with many translation blocks, it sometimes happens that you make a mistake with opening or closing translate tags. In a situation like this, the page preview will show all the translate markup alongside the content. Clicking Save changes has a suprisingly useful effect, however: instead of saving, it will display a reduced view of the source text, helping you to find your error.

Якщо у Вас є блоки, які містять лише одне число, ви можете використовувати магічне слово {{formatnum:1234}} замість блоку перекладу. За потреби номер буде автоматично відформатовано у східних стилях. Найкраще використовувати параметр NOSEP для цілих чисел, щоб запобігти показу роздільників тисяч, оскільки вони можуть заплутати читачів. Для десяткових чисел найкраще не використовувати NOSEP, оскільки таким чином локалізація десяткового роздільника буде пропущена.

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

 {{TopMenu{{#translation:}}}}
 {{Menu{{#translation:}}}}
 {{Menu.Documentation{{#translation:}}}}
 <languages/>

 <translate>
 == Hello World ==

 * We must take the world as we find it
 * When we are gone, let the world be flooded
 * The world is as fools wish it to be
 * It's a small world!
 </translate>
 <translate>
 * Crows are black the world over
 * He slipped once and all the world knew about it
 * The world is like a market, the one does business and the other does none
 * Huge though the world is, I always miss when I hit at it
 </translate>


 {| class="wikitable"
 |-
 | <translate>Cell content</translate>
 |-
 | {{sometemplate|<translate>Text content for a template</translate>}}
 |-
 | <bdi>{{formatnum:-1.10714871779409}}</bdi>
 |-
 | {{formatnum:110714871779409|NOSEP}}
 |}

 [[Special:MyLanguage/Development/Create_a_Hello_World_LibreOffice_extension|<translate>Tutorial on creating a Hello World extension</translate>]]

 [[Category:Documentation]]
 

Оскільки вміст таблиці може дратувати під час підготовки до перекладу, було створено допоміжний сценарій. Використовуйте його, скопіювавши вікі-статтю в локальний текстовий файл і вказавши ім’я файлу як аргумент для сценарію. Вміст файлу буде перезаписано на потрібне місце. Магічне слово formatnum буде застосовано до цілих чисел, чисел із ковзною комою та комплексних чисел, якщо вони є єдиним вмістом у комірці таблиці. Сценарій залежить від пакетів wikitextparser, regex і wcwidth. Натисніть Розгорнути, щоб побачити скрипт.


#!/usr/bin/env python3
#
# uses the library https://github.com/5j9/wikitextparser
import sys
import wikitextparser as wtp

def is_float_or_complex(value):
    try:
        float(value)
        return True
    except:
        return False
    try:
        complex(value)
        return True
    except:
        return False

def wrap_translate(string):
    if string.endswith(('{{#translation:}}}}', '</translate>')):
        return string
    elif string.isnumeric() or is_float_or_complex(string):
        if string.isnumeric():
            format_end = '|NOSEP}}'
        else:
            format_end = '}}'
        # Add bdi element so minuses will stay in place with RTL languages
        if string[0] == '-':
            return ' <bdi>{{formatnum:' + string + format_end + '</bdi> '
        else:
            return ' {{formatnum:' + string + format_end + ' '
    else:
        return ' <translate>' + string + '</translate> '

with open(sys.argv[1]) as f:
    doc = f.read()

p = wtp.parse(doc)
tables = p.get_tables()

for t in tables:
    if t.caption:
        caption = t.caption.strip()
        if len(caption) > 0:
            t.caption = wrap_translate(caption)
    for row in t.cells():
        for cell in row:
            c = cell.value.strip()
            if len(c) > 0:
                cell.value = wrap_translate(c)

with open(sys.argv[1], 'w') as f:
    f.write(p.string)

Перенесення раніше перекладеного тексту на поточну систему

У минулому у вікі TDF був задіяний процес перекладу, який використовував шаблони під назвою OrigLang і Lang. Шаблони відображали меню, яке пов’язувало вихідну сторінку з перекладеними. Весь перекладений вміст, який використовує шаблон Lang, можна знайти у цьому списку: Special:WhatLinksHere/Template:Lang. Так само можна перерахувати сторінки з шаблоном OrigLang.

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

Перенесення відбувається наступним чином:

  1. Після позначення сторінки для перекладу зачекайте кілька хвилин, щоб сервер обробив сторінку
  2. Перейдіть на Спеціальну сторінку міграції
  3. У полі введення введіть шлях до мови сторінки, яку ви хочете перемістити, наприклад: Mypath/Mypage/de для певного німецького перекладу
  4. Натисніть кнопку Імпорт
  5. Очистіть вміст у полях введення, що містять старі переклади (наприклад, видаліть будь-які непотрібні шаблони меню)
  6. У стовпці з перекладами не можна залишати порожні або зайві поля вводу в кінці, тому видаліть їх, натиснувши піктограму кошика поруч з ними
  7. Після того, як Ви прибрали і все довели до ладу, натисніть кнопку "Зберегти".

Пам’ятайте, що Ви завжди можете переглянути стару версію перекладеної сторінки, використовуючи посилання "Переглянути історію" та натиснувши на старій версії.

Якщо Ви хочете переглянути джерело старої версії, скопіюйте її посилання з історії та перейдіть за посиланням, додавши в кінці таке: &action=edit

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

Повідомлення на бічній панелі

Для перекладу повідомлень «Долучитись» та «Підтримайте LibreOffice!», вам потрібно надіслати переклади до одного з адміністраторів вікі. Інші є системними повідомленнями, які перекладені у верхній частині MediaWiki.

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

Посилання «Головна сторінка» та «Долучитись» використовують префікс Special:MyLanguage, який спрямовує їх на перекладену сторінку, якщо вона доступна.