Commit 340fa2f8 by maxmirazh33

fixes for translation of file 'structure-extensions.md' to Russian

parent 4890a719
...@@ -2,8 +2,8 @@ ...@@ -2,8 +2,8 @@
========== ==========
Расширения - это распространяемые программные пакеты, специально разработанные для использования в приложениях Yii и Расширения - это распространяемые программные пакеты, специально разработанные для использования в приложениях Yii и
содержащие готовые функции. Например, расширение [yiisoft/yii2-debug](tool-debugger.md) добавляет удобную панель содержащие готовые функции. Например, расширение [yiisoft/yii2-debug](tool-debugger.md) добавляет удобную отладочную
отладки в нижнюю часть каждой страницы вашего приложения, чтобы помочь вам разобраться в том, как генерируются панель в нижнюю часть каждой страницы вашего приложения, чтобы помочь вам разобраться в том, как генерируются
страницы. Вы можете использовать расширения для ускорения процесса разработки. Вы также можете оформить ваш код как страницы. Вы можете использовать расширения для ускорения процесса разработки. Вы также можете оформить ваш код как
расширение, чтобы поделиться с другими людьми результатами вашей работы. расширение, чтобы поделиться с другими людьми результатами вашей работы.
...@@ -13,17 +13,17 @@ ...@@ -13,17 +13,17 @@
## Использование расширений <a name="using-extensions"></a> ## Использование расширений <a name="using-extensions"></a>
Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как пакеты
[Composer](https://getcomposer.org/)-пакеты, которые могут быть установлены посредством следующих двух шагов: [Composer](https://getcomposer.org/), которые могут быть установлены посредством следующих двух шагов:
1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (Composer-пакеты) вы хотите 1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (пакеты Composer) вы хотите
установить. установить.
2. Выполните команду `php composer.phar install`, чтобы установить указанные расширения. 2. Выполните команду `php composer.phar install`, чтобы установить указанные расширения.
Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет. Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет.
По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем
репозитории для Composer-пакетов с открытым исходным кодом. Вы также можете репозитории для пакетов Composer с открытым исходным кодом. Вы также можете
[создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его [создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его
использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих
проектах. проектах.
...@@ -51,7 +51,7 @@ ...@@ -51,7 +51,7 @@
> Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда > Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда
разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются
`yiisoft/yii2-xyz`, где `xyz` меняется для разных расширений. `yiisoft/yii2-xyz`, где `xyz` является названием расширения.
Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы
можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`. можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`.
...@@ -256,7 +256,7 @@ class MyBootstrapClass implements BootstrapInterface ...@@ -256,7 +256,7 @@ class MyBootstrapClass implements BootstrapInterface
public function bootstrap($app) public function bootstrap($app)
{ {
$app->on(Application::EVENT_BEFORE_REQUEST, function () { $app->on(Application::EVENT_BEFORE_REQUEST, function () {
// полезный код // остальной код
}); });
} }
} }
...@@ -282,7 +282,7 @@ class MyBootstrapClass implements BootstrapInterface ...@@ -282,7 +282,7 @@ class MyBootstrapClass implements BootstrapInterface
#### Работа с базами данных <a name="working-with-databases"></a> #### Работа с базами данных <a name="working-with-databases"></a>
Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение, Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение,
всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вы должны объявить свойство `db` в классах, всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вам следует объявить свойство `db` в классах,
которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД, которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД,
которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу
[[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`. [[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`.
...@@ -298,8 +298,8 @@ class MyBootstrapClass implements BootstrapInterface ...@@ -298,8 +298,8 @@ class MyBootstrapClass implements BootstrapInterface
Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых
[ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат [ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат
изображения, JavaScript и CSS. Так как все файлы расширения находятся в одной директории, недоступной из интернета, у изображения, JavaScript и CSS. Так как все файлы расширения находятся в директории, недоступной из интернета, у вас
вас есть два варианта сделать директорию ресурсов непосредственно доступной из интернета: есть два варианта сделать директорию ресурсов непосредственно доступной из интернета:
- попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку; - попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку;
- объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически - объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически
...@@ -313,7 +313,7 @@ class MyBootstrapClass implements BootstrapInterface ...@@ -313,7 +313,7 @@ class MyBootstrapClass implements BootstrapInterface
Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение
отображает содержимое конечному пользователю, вы должны попробовать отображает содержимое конечному пользователю, вы должны попробовать
[интернационализировать и локализовать](tutorial-i18n.md) его. В частности, [интернационализовать и локализовать](tutorial-i18n.md) его. В частности,
- Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в - Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в
метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например, метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например,
...@@ -360,7 +360,7 @@ class MyBootstrapClass implements BootstrapInterface ...@@ -360,7 +360,7 @@ class MyBootstrapClass implements BootstrapInterface
* Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот * Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот
файл может быть написан в формате Markdown и назван `upgrade.md`. файл может быть написан в формате Markdown и назван `upgrade.md`.
* Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много * Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много
возможностей, которые нельзя полностью описать в файле readme. возможностей, которые невозможно полностью описать в файле readme.
* Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы * Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы
можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php), можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php),
чтобы узнать, как нужно документировать код. чтобы узнать, как нужно документировать код.
...@@ -379,7 +379,7 @@ Yii предоставляет следующие базовые расшире ...@@ -379,7 +379,7 @@ Yii предоставляет следующие базовые расшире
[Использование расширений](#using-extensions). [Использование расширений](#using-extensions).
- [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc): - [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc):
обеспечивает расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации предоставляет расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации
документации API фреймворка. документации API фреймворка.
- [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient): - [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient):
предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub
...@@ -389,7 +389,7 @@ Yii предоставляет следующие базовые расшире ...@@ -389,7 +389,7 @@ Yii предоставляет следующие базовые расшире
- [yiisoft/yii2-codeception](https://github.com/yiisoft/yii2-codeception): - [yiisoft/yii2-codeception](https://github.com/yiisoft/yii2-codeception):
предоставляет поддержку тестирования, основанного на [Codeception](http://codeception.com/). предоставляет поддержку тестирования, основанного на [Codeception](http://codeception.com/).
- [yiisoft/yii2-debug](https://github.com/yiisoft/yii2-debug): - [yiisoft/yii2-debug](https://github.com/yiisoft/yii2-debug):
предоставляет поддержку отладки в приложениях Yii. Когда это расширение используется, панель отладки появится в предоставляет поддержку отладки в приложениях Yii. Когда это расширение используется, отладочная панель появится в
нижней части каждой страницы. Это расширение также предоставляет набор отдельных страниц для отображения более нижней части каждой страницы. Это расширение также предоставляет набор отдельных страниц для отображения более
подробной отладочной информации. подробной отладочной информации.
- [yiisoft/yii2-elasticsearch](https://github.com/yiisoft/yii2-elasticsearch): - [yiisoft/yii2-elasticsearch](https://github.com/yiisoft/yii2-elasticsearch):
...@@ -408,10 +408,10 @@ Yii предоставляет следующие базовые расшире ...@@ -408,10 +408,10 @@ Yii предоставляет следующие базовые расшире
предоставляет набор виджетов, основанный на взаимодействиях и виджетах [JQuery UI](http://jqueryui.com/). предоставляет набор виджетов, основанный на взаимодействиях и виджетах [JQuery UI](http://jqueryui.com/).
- [yiisoft/yii2-mongodb](https://github.com/yiisoft/yii2-mongodb): - [yiisoft/yii2-mongodb](https://github.com/yiisoft/yii2-mongodb):
предоставляет поддержку использования [MongoDB](http://www.mongodb.org/). Оно включает такие возможности, как предоставляет поддержку использования [MongoDB](http://www.mongodb.org/). Оно включает такие возможности, как
базовые запросы, Active Record, миграции, кеширование, генерация кода и т.д. базовые запросы, Active Record, миграции, кэширование, генерация кода и т.д.
- [yiisoft/yii2-redis](https://github.com/yiisoft/yii2-redis): - [yiisoft/yii2-redis](https://github.com/yiisoft/yii2-redis):
предоставляет поддержку использования [redis](http://redis.io/). Оно включает такие возможности, как базовые запросы, предоставляет поддержку использования [redis](http://redis.io/). Оно включает такие возможности, как базовые запросы,
Active Record, кеширование и т.д. Active Record, кэширование и т.д.
- [yiisoft/yii2-smarty](https://github.com/yiisoft/yii2-smarty): - [yiisoft/yii2-smarty](https://github.com/yiisoft/yii2-smarty):
предоставляет шаблонизатор, основанный на [Smarty](http://www.smarty.net/). предоставляет шаблонизатор, основанный на [Smarty](http://www.smarty.net/).
- [yiisoft/yii2-sphinx](https://github.com/yiisoft/yii2-sphinx): - [yiisoft/yii2-sphinx](https://github.com/yiisoft/yii2-sphinx):
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment