docs: publish translated docs in twelve languages and the tool that maintains them (#3280)
This commit is contained in:
parent
14aa889992
commit
52ad0a8876
1 changed files with 89737 additions and 54 deletions
30
i18n/uk/pages/translations.md
Normal file
30
i18n/uk/pages/translations.md
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
---
|
||||
translation:
|
||||
sections: [f671b445b16e4f99, 3983a560eb2cece7, b5c8bd4f2b3903e5, c6e2debf1da06eb7, 81d412ed5f399f94]
|
||||
tool: 1
|
||||
---
|
||||
# Переклади {#translations}
|
||||
|
||||
Цю документацію написано англійською. Щоб вона стала в пригоді більшій кількості людей, ми також публікуємо її машинні переклади, і ця сторінка пояснює, що це означає для вас і як допомогти їх покращити.
|
||||
|
||||
## Що доступно {#whats-available}
|
||||
|
||||
Перекладена документація наразі є **попередньою версією** дванадцятьма мовами: Deutsch, español, français, हिन्दी, 日本語, 한국어, português (Brasil), русский язык, Türkçe, українська мова, 简体中文 і 繁體中文. Виберіть потрібну в перемикачі мов угорі будь-якої сторінки. Інші мови можуть з'явитися пізніше, коли ці себе виправдають.
|
||||
|
||||
Довідник API не перекладено: перекладений сайт посилається на єдину англійську версію.
|
||||
|
||||
## Англійська — джерело істини {#english-is-the-source-of-truth}
|
||||
|
||||
Якщо перекладена сторінка та її англійський оригінал розходяться, правильною є англійська сторінка. Кожна сторінка перекладеного сайту починається з однієї з трьох приміток, що пояснюють її стан:
|
||||
|
||||
- **Машинний переклад** — сторінку перекладено автоматично, і вона посилається на англійський оригінал.
|
||||
- **Переклад відстає від англійської сторінки** — англійський оригінал змінився після того, як сторінку переклали. Ви й далі читаєте той переклад, тож деякі його частини можуть бути неактуальними, доки він не наздожене; примітка посилається на актуальну англійську сторінку.
|
||||
- **Показано англійською** — сторінку ще не перекладено, тож ви читаєте англійський текст.
|
||||
|
||||
## Як створюються переклади {#how-the-translations-are-made}
|
||||
|
||||
Перекладені сторінки генерує машинно інструмент із цього репозиторію з англійських сторінок у `docs/`, керуючись двома написаними людьми вхідними файлами для кожної мови: настановами зі стилю (регістр, тон, типографіка, як поводитися з жартами та ідіомами) і глосарієм (які терміни лишаються англійською, а також обов'язкові й заборонені відповідники для решти). Згенерований текст ніколи не редагують вручну. Натомість кожне покращення вносять у ці вхідні файли, щоб воно збереглося під час наступної генерації сторінок.
|
||||
|
||||
## Повідомлення про проблему з перекладом {#reporting-a-translation-problem}
|
||||
|
||||
Знайшли неправильний термін, незграбне речення або переклад, який стверджує те, чого немає в англійській версії? [Створіть issue](https://github.com/modelcontextprotocol/python-sdk/issues), вказавши мову, сторінку та уривок; повідомлення від носіїв мови особливо цінні. Якщо знаєте, як виправити, запропонуйте це одразу як pull request до настанов зі стилю (`instructions.md`) або глосарія (`glossary.json`) відповідної мови в [`i18n/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/i18n) — тоді виправлення потрапить на кожну сторінку, якої воно стосується, під час наступної генерації перекладів. Проблеми з самим англійським текстом виправляють на сторінках у `docs/`, як і будь-яку іншу зміну в документації.
|
||||
Loading…
Reference in a new issue