Переклади

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

Що доступно

Перекладена документація наразі є попередньою версією дванадцятьма мовами: Deutsch, español, français, हिन्दी, 日本語, 한국어, português (Brasil), русский язык, Türkçe, українська мова, 简体中文 і 繁體中文. Виберіть потрібну в перемикачі мов угорі будь-якої сторінки. Інші мови можуть з'явитися пізніше, коли ці себе виправдають.

Довідник API не перекладено: перекладений сайт посилається на єдину англійську версію.

Англійська — джерело істини

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

• Машинний переклад — сторінку перекладено автоматично, і вона посилається на англійський оригінал.
• Переклад відстає від англійської сторінки — англійський оригінал змінився після того, як сторінку переклали, тож деякі її частини можуть бути неактуальними, доки переклад не наздожене.
• Показано англійською — актуального перекладу сторінки немає, тож ви читаєте англійський текст.

Як створюються переклади

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

Повідомлення про проблему з перекладом

Знайшли неправильний термін, незграбне речення або переклад, який стверджує те, чого немає в англійській версії? Створіть issue, вказавши мову, сторінку та уривок; повідомлення від носіїв мови особливо цінні. Якщо знаєте, як виправити, запропонуйте це одразу як pull request до настанов зі стилю (instructions.md) або глосарія (glossary.json) відповідної мови в i18n/ — тоді виправлення потрапить на кожну сторінку, якої воно стосується, під час наступної генерації перекладів. Проблеми з самим англійським текстом виправляють на сторінках у docs/, як і будь-яку іншу зміну в документації.