From 77569c8587699a5b8e3ec9c401abf177093b4b6f Mon Sep 17 00:00:00 2001 From: John Kind Date: Sat, 9 Jan 2016 19:38:28 +0300 Subject: [PATCH 1/2] Fix typo in documentation. --- docs/guide-ru/concept-service-locator.md | 2 +- docs/guide-ru/input-file-upload.md | 4 ++-- docs/guide-ru/output-data-providers.md | 10 +++++----- docs/guide-ru/tutorial-console.md | 18 +++++++++--------- docs/guide/tutorial-console.md | 2 +- 5 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/guide-ru/concept-service-locator.md b/docs/guide-ru/concept-service-locator.md index b0a341dd57..1247717594 100644 --- a/docs/guide-ru/concept-service-locator.md +++ b/docs/guide-ru/concept-service-locator.md @@ -62,7 +62,7 @@ $cache = $locator->cache; Поскольку Service Locator часто используется с [конфигурациями](concept-configurations.md), в нём имеется доступное для записи свойство [[yii\di\ServiceLocator::setComponents()|components]]. Это позволяет настроить и зарегистрировать сразу несколько компонентов. Следующий код демонстрирует конфигурационный массив, который может использоваться -для регистрации компонентов "db", "cache" и "search" в (то есть в [приложении](structure-applications.md)): +для регистрации компонентов "db", "cache" и "search" в Service Locator (то есть в [приложении](structure-applications.md)): ```php return [ diff --git a/docs/guide-ru/input-file-upload.md b/docs/guide-ru/input-file-upload.md index c15de9af9b..dd64725aa7 100644 --- a/docs/guide-ru/input-file-upload.md +++ b/docs/guide-ru/input-file-upload.md @@ -118,8 +118,8 @@ class SiteController extends Controller Для загрузки нескольких файлов достаточно внести в предыдущий код несколько небольших изменений. -Сначала нужно добавить в правило валидации `file` параметр `maxFiles` для ограничения максимального количество -загружаемых одновременно файлов. Установка `maxFiles` равным `0` означает снятие ограничений на количесово файлов, +Сначала нужно добавить в правило валидации `file` параметр `maxFiles` для ограничения максимального количества +загружаемых одновременно файлов. Установка `maxFiles` равным `0` означает снятие ограничений на количество файлов, которые могут быть загружены одновременно. Максимально разрешенное количество одновременно закачиваемых файлов также ограничивается директивой PHP [`max_file_uploads`](http://php.net/manual/ru/ini.core.php#ini.max-file-uploads), и по умолчанию равно 20. Метод `upload()` нужно изменить для сохранения загруженных файлов по одному. diff --git a/docs/guide-ru/output-data-providers.md b/docs/guide-ru/output-data-providers.md index f5df604575..52ab10840f 100644 --- a/docs/guide-ru/output-data-providers.md +++ b/docs/guide-ru/output-data-providers.md @@ -90,9 +90,9 @@ use yii\db\Query; $query = (new Query())->from('post')->where(['status' => 1]); ``` -> Совет: Если query содержит условия сортировки в `orderBy`, то новые условия, полученные от конечных пользователей +> Note: Если query содержит условия сортировки в `orderBy`, то новые условия, полученные от конечных пользователей (через настройки `sort`) будут добавлены к существующим условиям в `orderBy`. Любые условия в `limit` и `offset` - and `offset` будут переписаны запросом конечного пользователя к различным страницам ( через конфигурацию `pagination`) + будут переписаны запросом конечного пользователя к различным страницам ( через конфигурацию `pagination`). По умолчанию, [[yii\data\ActiveDataProvider]] использует компонент приложения `db` для подключения к базе данных. Можно использовать разные базы данных, настроив подключение через конфигурацию свойства [[yii\data\ActiveDataProvider::db]]. @@ -198,10 +198,10 @@ $posts = $provider->getModels(); $ids = $provider->getKeys(); ``` -В выше описанном примере, так как [[yii\data\ActiveDataProvider]] предоставляется один [[yii\db\ActiveQuery]] объект, то +В вышеописанном примере, так как [[yii\data\ActiveDataProvider]] предоставляется один [[yii\db\ActiveQuery]] объект, то в этом случае провайдер достаточно умён, чтобы вернуть значения первичных ключей в качестве идентификатора. Также есть -возможность настроить способ вычисления значение идентификатора, через настройку [[yii\data\ActiveDataProvider::key]], как -имя колонки или функция вычисления значений ключа. Например: +возможность настроить способ вычисления значения идентификатора, через настройку [[yii\data\ActiveDataProvider::key]], как +имя колонки или функцию вычисления значений ключа. Например: ```php // используется "slug" колонка как ключ diff --git a/docs/guide-ru/tutorial-console.md b/docs/guide-ru/tutorial-console.md index fd808e63ab..0b2ceb10e1 100644 --- a/docs/guide-ru/tutorial-console.md +++ b/docs/guide-ru/tutorial-console.md @@ -27,7 +27,7 @@ Больше об этой команде вы можете узнать в [I18N Section](tutorial-i18n.md#message-command). - [[yii\console\controllers\MigrateController|MigrateController]] - Управление миграциями приложения. Миграции базы данных более детально описаны в [Database Migration Section](db-migrations.md). -- [[yii\console\controllers\ServeController|ServeController]] - позволяет запускать встроенный вебсервер PHP. +- [[yii\console\controllers\ServeController|ServeController]] - Позволяет запускать встроенный вебсервер PHP. Использование @@ -139,8 +139,8 @@ exit($exitCode); умолчанию, если они определены. Если значения по умолчанию не определены, и не были переданы, команда завершит выполнение с ошибкой. -Вы можете использовать указание типа `array`, чтобы указать что аргумент должен рассматриваться как массив. Массив -будет сгенерирован путём разделение входной строки по запятым. +Вы можете использовать указание типа `array`, чтобы указать, что аргумент должен рассматриваться как массив. Массив +будет сгенерирован путём разделения входной строки по запятым. Следующий пример показывает как описывать аргументы: @@ -165,7 +165,7 @@ class ExampleController extends \yii\console\Controller При разработке консольного приложения принято использовать код возврата. Принято, код `0` означает, что команда выполнилась удачно. Если команда вернула код больше нуля, то это говорит об ошибке. Номер, который был возвращён при ошибке, -потенциально может быть использован для поиска более детальной информации о ошибке. +потенциально может быть использован для поиска более детальной информации об ошибке. Для примера `1` может указывать на неизвестную ошибку, а все коды выше могут быть зарезервированы под специфичные ошибки: ошибки ввода, повреждённые файлы, и что-то другое. @@ -174,11 +174,11 @@ class ExampleController extends \yii\console\Controller ```php public function actionIndex() { - if (/* some problem */) { - echo "A problem occured!\n"; + if (/* возникла проблема */) { + echo "Возникла проблема!\n"; return 1; } - // do something + // делаем что-нибудь return 0; } ``` @@ -192,8 +192,8 @@ public function actionIndex() ### Форматирование и цвета -Консоль Yii поддерживает форматирование вывода, который автоматически деградирует до не форматированного, если это поддерживается -в терминале где запускается команда. +Консоль Yii поддерживает форматирование вывода, который автоматически деградирует до не форматированного, если это не поддерживается +в терминале, где запускается команда. Вывод форматированных строк прост. Вот как можно вывести некоторый жирный текст: diff --git a/docs/guide/tutorial-console.md b/docs/guide/tutorial-console.md index 3426f4d7bb..60c3cc20b7 100644 --- a/docs/guide/tutorial-console.md +++ b/docs/guide/tutorial-console.md @@ -172,7 +172,7 @@ method: public function actionIndex() { if (/* some problem */) { - echo "A problem occured!\n"; + echo "A problem occurred!\n"; return 1; } // do something From 04804174421a75102dc80760008315c6368434a2 Mon Sep 17 00:00:00 2001 From: John Kind Date: Sat, 9 Jan 2016 19:42:06 +0300 Subject: [PATCH 2/2] Fix markdown indent --- docs/guide-ru/structure-assets.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guide-ru/structure-assets.md b/docs/guide-ru/structure-assets.md index 7143cae781..3fb447aa81 100644 --- a/docs/guide-ru/structure-assets.md +++ b/docs/guide-ru/structure-assets.md @@ -44,8 +44,8 @@ class AppAsset extends AssetBundle * [[yii\web\AssetBundle::basePath|basePath]]: задаёт Web доступную директорию, которая содержит файлы ресурсов текущего комплекта. Когда Вы задаёте свойство [[yii\web\AssetBundle::sourcePath|sourcePath]] [Менеджер ресурсов](#asset-manager) опубликует ресурсы текущего комплекта в Web доступную директорию и перезапишет соответственно данное свойство. Вы должны задать данное свойство если Ваши файлы ресурсов уже в Web доступной директории и не нужно опубликовывать ресурсы. Здесь могут быть использованы [псевдонимы путей](concept-aliases.md). * [[yii\web\AssetBundle::baseUrl|baseUrl]]: задаёт URL соответствующий директории [[yii\web\AssetBundle::basePath|basePath]]. Также как и для [[yii\web\AssetBundle::basePath|basePath]], если Вы задаёте свойство [[yii\web\AssetBundle::sourcePath|sourcePath]] [Менеджер ресурсов](#asset-manager) опубликует ресурсы и перезапишет это свойство соответственно. Здесь могут быть использованы [псевдонимы путей](concept-aliases.md). * [[yii\web\AssetBundle::js|js]]: массив, перечисляющий JavaScript файлы, содержащиеся в данном комплекте. Заметьте, что только прямая косая черта (forward slash - "/") может быть использована, как разделитель директорий. Каждый JavaScript файл может быть задан в одном из следующих форматов: -- относительный путь, представленный локальным JavaScript файлом (например `js/main.js`). Актуальный путь файла может быть определён путём добавления [[yii\web\AssetManager::basePath]] к относительному пути, и актуальный URL файла может быть определён путём добавления [[yii\web\AssetManager::baseUrl]] к относительному пути. -- абсолютный URL, представленный внешним JavaScript файлом. Например, + - относительный путь, представленный локальным JavaScript файлом (например `js/main.js`). Актуальный путь файла может быть определён путём добавления [[yii\web\AssetManager::basePath]] к относительному пути, и актуальный URL файла может быть определён путём добавления [[yii\web\AssetManager::baseUrl]] к относительному пути. + - абсолютный URL, представленный внешним JavaScript файлом. Например, `http://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js` или `//ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js`. * [[yii\web\AssetBundle::css|css]]: массив, перечисляющий CSS файлы, содержащиеся в данном комплекте. Формат этого массива такой же, как и у [[yii\web\AssetBundle::js|js]].