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/ru/pages/translations.md
Normal file
30
i18n/ru/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), указав язык, страницу и фрагмент; сообщения от носителей языка особенно ценны. Если знаете, как исправить, предложите правку напрямую — пул-реквестом в руководство по стилю (`instructions.md`) или глоссарий (`glossary.json`) этого языка в каталоге [`i18n/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/i18n). Тогда исправление попадёт на все затронутые страницы при следующей генерации переводов. Проблемы в самом английском тексте исправляются в страницах каталога `docs/`, как и любые другие изменения документации.
|
||||
Loading…
Reference in a new issue