From 2249a9eb993b2541aca9fbd504e27d1ac3c02dbe Mon Sep 17 00:00:00 2001 From: maxmirazh33 Date: Sun, 24 Aug 2014 22:39:02 +0700 Subject: [PATCH] fixes for translation of file 'structure-extensions.md' to Russian --- docs/guide-ru/structure-extensions.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/guide-ru/structure-extensions.md b/docs/guide-ru/structure-extensions.md index 318e2da..1cc7121 100644 --- a/docs/guide-ru/structure-extensions.md +++ b/docs/guide-ru/structure-extensions.md @@ -13,17 +13,17 @@ ## Использование расширений -Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как -[Composer](https://getcomposer.org/)-пакеты, которые могут быть установлены посредством следующих двух шагов: +Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как пакеты +[Composer](https://getcomposer.org/), которые могут быть установлены посредством следующих двух шагов: -1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (Composer-пакеты) вы хотите +1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (пакеты Composer) вы хотите установить. 2. Выполните команду `php composer.phar install`, чтобы установить указанные расширения. Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет. По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем -репозитории для Composer-пакетов с открытым исходным кодом. Вы также можете +репозитории для пакетов Composer с открытым исходным кодом. Вы также можете [создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих проектах. @@ -51,7 +51,7 @@ > Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются - `yiisoft/yii2-xyz`, где `xyz` меняется для разных расширений. + `yiisoft/yii2-xyz`, где `xyz` является названием расширения. Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`. @@ -256,7 +256,7 @@ class MyBootstrapClass implements BootstrapInterface public function bootstrap($app) { $app->on(Application::EVENT_BEFORE_REQUEST, function () { - // полезный код + // остальной код }); } } @@ -282,7 +282,7 @@ class MyBootstrapClass implements BootstrapInterface #### Работа с базами данных Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение, -всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вы должны объявить свойство `db` в классах, +всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вам следует объявить свойство `db` в классах, которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД, которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу [[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`. @@ -298,8 +298,8 @@ class MyBootstrapClass implements BootstrapInterface Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых [ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат -изображения, JavaScript и CSS. Так как все файлы расширения находятся в одной директории, недоступной из интернета, у -вас есть два варианта сделать директорию ресурсов непосредственно доступной из интернета: +изображения, JavaScript и CSS. Так как все файлы расширения находятся в директории, недоступной из интернета, у вас +есть два варианта сделать директорию ресурсов непосредственно доступной из интернета: - попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку; - объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически @@ -313,7 +313,7 @@ class MyBootstrapClass implements BootstrapInterface Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение отображает содержимое конечному пользователю, вы должны попробовать -[интернационализировать и локализовать](tutorial-i18n.md) его. В частности, +[интернационализовать и локализовать](tutorial-i18n.md) его. В частности, - Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например, @@ -360,7 +360,7 @@ class MyBootstrapClass implements BootstrapInterface * Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот файл может быть написан в формате Markdown и назван `upgrade.md`. * Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много - возможностей, которые нельзя полностью описать в файле readme. + возможностей, которые невозможно полностью описать в файле readme. * Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php), чтобы узнать, как нужно документировать код. @@ -379,7 +379,7 @@ Yii предоставляет следующие базовые расшире [Использование расширений](#using-extensions). - [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc): - обеспечивает расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации + предоставляет расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации документации API фреймворка. - [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient): предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub