From 35fba52a6a3094213009c93f7265dea7b5cd1ebc Mon Sep 17 00:00:00 2001 From: Max Alexandrov Date: Sat, 14 Oct 2017 15:33:06 +0300 Subject: [PATCH] Improve Russian translations for some guide docs. (#14966) [skip ci] --- docs/guide-ru/caching-data.md | 8 ++++---- docs/guide-ru/intro-yii.md | 7 ++++--- docs/guide-ru/test-acceptance.md | 9 +++++++-- docs/guide-ru/translators.json | 1 + 4 files changed, 16 insertions(+), 9 deletions(-) diff --git a/docs/guide-ru/caching-data.md b/docs/guide-ru/caching-data.md index 226d9bd..f6fb13c 100644 --- a/docs/guide-ru/caching-data.md +++ b/docs/guide-ru/caching-data.md @@ -109,7 +109,7 @@ Yii поддерживает множество хранилищ кэша: ## Кэш API, -У всех компонентов кэша один базовый класс [[yii\caching\Cache]] со следующими методами: +У всех компонентов кэша имеется один базовый класс [[yii\caching\Cache]] со следующими методами: * [[yii\caching\Cache::get()|get()]]: возвращает данные по указанному ключу. Если данные не найдены или устарели, то значение `false` будет возвращено; @@ -291,9 +291,9 @@ $result = $db->cache(function ($db) { }, $duration, $dependency); ``` -Любые SQL запросы в анонимной функции будут кэшироваться в течении указанного промежутка времени с заданной зависимостью. Если результат в кэше актуален - запрос будет пропущен и, вместо этого, из кэша будет возвращен результат. Если вы не укажете `'$duration'`, то значение [[yii\db\Connection::queryCacheDuration|queryCacheDuration]] будет использоваться вместо него. +Любые SQL запросы в анонимной функции будут кэшироваться в течение указанного промежутка времени и с помощью заданной зависимости. Если результат запроса в кэше актуален, запрос будет пропущен, и вместо этого из кэша будет возвращен результат. Если вы не укажете параметр `'$duration'`, то значение [[yii\db\Connection::queryCacheDuration|queryCacheDuration]] будет использоваться вместо него. -Иногда в пределах `"cache()"` вы можете отключить кэширование запроса. В этом случае вы можете использовать [[yii\db\Connection::noCache()]]. +Иногда в пределах `"cache()"` вы можете захотеть отключить кэширование запроса. В этом случае вы можете использовать [[yii\db\Connection::noCache()]]. ```php $result = $db->cache(function ($db) { @@ -338,6 +338,6 @@ $result = $db->cache(function ($db) { ### Ограничения -Кэширование запросов не работает с результатами запросов, которые содержат обработчики ресурсов. Например, при использовании типа столбца `BLOB` в некоторых СУБД, в качестве результата запроса будет выведен ресурс обработчик данных столбца. +Кэширование запросов не работает с результатами запросов, которые содержат обработчики ресурсов. Например, при использовании столбца типа `BLOB` в некоторых СУБД, в качестве результата запроса будет возвращен указатель на ресурс для этого столбца данных. Некоторые кэш хранилища имеют ограничение в размере данных. Например, Memcache ограничивает максимальный размер каждой записи до 1 Мб. Таким образом, если результат запроса превышает этот предел, данные не будут закэшированы. diff --git a/docs/guide-ru/intro-yii.md b/docs/guide-ru/intro-yii.md index c44ae37..0c2fbdd 100644 --- a/docs/guide-ru/intro-yii.md +++ b/docs/guide-ru/intro-yii.md @@ -43,9 +43,10 @@ Yii — не проект одного человека. Он поддержив Требования к ПО и знаниям ------------------------- -Yii 2.0 требует PHP 5.4.0 и выше. Чтобы узнать требования для отдельных возможностей вы можете запустить скрипт проверки +Yii 2.0 требует PHP 5.4.0 и выше и наилучшим образом работает на последней версии PHP 7. Чтобы узнать требования для отдельных возможностей вы можете запустить скрипт проверки требований, который поставляется с каждым релизом фреймворка. -Для разработки на Yii потребуется общее понимание ООП так как фреймворк полностью следует этой парадигме. Также стоит +Для разработки на Yii потребуется общее понимание ООП, так как фреймворк полностью следует этой парадигме. Также стоит изучить такие современные возможности PHP как [пространства имён](http://www.php.net/manual/ru/language.namespaces.php) -и [трейты](http://www.php.net/manual/ru/language.oop5.traits.php). +и [трейты](http://www.php.net/manual/ru/language.oop5.traits.php). Понимание этих концепций позволит вам более легко освоиться c Yii 2.0. + diff --git a/docs/guide-ru/test-acceptance.md b/docs/guide-ru/test-acceptance.md index 7b27ab2..0ad6975 100644 --- a/docs/guide-ru/test-acceptance.md +++ b/docs/guide-ru/test-acceptance.md @@ -1,11 +1,16 @@ Приёмочное тестирование ======================= -> Note: Данный раздел находится в разработке. +Приемочный тест проверяет сценарий с точки зрения конечного пользователя. К тестируемому приложению получают доступ либо через PhpBrowser, либо через реальный браузер. В обоих случаях браузеры взаимодействуют с приложением через HTTP, поэтому приложение следует запускать посредством веб-сервера. +Приемочное тестирование реализуется с помощью фреймворка Codeception, который имеет отличную документацию: + +- [Codeception for Yii framework](http://codeception.com/for/yii) - [Codeception Acceptance Tests](http://codeception.com/docs/03-AcceptanceTests) Запуск тестов в шаблонах проектов basic и advanced -------------------------------------------------- -Инструкции приведены в `apps/advanced/tests/README.md` и `apps/basic/tests/README.md`. +Если вы начали с шаблона advanced, пожалуйста, обратитесь к руководству по ["Тестированию"](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/start-testing.md) для получения более детальной информации о запускаемых тестах. + +Если вы начали с шаблона basic, обратитесь к разделу ["Тестирование"](https://github.com/yiisoft/yii2-app-basic/blob/master/README.md#testing) в его README. diff --git a/docs/guide-ru/translators.json b/docs/guide-ru/translators.json index 55cb218..9758db9 100644 --- a/docs/guide-ru/translators.json +++ b/docs/guide-ru/translators.json @@ -49,5 +49,6 @@ "LAV45", "Maksim Pestov", "PendalF89", + "Max Alexandrov", "and others" ]