🌐 Add Russian translation for docs/ru/docs/index.md
#5289
Conversation
Codecov Report
@@ Coverage Diff @@
## master #5289 +/- ##
=========================================
Coverage 100.00% 100.00%
=========================================
Files 533 533
Lines 13725 13755 +30
=========================================
+ Hits 13725 13755 +30
Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here. |
|
📝 Docs preview for commit d6ac0b5 at: https://62fff65d82d48a39e4ef64cd--fastapi.netlify.app |
impocode
changed the title
|
📝 Docs preview for commit 17b6aa3 at: https://62fff8f45f3879428c89217d--fastapi.netlify.app |
|
📝 Docs preview for commit 22e115d at: https://62fffb03330a643ddf1b9ad4--fastapi.netlify.app |
docs/ru/docs/index.md
Outdated
| <p align="center"> | ||
| <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a> | ||
| </p> | ||
| <p align="center"> | ||
| <em>FastAPI framework, high performance, easy to learn, fast to code, ready for production</em> | ||
| <em>Фреймворк FastAPI, высокая производительность, простота в изучении, быстрота написания кода, готовность к производству</em> |
There was a problem hiding this comment.
Фреймворк FastAPI, **высокопроизводительный**, **простой в изучении** * и т.д.
There was a problem hiding this comment.
Это уже, наверное, десятая попытка перевода главной страницы ))
There was a problem hiding this comment.
По-прежнему предлагаю этот вариант.) Готовый к внедрению высокопроизводительный фреймворк, простой в изучении и разработке.
There was a problem hiding this comment.
Это уже, наверное, десятая попытка перевода главной страницы ))
Честно, я даже не видел)) Надо было глянуть прежде чем править.
There was a problem hiding this comment.
Я вижу несколько вариантов перевода.
Все слова который описывают фреймворк отвечают на вопрос:
- Какой?:
1.1 Высокопроизводительный
1.2 Простой в изучении, простой при изучении, простой в освоении (еще как вариант можно использовать слово "прост", например "прост в изучении")
1.3 Быстрый в написании кода, быстрый при написании кода
1.4 Готовый к производству, готовый к внедрению в производство
- Это?(FastAPI это?)
2.1 Высокопроизводительность, высокая производительность
2.2 Простота в изучении, простота при изучении, простота изучения, простота освоения
2.3 Быстрый в написании кода, быстрый при написании кода, быстрый кодинг
2.4 Готовность к производству, готовность к внедрению в производство
There was a problem hiding this comment.
В оригинале написано, как "FastAPI (это) ...", но, вероятно, предложение от @Winand вполне достаточное, тем более, что этот блок текста повторяется часто в документации.
| </a> | ||
| <a href="https://pypi.org/project/fastapi" target="_blank"> | ||
| <img src="https://badge.fury.io/py/fastapi.svg" alt="Package version"> | ||
| <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions"> |
There was a problem hiding this comment.
Взял из английской версии главной страницы. Чтобы было однообразно.
docs/ru/docs/index.md
Outdated
| * **Быстрота разработки**: Увеличьте скорость разработки примерно на 200–300%. * | ||
| * **Меньше ошибок**: Сократите примерно на 40 % ошибок, вызванных человеком (разработчиком). * |
There was a problem hiding this comment.
Сокращает
Увеличивает
Я думаю в этих предложениях более подходящими являются такие варианты переводов. НО - я могу ошибаться.
There was a problem hiding this comment.
Увеличивает скорость разработки
Сокращает количество ошибок
Это имеется ввиду?
Вообще я пытался отталкиваться от того как это будет восприниматься при чтении. То есть тут такая часть.
Ключевые особенности:
(Ключевые особенности какие?)
- Скорость
- Быстрота разработки
- Меньше ошибок(или меньшее кол-во ошибок при разработке)
- Интуитивно понятный(тут на самом деле немного не то, то есть нет ответа на вопрос "какие?", но и с альтернативой сложно. Если есть варианты можете предложить)
и т.д.
То есть если писать, что-то типа "сокращает" или "увеличивает" то это ответ на вопрос "что FastAPI делает?" и надо везде написать в таком стиле, а это уже проблема так как не везде это подходит.
There was a problem hiding this comment.
В тоже время(сейчас заметил) надо тогда и дальше в этом стиле написать. Лёгкость, краткость, надёжность и т.д.
There was a problem hiding this comment.
Вероятно ты прав, я тоже не посмотрел. Нужно уже у Себастиана спросить поддерживать ли однообразность перевода во всем тексте
docs/ru/docs/index.md
Outdated
|
|
||
| "_[...] I'm using **FastAPI** a ton these days. [...] I'm actually planning to use it for all of my team's **ML services at Microsoft**. Some of them are getting integrated into the core **Windows** product and some **Office** products._" | ||
| "_В последнее время я много где использую **FastAPI**. [...] На самом деле я планирую использовать его для всех **служб машинного обучения моей команды в Microsoft**. Некоторые из них интегрируются в основной продукт **Windows**, а некоторые — в продукты **Office**._" |
There was a problem hiding this comment.
служб машинного обучения - скорее всего подразумевается как сервисов или же приложений для
There was a problem hiding this comment.
Могу поправить на "сервисов машинного обучения...", думаю это будет более близкое по смыслу. Вариант приложений для как мне кажется не очень подходит.
There was a problem hiding this comment.
Согласен - сервисов машинного обучения, хорошо звучит
docs/ru/docs/index.md
Outdated
|
|
||
| * Create a file `main.py` with: | ||
| * Создайте файл `main.py` с: |
There was a problem hiding this comment.
Возможно лучше дополнить Создайте файл 'main.py' с содежимым: или что-то на подобии?
There was a problem hiding this comment.
@RobotToI
Как на счет "со следующим содержимым"?
docs/ru/docs/index.md
Outdated
| * **WebSockets** | ||
| * **GraphQL** | ||
| * extremely easy tests based on `requests` and `pytest` | ||
| * Объявление **параметров** из других мест, таких как: **заголовки**, **куки**, **поля формы** и **файлы**. |
There was a problem hiding this comment.
Здесь тоже самое со словом куки - оно хоть и есть в русском, даже если мы его только что придумали, но использовать его наверное не стоит и лучше использовать английского предка)
| * Очень мощная и простая в использовании система **<abbr title="также известная как компоненты, ресурсы, провайдеры, сервисы, инъекции">внедрения зависимостей</abbr>**. | ||
| * Безопасность и аутентификация, включая поддержку **OAuth2** с **токенами JWT** и **HTTP Basic** аутентификацию. | ||
| * Более продвинутые (но столь же простые) методы объявления **глубоко вложенных моделей JSON** (спасибо Pydantic). | ||
| * **GraphQL** интеграция с <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> и другими библиотеками. |
There was a problem hiding this comment.
У вас немного выше переехал GraphQL чем должен быть
docs/ru/docs/index.md
Outdated
| * **CORS** | ||
| * **Cookie Sessions** | ||
| * ...and more. | ||
| * **Сеансы файлов Cookie** |
There was a problem hiding this comment.
Возможно Cookie сеансы(сессии) будет более корректно?
There was a problem hiding this comment.
Только это куки сеансов/сессий.
Такие штуки, которые позволяют продолжить конкретный прерванный сеанс.
docs/ru/docs/index.md
Outdated
|
|
||
| To understand more about it, see the section <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Benchmarks</a>. | ||
| Чтобы узнать больше об этом, см. раздел <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Тесты</a>. |
There was a problem hiding this comment.
Не совсем понятно какие Тесты - возможно стоит указать что это тесты производительности?
|
|
||
| You can install all of these with `pip install fastapi[all]`. | ||
| Вы можете установить все это с помощью `pip install "fastapi[all]"`. |
There was a problem hiding this comment.
Сделал по аналогии с оригиналом.
https://github.com/tiangolo/fastapi/blob/master/docs/en/docs/index.md#optional-dependencies
tiangolo
changed the title
docs/ru/docs/index.md
tiangolo
added
lang-all
docs/ru/docs/index.md
Outdated
| * **Быстрота разработки**: Увеличьте скорость разработки примерно на 200–300%. * | ||
| * **Меньше ошибок**: Сократите примерно на 40 % ошибок, вызванных человеком (разработчиком). * | ||
| * **Интуитивно понятный**: Отличная поддержка редактора. <abbr title="также известное как автозаполнение, автодополнение, IntelliSense">Автозавершение</abbr> везде. Меньше времени на отладку. | ||
| * **Легкий**: Разработан так, чтобы его было легко использовать и осваивать. Меньше времени на чтение документов. |
There was a problem hiding this comment.
чтение документов
документации
docs/ru/docs/index.md
Outdated
| <p align="center"> | ||
| <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a> | ||
| </p> | ||
| <p align="center"> | ||
| <em>FastAPI framework, high performance, easy to learn, fast to code, ready for production</em> | ||
| <em>Фреймворк FastAPI, высокая производительность, простота в изучении, быстрота написания кода, готовность к производству</em> |
There was a problem hiding this comment.
Это уже, наверное, десятая попытка перевода главной страницы ))
docs/ru/docs/index.md
Outdated
| FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. | ||
|
|
||
| The key features are: | ||
| FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API-интерфейсов с Python 3.6+ на основе стандартных подсказок типов Python. |
There was a problem hiding this comment.
API-интерфейсов с Python 3.6+
Последняя буква в API - это и есть интерфейс.
В данном случае with это не c, а скорее используя.
docs/ru/docs/index.md
Outdated
| * **Меньше ошибок**: Сократите примерно на 40 % ошибок, вызванных человеком (разработчиком). * | ||
| * **Интуитивно понятный**: Отличная поддержка редактора. <abbr title="также известное как автозаполнение, автодополнение, IntelliSense">Автозавершение</abbr> везде. Меньше времени на отладку. | ||
| * **Легкий**: Разработан так, чтобы его было легко использовать и осваивать. Меньше времени на чтение документов. | ||
| * **Короткий**: Сведите к минимуму дублирование кода. Несколько функций из каждого объявления параметра. Меньше ошибок. |
There was a problem hiding this comment.
Несколько функций из каждого объявления параметра
Не понятно, что имеется ввиду.. С буквальным переводом справятся и роботы.
Каждый объявленный параметр - определяет несколько функций.
docs/ru/docs/index.md
Outdated
| * **Легкий**: Разработан так, чтобы его было легко использовать и осваивать. Меньше времени на чтение документов. | ||
| * **Короткий**: Сведите к минимуму дублирование кода. Несколько функций из каждого объявления параметра. Меньше ошибок. | ||
| * **Надежный**: Получите готовый к работе код. С автоматической интерактивной документацией. | ||
| * **На основе стандартов**: На основе (и полностью совместимых) открытых стандартов для API: <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (ранее известном как Swagger) и <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>. |
There was a problem hiding this comment.
На основе (и полностью совместимых)
Основан на открытых стандартах API и полностью совместим с ними.
| * Преобразование типов Python (`str`, `int`, `float`, `bool`, `list`, etc). | ||
| * Объекты `datetime`. | ||
| * Объекты `UUID`. | ||
| * Модели баз данных. |
docs/ru/docs/index.md
Outdated
| * Если это не так, клиент увидит полезную чёткую ошибку. | ||
| * Проверять, есть ли необязательный параметр запроса с именем `q` (например, `http://127.0.0.1:8000/items/foo?q=somequery`) для `GET` запросов. | ||
| * Поскольку параметр `q` объявлен с `= None`, он является необязательным. | ||
| * Без `None` это было бы необходимо (как тело в случае с `PUT`). |
There was a problem hiding this comment.
Без
Noneэто было бы необходимо
Без None он был бы необходим.
Вам следует попрактиковаться со словом It.
docs/ru/docs/index.md
Outdated
|
|
||
| --- | ||
|
|
||
| We just scratched the surface, but you already get the idea of how it all works. | ||
| Мы только поцарапали поверхность, но вы уже поняли, как все это работает. |
There was a problem hiding this comment.
немного капнули
копать != капать
docs/ru/docs/index.md
Outdated
|
|
||
|  | ||
|
|
||
| For a more complete example including more features, see the <a href="https://fastapi.tiangolo.com/tutorial/">Tutorial - User Guide</a>. | ||
| Более полный пример с дополнительными функциями см. в <a href="https://fastapi.tiangolo.com/tutorial/">Учебном руководстве - Руководство пользователя</a>. |
There was a problem hiding this comment.
Учебном руководстве - Руководство пользователя
Руководстве пользователя
docs/ru/docs/index.md
Outdated
| * **GraphQL** | ||
| * extremely easy tests based on `requests` and `pytest` | ||
| * Объявление **параметров** из других мест, таких как: **заголовки**, **куки**, **поля формы** и **файлы**. | ||
| * Как установить **ограничения проверки** как `maximum_length` или `regex`. |
There was a problem hiding this comment.
ограничения проверки как
ограничительные ,,,, такие как
|
📝 Docs preview for commit 20428cf at: https://630718d528099e4b1154c0ce--fastapi.netlify.app |
docs/ru/docs/index.md
Outdated
|
|
||
| Ключевые особенности: | ||
|
|
||
| * **Скорость**: Очень высокая производительность, на уровне **NodeJS** и **Go** (благодаря Starlette и Pydantic). [Один из самых быстрых фреймворков Python](#_10). | ||
| * **Быстрота разработки**: Увеличьте скорость разработки примерно на 200–300%. * | ||
| * **Меньше ошибок**: Сократите примерно на 40 % ошибок, вызванных человеком (разработчиком). * | ||
| * **Меньше ошибок**: Сократите примерно на 40% ошибок, вызванных человеком (разработчиком). * |
There was a problem hiding this comment.
Здесь и далее я не буду настаивать на исправлении, но оставлю некоторые комментарии для рассмотрения переводчиком.
на 40% ошибок
на 40% количество ошибок
docs/ru/docs/index.md
Outdated
|
|
||
| Now modify the file `main.py` to receive a body from a `PUT` request. | ||
| Теперь измените файл `main.py`, чтобы получить тело из `PUT` запроса. |
There was a problem hiding this comment.
Для этой строки и прочих, где body переводится, как тело .
Да, это наиболее используемый перевод, но на самом деле body означает некую цельную собранную конструкцию.
То есть, если фреймворк считать скелетом, то вместе со всеми навешанными зависимостями будет body .
Касательно данного случая. Читатель, конечно, поймёт о чём речь, но всё же, услышав слово тело , обычно представляется человечское тело, потому, возможно, стоит дополнить тело ответа. В оригинале такого уточнения нет, потому что в английском очень сильную роль играют окружающие контексты.
docs/ru/docs/index.md
Outdated
| FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. | ||
|
|
||
| The key features are: | ||
| FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API используя Python 3.6+ на основе стандартных подсказок типов Python. |
There was a problem hiding this comment.
На мой взгляд в старом переводе эта фраза выглядит лучше:
Только, кажется, не нужно ставить запятую: "современный высокопроизводительный веб-фреймворк"
|
📝 Docs preview for commit f13dac9 at: https://630785b2b5a6e60c6a3a430a--fastapi.netlify.app |
Я посмотрел эти PR'ы. Думаю, мы уже взяли самые удачные формулировки) В остальном, как мне кажется, там очень много неудачных(неподходящих) переводов(Пример: перевод Возможно, я что-то мог упустить, проглядеть. Если у вас есть предложения, можете написать. |
|
Штош, господа, теперь приглашаю вас поревьюить тут |
No description provided.