added Russian 5.1.1 docs
diff --git a/docs/ru/5.1.1/config.json b/docs/ru/5.1.1/config.json
new file mode 100644
index 0000000..9d3477d
--- /dev/null
+++ b/docs/ru/5.1.1/config.json
@@ -0,0 +1,18 @@
+{
+ "language": "Russian",
+ "merge": {
+ "events.md": [
+ "cordova/events/events.md",
+ "cordova/events/events.deviceready.md",
+ "cordova/events/events.pause.md",
+ "cordova/events/events.resume.md",
+ "cordova/events/events.backbutton.md",
+ "cordova/events/events.menubutton.md",
+ "cordova/events/events.searchbutton.md",
+ "cordova/events/events.startcallbutton.md",
+ "cordova/events/events.endcallbutton.md",
+ "cordova/events/events.volumedownbutton.md",
+ "cordova/events/events.volumeupbutton.md"
+ ]
+ }
+}
diff --git a/docs/ru/5.1.1/config_ref/images.md b/docs/ru/5.1.1/config_ref/images.md
new file mode 100644
index 0000000..d29fa13
--- /dev/null
+++ b/docs/ru/5.1.1/config_ref/images.md
@@ -0,0 +1,210 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Иконки и заставки
+
+В этом разделе показано, как настроить иконку приложения и дополнительные заставки для различных платформ, как при работе с Cordova CLI (описано в разделе Интерфейс Командной Строки) так и с помощью средств SDK специфических для платформы (подробнее в разделе Руководстве по поддерживаемым платформам).
+
+## Настройка иконок в CLI
+
+При работе в CLI можно определить icon(s) app через элемент `<icon>` (`config.xml`). Если значок не задан, то используется логотип Apache Cordova.
+
+ <icon src="res/ios/icon.png" platform="ios" width="57" height="57" density="mdpi" />
+
+
+src: (обязательный) указывает расположение файла с изображением, относительно каталога проекта
+
+platform: (необязательно) Целевая платформа
+
+width: (необязательно) ширина иконки в пикселях
+
+height: (необязательно) высота иконки в пикселях
+
+density: (опционально) Только для android, указывает плотность пикселей для иконки
+
+Следующая конфигурация может использоваться для определения одной иконки по умолчанию, которая будет использоваться для всех платформ.
+
+ <icon src="res/icon.png" />
+
+
+Для каждой платформы можно также определить подобранные с точностью до пикселя значки, заданные для различных разрешений экрана.
+
+Amazon Fire OS
+
+ <platform name="amazon-fireos">
+ <icon src="res/android/ldpi.png" density="ldpi" />
+ <icon src="res/android/mdpi.png" density="mdpi" />
+ <icon src="res/android/hdpi.png" density="hdpi" />
+ <icon src="res/android/xhdpi.png" density="xhdpi" />
+ </platform>
+
+
+Android
+
+ <platform name="android">
+ <icon src="res/android/ldpi.png" density="ldpi" />
+ <icon src="res/android/mdpi.png" density="mdpi" />
+ <icon src="res/android/hdpi.png" density="hdpi" />
+ <icon src="res/android/xhdpi.png" density="xhdpi" />
+ </platform>
+
+
+BlackBerry10
+
+ <platform name="blackberry10">
+ <icon src="res/bb10/icon-86.png" />
+ <icon src="res/bb10/icon-150.png" />
+ </platform>
+
+
+Смотрите документацию BlackBerry при ориентировании на набор различных размеров и языков. [http://developer.blackberry.com/html5/documentation/icon_element.html]
+
+Firefox OS
+
+ <platform name="firefoxos">
+ <icon src="res/ff/logo.png" width="60" height="60" />
+ </platform>
+
+
+iOS
+
+ <platform name="ios">
+ <!-- iOS 8.0+ -->
+ <!-- iPhone 6 Plus -->
+ <icon src="res/ios/icon-60@3x.png" width="180" height="180" />
+ <!-- iOS 7.0+ -->
+ <!-- iPhone / iPod Touch -->
+ <icon src="res/ios/icon-60.png" width="60" height="60" />
+ <icon src="res/ios/icon-60@2x.png" width="120" height="120" />
+ <!-- iPad -->
+ <icon src="res/ios/icon-76.png" width="76" height="76" />
+ <icon src="res/ios/icon-76@2x.png" width="152" height="152" />
+ <!-- iOS 6.1 -->
+ <!-- Spotlight Icon -->
+ <icon src="res/ios/icon-40.png" width="40" height="40" />
+ <icon src="res/ios/icon-40@2x.png" width="80" height="80" />
+ <!-- iPhone / iPod Touch -->
+ <icon src="res/ios/icon.png" width="57" height="57" />
+ <icon src="res/ios/icon@2x.png" width="114" height="114" />
+ <!-- iPad -->
+ <icon src="res/ios/icon-72.png" width="72" height="72" />
+ <icon src="res/ios/icon-72@2x.png" width="144" height="144" />
+ <!-- iPhone Spotlight and Settings Icon -->
+ <icon src="res/ios/icon-small.png" width="29" height="29" />
+ <icon src="res/ios/icon-small@2x.png" width="58" height="58" />
+ <!-- iPad Spotlight and Settings Icon -->
+ <icon src="res/ios/icon-50.png" width="50" height="50" />
+ <icon src="res/ios/icon-50@2x.png" width="100" height="100" />
+ </platform>
+
+
+Tizen
+
+ <platform name="tizen">
+ <icon src="res/tizen/icon-128.png" width="128" height="128" />
+ </platform>
+
+
+Windows Phone8
+
+ <platform name="wp8">
+ <icon src="res/wp/ApplicationIcon.png" width="99" height="99" />
+ <!-- tile image -->
+ <icon src="res/wp/Background.png" width="159" height="159" />
+ </platform>
+
+
+Windows8
+
+ <platform name="windows8">
+ <icon src="res/windows8/logo.png" width="150" height="150" />
+ <icon src="res/windows8/smalllogo.png" width="30" height="30" />
+ <icon src="res/windows8/storelogo.png" width="50" height="50" />
+ </platform>
+
+
+## Настройка заставки с помощью CLI
+
+В файле `config.xml` верхнего уровня (не том который расположен в `platforms` ), добавьте элементы конфигурации как те, которые указаны здесь.
+
+# Пример конфигурации
+
+Пожалуйста, обратите внимание, что значение атрибута "src" определяется относительно каталога проекта, а не относительно каталога www. Вы можете называть файл исходного изображения как угодно. Внутреннее имя в приложении определяется Cordova.
+
+ <platform name="android">
+ <!-- you can use any density that exists in the Android project -->
+ <splash src="res/screen/android/splash-land-hdpi.png" density="land-hdpi"/>
+ <splash src="res/screen/android/splash-land-ldpi.png" density="land-ldpi"/>
+ <splash src="res/screen/android/splash-land-mdpi.png" density="land-mdpi"/>
+ <splash src="res/screen/android/splash-land-xhdpi.png" density="land-xhdpi"/>
+
+ <splash src="res/screen/android/splash-port-hdpi.png" density="port-hdpi"/>
+ <splash src="res/screen/android/splash-port-ldpi.png" density="port-ldpi"/>
+ <splash src="res/screen/android/splash-port-mdpi.png" density="port-mdpi"/>
+ <splash src="res/screen/android/splash-port-xhdpi.png" density="port-xhdpi"/>
+ </platform>
+
+ <platform name="ios">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
+ <splash src="res/screen/ios/Default@2x~iphone.png" width="640" height="960"/>
+ <splash src="res/screen/ios/Default-Portrait~ipad.png" width="768" height="1024"/>
+ <splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
+ <splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024" height="768"/>
+ <splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
+ <splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640" height="1136"/>
+ <splash src="res/screen/ios/Default-667h.png" width="750" height="1334"/>
+ <splash src="res/screen/ios/Default-736h.png" width="1242" height="2208"/>
+ <splash src="res/screen/ios/Default-Landscape-736h.png" width="2208" height="1242"/>
+ </platform>
+
+ <platform name="wp8">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/wp8/SplashScreenImage.jpg" width="768" height="1280"/>
+ </platform>
+
+ <platform name="windows8">
+ <!-- images are determined by width and height. The following are supported -->
+ <splash src="res/screen/windows8/splashscreen.png" width="620" height="300"/>
+ </platform>
+
+ <platform name="blackberry10">
+ <!-- Add a rim:splash element for each resolution and locale you wish -->
+ <!-- http://developer.blackberry.com/html5/documentation/rim_splash_element.html -->
+ <rim:splash src="res/screen/windows8/splashscreen.png"/>
+ </platform>
+
+
+ <preference name="SplashScreenDelay" value="10000" />
+
+
+# Поддерживаемые платформы
+
+На данный момент (Cordova 3.5.0 июль 2014 года) следующие платформы поддерживают экраны-заставки.
+
+ android
+ ios
+ wp8
+ windows8
+ blackberry10
+
+
+# Плагин SplashScreen
+
+Apache Cordova также предлагает специальный плагин для упралвения экранами-заставками, который может быть использован для программного отображения и скрытия заставки во время запуска приложения https://github.com/apache/cordova-plugin-splashscreen
\ No newline at end of file
diff --git a/docs/ru/5.1.1/config_ref/index.md b/docs/ru/5.1.1/config_ref/index.md
new file mode 100644
index 0000000..2266a83
--- /dev/null
+++ b/docs/ru/5.1.1/config_ref/index.md
@@ -0,0 +1,199 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Файл config.xml
+
+Многие аспекты поведения приложения могут контролироваться с помощью глобального конфигурационного файла `config.xml`. Этот платформо-зависимый XML-файл основан на спецификации W3C [Упакованые веб-приложения (Packaged Web Apps)][1] и расширен для определения основных функций Cordova API, плагинов и настроек специфичных для платформы.
+
+ [1]: http://www.w3.org/TR/widgets/
+
+Для проектов, созданных с использованием Cordova CLI (описанном в разделе Интерфейс командной строки) этот файл можно найти в директории верхнего уровня:
+
+ app/config.xml
+
+
+Обратите внимание, что до версии 3.3.1-0.2.0, файл располагался в `app/www/config.xml`, и что размещение файла в этом месте по-прежнему поддерживается.
+
+При использовании командной строки для построения проекта, версии этого файла копируются без изменений в различные подкаталоги `platforms/`, например:
+
+ app/platforms/ios/AppName/config.xml
+ app/platforms/blackberry10/www/config.xml
+ app/platforms/android/res/xml/config.xml
+
+
+Этот раздел описывает параметры глобальной и кросс платформенной конфигурации. В следующих разделах для платформо-зависимых параметров:
+
+* Конфигурация iOS
+* Конфигурация Android
+* Конфигурация BlackBerry 10
+
+В дополнение к различным конфигурационным параметрам описанным ниже, можно также настроить основной набор изображений для приложения для каждой целевой платформы. Смотрите раздел Иконки и заставки для дополнительной информации.
+
+## Основные элементы конфигурации
+
+Этот пример показывает значения по умолчанию в файле `config.xml` сформированном командой CLI `create`, описанной в разделе Интерфейс командной строки:
+
+ <widget id="com.example.hello" version="0.0.1">
+ <name>HelloWorld</name>
+ <description>
+ A sample Apache Cordova application that responds to the deviceready event.
+ </description>
+ <author email="dev@callback.apache.org" href="http://cordova.io">
+ Apache Cordova Team
+ </author>
+ <content src="index.html" />
+ <access origin="*" />
+ </widget>
+
+
+Следующие элементы конфигурации появляются в файле верхнего уровня `config.xml` и поддерживаются на всех существующих платформах Cordova:
+
+* Атрибут `id` элемента `<widget>` указывает идентификатор приложения в обратном формате доменных имен и атрибут `version` его полный номер версии в нотации майор/минор/патч.
+
+ Тег widget также может также иметь атрибуты, которые определяют альтернативные версии, а именно versionCode для Android и CFBundleVersion для iOS. Смотри раздел "Дополнительное управление версиями" ниже для подробностей.
+
+* Элемент `<name>` определяет официальное имя приложения, как оно отображается на главном экране устройства и в интерфейсе магазина приложений.
+
+* Элементы `<description>` и `<author>` определяют метаданные и контактную информацию, которые могут отображаться в каталоге магазина приложений.
+
+* Необязательный элемент `<content>` определяет стартовую страницу приложения в каталоге веб ресурсов верхнего уровня . Значением по умолчанию является `index.html` , которая обычно находится в каталоге верхнего уровня `www` проекта.
+
+* Элементы `<access>` определяют набор внешних доменов, с которым приложение имеет право взаимодействовать. Значение по умолчанию, показанное выше позволяет осуществлять доступ к любому серверу. Смотрите раздел "Инструкция по доступу к внешним ресурсам" для подробностей.
+
+* Элемент `<preference>` задает различные параметры как пару атрибутов `name`/`value`. Имя каждого параметра, указанного в атрибуте `name` указывается без учета регистра. Многие параметры являются уникальными для конкретных платформ, как это указано в начале этой страницы. В следующих разделах подробно описаны настройки, которые применяются к более чем одной платформе.
+
+### Дополнительное управление версиями
+
+Так, Android и iOS поддерживает вторую строку версии (или номер) помимо видимой в app магазины, [versionCode][2] для Android и [CFBundleVersion][3] для iOS. Ниже приведен пример, который явно задает versionCode и CFBundleVersion
+
+ [2]: http://developer.android.com/tools/publishing/versioning.html
+ [3]: http://stackoverflow.com/questions/4933093/cfbundleversion-in-the-info-plist-upload-error
+
+ <widget id="io.cordova.hellocordova"
+ version="0.0.1"
+ android-versionCode="7"
+ ios-CFBundleVersion="3.3.3">
+
+
+Если альтернативная версия не указана, будет использоваться следующие значения по умолчанию:
+
+ // assuming version = MAJOR.MINOR.PATCH-whatever
+ versionCode = PATCH + MINOR * 100 + MAJOR * 10000
+ CFBundleVersion = "MAJOR.MINOR.PATCH"
+
+
+## Глобальные настройки
+
+Следующие глобальные настройки применяются для всех платформ:
+
+* `Fullscreen` позволяет скрыть строку состояния в верхней части экрана. Значение по умолчанию — `false` . Пример:
+
+ <preference name="Fullscreen" value="true" />
+
+
+## Много-платформенный настройки
+
+Следующие параметры применяются для более чем одной платформы, но не ко всем из них:
+
+* `DisallowOverscroll` (логическое значение, по умолчанию `false` ): Установите в `true` если вы не хотите чтобы интерфейс отображал каких-либо обратной связи, когда пользователи прокручивают за начало или конец содержимого.
+
+ <preference name="DisallowOverscroll" value="true"/>
+
+ Применяется к Android и iOS. На iOS, совершение перелистывание за границу контента (overscroll) плавно возвращает положение контента назад в исходное положение. На Android это действие производит более тонкий светящийся эффект вдоль верхнего или нижнего края контента.
+
+* `BackgroundColor`: Задайте цвет фона приложения. Поддерживает шестнадцатеричное значение размером 4 байта, где первый байт представляющий альфа-канал и стандартные значения RGB для следующих трех байтов. В этом примере указывается голубой цвет:
+
+ <preference name="BackgroundColor" value="0xff0000ff"/>
+
+ Применяется к Android и BlackBerry. Переопределяет CSS, который доступен для *всех* платформ, например:`body{background-color:blue}`.
+
+* `HideKeyboardFormAccessoryBar`(логическое значение, по умолчанию `false` ): Установите в `true` чтобы скрыть дополнительную панель инструментов, которая появляется над клавиатурой, помогая пользователям перемещаться из одной формы ввода на другой.
+
+ <preference name="HideKeyboardFormAccessoryBar" value="true"/>
+
+ Применяется к iOS и BlackBerry.
+
+* `Orientation` (строка, по умолчанию `default`): позволяет вам заблокировать ориентацию и предотвратить интерфейс от вращения в ответ на изменения в ориентации. Возможные значения `default`, `landscape`, или `portrait`. Пример:
+
+ <preference name="Orientation" value="landscape" />
+
+ Кроме того можно указать любое значение платформо-зависимое значение для ориентации, если вы разместите элемент `<preference>` внутри элемента `<platform>`:
+
+ <platform name="android">
+ <preference name="Orientation" value="sensorLandscape" />
+ </platform>
+
+ Применяется к Android, iOS, WP8, Amazon Fire OS и Firefox OS.
+
+ **Примечание**: Значение `default` означает что Cordova удалит предпочитаемое значение orientation из файла конфигурации/манифеста платформы позволяя платформе использовать свое поведение по умолчанию.
+
+ Для iOS, чтобы указать как портретный так и альбомный режим вы будете использовать платформо-специфическое значение `all`:
+
+ <platform name="ios">
+ <preference name="Orientation" value="all" />
+ </platform>
+
+ Для iOS ориентацией можно программно управлять путем определения функции обратного вызова javascript в объекте `window`:
+
+ <pre>/**
+ * @param {Number} degree
+ * UIInterfaceOrientationPortrait: 0,
+ * UIInterfaceOrientationLandscapeRight: 90,
+ * UIInterfaceOrientationLandscapeLeft: -90,
+ * UIInterfaceOrientationPortraitUpsideDown: 180
+ *
+ * @returns {Boolean} Определяет допускается ли поворот.
+ */
+ function shouldRotateToOrientation(degrees) {
+ return true;
+ }
+ </pre>
+
+## Элемент *feature*
+
+При использовании командной строки для построения приложений, используйте команду `plugin`, чтобы включить API устройства. Это не изменяет файл `config.xml` верхнего уровня, так что элемент `<feature>` не применяется к вашему рабочему процессу. Если вы работаете непосредственно в SDK и используете специфический для платформы файл `config.xml` в качестве источника, используйте `<feature>` тег, чтобы включить API устройства и внешних плагинов. Эти элементы обычно присутствуют с разными значениями в платформо-зависимых файлах `config.xml`. К примеру, таким образом можно указать Device API для проектов Android:
+
+ <feature name="Device">
+ <param name="android-package" value="org.apache.cordova.device.Device" />
+ </feature>
+
+
+Вот как появляется элемент в проектах iOS:
+
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice" />
+ </feature>
+
+
+Смотрите подробную информацию о том, как определить каждую функции в разделе Справочник API. Также смотрите Руководство по разработке плагинов для получения дополнительной информации по плагинам.
+
+## Элемент *platform*
+
+При использовании командной строки для построения приложений, иногда бывает необходимо указать параметры или другие элементы, специфичные для конкретной платформы. Используйте элемент `<platform>` для указания конфигурации которая должна применяться только в файле `config.xml` определенной платформы. Например, вот как можно указать, что только на платформе Android следует использовать параметр Fullscreen:
+
+ <platform name="android">
+ <preference name="Fullscreen" value="true" />
+ </platform>
+
+
+## Элемент *hook*
+
+Представляет ваш пользовательский сценарий, который будет вызываться Cordova при возникновении определенных действий (например, после того, как плагин добавлен или логика подготовки платформы вызвана). Это полезно, когда вам нужно расширить функциональность Cordova по умолчанию. Смотрите "Руководство по хукам" для детальной информации.
+
+ <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" />
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.backbutton.md b/docs/ru/5.1.1/cordova/events/events.backbutton.md
new file mode 100644
index 0000000..fed1908
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.backbutton.md
@@ -0,0 +1,79 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# backbutton
+
+Событие возникает, когда пользователь нажимает кнопку "назад".
+
+ document.addEventListener("backbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Чтобы переопределить поведение по умолчанию кнопки back, зарегистрируйте обработчик события `backbutton`, обычно путем вызова `document.addEventListener`, после того как вы произойдет событий `deviceready`. Более не требуется вызывать никакой другой метод для переопределения поведения кнопки back.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Windows Phone 8
+
+## Краткий пример
+
+ document.addEventListener("backbutton", onBackKeyDown, false);
+
+ function onBackKeyDown() {
+ // Handle the back button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Back Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("backbutton", onBackKeyDown, false);
+ }
+
+ // Handle the back button
+ //
+ function onBackKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.deviceready.md b/docs/ru/5.1.1/cordova/events/events.deviceready.md
new file mode 100644
index 0000000..9c402f2
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.deviceready.md
@@ -0,0 +1,82 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# deviceready
+
+Событие возникает, когда Cordova загружена полностью.
+
+ document.addEventListener("deviceready", yourCallbackFunction, false);
+
+
+## Подробности
+
+Это событие имеет важное значение для любого приложения. Оно сигнализирует, что Cordova API для устройств загружены и готовы для работы.
+
+Кордова состоит из двух наборов исходных кодов: родной язык платформы и JavaScript. В то время как основной код загружается, отображается экран загрузки. Однако JavaScript загружает только после того, как загружен DOM. Это означает, что веб-приложение потенциально может вызвать JavaScript функцию Cordova, прежде тем как соответствующий машинный код будет доступен.
+
+Событие `deviceready` возникает после полной загрузки Cordova. Когда событие происходит, вы можете безопасно вызывать API Cordova. Приложения обычно устанавливают обработчик события с помощью `document.addEventListener` после загрузки DOM HTML-документа.
+
+Поведение события `deviceready` несколько отличается от других событий. Любой обработчик событий, зарегистрированных после того событие `deviceready` произошло, вызывается немедленно.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Tizen
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ function onDeviceReady() {
+ // Now safe to use device APIs
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Device Ready Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Now safe to use device APIs
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.endcallbutton.md b/docs/ru/5.1.1/cordova/events/events.endcallbutton.md
new file mode 100644
index 0000000..a93688d
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.endcallbutton.md
@@ -0,0 +1,79 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# endcallbutton
+
+Это событие вызывается, когда пользователь нажимает кнопку окончания звонка.
+
+ document.addEventListener("endcallbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие переопределяет поведение по умолчанию при окончании звонка.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+
+ function onEndCallKeyDown() {
+ // Handle the end call button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>End Call Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+ }
+
+ // Handle the end call button
+ //
+ function onEndCallKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.md b/docs/ru/5.1.1/cordova/events/events.md
new file mode 100644
index 0000000..88d5b09
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.md
@@ -0,0 +1,50 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# События
+
+> События жизненного цикла Cordova.
+
+## Типы событий
+
+* deviceready
+* pause
+* resume
+* backbutton
+* menubutton
+* searchbutton
+* startcallbutton
+* endcallbutton
+* volumedownbutton
+* volumeupbutton
+
+## События добавленные [cordova-plugin-battery-status][1]
+
+ [1]: https://github.com/apache/cordova-plugin-battery-status/blob/master/README.md
+
+* batterycritical
+* batterylow
+* batterystatus
+
+## События добавленные [cordova-plugin-network-information][2]
+
+ [2]: https://github.com/apache/cordova-plugin-network-information/blob/master/README.md
+
+* online
+* offline
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.menubutton.md b/docs/ru/5.1.1/cordova/events/events.menubutton.md
new file mode 100644
index 0000000..e223a6f
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.menubutton.md
@@ -0,0 +1,81 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# menubutton
+
+Событие возникает, когда пользователь нажимает кнопку меню.
+
+ document.addEventListener("menubutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Применение обработчика события переопределяет поведение кнопки меню по умолчанию.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("menubutton", onMenuKeyDown, false);
+
+ function onMenuKeyDown() {
+ // Handle the back button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Menu Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("menubutton", onMenuKeyDown, false);
+ }
+
+ // Handle the menu button
+ //
+ function onMenuKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.pause.md b/docs/ru/5.1.1/cordova/events/events.pause.md
new file mode 100644
index 0000000..f512b48
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.pause.md
@@ -0,0 +1,91 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# pause
+
+Событие возникает, когда приложение переводят в фоновом режиме.
+
+ document.addEventListener("pause", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие `pause` возникает, когда платформа переводит приложения в фоновом режиме, как правило, когда пользователь переключается на другое приложение.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("pause", onPause, false);
+
+ function onPause() {
+ // Handle the pause event
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Pause Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ document.addEventListener("pause", onPause, false);
+ }
+
+ // Handle the pause event
+ //
+ function onPause() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
+
+
+## Особенности iOS
+
+В обработчик события `pause`, все вызовы API Cordova или плагинов, которые идут через Objective-C не работают, а также любых интерактивных вызовов, например оповещения или вызовы `console.log()` . Они обрабатываются только когда приложение возобновляет работу, на следующий цикл выполнения.
+
+Специфичное для iOS событие `resign` доступно как альтернатива `pause` и определяет, когда пользователи включили кнопку **замка** чтобы заблокировать устройство с приложением работающим на переднем плане. Если приложение (и устройство) поддерживает многозадачность, это событие находится в паре с последующим событием `pause`, но только при работе в iOS 5. По сути всех заблокированных приложений в iOS 5, которые поддерживают многозадачность переводятся в фоновый режим. Чтобы приложение работало когда устройство заблокировано под iOS 5, необходимо отключить многозадачность приложения, установив [UIApplicationExitsOnSuspend][1] в значение `YES` . Чтобы выполняться когда устройство заблокировано на iOS 4, этот параметр не имеет значения.
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.resume.md b/docs/ru/5.1.1/cordova/events/events.resume.md
new file mode 100644
index 0000000..80366b9
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.resume.md
@@ -0,0 +1,105 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# resume
+
+Событие возникает, когда приложение восстанавливается из фонового режима.
+
+ document.addEventListener("resume", yourCallbackFunction, false);
+
+
+## Подробности
+
+Событие `resume` возникает, когда платформа переводит приложения из фонового режима.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* iOS
+* Windows Phone 8
+* Windows 8
+
+## Краткий пример
+
+ document.addEventListener("resume", onResume, false);
+
+ function onResume() {
+ // Handle the resume event
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Resume Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ document.addEventListener("resume", onResume, false);
+ }
+
+ // Handle the resume event
+ //
+ function onResume() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
+
+
+## Особенности iOS
+
+Любых интерактивных функций, вызываемых из обработкика события `pause` выполнять позже, когда приложение возобновляет свою работу, как сигнализируется событием `resume`. К этому относятся оповещения, вызовы `console.log()` и все вызовы из плагинов или Cordova API, которые идут через Objective-C.
+
+* Событие **active**
+
+ Специфичные для iOS `active` событие доступно как альтернатива `resume` и определяет, когда пользователям отключить кнопку **замка** , чтобы разблокировать устройство с приложением работающим на переднем плане. Если для приложения (и устройства) включена поддержка многозадачности, это находится в паре с последующим событием `resume`, но только под iOS 5. По сути всех заблокированных приложений в iOS 5, которые поддерживают многозадачность переводятся в фоновый режим. Чтобы приложение работало когда устройство заблокировано под iOS 5, необходимо отключить многозадачность приложения, установив [UIApplicationExitsOnSuspend][1] в значение `YES`. Чтобы выполняться когда устройство заблокировано на iOS 4, этот параметр не имеет значения.
+
+* Событие **resume**
+
+ При вызове из обработчика событий `resume`, интерактивных функций, таких как `alert()`, эти функции должны быть обернуты в `setTimeout()` вызов с таймаутом нулю, или же в приложение зависает. Например:
+
+ document.addEventListener("resume", onResume, false);
+ function onResume() {
+ setTimeout(function() {
+ // TODO: do your thing!
+ }, 0);
+ }
+
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.searchbutton.md b/docs/ru/5.1.1/cordova/events/events.searchbutton.md
new file mode 100644
index 0000000..9651908
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.searchbutton.md
@@ -0,0 +1,79 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# searchbutton
+
+Событие возникает, когда пользователь нажимает кнопку Поиск на Android.
+
+ document.addEventListener("searchbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки поиск на Android вы можете зарегистрировать обработчик события для события «searchbutton».
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* Android
+
+## Краткий пример
+
+ document.addEventListener("searchbutton", onSearchKeyDown, false);
+
+ function onSearchKeyDown() {
+ // Handle the search button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Search Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("searchbutton", onSearchKeyDown, false);
+ }
+
+ // Handle the search button
+ //
+ function onSearchKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.startcallbutton.md b/docs/ru/5.1.1/cordova/events/events.startcallbutton.md
new file mode 100644
index 0000000..7c5c8a2
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.startcallbutton.md
@@ -0,0 +1,79 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# startcallbutton
+
+Событие возникает, когда пользователь нажимает кнопку начала звонка.
+
+ document.addEventListener("startcallbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию начала вызова вы можете зарегистрировать обработчик для события `startcallbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+
+## Краткий пример
+
+ document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+
+ function onStartCallKeyDown() {
+ // Handle the start call button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Start Call Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+ }
+
+ // Handle the start call button
+ //
+ function onStartCallKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.volumedownbutton.md b/docs/ru/5.1.1/cordova/events/events.volumedownbutton.md
new file mode 100644
index 0000000..b2204fa
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.volumedownbutton.md
@@ -0,0 +1,80 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# volumedownbutton
+
+Событие возникает, когда пользователь нажимает кнопку уменьшения громкости.
+
+ document.addEventListener("volumedownbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки уменьшения громкости вы можете зарегистрировать обработчик для события `volumedownbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+* Android
+
+## Краткий пример
+
+ document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+
+ function onVolumeDownKeyDown() {
+ // Handle the volume down button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Volume Down Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+ }
+
+ // Handle the volume down button
+ //
+ function onVolumeDownKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/events/events.volumeupbutton.md b/docs/ru/5.1.1/cordova/events/events.volumeupbutton.md
new file mode 100644
index 0000000..d6b61bf
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/events/events.volumeupbutton.md
@@ -0,0 +1,80 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# volumeupbutton
+
+Событие возникает, когда пользователь нажимает кнопку повышения громкости.
+
+ document.addEventListener("volumeupbutton", yourCallbackFunction, false);
+
+
+## Подробности
+
+Если необходимо переопределить поведение по умолчанию кнопки увличения громкости вы можете зарегистрировать обработчик для события `volumeupbutton`.
+
+Приложения обычно должны использовать `window.addEventListener` чтобы добавить обработчик события после того как произойдет событие `deviceready`.
+
+## Поддерживаемые платформы
+
+* BlackBerry 10
+* Android
+
+## Краткий пример
+
+ document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+
+ function onVolumeUpKeyDown() {
+ // Handle the volume up button
+ }
+
+
+## Развернутый пример
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Volume Up Button Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ // Register the event listener
+ document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+ }
+
+ // Handle the volume up button
+ //
+ function onVolumeUpKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/plugins/pluginapis.md b/docs/ru/5.1.1/cordova/plugins/pluginapis.md
new file mode 100644
index 0000000..d85bf20
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/plugins/pluginapis.md
@@ -0,0 +1,136 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# API плагинов
+
+Cordova поставляется с минимальным набором APIs, и проекты которым необходимы дополнительные API, добавляют их через плагины.
+
+Вы можете искать по все существующим плагинам (в том числе сторонние плагины) на [npm][1].
+
+ [1]: https://www.npmjs.com/search?q=ecosystem%3Acordova
+
+Традиционный набор плагинов Cordova следующий:
+
+* [Состояние батареи][2]
+
+ > Отслеживает статус батареи устройства.
+
+* [Камера][3]
+
+ > Получает фото используя камеру устройства.
+
+* [Консоль][4]
+
+ > Добавление дополнительных возможностей к console.log().
+
+* [Контакты][5]
+
+ > Взаимодействует с книгой контактов на устройстве.
+
+* [Устройство][6]
+
+ > Получает информацию об устройстве.
+
+* [Движение устройства (Акселерометр)][7]
+
+ > Используйте датчик движения устройства.
+
+* [Ориентация устройства (Компас)][8]
+
+ > Получите направление в котором указывает устройство.
+
+* [Диалоги][9]
+
+ > Визуальные уведомления на устройстве.
+
+* [Файловая система][10]
+
+ > Подключитесь к файловой системе устройства с помощью JavaScript.
+
+* [Передача файлов][11]
+
+ > Подключитесь к файловой системе устройства с помощью JavaScript.
+
+* [Географическое положение][12]
+
+ > Пусть ваше приложение знает свое местоположение.
+
+* [Глобализация][13]
+
+ > Добавляет представление объектов в виде принятом для выбранной локали.
+
+* [Внутренний браузер][14]
+
+ > Открывает URL-адреса в другом окне браузера внутри приложения.
+
+* [Аудио и видео][15]
+
+ > Записывайте и проигрывайте аудиофайлы.
+
+* [Захват аудио и видео][16]
+
+ > Создавайте медиа-файлы используя приложения по захвату медиа, на устройстве.
+
+* [Информацию о сети (подключение)][17]
+
+ > Быстро проверьте состояние сети интернет, и информацию о сети сотовой связи.
+
+* [Заставка][18]
+
+ > Показывайте и прячьте экран заставки приложения.
+
+* [Вибрация][19]
+
+ > API для вибрации устройства.
+
+* [Строка состояния][20]
+
+ > API-интерфейс для отображения, скрытия и настройке фона строки состояния.
+
+* [Список разрешенных ресурсов][21]
+
+ > Плагин для разрешение сетевых запросов. Должен быть установлен если вы хотите иметь возможность делать любые сетевые запросы в вашем приложении.
+
+* [Устаревший список разрешенных ресурсов][22]
+
+ > Плагин для использования старого стиля списка разрешенных ресурсов, прежде чем он был удален из платфор и изменил в виде текущего плагина списка разрешеных ресурсов.
+
+ [2]: https://www.npmjs.com/package/cordova-plugin-battery-status
+ [3]: https://www.npmjs.com/package/cordova-plugin-camera
+ [4]: https://www.npmjs.com/package/cordova-plugin-console
+ [5]: https://www.npmjs.com/package/cordova-plugin-contacts
+ [6]: https://www.npmjs.com/package/cordova-plugin-device
+ [7]: https://www.npmjs.com/package/cordova-plugin-device-motion
+ [8]: https://www.npmjs.com/package/cordova-plugin-device-orientation
+ [9]: https://www.npmjs.com/package/cordova-plugin-dialogs
+ [10]: https://www.npmjs.com/package/cordova-plugin-file
+ [11]: https://www.npmjs.com/package/cordova-plugin-file-transfer
+ [12]: https://www.npmjs.com/package/cordova-plugin-geolocation
+ [13]: https://www.npmjs.com/package/cordova-plugin-globalization
+ [14]: https://www.npmjs.com/package/cordova-plugin-inappbrowser
+ [15]: https://www.npmjs.com/package/cordova-plugin-media
+ [16]: https://www.npmjs.com/package/cordova-plugin-media-capture
+ [17]: https://www.npmjs.com/package/cordova-plugin-network-information
+ [18]: https://www.npmjs.com/package/cordova-plugin-splashscreen
+ [19]: https://www.npmjs.com/package/cordova-plugin-vibration
+ [20]: https://www.npmjs.com/package/cordova-plugin-statusbar
+ [21]: https://www.npmjs.com/package/cordova-plugin-whitelist
+ [22]: https://www.npmjs.com/package/cordova-plugin-legacy-whitelist
+
+Переводы с английского документации этих плагинов можно найти, перейдя в репозитории github плагина и посмотрев в папке docs
\ No newline at end of file
diff --git a/docs/ru/5.1.1/cordova/storage/storage.md b/docs/ru/5.1.1/cordova/storage/storage.md
new file mode 100644
index 0000000..bd8cb66
--- /dev/null
+++ b/docs/ru/5.1.1/cordova/storage/storage.md
@@ -0,0 +1,65 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Хранилище
+
+> Обзор вариантов хранения данных для Cordova.
+
+Несколько API интерфейсов хранения данных доступны для приложений Cordova. Смотрите [html5rocks][1]. для более полного обзора и примеров.
+
+ [1]: http://www.html5rocks.com/en/features/storage
+
+## LocalStorage
+
+Также известен как *веб-хранилище*, *простое хранилище*, или его альтернативный интерфейс *хранилище сессии*, этот интерфейс API обеспечивает хранение пары ключ/значение и доступны в нижеуказанных реализациях WebView. Обратитесь к [спецификации W3C][2] для детальной информации.
+
+ [2]: http://www.w3.org/TR/webstorage/
+
+## WebSQL
+
+Этот API-интерфейс доступен в нижеуказанных реализациях WebView. [Спецификация базы данных Web SQL][3] предлагает более полнофункциональные таблицы базы данных с доступом к ним через SQL-запросы.
+
+ [3]: http://dev.w3.org/html5/webdatabase/
+
+Следующие платформы поддерживают WebSQL:
+
+* Android
+* BlackBerry 10
+* iOS
+* Tizen
+
+## IndexedDB
+
+Этот API-интерфейс доступен в нижеуказанных WebView. [Indexed DB][4] предоставляет больше возможностей, чем LocalStorage, но меньше, чем WebSQL.
+
+ [4]: http://www.w3.org/TR/IndexedDB/
+
+Следующие платформы поддерживают IndexedDB:
+
+* BlackBerry 10
+* Firefox OS
+* Windows Phone 8
+* Windows 8
+
+## Варианты на основе плагинов
+
+В дополнение к API хранилищ перечисленных выше, [File API][5] позволяет вам кешировать данные в локальной файловой системе. Другие [плагины Cordova][6] предоставляют схожие варианты хранения данных.
+
+ [5]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md
+ [6]: http://plugins.cordova.io/
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/appdev/hooks/index.md b/docs/ru/5.1.1/guide/appdev/hooks/index.md
new file mode 100644
index 0000000..afa0ffa
--- /dev/null
+++ b/docs/ru/5.1.1/guide/appdev/hooks/index.md
@@ -0,0 +1,257 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по хукам
+
+Хуки Cordova представляют собой специальные скрипты, которые могут быть добавлены приложениями и разработчиками плагинов или даже самостоятельно вашей системы сборки для настройки команд cordova. Скрипты хуков может быть определены путем добавления их в специальную предопределенную папку (`/hooks`) или с помощью файлов конфигурации (`config.xml` и `plugin.xml`) и последовательно выполняются в следующем порядке:
+
+* Хуки приложения из `/hooks`;
+* Хуки приложения из `config.xml`;
+* Хуки плагинов из `plugins/.../plugin.xml`.
+
+**Примечание**: Каталог `/hooks` считается устаревшим и заменяется элементами hook в файлах config.xml и plugin.xml.
+
+## Типы поддерживаемых хуков
+
+Поддерживаются следующие типы хуков:
+
+ after_build
+ after_compile
+ after_clean
+ after_docs
+ after_emulate
+ after_platform_add
+ after_platform_rm
+ after_platform_ls
+ after_plugin_add
+ after_plugin_ls
+ after_plugin_rm
+ after_plugin_search
+ after_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only
+ after_prepare
+ after_run
+ after_serve
+ before_build
+ before_clean
+ before_compile
+ before_docs
+ before_emulate
+ before_platform_add
+ before_platform_rm/
+ before_platform_ls
+ before_plugin_add
+ before_plugin_ls
+ before_plugin_rm
+ before_plugin_search/
+ before_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only
+ before_plugin_uninstall // Plugin hooks in plugin.xml are executed for a plugin being uninstalled only
+ before_prepare
+ before_run
+ before_serve
+ pre_package // Windows and Windows Phone only
+
+
+## Способы определения хуков
+
+### Через каталог `/hooks`
+
+**Примечание**: Этот метод считается устаревшим и заменяется элементами hook в файлах config.xml и plugin.xml.
+
+Для выполнения настраиваемых действий при срабатывании соответствующего типа хука, используйте имя хука как имя подпапки внутри директории 'hooks' и разместите ваш файл скрипта там, например:
+
+ # Файл скрипта будет автоматически выполняться после каждой сборки
+ hooks/after_build/after_build_custom_action.js
+
+
+При использовании этих хуков, они всегда будут запускаться как исполняемые файлы, не как загружаемые модули JavaScript. **Помните**: Сделайте ваши скрипты исполняемым для этого случая.
+
+### Config.xml
+
+Крючки могут быть определены в файле проекта `config.xml` с помощью элементов `<hook>`, например:
+
+ <hook type="before_build" src="scripts/appBeforeBuild.bat" />
+ <hook type="before_build" src="scripts/appBeforeBuild.js" />
+ <hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" />
+
+ <platform name="wp8">
+ <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.bat" />
+ <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.js" />
+ <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" />
+ ...
+ </platform>
+
+ <platform name="windows8">
+ <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" />
+ <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" />
+ <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" />
+ ...
+ </platform>
+
+
+### Хуки плагинов (plugin.xml)
+
+Как разработчик плагинов, вы можете определить скрипты хуков с использованием элементов `<hook>` в файле `plugin.xml`, как например:
+
+ <hook type="before_plugin_install" src="scripts/beforeInstall.js" />
+ <hook type="after_build" src="scripts/afterBuild.js" />
+
+ <platform name="wp8">
+ <hook type="before_plugin_install" src="scripts/wp8BeforeInstall.js" />
+ <hook type="before_build" src="scripts/wp8BeforeBuild.js" />
+ ...
+ </platform>
+
+
+Хуки плагинов `before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall` будут вызываться исключительно для плагина который устанавливается/удаляется.
+
+## Интерфейс скрипта
+
+### Javascript
+
+Если вы пишете хуки с помощью Node.js следует использовать следующее определение модуля:
+
+```javascript
+module.exports = function(context) {
+ ...
+}
+```
+
+Вы можете сделать ваши скрипты асинхронными, используя Q:
+
+```javascript
+module.exports = function(context) {
+ var Q = context.requireCordovaModule('q');
+ var deferral = new Q.defer();
+
+ setTimeout(function(){
+ console.log('hook.js>> end');
+ deferral.resolve();
+ }, 1000);
+
+ return deferral.promise;
+}
+```
+
+Объект `контекста` содержит тип хука, полный путь исполняемого скрипта, параметры хука, аргументы командной строки, передаваемые Cordova и объект верхнего уровня "cordova»:
+
+```json
+{
+ "hook": "before_plugin_install",
+ "scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js",
+ "cmdLine": "The\\exact\\command\\cordova\\run\\with arguments",
+ "opts": {
+ "projectRoot":"C:\\path\\to\\the\\project",
+ "cordova": {
+ "platforms": ["wp8"],
+ "plugins": ["com.plugin.withhooks"],
+ "version": "0.21.7-dev"
+ },
+ "plugin": {
+ "id": "com.plugin.withhooks",
+ "pluginInfo": {
+ ...
+ },
+ "platform": "wp8",
+ "dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks"
+ }
+ },
+ "cordova": {...}
+}
+
+```
+
+Объект `context.opts.plugin` будет передаваться только сценариям хуков плагина.
+
+Также можете подключить дополнительные модули Cordova в вашем скрипте, используя `context.requireCordovaModule` следующим образом:
+
+```javascript
+var Q = context.requireCordovaModule('q');
+```
+
+**Примечание**: новый интерфейс загрузчика модулей используется для `.js` файлов определенных только через `config.xml` или `plugin.xml`. Для обеспечения совместимости файлов хуков, указанные с помощью каталога `/hooks` запускаются через узел child_process.spawn, раздел 'Не-javascript' ниже.
+
+### Не-javascript
+
+**Примечание**: Мы настоятельно рекомендуем писать ваши хуки, используя Node.js, так, что они будут кросс платформенными, см. выше раздел 'Javascript'.
+
+Не-javascript сценарии запускаются через узел child_process.spawn из корневого каталога проекта и получают корневой каталог в качестве первого аргумента. Все остальные параметры передаются в сценарий с помощью переменных среды:
+
+ * CORDOVA_VERSION - версия Cordova-CLI.
+ * CORDOVA_PLATFORMS - разделенный запятыми список платформ, к которым команда применяется (например: android, ios).
+ * CORDOVA_PLUGINS - разделенный запятыми список идентификаторов плагинов, к которым команда применяется (например: org.apache.cordova.file, org.apache.cordova.file)
+ * CORDOVA_HOOK - путь к выполняемому хуку.
+ * CORDOVA_CMDLINE - точные аргументы командной строки, передаваемые cordova (например: cordova run ios --emulate)
+
+Если сценарий возвращает код выхода не равный нулю, то родительская команда cordova будет прервана.
+
+Кроме того обратите внимание, что даже если вы работаете на Windows, и в случае, если ваши скрипты хуков не bat файлы (что рекомендуется, если вы хотите, чтобы ваши скрипты работали не только на Windows) Cordova CLI будет ожидать shabang линию в качестве первой линии для того чтобы знать какой интерпретатор необходимо использовать для запуска сценария. Shebang линия должна соответствовать следующему примеру:
+
+ #!/usr/bin/env [name_of_interpreter_executable]
+
+
+## Пример использования
+
+В этом примере демонстрируется использование хуков Cordova для трассировки в консоль вывода размера файла созданного .apk для платформы Android.
+
+Создайте пустое Cordova-приложение и добавьте следующее определение в `config.xml` , чтобы указать Cordova запускать скрипт `afterBuild.js` после каждой сборки платформы.
+
+ <hook type="after_build" src="scripts/afterBuild.js" />
+
+
+Создайте файл `scripts/afterBuild.js` и добавьте следующую реализацию. Мы используем асинхронную версию метода `fs.stat` чтобы продемонстрировать, как async функциональность может быть реализована через хуки.
+
+ module.exports = function(ctx) {
+ // Убедитесь что платформа android является частью построения
+ if (ctx.opts.platforms.indexOf('android') < 0) {
+ return;
+ }
+ var fs = ctx.requireCordovaModule('fs'),
+ path = ctx.requireCordovaModule('path'),
+ deferral = ctx.requireCordovaModule('q').defer();
+
+ var platformRoot = path.join(ctx.opts.projectRoot, 'platforms/android');
+ var apkFileLocation = path.join(platformRoot, 'build/outputs/apk/android-debug.apk');
+
+ fs.stat(apkFileLocation, function(err,stats) {
+ if (err) {
+ deferral.reject('Операция неуспешна');
+ } else {
+ console.log('Размер ' + apkFileLocation + ' равен ' + stats.size +' байт');
+ deferral.resolve();
+ }
+ });
+
+ return deferral.promise;
+ };
+
+
+Параметр `ctx` в приведенном выше примере передается Cordova и представляет контекст выполнения, такой как полный путь к сценарию, целевая платформа, аргументы командной строки, и т.д., а также предоставляет дополнительные вспомогательные функции. Смотрите раздел `Интерфейс скрипта` выше для более подробной информации.
+
+Теперь можно добавить платформу android и выполнить построение.
+
+ cordova platform add android
+ ..
+ cordova build
+ ..
+ Size of path\to\app\platforms\android\build\outputs\apk\android-debug.apk is 1821193 bytes
+
+
+Более хорошие примеры использования можно найти здесь:
+
+<http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/appdev/privacy/index.md b/docs/ru/5.1.1/guide/appdev/privacy/index.md
new file mode 100644
index 0000000..d53a58b
--- /dev/null
+++ b/docs/ru/5.1.1/guide/appdev/privacy/index.md
@@ -0,0 +1,57 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по конфиденциальности
+
+Мобильная конфиденциальность является важным вопросом, который каждый разработчик приложения должен учитывать. Ваши пользователи ожидают, что их частная информация, будут собираться и обрабатываться вашим приложением надлежащим образом. Кроме того есть все большее число юрисдикций, которые сейчас имеют юридические требования в отношении конфиденциальности в отношении мобильных устройств.
+
+Это руководство о конфиденциальности мобильных приложений следует рассматривать *заготовку* решающую некоторые наиболее значительные проблемы. Оно излагает некоторые общепринятые практики и предоставляет ссылки на другие более подробные руководства и материалы.
+
+* **Политика конфиденциальности**: Ваше приложение должно включать политику конфиденциальности которая описывает области, такие как, что за информацию приложение собирает от своих пользователей и о них, как эта информация используется, с кому она может быть передана, и как пользователели могут совершить выбор относительно своей конфиденциальности в рамках приложения. Чтобы помочь пониманию, вы должны использовать обычный язык и избегать использование технического жаргона. Вы должны сделать вашу политику конфиденциальности доступной пользователям для рассмотрения до загрузки, например в описании приложения в магазине приложений. Кроме того вы должны сделать вашу политику конфиденциальности доступной в рамках самого приложения. Ограниченный размер дисплеев мобильных устройств создает проблемы для отображения политик конфиденциальности для пользователей. Рассмотреть вопрос о разработке *краткой формы* политики, которая включает в себя наиболее важную информацию, а затем предоставить ссылку на «полную форму» политики для тех, кто заинтересован в более подробной информации. Некоторые группы пытаются разработать стандарты на основе значков для сообщения о применяемых практиках конфиденциальности, которые вы можете хотеть рассматривать после того, как эти стандарты будут достаточно зрелыми.
+
+* **Сбор конфиденциальной информации**: сбор конфиденциальной личной информации приложением поднимает важные конфиденциальности. Примеры конфиденциальной личной информации включая финансовую информацию, информацию о здоровье и информацию от ваших детей или о ваших детях. Это также включает информацию, полученную от некоторых датчиков и баз данных, как правило, находящихся на мобильных устройствах и таблетках, таких как информация о географическом положении, контакты/телефонной книги, микрофон/камера и сохраненных снимках/видео. Смотрите на следующих страницах документации для получения дополнительной информации: [Камера][1], [Захват аудио и видео][2], [Контакты][3]и [Геолокация][4]. Как правило следует получить разрешения пользователя прежде чем собирать конфиденциальную информацию и, если это возможно, предоставляет механизм управления, который позволяет пользователю легко изменить разрешения. Операционные системы где работают приложения могут в этом помогать в некоторых случаях, представляя диалоговые окна запрашивающие разрешение пользователя, непосредственно перед сбором информации. В этих случаях не забудьте воспользоваться любой возможностью для настройки текста диалогового окна для уточнения, как приложение использует и, если применимо, разделяет такую информацию с третьими лицами.
+
+* **Избегайте делать сюрпризы пользователю**: Если приложение собирает или использует информацию способом который может быть необычным для пользователей в свете основной цели вашего приложения (например, музыкальный плейер которые получает доступ к сохраненным изображениям), вы должны принять похожие шаги как при сборе личной информации. То есть настоятельно рекомендуется использование диалоговых окон появляющихся перед совершением действия, для информирования пользователя о сборе или использовани его информацию и, при необходимости, обеспечивать соответствующий контроль конфиденциальности.
+
+* **Сбор данных третьей стороной или обмена данными с третьими лицами**: Если ваше приложение собирает информацию, которая предоставляется другой компании--такой как социальная платформа или рекламная сеть (например, если ваше приложение отображает рекламу)--вы должны сообщить пользователям об этом сборе и обмена данными. Как минимум, ваша политика конфиденциальности должна описывать сбор информации и ее обмен и, если это уместно, предлагать пользователям возможность управления или отказа от такого сбора или обмена информацией.
+
+* **Ограничение сбора и безопасность**: пользователи доверяют вашему приложению свою информацию и они ожидают, что вы будете принимать соответствующие предосторожности, чтобы защитить ее. Один из лучших способов избежать компромиссов в безопасности личной информации в первую очередь является на собирать информацию, если ваше приложение не имеет конкретных и законных оснований для сбора. Для информации, которая должна быть получена, убедитесь, что вы применяете надлежащие мер безопасности для защиты этой информации, хранятся ли они на устройстве или на ваших серверах. Следует также разработать политику хранения соответствующих данных, которая осуществляется в пределах приложения и на ваших серверы.
+
+ [1]: cordova_camera_camera.md.html
+ [2]: cordova_media_capture_capture.md.html
+ [3]: cordova_contacts_contacts.md.html
+ [4]: cordova_geolocation_geolocation.md.html
+
+Ниже приведены некоторые дополнительные полезные руководства по мобильной конфиденциальности для разработчиков:
+
+* Генеральный прокурор Калифорнии, [Конфиденциальность в движении: рекомендации для мобильных экосистем][5]
+
+* Центр демократии и технологии, Форум будущего конфиденциальности, [ лучшии практики для разработчиков мобильных приложений][6]
+
+* CTIA-Ассоциация беспроводной связи, [передовые практики и руководства для услуг на основе местоположение][7]
+
+* Федеральная торговая комиссия, [мобильная конфиденциальность информации: укрепление доверия через прозрачность][8]
+
+* Форум Будущее конфиденциальности, веб-сайт [Конфиденциальность приложения][9]
+
+ [5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf
+ [6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf
+ [7]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300
+ [8]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf
+ [9]: http://www.applicationprivacy.org
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/appdev/security/index.md b/docs/ru/5.1.1/guide/appdev/security/index.md
new file mode 100644
index 0000000..14b58df
--- /dev/null
+++ b/docs/ru/5.1.1/guide/appdev/security/index.md
@@ -0,0 +1,105 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по безопасности
+
+Следующее руководство содержит некоторые рекомендации по безопасности, которые следует учитывать при разработке приложений Cordova. Имейте в виду, что безопасность-это очень сложная тема, и поэтому это руководство не является исчерпывающим. Если вы считаете, что вы можете внести свой вклад в это руководстве, пожалуйста, не стесняйтесь создать запрос в баг трекере Cordova в разделе [«Documentation»][1]. Это руководство предназначено, чтобы быть применимым к любой разработке на Cordova (все платформы), но следует отметить некоторые особенности платформ.
+
+ [1]: https://issues.apache.org/jira/browse/CB/component/12316407
+
+## В данном руководстве рассматриваются следующие темы:
+
+* Список разрешенных ресурсов
+* IFRAME и механизм идентификатора обратного вызова
+* Закрепление сертификата
+* Самозаверенные сертификаты
+* Шифрованное хранилище
+* Общие советы
+* Рекомендуемые статьи и другие ресурсы
+
+## Список разрешенных ресурсов
+
+* Прочтите и разберитесь в разделе "Инструкция по доступу к внешним ресурсам"
+
+* Резрешение определенных доменов не работает на Android API 10 и ниже, и в WP8 для iframe и XMLHttpRequest. Это значит, злоумышленник может загрузить любой домен в iframe и любой сценарий на странице внутри iframe и получить непосредственный доступ к Cordova JavaScript-объектам и соответствующим Java-объектам. Вы должны принять это во внимание при создании приложений для этих платформ. На практике это означает, что вы должны убедится, что вы разрабатываете для Android API версии выше 10, и по возможности не использовать iframe для загрузки внешнего содержимого - используйте плагин inAppBrowser или другие сторонние плагины.
+
+## IFRAME и механизм идентификатора обратного вызова
+
+Если содержимое подается в iframe из whitelisted домена, этот домен будет иметь доступ к родной мост Кордова. Это означает, что если вы белый сторонние рекламные сети и обслуживать эти объявления через iframe, вполне возможно, что вредоносные объявление будет возможность вырваться из iframe и выполнять вредоносные действия. Из-за этого как правило не следует использовать фреймы если вы контролируете сервера, на котором содержание iframe. Также, обратите внимание, что существуют сторонние плагины доступны для поддержки рекламных сетей. Обратите внимание, что это утверждение верно не для iOS, который перехватывает все, включая iframe соединения.
+
+## Закрепление сертификата
+
+Кордова не поддерживает закрепление истинное свидетельство. Главным препятствием для этого является отсутствие родного API в Android для перехвата соединений SSL для выполнения проверки сертификата сервера. (Хотя это возможно для сертификата, закрепление на Android в Java с помощью JSSE, webview на андроид написан на C++, и соединения сервера обрабатываются webview для вас, поэтому невозможно использовать Java и JSSE там.) Поскольку Apache Cordova предназначен предлагать последовательного интерфейсов API на нескольких платформах, не имея возможности в основных платформ ломает эту последовательность.
+
+Есть способы для закрепления сертификат, как проверка, Открытый ключ сервера (отпечатков пальцев) это ожидаемое значение при запуске приложения или другие неоднократно в течение жизни вашего приложения. Сторонние плагины доступны для Кордова, который может сделать это. Однако это не то же самое, как истинный сертификат, закрепления, который автоматически проверяет ожидаемое значение каждого соединения с сервером.
+
+## Самозаверенные сертификаты
+
+Использование самоподписывающихся сертификатов на вашем сервере не рекомендуется. Если вы желаете SSL, то настоятельно рекомендуется что ваш сервер имеет сертификат, который должным образом подписан известным центром сертификации (центр сертификации). Неспособность true сертификат закрепление делает это важно.
+
+Причина заключается, что принимая самозаверяющие сертификаты обходит проверка цепочки сертификатов, которая позволяет любой сертификат сервера, чтобы считаться допустимым в устройство. Это открывает сообщение man-in--middle атак. Она становится очень легко для хакера не только перехватывать и читать весь обмен данными между устройством и сервером, но и изменять сообщения. Устройство никогда не будут знать, что это происходит потому, что он не проверяет, что сертификат сервера подписан доверенным центром сертификации. Устройство имеет никаких доказательств того, что сервер является кто он ожидает. Из-за легкости делает человек в середине нападение принимая самозаверяющие сертификаты лишь незначительно лучше, чем просто выполнение http вместо https на ненадежной сети. Да, трафик будет зашифрован, но он может быть зашифрован с помощью ключа от man-in--middle, поэтому человек в середине может получить доступ все, так что шифрование бесполезно Кроме пассивных наблюдателей. Пользователи доверять SSL для обеспечения безопасности, и это будет намеренно делать это небезопасно, так что использование SSL становится заблуждение. Если это будет использоваться на доверенной сети (то есть, ты полностью внутри контролируемого предприятия), то до сих пор самозаверяющие сертификаты не рекомендуется. Две рекомендации, содержащиеся в доверенной сети, просто использовать http, потому что сама сеть является доверенным, или для получения сертификата, подписанного доверенным центром сертификации (не самоподписанный). Сеть доверенных или нет.
+
+Принципы, описанные здесь, не являются специфическими для Apache Cordova, они применяются для всех связь клиент сервер.
+
+При запуске Кордова на Android, с помощью `android:debuggable="true"` в приложения манифест позволит ошибки SSL, например сертификат цепи ошибок проверки на самозаверяющие сертификаты. Так что вы можете использовать самозаверяющие сертификаты в этой конфигурации, но это не конфигурация, которая должна использоваться, когда ваше приложение находится в производстве. Он предназначен для использования только во время разработки приложения.
+
+## Шифрованное хранилище
+
+(TBD)
+
+## Общие советы
+
+### Не использовать Android Пряник!
+
+* Установите уровень выше, чем 10 мин цели sdk. API 10 является пряник, и пряник больше не поддерживается Google или устройство производителями и поэтому не рекомендуем команды Кордова.
+* Пряников было показано, чтобы быть небезопасно и один из самых ориентированных мобильных ОС [http://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/][2].
+* Белый на андроиде не работает с пряников или ниже. Это означает, что злоумышленник может загрузить вредоносный код в iframe, который затем будет иметь доступ ко всем API, Кордова и могли бы использовать этот доступ для кражи личных данных, отправлять SMS-сообщения на платные номера и выполнения других вредоносных действий.
+
+ [2]: http://bgr.com/2012/11/06/android-security-gingerbread-malware/
+
+### Используйте InAppBrowser для внешних ссылок
+
+* Использование InAppBrowser при открытии ссылки на любой внешний веб-сайт. Это гораздо безопаснее, чем белый, имя домена и включая содержимое непосредственно в приложении, потому что InAppBrowser будет использовать функции безопасности родной браузер и веб-сайт не даст доступ к среде Кордова. Даже если вы доверяете веб-сайт третьей стороны и включить его непосредственно в приложении, что веб-сайт третьей стороны можно связать с вредоносного веб-содержимого.
+
+### Проверка всех входных данных пользователя
+
+* Всегда проверяют все данные, что приложение принимает. Это включает в себя имена пользователей, пароли, даты, загруженных средств массовой информации и т.д. Поскольку злоумышленник может манипулировать HTML и JS активы (либо декомпиляции приложения или с помощью средств отладки как chrome://inspect), эта проверка следует также выполнить на вашем сервере, особенно перед передачей данных в любой серверной службе.
+* Другие источники, где данные должны быть проверены: документы пользователей, контактов, push-уведомления
+
+### Не кэшируйте конфиденциальные данных
+
+* Если имена пользователей, пароль, геолокации информацию и другие важные данные находятся в кэше, он мог бы потенциально быть получены позднее неавторизованным пользователем или приложением.
+
+### Не используйте функцию eval(), за исключением случаев если вы знаете, что вы делаете
+
+* Функция eval() JavaScript имеет долгую историю злоупотребляют. Неправильное использование может открыть код для атак, отладка трудности и медленнее выполнение кода.
+
+### Не думайте, что ваш исходный код является безопасным
+
+* Поскольку Cordova-приложение строится на основе HTML и JavaScript, которые упаковываются в контейнере платформы, не следует считать ваш код безопасным. Это позволяет произвести реверс-инжиниринг Cordova-приложения.
+
+## Рекомендуемые статьи и другие ресурсы
+
+* [HTML5 безопасности шпаргалку, подробно как для защиты приложения HTML5][3]
+* [PhoneGap и статьи о безопасности устройства, например с помощью зашифрованных данных][4]
+* [Официальный документ о безопасности хорошо известны недостатки в Webview на основе гибридных приложений][5]
+
+ [3]: https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet
+ [4]: https://github.com/phonegap/phonegap/wiki/Platform-Security
+ [5]: http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/appdev/whitelist/index.md b/docs/ru/5.1.1/guide/appdev/whitelist/index.md
new file mode 100644
index 0000000..e05ab30
--- /dev/null
+++ b/docs/ru/5.1.1/guide/appdev/whitelist/index.md
@@ -0,0 +1,133 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Инструкция по доступу к внешним ресурсам
+
+Список разрешенных доменов это модель безопасности, которая контролирует доступ во внешние домены, к которому ваше приложение не имеет доступа. Cordova предоставляет настраиваемую политику безопасности для определения, к каким внешним сайтам может быть получен доступ. По умолчанию новые приложения настроены для доступа к любому сайту. Прежде чем переносить приложение для рабочую среду, следует сформулировать список разрешений и разрешить доступ к определенным сетевым доменам и поддоменам.
+
+Для Android и iOS (по состоянию на их версии 4.0) политики безопасности Cordova могут быть расширяемым через инерфейс плагина. Ваше приложение должно использовать [cordova-plugin-whitelist][1], так как он обеспечивает лучшую безопасность и настраиваемость, чем более ранние версии Cordova. Хотя это возможно осуществить свой собственный плагин управления доступом к внешним ресурсам, это не рекомендуется, за исключением случая если ваше приложение имеет весьма специфические требования политики безопасности. Смотрите [cordova-plugin-whitelist][1] за подробностями об использовании и настройке.
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+
+Cordova следует спецификации [W3C Доступ виджета][2], которая опирается на элемент `<access>` в файле `config.xml` приложения, чтобы включить сетевой доступ к отдельным доменам. Для проектов которые погалаются на процесс с использованием командной строки, описанный в разделе "Интерфейс командной строки", этот файл расположен в корневой папке проекта. В противном случае при использовании пути разработки с использованием платформо-ориентированного кода, места расположения указаны в разделах ниже. (См. различные разделы "Руководство по поддерживаемым платформам" для получения дополнительной информации на каждой платформе.)
+
+ [2]: http://www.w3.org/TR/widgets-access/
+
+В следующих примерах демонстрируется синтаксис `<access>` списка разрешенных ресурсов:
+
+* Доступ к [google.com][3]:
+
+ <access origin="http://google.com" />
+
+* Доступ по защищенному протоколу к [google.com][4] (`https://`):
+
+ <access origin="https://google.com" />
+
+* Доступ к поддомену [maps.google.com][5]:
+
+ <access origin="http://maps.google.com" />
+
+* Доступ для всех поддоменов для домена [google.com][3], например, [mail.google.com][6] и [docs.google.com][7]:
+
+ <access origin="http://*.google.com" />
+
+* Доступ ко *всем* доменам, например, [google.com][3] и [developer.mozilla.org][8]:
+
+ <access origin="*" />
+
+ Это значение по умолчанию для вновь созданных проектов CLI.
+
+ [3]: http://google.com
+ [4]: https://google.com
+ [5]: http://maps.google.com
+ [6]: http://mail.google.com
+ [7]: http://docs.google.com
+ [8]: http://developer.mozilla.org
+
+Имейте ввиду что некоторые сайты могут автоматически перенаправить вас со своей домашней страницы на другой URL, например используя протокол HTTPS или на домен специфичный для страны пользователя. Например http://www.google.com будет перенаправлять на использование протокола SSL/TLS по адресу https://www.google.com и затем может перенаправить на оснввании вашего географического расположения, например https://www.google.co.uk. Такие сценарии могут потребовать измененных или дополнительных записей в списке разрешенных доменов по отношению к вашим первоначальным требованиям. Пожалуйста, учитывайте это, когда вы строите ваш список разрешенных доменов.
+
+Обратите внимание, что список разрешенных доменов применяется только к основным WebView Cordova и не применяется к InAppBrowser WebView или при открытии ссылки в веб-браузере системы.
+
+## Список разрешений Amazon Fire OS
+
+Список разрешений расположен в`res/xml/config.xml`.
+
+## Список разрешений Android
+
+Как указано выше см. [cordova-plugin-whitelist][1] для подробностей. Для cordova-android до 4.0.0 версии смотрите старые версии этой документации.
+
+## Список разрешений iOS
+
+Как указано выше см. [cordova-plugin-whitelist][1] для подробностей. Для cordova-ios до 4.0.0 версии смотрите старые версии этой документации.
+
+## Список разрешений BlackBerry 10
+
+Разрешающие правила могут быть найдены в `www/config.xml`.
+
+Использование шаблонов в BlackBerry 10 отличается от остальных платформы двумя способами:
+
+* Любой контент, к которому получается доступ с использованием `XMLHttpRequest` должн быть объявлен явным образом. Установка `origin="*"` в этом случае не работает. Как вариант, веб-безопасность можно отключить с помощью параметра `WebSecurity`, описанном в разделе Настройка BlackBerry:
+
+ <preference name="websecurity" value="disable" />
+
+* Как альтернатива параметру `*.domain` , установите дополнительный атрибут `subdomains` со значением `true`. Он установлен в `false` по умолчанию. Например, следующее описание позволяет получить доступ к `google.com` , `maps.google.com` , и `docs.google.com`:
+
+ <access origin="http://google.com" subdomains="true" />
+
+ А следующее описание ограничивает доступ до `google.com`:
+
+ <access origin="http://google.com" subdomains="false" />
+
+ Укажите доступ ко всем доменам, в том числе для протокола локальной файловой системы `file://`:
+
+ <access origin="*" subdomains="true" />
+
+(За более подробной информацией о поддерживаемых функциях, смотрите документации BlackBerry по [тегу access][9].)
+
+ [9]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html
+
+## Firefox OS
+
+В Firefox OS нет концепции разрешения определенного домена. Вместо этого есть специальное разрешение называемое [SystemXHR][10]. Существует необходимость добавить это разрешение в `config.xml`:
+
+ [10]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#Permissions
+
+ <platform name="firefoxos">
+ <permission name="systemXHR" privileged="true" description="load data from server" />
+ </platform>
+
+
+Объект`XMLHttpRequest` должен быть инстанцирован с двумя параметрами `mozAnon` и `mozSystem`:
+
+ var request = new XMLHttpRequest({
+ mozAnon: true,
+ mozSystem: true});
+
+
+Это решение является прозрачным, так что нет никакой разницы при использовании его совместно с другими платформами.
+
+## Список разрешений Windows Phone
+
+Списки разрешающий правил для Windows Phone 7 и 8 находятся в файле `config.xml` приложения.
+
+## Список разрешений Tizen
+
+Списки разрешающий правил находятся в файле приложения `config.xml`. Платформа рассчитывает на тот же атрибут `subdomains` что и платформа BlackBerry. (За более детальной информацией о поддерживаемых функциях, смотрите документацию Tizen по [тегу access][11].)
+
+ [11]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/cli/index.md b/docs/ru/5.1.1/guide/cli/index.md
new file mode 100644
index 0000000..dbb0e4f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/cli/index.md
@@ -0,0 +1,392 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Интерфейс командной строки
+
+Это руководство показывает, как создать приложения и развернуть их на различных мобильных платформах с использованием `cordova` интерфейса командной строки (CLI). Эта программа позволяет вам создавать новые проекты, собирать их на различных платформах, и запускать ваше приложение на устройствах или в эмуляторах. CLI является основным инструментом используемым для кросс платформенного процесса разработки, описанного в разделе "Введение". В другом случае вы также можете использовать CLI для инициализации кода проекта, а затем переключиться на использование SDK различных платформ и другие инструменты командной строки для дальнейшей разработки.
+
+## Необходимые условия
+
+Перед запуском любого средства командной строки, необходимо установить пакет SDK для каждой платформы, для которой вы хотите разрабатывать. (См. раздел "Руководство по поддерживаемым платформам" для получения более подробной информации.)
+
+Чтобы добавить поддержку платформы или перестроить проект для какой либо платформы, вы должны запустить интерфейс командной строки на том же компьютере, который поддерживает SDK платформы. CLI поддерживает следующие комбинации:
+
+* iOS (Mac)
+* Amazon Fire OS (Mac, Linux, Windows)
+* Android (Mac, Linux, Windows)
+* BlackBerry 10 (Mac, Linux, Windows)
+* Windows Phone 8 (Windows)
+* Окна (Windows)
+* Firefox OS (Mac, Linux, Windows)
+
+На Mac командная строка доступна с помощью приложения *Терминал*. На ПК он доступен как приложение *Командная строка* в разделе *Аксессуары*.
+
+**Примечание**: Для Windows платформ, вы по прежнему можете вести свою разработку на Mac запуская Windows в виртуальной машине или в режиме двойной загрузки. Доступные параметры см. в разделах "Руководство для платформы Windows Phone 8" или "Руководство по платформе Windows".
+
+Скорее всего, вы будете запускать CLI с различных компьютеров, тем больше имеет смысл поддерживать удаленный репозиторий, откуда вы будете забирать рабочие материалы в локальные каталоги.
+
+## Установка CLI Cordova
+
+Средство командной строки Cordova распространяется как пакет npm в готовом к использованию формате. Нет необходимости для его компиляции из исходного кода.
+
+Чтобы установить инструмент командной строки `cordova`, выполните следующие действия:
+
+1. Скачайте и установите [Node.js](http://nodejs.org/). После установки вы должны быть возможность выполнять `node` и `npm` в командной строке. При желании, вы можете дополнительно использовать инструмент, как например `nvm` или `nave` для управления вашей установкой Node.js.
+
+2. Скачайте и установите [git клиент](http://git-scm.com/), если у вас его еще нет. После установки вы должны быть способны вызвать `git` из вашей командной строки. Даже несмотря на то, что вы не будете использовать `git` вручную, CLI использовать для загрузки некоторых ресурсов при создании нового проекта.
+
+3. Установите модуль `cordova` с помощью инструмента `npm` Node.js. Модуль `cordova` будет автоматически загружен `npm`.
+
+ * В OS X и Linux:
+
+ $ sudo npm install -g cordova
+
+ В OS X и Linux, может быть необходимым предварять команду `npm` командой `sudo` чтобы установить этот инструмент разработки, в защищенные каталоги, такие как `usr/local/share`. Если вы используете инструмент nvm/nave и имеете доступ на запись к каталогу установки, префикс `sudo` можно опустить. Есть [больше подсказок][3] по использованию `npm` без `sudo`, если вы имеете желание сделать это.
+
+ * В Windows:
+
+ C:\>npm install -g cordova
+
+ Упомянутый выше флаг `-g` указывает `npm` установить `cordova` глобально. В противном случае он будет установлен в подкаталоге `node_modules` текущего рабочего каталога.
+
+ Вам может понадобиться добавить каталог `npm` в переменную `PATH` вашего окружения, для того чтобы вызывать глобально установленные `npm` модули. В Windows `npm` обычно можно найти в каталоге `C:\Users\username\AppData\Roaming\npm`. На OS X и Linux его обычно можно найти в каталоге `/usr/local/share/npm`.
+
+ Журнал установки может приводить к ошибкам, для любого не установленного SDK платформы.
+
+ После установки вы должны иметь возможность запускать `cordova` в командной строке без аргументов, и это должно напечатать текст справки.
+
+ [3]: http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears
+
+## Создание приложения
+
+Перейдите в каталог, где вы сохранили ваш исходный код и выполнить команду следующего вида:
+
+ $ cordova create hello com.example.hello HelloWorld
+
+
+Завершение команды может длиться дольше нескольких секунд, поэтому будьте терпеливы. Запуск команды с опцией `-d` будет показывать информацию о прогрессе операции.
+
+Первый аргемент - *hello* указывает каталог в котором будет сформирован ваш проект. Этот каталог не должен существовать, Cordova создаст его для вас. Подкаталог `www` созданной директории будет содержать домашнюю страницу вашего приложения, совместно с ресурсами в каталогах `css`, `js`, и `img`, что соответствует общепринятым соглашениям по наименованию файлов и каталогов принятых в веб-разработке. Эти активы будут храниться в локальной файловой системе устройства, не служил удаленно. Файл `config.xml` содержит важные метаданные необходимые для формирования и распространения приложения.
+
+Второй аргумент `com.example.hello` указывает идентификатор вашего проекта в обратном формате доменных имен. Этот аргумент необязателен, но только если вы также пропустите третий аргумент, потому что аргументы определяются в зависимости от их позиций. Вы можете изменить это значение позже в файле `config.xml`, но вам надо учитывать что возможно код сформированный вне `config.xml` использует это значение, как например имена Java пакетов. Значение по умолчанию `io.cordova.hellocordova`, но рекомендуется чтобы вы выбрали подходящее значение.
+
+Третий аргумент `HelloWorld` указывает отображаемое имя приложения. Этот аргумент является необязательным. Вы можете изменить это значение позже в файле `config.xml`, но вам надо учитывать что возможно код сформированный вне `config.xml` использует это значение, как например имена Java классов. Значением по умолчанию является `HelloCordova`, но мы рекомендуем вам выбрать подходящее значение.
+
+## Добавление платформ
+
+Все последующие команды должны быть выполняться в каталоге проекта или любых подкаталогах в его пределах:
+
+ $ cd hello
+
+
+Перед тем, как можно построить проект, необходимо указать набор целевых платформ. Ваши возможности по запуску этих команд зависят от того поддерживает ваш компьютер каждое SDK, и установили ли вы соответствующее SDK. Запустите любую из этих команд на Mac:
+
+ $ cordova platform add ios
+ $ cordova platform add amazon-fireos
+ $ cordova platform add android
+ $ cordova platform add blackberry10
+ $ cordova platform add firefoxos
+
+
+Запустите любую из этих команд на Windows компьютере, где *wp* ссылается на различные версии операционной системы Windows Phone:
+
+ $ cordova platform add wp8
+ $ cordova platform add windows
+ $ cordova platform add amazon-fireos
+ $ cordova platform add android
+ $ cordova platform add blackberry10
+ $ cordova platform add firefoxos
+
+
+Выполните это, чтобы проверить ваш текущий набор платформ:
+
+ $ cordova platforms ls
+
+
+(Обратите внимание, что команды `platform` и `platforms` являются синонимами.)
+
+Выполните одну из следующих команд, которые являются синонимами, чтобы удалить платформу:
+
+ $ cordova platform remove blackberry10
+ $ cordova platform rm amazon-fireos
+ $ cordova platform rm android
+
+
+Выполнение команд для добавления или удаления платформ затрагивает содержимое каталога *platforms* проекта, где каждая указанная платформа представлена как подкаталог. Исходный каталог *www* повторяется в подкаталоге каждой платформы, например вы можете увидеть его в `platforms/ios/www` или `platforms/android/assets/www`. Потому что CLI постоянно копирует файлы из исходной папки *www*, следует изменять только эти файлы, а не файлы, расположенные в подкаталогах *platforms*. При использовании системы управления версиями, следует добавить папку с исходным кодом *www*, наряду с папкой *merges* в вашу систему управления версиями. (Дополнительные сведения о папке *merges* можно найти в разделе "Настройка каждой платформы" ниже.)
+
+**Предупреждение**: При использовании CLI для построения вашего приложение, вы *не* должны редактировать какие либо файлы в каталоге `/platforms/` за исключением того случая если вы знаете что вы делаете, или в документации указано обратное. Файлы в этом каталоге обычно перезаписываются при подготовке приложений к построения, или при переустановке плагина.
+
+Если вы хотите в данный момент, можно использовать IDE, как например Eclipse или Xcode чтобы открыть проект который вы создали. Вам будет нужно открыть производный набор ресурсов из каталога `/platforms/` для разработки с использованием SDK. Это потому что специфичные для SDK метаданные хранятся в соответствующем подкаталоге `/platforms/`. (См. раздел "Руководство по поддерживаемым платформам" для получения информации о том как разрабатывать приложение в каждой IDE.) Используйте этот подход, если вы просто хотите инициализироавть проект с использованием CLI и потом переключиться на SDK для работы с инструментами платформы.
+
+Продолжайте читать если вы хотите использовать кросс-платформенный процесс разработки (CLI) для всего цикла разработки.
+
+## Построение приложения
+
+По умолчанию скрипт `cordova create` создает каркас веб приложения чья домашняя страница это файл проекта `www/index.html`. Изменяйте это приложения как вы желаете, но любая инициализация должна быть указана как часть обработчика события `deviceready`, используемого по умолчанию из `www/js/index.js`.
+
+Выполните следующую команду для итеративного построения проекта:
+
+ $ cordova build
+
+
+Это создает код платформы в подкаталоге проекта `platforms`. При необходимости можно ограничить применения каждой сборки для выбранных платформ:
+
+ $ cordova build ios
+
+
+Команда `cordova build` это сокращение для следующих команд, которые в этом примере нацелены на одну платформу:
+
+ $ cordova prepare ios
+ $ cordova compile ios
+
+
+В этом случае, как только вы запустили `prepare`, вы можете использовать Xcode SDK компании Apple как альтернативу для изменения и компиляции платформо-зависимого кода, который кордова создала в каталоге `platforms/ios`. Вы можете использовать тот же подход для SDK других платформ.
+
+## Тестирование приложения на эмуляторе или устройстве
+
+SDK для мобильных платформ часто поставляются с эмуляторами которые выполняют образ устройства, таким образом что вы можете запустить ваше приложение из главного экрана и посмотреть как оно взаимодействует с различными функциями платформы. Выполните команду как указано ниже для перепостроения приложения запуска его в эмуляторе указанной платформы:
+
+ $ cordova emulate android
+
+
+Некоторые мобильные платформы эмулируют определенное устройство по умолчанию, как например iPhone для проектов iOS. Для других платформы, вам может понадобиться сперва ассоциировать устройство с эмулятором.
+
+**Примечание**: Поддержка эмулятора в настоящее время недоступна для Amazon Fire ОС.
+
+(См. "Руководство по поддерживаемым платформам" для подробной информации). Например вы можете сначала выполнить команду `android` для запуска Android SDK, а затем запустить образ конкретного устройства, которое запускает его согласно поведению по умолчанию:
+
+![][4]
+
+ [4]: img/guide/cli/android_emulate_init.png
+
+Последующая команда `cordova emulate` обновляет образ эмулятор для отображения последней версии приложение, которое теперь доступно для запуска с главного экрана:
+
+![][5]
+
+ [5]: img/guide/cli/android_emulate_install.png
+
+Поочередно можно подключить телефон к компьютеру и тестирование приложения непосредственно на нем:
+
+ $ cordova run android
+
+
+Перед выполнением этой команды, необходимо настроить устройство для тестирования, следуя процедурам, которые различаются для каждой платформы. В устройствах Android и Amazon Fire ОС вам придется включить функцию **Отладка USB** на устройстве и возможно добавить драйвер, USB в зависимости от вашего окружения разработки. Смотрите раздел "Руководство по поддерживаемым платформам" за подробностями о требованиях каждой платформы.
+
+## Добавить функции плагина
+
+При построении или просмотре нового проекта, приложение по умолчанию не делает очень много. Вы можете изменить приложение различными способами используя преимущества стандартных веб-технологий, но для того чтобы приложение тесно взаимодействовало с различными функциями устройства, вам необходимо добавить плагины которые предоставят доступ к базовым функциям Cordova API.
+
+*Плагин* это немного дополнительного кода которые предоставляет интерфейс к встроенным компонентам платформы. ВЫ можете создать свой собственный интерфейс плагина, к примеры для проектирования гибридного приложения которое совмещает Cordova WebView с встроенными компонентами. (За подробной информацией смотрите "Интеграция WebViews" и [Руководство по разработке плагинов][6].) В основном, вы будете добавлять плагин чтобы включить одну из базовых функций Cordova описанном в разделе "Справочник по API".
+
+ [6]: guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide
+
+Начиная с версии 3.0 при создании проекта Cordova она не содержит каких-либо плагинов настоящей. Это новое поведение по умолчанию. Какие плагины вы хотите, даже основные плагины, должен быть явно добавлен.
+
+Список этих плагинов, включая дополнительные сторонние плагины, сообщества, можно найти в реестре по адресу [plugins.cordova.io][7]. Вы можете использовать CLI для поиска плагинов в этом реестре. К примеру поиск `bar` и `code` возвращает один результат который содержит оба слова без учета регистра:
+
+ [7]: http://plugins.cordova.io/
+
+ $ cordova plugin search bar code
+
+ com.phonegap.plugins.barcodescanner - Scans Barcodes
+
+
+Поиск только по слову `bar` возвращает дополнительный результат:
+
+ cordova-plugin-statusbar - Cordova StatusBar Plugin
+
+
+Команда `cordova plugin add` требует чтобы вы указали репозиторий для кода плагина. Вот пример как вы можете использовать CLI для добавления функций в приложение:
+
+* Базовая информация устройства (Device API):
+
+ $ cordova plugin add cordova-plugin-device
+
+* Сетевое подключение и События батареи:
+
+ $ cordova plugin add cordova-plugin-network-information
+ $ cordova plugin add cordova-plugin-battery-status
+
+* Акселерометр, компас и информация о расположении:
+
+ $ cordova plugin add cordova-plugin-device-motion
+ $ cordova plugin add cordova-plugin-device-orientation
+ $ cordova plugin add cordova-plugin-geolocation
+
+* Камера, воспроизведение мультимедиа и съемка:
+
+ $ cordova plugin add cordova-plugin-camera
+ $ cordova plugin add cordova-plugin-media-capture
+ $ cordova plugin add cordova-plugin-media
+
+* Доступ к файлам на устройстве или по сети (File API):
+
+ $ cordova plugin add cordova-plugin-file
+ $ cordova plugin add cordova-plugin-file-transfer
+
+* Уведомление с помощью диалогового окна или вибрации:
+
+ $ cordova plugin add cordova-plugin-dialogs
+ $ cordova plugin add cordova-plugin-vibration
+
+* Контакты:
+
+ $ cordova plugin add cordova-plugin-contacts
+
+* Глобализация:
+
+ $ cordova plugin add cordova-plugin-globalization
+
+* Заставка:
+
+ $ cordova plugin add cordova-plugin-splashscreen
+
+* Открытие новых окон браузера (InAppBrowser):
+
+ $ cordova plugin add cordova-plugin-inappbrowser
+
+* Консоль отладки:
+
+ $ cordova plugin add cordova-plugin-console
+
+
+**Примечание**: CLI добавляет код плагина соответствующим образом для каждой платформы. Если вы хотите разработать с использованием инструментов низкого уровня или SDK платформы, как описано в разделе "Введение", необходимо запустить утилиту Plugman которая добавит плагины отдельно для каждой платформы. (Для получения дополнительной информации, см. раздел "Использование Plugman для управления расширениями".)
+
+Используйте `plugin ls` (или `plugin list`, или просто `plugin`) для просмотра установленных на данный момент плагинов. Для каждого установленного плагина отображается его идентификатор:
+
+ $ cordova plugin ls # or 'plugin list'
+ [ 'cordova-plugin-console' ]
+
+
+Чтобы удалить плагин, сошлитесь к нему по тому же идентификатору, который появляется в списке. Например таким образом вы бы удалили поддержку для консоли отладки из версии релиза:
+
+ $ cordova plugin rm cordova-plugin-console
+ $ cordova plugin remove cordova-plugin-console # same
+
+
+Вы можете удалять или добавлять плагины пакетно указывая более чем один аргумент для соответствующей команды:
+
+ $ cordova plugin add cordova-plugin-console cordova-plugin-device
+
+
+## Расширенные параметры плагина
+
+При добавлении плагина, некоторые параметры позволяют указать откуда взять плагин. Приведенные выше примеры использования общепринятого реестра `registry.cordova.io`, и плагин определяется по его `id`:
+
+ $ cordova plugin add cordova-plugin-console
+
+
+`Id` также может включать номер версии плагина, добавленный после символа `@`. Версия `latest` — это псевдоним для самой последней версии. Например:
+
+ $ cordova plugin add cordova-plugin-console@latest
+ $ cordova plugin add cordova-plugin-console@0.2.1
+
+
+Если плагин не зарегистрирована в `registry.cordova.io`, но расположен в другом репозитории git, вы можете указать альтернативный URL-адрес:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git
+
+
+Приведенный выше пример git получает плагин из последней версии ветки master, но альтернативная git ссылка например тег или другая ветка могут быть добавлены после символа `#`:
+
+ $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
+
+
+Если плагин (и его файл `plugin.xml`) находится в подкаталоге репозитария git, вы можете указать его после символа `:`. Обратите внимание, что символ `#` все еще необходим:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
+
+
+Вы также можете объединить как ссылку git так и подкаталоги:
+
+ $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
+
+
+Как вариант укажите локальный путь к папке плагина, который содержит файл `plugin.xml`:
+
+ $ cordova plugin add ../my_plugin_dir
+
+
+## Использование каталога *merges* для настройки каждой платформы
+
+Хотя Cordova позволяет легко развертывать приложение на разных платформах, иногда необходимо добавить индивидуальные настройки. В этом случае вы не хотите изменить исходные файлы в различных каталогах `www` в каталоге верхнего уровня `платформы`, потому что они регулярно заменяются из кросс-платформенного источника - каталога верхнего уровня `www`.
+
+Вместо этого в каталог верхнего уровня `merges` предоставляет место для указания ресурсов для развертывания на определенных платформах. Каждый платформо-зависимый подкаталог `merges` отражает повторяет структуру директории `www`, и позволяет переопределить или добавить файлы, как это необходимо. Например вот как вы, возможно, использует `merges` чтобы увеличить размер шрифта по умолчанию для устройств Android и Amazon Fire ОС:
+
+* Измените файл `www/index.html`, добавив ссылку на дополнительный CSS-файл, `overrides.css` в данном случае:
+
+ <link rel="stylesheet" type="text/css" href="css/overrides.css" />
+
+* При необходимости создайте пустой `www/css/overrides.css` файл, который будет применяться для всех построений отличных от Android, предотвращая ошибку недостающего файла.
+
+* Создайте `css` подкаталог внутри `merges/android` , затем добавьте соответствующий файл `overrides.css`. Укажите CSS, который переопределяет 12 пунктовый размер шрифта по умолчанию, указанный в `www/css/index.css` , например:
+
+ body { font-size:14px; }
+
+
+При повторном построении проекта, Android версия будет содержать измененный размер шрифта, в то время как другие платформы остаются неизменными.
+
+Можно также использовать `merges` для добавления файлов, изначально не присутствующих в каталоге `www`. Например приложение может включить изображение для *кнопки Назал* в интерфейсе iOS, хранимом в `merges/ios/img/back_button.png`, в то время как версия Android вместо этого может перехватывать захватить события `backbutton` от соответствующей аппаратной кнопки.
+
+## Команды справки
+
+Cordova имеет несколько глобальных команд, которые могут помочь вам, если вы застряли или возникли проблемы. Команда `help` отображает все доступные команды Cordova и их синтаксис:
+
+ $ cordova help
+ $ cordova # same
+
+
+Кроме того вы можете получить более подробную справку по определенной команде. Например:
+
+ $ cordova run --help
+
+
+Команда `info` формирует список потенциально полезных сведений, например установленных платформ и плагинов, версии SDK для каждой платформы и версии CLI и `node.js`:
+
+ $ cordova info
+
+
+Она представляет информацию на экран и перенаправляет выходные данные в локальный файл `info.txt`.
+
+**Примечание**: в настоящее время, доступны только сведения о платформах iOS и Android.
+
+## Обновление Cordova и вашего проекта
+
+После установки утилиты `cordova`, вы можете всегда обновить ее до последней версии, выполнив следующую команду:
+
+ $ sudo npm update -g cordova
+
+
+Используйте этот синтаксис для установки определенной версии:
+
+ $ sudo npm install -g cordova@3.1.0-0.2.0
+
+
+Запустите `cordova - v`, чтобы увидеть, какая версия в настоящее время установлена. Выполните команду `npm info` для более длинного списка, который включает в себя текущую версию и другие доступные номера версий:
+
+ $ npm info cordova
+
+
+Кордова 3.0 является первая версия поддерживающая интерфейс командной строки, описанные в этом разделе. Если вы обновляете проект с версии ранее чем 3.0, необходимо создать новый проект, как описано выше, а затем скопировать старые ресурсы приложения в каталог верхнего уровня `www`. Там, где это применимо, далее сведения об обновлении до 3.0 доступны в разделе "Руководство по поддерживаемым платформам". После обновления к интерфейсу командной строки `cordova` используйте `npm update` чтобы оставаться актуальным, более длительные процедуры, описанные там более не актуальны.
+
+Cordova 3.0 + по-прежнему может требовать различных изменений структуры каталогов уровня проекта и других зависимостей. После того, как вы выполните команду `npm` указанную выше для обновления Cordova, необходимо убедиться, что ресурсы вашего проекта соответствуют требованиям последней версии. Выполните команды указанную ниже для каждой платформы, под которую вы создаете приложение:
+
+ $ cordova platform update android
+ $ cordova platform update ios
+ ...etc.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/hybrid/plugins/index.md b/docs/ru/5.1.1/guide/hybrid/plugins/index.md
new file mode 100644
index 0000000..e283465
--- /dev/null
+++ b/docs/ru/5.1.1/guide/hybrid/plugins/index.md
@@ -0,0 +1,160 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по разработке плагинов
+
+*Плагин* представляет собой пакет из встраиваемого кода, который позволяет WebView Cordova, в котором отображается приложение, взаимодействовать с платформой, на которой работает плагин. Плагины предоставляют доступ к функциям устройства и платформы, которые обычно недоступны для веб-приложений. Все основные функции Cordova API реализованы в виде плагинов, и многие другие доступны, что включение функций, таких как сканеры штрих-кодов, NFC-коммуникации, или адаптировать календарь интерфейсов. Существует [реестр][1] доступных плагинов.
+
+ [1]: http://plugins.cordova.io
+
+Плагины составляют единый интерфейс JavaScript наряду с соответствующей библиотеки машинного кода для каждой поддерживаемой платформы. По сути это скрывает различные реализации машинного кода за общий интерфейс JavaScript.
+
+Этот раздел шаги через простой *эхо* плагин, который передает строку из JavaScript на родной платформе и обратно, один, который можно использовать в качестве модели для создания гораздо более сложные функции. В этом разделе обсуждаются основные плагинная структура и интерфейс JavaScript с видом на улицу. Для каждого соответствующего родной интерфейс см. список в конце этого раздела.
+
+В дополнение к этим инструкциям, при подготовке к написать плагин, то лучше посмотреть на [Существующие плагины][2] для руководства.
+
+ [2]: http://cordova.apache.org/#contribute
+
+## Создание плагина
+
+Разработчики приложений используют команду CLI `plugin add` (обсуждается в разделе "Интерфейс командной строки") чтобы применить плагин к проекту. Аргумент для этой команды является URL-адрес для *git* -репозиторий, содержащий код плагина. Этот пример реализует API устройств в Кордова:
+
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+
+
+Репозиторий плагинов должен предоставлять файл манифеста верхнего уровня `plugin.xml` . Есть много способов для настройки этого файла, подробности о которых доступны в "Спецификация расширений". Эта сокращенная версия плагина `Device` обеспечивает простой пример для использования в качестве модели:
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="cordova-plugin-device" version="0.2.3">
+ <name>Device</name>
+ <description>Cordova Device Plugin</description>
+ <license>Apache 2.0</license>
+ <keywords>cordova,device</keywords>
+ <js-module src="www/device.js" name="device">
+ <clobbers target="device" />
+ </js-module>
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice"/>
+ </feature>
+ </config-file>
+ <header-file src="src/ios/CDVDevice.h" />
+ <source-file src="src/ios/CDVDevice.m" />
+ </platform>
+ </plugin>
+
+
+Атрибут `id` тега верхнего уровня `plugin` использует тот же формат реверс домена для идентификации плагина как и приложения, к которым он добавляется. Тег `js-module` указывает путь к общим интерфейсом JavaScript. Тег `platform` указывает соответствующий набор кода платформы, для платформы `ios` в данном случае. Тег `config-file` инкапсулирует тег `feature`, который вводится доабавляется в платформо-зависимый файл `config.xml`, чтобы уведомить платформу о дополнительном коде библиотеки. Теги `header-file` и `source-file` указывают путь к файлам библиотеки компонентов.
+
+## Проверка плагина
+
+Вы можете использовать `plugman` утилита для проверки, является ли плагин устанавливает правильно для каждой платформы. Установка `plugman` с помощью следующей команды [node][3] :
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+Вам нужен корректный каталог исходного кода приложения, например каталог верхнего уровня `www`, включенных в проект, созданный CLI, как описано в разделе "Интерфейс командной строки". Убедитесь, что домашняя страница приложения `index.html` ссылаются на имя файла интерфейса плагина JavaScript, как будто он расположен в той же директории с исходным кодом:
+
+ <script src="myplugin.js"></script>
+
+
+Затем выполните команду, такую как нижеуказанную, для тестирования что iOS зависимости загрузились должным образом:
+
+ $ plugman install --platform ios --project /path/to/my/project/www --plugin /path/to/my/plugin
+
+
+Для подробной информации о параметрах `plugman`, см. "Использование Plugman для управления расширениями". Для получения информации о том, как на самом деле *отладки* плагины увидеть родной интерфейс каждой из платформ, перечисленных в нижней части этой страницы.
+
+## Интерфейс JavaScript
+
+JavaScript предоставляет интерфейс передней, что делает его может быть самой важной частью плагин. Ваш плагин JavaScript можно структурировать, однако вам нравится, но вам нужно вызвать `cordova.exec` для взаимодействия с родной платформой, используя следующий синтаксис:
+
+ cordova.exec(function(winParam) {},
+ function(error) {},
+ "service",
+ "action",
+ ["firstArgument", "secondArgument", 42, false]);
+
+
+Вот как работает каждого параметра:
+
+* `function(winParam) {}`: Функция обратного вызова успех. Предполагая ваш `exec` вызов завершается успешно, эта функция выполняет наряду с каких-либо параметров, вы проходите к нему.
+
+* `function(error) {}`: Функция обратного вызова ошибки. Если операция не завершена успешно, эта функция выполняется с параметром необязательные ошибки.
+
+* `"service"`: Имя службы, для вызова на родной стороне. Это соответствует в родной класс, для которого более подробная информация доступна в родной гидов, перечисленных ниже.
+
+* `"action"`: Имя действия вызова на родной стороне. Это обычно соответствует методу собственного класса. Смотрите собственного руководства, перечисленных ниже.
+
+* `[/* arguments */]`: Массив аргументов для передачи в родной среде.
+
+## Пример JavaScript
+
+В этом примере показан один из способов реализовать интерфейс JavaScript плагин:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+В этом примере плагин прикрепляется к `window` объект как `echo` функция, которая плагин пользователей назвал бы следующим образом:
+
+ window.echo("echome", function(echoValue) {
+ alert(echoValue == "echome"); // should alert true.
+ });
+
+
+Посмотрите на три последние аргументы для `cordova.exec` функции. Первые звонки `Echo` *службы*, имя класса. Второй просит `echo` *действий*, метода в этом классе. В-третьих, массив аргументов, содержащих строку эхо, которая является `window.echo` функция в первый параметр.
+
+Успех обратного вызова передается в `exec` это просто ссылка на функцию обратного вызова `window.echo` принимает. Если родной платформе инициирует обратный вызов для ошибки, он просто вызывает успех обратного вызова и передает ему строку по умолчанию.
+
+## Интерфейсы
+
+После того, как вы определяете JavaScript для вашего плагина, необходимо дополнить его по крайней мере один собственной реализации. Детали для каждой платформы перечислены ниже, и каждый основывается на простой пример эхо плагин выше:
+
+* Плагины для Amazon Fire OS
+* Плагины для Android
+* Плагины для iOS
+* Плагины для BlackBerry 10
+* Плагины Windows Phone 8
+* Плагины Windows
+
+Платформа Tizen не поддерживает плагины.
+
+## Публикации плагины
+
+После того как вы развивать ваш плагин, вы можете опубликовать и поделиться им с сообществом. Вы можете опубликовать ваш плагин в [реестра][1] Cordova (на основе [`npmjs`][4]) или в любом другом основанном на `npmjs` реестре. Другие разработчики могут установить его автоматически с помощью `plugman` или Кордова CLI. (Подробную информацию о каждом пути разработки, см. "Использование Plugman для управления расширениями" и "Интерфейс командной строки".)
+
+ [4]: https://github.com/isaacs/npmjs.org
+
+Чтобы опубликовать плагин, вам нужно использовать `plugman` инструмент и пройти через следующие шаги:
+
+ $ plugman adduser # that is if you don't have an account yet
+ $ plugman publish /path/to/your/plugin
+
+
+Вот оно что!
+
+Запуск `plugman --help` перечислены другие доступные команды на основе реестра.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/hybrid/webviews/index.md b/docs/ru/5.1.1/guide/hybrid/webviews/index.md
new file mode 100644
index 0000000..8e7bfda
--- /dev/null
+++ b/docs/ru/5.1.1/guide/hybrid/webviews/index.md
@@ -0,0 +1,29 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Интеграция WebViews
+
+Приложения cordova обычно реализуются как на основе браузера *WebView* в пределах мобильной платформы. В этом разделе показано, как, для поддерживаемых платформ, создать собственных WebView компоненты, которые в полной мере используют API Cordova. Затем вы сможете развернуть эти компоненты приложения Cordova наряду с собственными компонентами в гибридном приложении.
+
+Чтобы развернуть WebView, вы должны быть знакомы с средой программирования родной для платформы. Ниже приведены инструкции для поддерживаемых платформ:
+
+* WebView в Amazon Fire OS
+* WebViews в Android
+* WebViews в iOS
+* Windows Phone 8.0 WebViews
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/next/index.md b/docs/ru/5.1.1/guide/next/index.md
new file mode 100644
index 0000000..ad061e4
--- /dev/null
+++ b/docs/ru/5.1.1/guide/next/index.md
@@ -0,0 +1,254 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Последующие шаги
+
+Для разработчиков, иметь представление о том, как использовать Cordova CLI и использовать плагины, есть несколько вещей, вы можете хотеть рассматривать исследования рядом с построения лучшего, более мощные приложений Cordova. Следующий документ предлагает советы по различным темам, касающимся передовой практики, испытаний, модернизации и другие темы, но не предназначен быть директивный характер. Рассмотрим это вашей отправной точкой для вашего роста, как разработчик Кордова. Кроме того если вы видите то, что можно улучшить, пожалуйста, [внести][1]!
+
+ [1]: http://cordova.apache.org/#contribute
+
+Данное руководство содержит следующие разделы:
+
+* Лучшие практики
+* Обработка обновлений
+* Тестирование приложений Cordova
+* Отладка приложений Cordova
+* Пользовательский интерфейс
+* Особые соображения
+* Ногу
+* Получение справки
+
+# Лучшие практики разработки приложений Cordova
+
+## 1) Спа-ваш друг
+
+Прежде всего - приложений Cordova следует принять дизайн спа (одной страницы приложения). Слабо определены, Спа это клиентское приложение, которое запускается из одного запроса веб-страницы. Пользователь загружает начальный набор ресурсов (HTML, CSS и JavaScript) и дальнейшего обновления (показывая новый взгляд, загрузки данных) делается через AJAX. Курорты широко используются для более сложных клиентских приложений. GMail является прекрасным примером этого. После загрузки GMail, mail просмотров, редактирования и Организации выполняются путем обновления DOM вместо фактически оставляя на текущей странице для загрузки полностью новый.
+
+С помощью спа может помочь вам организовать ваше приложение более эффективным образом, но она также имеет конкретные преимущества для приложений Cordova. Cordova-приложение необходимо дождаться события deviceready прежде чем какие-либо плагины могут быть использованы. Если вы не использовать спа, и пользователь нажимает перейти от одной страницы к другой, вам придется ждать deviceready огонь снова прежде чем вы делаете использовать плагин. Это легко забыть, как ваше приложение получает больше.
+
+Даже если вы не хотите использовать Cordova, создание мобильного приложения без использования архитектуры одной страницы будет иметь серьезные производительность последствия. Это потому, что Навигация между страницами потребует скрипты, активов и т.д., необходимо перезагрузить. Даже если эти активы кэшируются, по-прежнему будет проблем производительности.
+
+Примеры спа библиотек, которые можно использовать в приложениях Cordova являются:
+
+* [AngularJS][2]
+* [EmberJS][3]
+* [Костяк][4]
+* [Кэндо пользовательского интерфейса][5]
+* [Монака][6]
+* [ReactJS][7]
+* [Sencha Touch][8]
+* [jQuery Mobile][9]
+
+ [2]: http://angularjs.org
+ [3]: http://emberjs.com
+ [4]: http://backbonejs.org
+ [5]: http://www.telerik.com/kendo-ui
+ [6]: http://monaca.mobi/en/
+ [7]: http://facebook.github.io/react/
+ [8]: http://www.sencha.com/products/touch/
+ [9]: http://jquerymobile.com
+
+И много, много, больше.
+
+## 2) производительность.
+
+Один из самых больших ошибок, можно сделать новый разработчик Кордова является предположить, что производительность, они получают на столе машины является то же самое, они получат на мобильном устройстве. Хотя наших мобильных устройств получили более мощные каждый год, они по-прежнему не хватает мощности и производительности рабочего стола. Мобильные устройства, как правило, имеют гораздо меньше оперативной памяти и GPU, что является далеко от их стола (или даже ноутбук) братьев. Полный список советов здесь будет слишком много, но вот несколько вещей, чтобы иметь в виду (с перечнем больше ресурсов в конце для дальнейших исследований).
+
+**Щелкните по сравнению с Touch** - крупнейший и самый простой ошибкой, вы можете сделать должна использовать события click. Хотя эти «работы» просто отлично на мобильный, большинство устройств вводят 300 мс задержки на них для того, чтобы различить прикосновение и коснуться событие «hold». С помощью `touchstart` , или `touchend` , приведет к резкому улучшению - 300 мс не звучит как много, но это может привести к отрывисто обновления пользовательского интерфейса и поведения. Следует также учитывать тот факт, что «touch» события не поддерживаются на не webkit-браузерами, см [CanIUse][10]. Для того, чтобы справиться с эти ограничения, вы можете оформить различные библиотеки, такие как HandJS и Fastouch.
+
+ [10]: http://caniuse.com/#search=touch
+
+**Переходы CSS против манипуляции DOM** - с использованием аппаратного ускорения переходы CSS будет значительно лучше, чем использование JavaScript для создания анимации. Смотрите список ресурсов в конце этого раздела для примеров.
+
+**Сетей сосать** - ОК, сети не всегда сосать, но задержку мобильных сетей, даже хорошие мобильные сети, намного хуже, чем вы, вероятно, думаете. Приложение рабочего стола, который хлебает вниз 500 строк данных JSON, каждые 30 секунд, будет медленнее на мобильное устройство, а также батарея hog. Имейте в виду, что Кордова apps имеют несколько способов для сохранения данных в приложении (LocalStorage и файловой системе, например). Кэшировать данные локально и учитывать количество данных, отправляемых и обратно. Это особенно важно, когда ваше приложение подключается через сотовую сеть.
+
+**Дополнительный выигрыш в производительности статьи и ресурсы**
+
+* [«Вы наполовину assed он»][11]
+* [«Топ 10 Советы по повышению производительности для PhoneGap и гибридных приложений»][12]
+* [«Быстрые приложения и сайты с JavaScript»](https://channel9.msdn.com/Events/Build/2013/4-313)
+
+ [11]: http://sintaxi.com/you-half-assed-it
+ [12]: http://coenraets.org/blog/2013/10/top-10-performance-techniques-for-phonegap-and-hybrid-apps-slides-available/
+
+## 3) признавать и обрабатывать автономный статус
+
+Смотрите предыдущий совет о сетях. Не только вы можете быть на медленных сетях, это вполне возможно для вашего приложения в полностью автономном режиме. Приложение должно обрабатывать это интеллигентая(ый) образом. Если ваше приложение не произойдет, люди будут думать, что ваше приложение не работает. Учитывая, насколько легко это для обработки (Кордова поддерживает прослушивание для оффлайн и онлайн событие) нет абсолютно никаких оснований для вашего приложения не реагировать, хорошо, когда запускать в автономном режиме. Будьте уверены, чтобы проверить (см. ниже раздел Тестирование) вашего приложения и не забудьте проверить, как ваше приложение обрабатывает при запуске в одном государстве и затем переключиться на другой.
+
+Обратите внимание, что онлайн и оффлайн события, а также API подключения сети не является совершенным. Вам придется полагаться на с помощью XHR-запрос, чтобы увидеть, если оно действительно оффлайн или онлайн. В конце дня быть уверен, добавить той или иной форме поддержку для сетевых проблем - в самом деле, в Apple store (и возможно другие магазины) будут отвергать apps которые не обрабатывает должным образом оффлайн/онлайн государств. Для более подробного обсуждения этой темы см [«Является эта вещь по?»][13]
+
+ [13]: http://blogs.telerik.com/appbuilder/posts/13-04-23/is-this-thing-on-%28part-1%29
+
+# Обработка обновлений
+
+## Обновление проектов Кордова
+
+Если ваш существующий проект был создан с помощью Cordova 3.x, можно обновить проект, выполнив следующие действия:
+
+ Кордова Платформа обновления имя платформы ios, android, и др.
+
+
+Если ваш существующий проект был создан в версии до Кордова 3.x, вероятно было бы лучше, чтобы создать новый проект 3.x Кордова, а затем скопируйте код и ресурсы вашего существующего проекта в новый проект. Типичные действия:
+
+* Создайте новый проект 3.x Кордова (Кордова создание...)
+* Скопируйте папку www из старого проекта в новый проект
+* Скопируйте любые параметры конфигурации из старого проекта в новый проект
+* Добавьте любые плагины, используемые в старого проекта в новый проект
+* Создайте свой проект
+* Тест, тест, тест!
+
+Независимо от предыдущей версии проекта абсолютно важно, что вы читаете на то, что было изменено в обновленной версии, как обновление может нарушить ваш код. Лучшее место, чтобы найти эту информацию будет в выпуске опубликованы на блоге Кордова и в хранилищах. Необходимо тщательно протестировать приложение, чтобы проверить правильность работы после выполнения обновления.
+
+Примечание: некоторые плагины не могут быть совместимы с новой версией Кордова. Если плагин не совместим, вы можете быть в состоянии найти замену плагин, который делает то, что вам нужно, или может потребоваться отложить модернизацию вашего проекта. Кроме того изменить плагин, чтобы он работать под новой версии и вносить обратно в общины.
+
+## Обновления плагинов
+
+По состоянию на Cordova 3.4 не существует механизма для обновления измененных плагины, с помощью одной команды. Вместо этого удалить плагин и добавить его обратно в ваш проект, и будет установлена новая версия:
+
+ Кордова плагин rm com.some.plugin cordova плагин добавить com.some.plugin
+
+
+Не забудьте проверить обновленный плагин документации, как вам может потребоваться настроить код для работы с новой версией. Кроме того проверьте, что новая версия плагина работает с версией вашего проекта Кордова.
+
+Всегда проверяйте свои приложения, чтобы обеспечить, что установка нового плагина не нарушил что-то, что вы не планировали.
+
+Если ваш проект имеет много плагинов, которые необходимо обновить, он может сэкономить время для создания оболочки или пакетный сценарий, который удаляет и добавляет плагины с помощью одной команды.
+
+# Тестирование приложений Cordova
+
+Супер важно, тестирование приложений. Кордова команда использует Жасмин, но любой дружественный отряд веб-тестирования решение будет делать.
+
+## Тестирование на тренажере против на реальном устройстве
+
+Это не редкость для использования настольных браузеров и тренажеры/эмуляторы устройств при разработке Cordova-приложение. Однако это невероятно важно, что вы протестировали свое приложение на столько физических устройств, как вы, возможно, может:
+
+* Тренажеры являются именно: тренажеры. Например ваше приложение может работать в симуляторе iOS без проблем, но он может не на реальном устройстве (особенно в определенных обстоятельствах, например состояние нехватки памяти). Или, ваше приложение может на самом деле не на тренажере, хотя она прекрасно работает на реальном устройстве.
+* Эмуляторы являются именно: Эмуляторы. Они не представляют, насколько хорошо ваше приложение будет работать на физическом устройстве. Например некоторые эмуляторы может сделать ваше приложение с искаженными дисплеем, в то время как реальное устройство не имеет никаких проблем. (Если вы столкнулись с этой проблемой, отключите узел GPU в эмуляторе).
+* Тренажеры обычно быстрее, чем физическое устройство. Эмуляторы, с другой стороны, как правило, медленнее. Не судите производительность вашего приложения, как он выполняет в тренажере или эмуляторе. Судья производительность вашего приложения, как он работает на спектр реальных устройств.
+* Невозможно получить хорошую почувствовать, как приложение реагирует на ваши прикосновения, используя эмулятор или симулятор. Вместо этого запуск приложения на реальном устройстве можно отметить проблемы с размерами элементов пользовательского интерфейса, отзывчивость и др.
+* Хотя было бы неплохо иметь возможность проверить только на одно устройство на платформе, то лучше проверить на многих устройствах, спортивные много различных версий ОС. К примеру что работает на вашей конкретной Android смартфон может не на другом устройстве Android. То, что работает на устройстве iOS 7 может не на устройстве iOS 6.
+
+Это, конечно же, невозможно проверить на все возможные устройства на рынке. По этой причине то целесообразно набирать много тестеров, которые имеют различные устройства. Хотя они не будут ловить каждую проблему, имеются хорошие шансы, что они откроют причуды и вопросы, которые вы бы никогда не найти в одиночку.
+
+Подсказка: Это возможно на устройствах Android Nexus легко прошить различных версий Android на устройстве. Этот простой процесс позволит вам легко тестировать приложения на различных уровнях с помощью одного устройства Андроид без аннулирования гарантии или требуя «побег из тюрьмы» или «корень» ваше устройство. Изображения фабрика Google Android и инструкции находятся в: https://developers.google.com/android/nexus/images#instructions
+
+# Отладка приложений Cordova
+
+Отладка Cordova требуется небольшая Настройка. В отличие от настольных приложений вы не можете просто открыть dev инструменты на вашем мобильном устройстве и начать отладку, к счастью, есть некоторые большие альтернативы.
+
+## iOS Отладка
+
+### Xcode
+
+С помощью Xcode можно отлаживать iOS родной стороне Cordova-приложение. Убедитесь, что область отладки показывает (вид-> отладки район). После того, как ваше приложение выполняется на устройстве (или симулятор), вывод журнала можно просмотреть в области отладки. Это где будет печатать любые ошибки или предупреждения. Также можно установить точки останова в файлах источника. Это позволит вам просматривать состояние переменных в то время и шаг через код по одной строке за один раз. Состояние переменных отображается в области отладки, когда точка останова. Как только ваше приложение и работает на устройстве, вы можете принести вверх в Safari веб-инспектор (как описано ниже) для отладки в webview и js части вашего приложения. Для более подробной информации и помощи, найти в руководстве Xcode: [Руководство по отладке Xcode][14]
+
+ [14]: https://developer.apple.com/library/mac/documentation/ToolsLanguages/Conceptual/Xcode_Overview/DebugYourApp/DebugYourApp.html#//apple_ref/doc/uid/TP40010215-CH18-SW1
+
+### Safari удаленной отладки с веб-инспектор
+
+С Safari веб-инспектор можно отлаживать код webview и js в Cordova-приложение. Это работает только на OSX и только с iOS 6 (и выше). Он использует Safari для подключения к устройству (или симулятор) и будет подключаться к Cordova-приложение браузера dev инструменты. Вы получаете то, что вы ожидаете от dev tools - инспекции/манипуляции DOM, отладчик JavaScript, сеть инспекции, консоли и многое другое. Как Xcode с Safari веб-инспектор можно установить точки останова в коде JavaScript и посмотреть состояние переменных в то время. Можно просмотреть ошибки, предупреждения или сообщения, которые выводятся на консоль. Можно также выполнять команды JavaScript непосредственно из консоли, как ваше приложение выполняется. Для более подробной информации о том, как установить его вверх и то, что вы можете сделать, увидеть эту прекрасную блоге: <http://moduscreate.com/enable-remote-web-inspector-in-ios-6/> и это руководство: [Safari веб-инспектор руководство][15]
+
+ [15]: https://developer.apple.com/library/safari/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/Introduction/Introduction.html
+
+## Хром удаленной отладки
+
+Практически же, как в версии Safari, это работает только с Android, но может быть использован с любой настольной операционной системы. Это требует как минимум Андроид 4.4 (KitKat), минимальный уровень API 19 и хром 30 + (на столе). После подключения, вы получите тот же опыт хром Dev Tools для мобильных приложений, как приложения для настольных. Даже лучше Chrome Dev инструменты имеют зеркальный вариант, который показывает ваше приложение работает на мобильном устройстве. Это больше, чем просто представление - вы можете прокручивать и нажмите от dev tools и обновляет на мобильном устройстве. Подробнее об удаленной отладки Chrome можно найти здесь: <https://developers.google.com/chrome/mobile/docs/debugging>
+
+Это позволяет использовать Chrome Dev инструменты для проверки приложений iOS, через прокси WebKit: <https://github.com/google/ios-webkit-debug-proxy/>
+
+## Пульсации
+
+Пульсация — обои на основе эмулятор для Кордова проектов. По сути он позволяет запускать Cordova-приложение в вашем настольном приложении и поддельные различные функции Кордова. Например он позволяет имитировать акселерометр для тестирования трясти события. Это подделки камеры API, позволяя выбрать картинку с вашего жесткого диска. Пульсации позволяет вам сосредоточиться на пользовательский код, а не беспокоиться о Кордове плагины. Вы можете узнать больше о пульсации здесь: <http://ripple.incubator.apache.org/>
+
+## Weinre
+
+Weinre создает локальный сервер, который может содержать клиент удаленной отладки для приложений Cordova. После того как установил и начал его, вы скопировать строку кода в Cordova-приложение и перезапустите его. Затем можно открыть панель инструментов dev на рабочем столе для работы с приложением. Weinre не как фантазии, как Chrome и Safari удаленной отладки, но имеет преимущества работы с гораздо большей спектр операционных систем и платформ. Дополнительную информацию можно найти здесь: <http://people.apache.org/~pmuellr/weinre/docs/latest/>
+
+## Другие варианты
+
+* BlackBerry 10 поддерживает отладку также: [Документация][16]
+* Вы можете отлаживать, а также с помощью диспетчера приложений Firefox, [этот блог][17] и эту [статью MDN][18].
+* Дополнительные примеры и объяснения выше отладки советы, см: <http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/>
+
+ [16]: https://developer.blackberry.com/html5/documentation/v2_0/debugging_using_web_inspector.html
+ [17]: https://hacks.mozilla.org/2014/02/building-cordova-apps-for-firefox-os/
+ [18]: https://developer.mozilla.org/en-US/Apps/Tools_and_frameworks/Cordova_support_for_Firefox_OS#Testing_and_debugging
+
+# Пользовательский интерфейс
+
+Здание Cordova-приложение, которое выглядит хорошо на мобильный может быть сложной задачей, особенно для разработчиков. Многие люди решили использовать UI framework, чтобы сделать это проще. Вот краткий список опций, которые вы можете хотеть рассматривать.
+
+* [jQuery Mobile][9] - jQuery Mobile автоматически повышает ваш макет для мобильных оптимизации. Он также обрабатывает создание спа для вас автоматически.
+* [Ionic][19] -это мощная инфраструктура пользовательского интерфейса на самом деле имеет свой собственный CLI для обработки создания проекта.
+* [Храповик][20] - привлечены к вам люди, которые создали Bootstrap.
+* [Кэндо UI][5] - открытым исходным кодом пользовательского интерфейса и платформа приложений от Telerik.
+* [Автоэмаль][21]
+* [ReactJS][7]
+
+ [19]: http://ionicframework.com/
+ [20]: http://goratchet.com/
+ [21]: http://topcoat.io
+
+При создании интерфейса пользователя, важно думать о всех платформ, которые вы ориентируетесь и различия между ожиданиям пользователя. Например, Android приложение, которое имеет интерфейс iOS стиль будет вероятно не хорошо сочетаются с пользователей. Это иногда даже применяется в различных магазинах приложений. Из-за этого, важно, что вы уважаете конвенций каждой платформы и поэтому знакомы с различными руководящими принципами человеческого интерфейса:
+
+* [iOS][22]
+* [Android][23]
+* [Windows Phone][24]
+
+ [22]: https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html
+ [23]: https://developer.android.com/designWP8
+ [24]: http://dev.windowsphone.com/en-us/design/library
+
+## Дополнительные пользовательского интерфейса статьи и ресурсы
+
+Хотя браузеров становится все больше и больше стандартов жалобы, мы все еще живем в мире, префиксом (-webkit и - г-жа) следующие статьи ценно при разработке UI в для кросс-браузер приложений: <http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx>
+
+# Особые соображения
+
+Хотя Cordova упрощает кросс платформенной разработки, это просто не возможно обеспечить 100% изоляция от родной базовой платформы. Так что надо знать ограничений.
+
+## Особенности платформы
+
+При чтении документации, искать разделы, которые структура различных поведений или требования на различных платформах. Если они присутствуют, они будут в разделе под названием «Android причуды», «причуды iOS», и т.д. Прочитайте эти причуды и быть осведомлены о них, как вы работаете с Кордова.
+
+## Загрузка удаленного содержимого
+
+Вызов функции Cordova JavaScript с удаленной загрузки HTML-страницы (HTML-страницы, не хранятся локально на устройстве) является неподдерживаемая конфигурация. Это потому что Кордова была не предназначены для этого, и сообщество Apache Cordova делает не тестирования данной конфигурации. Хотя она может работать в некоторых случаях, она не рекомендуется и не поддерживается. Есть проблемы с политики единого происхождения, сохраняя JavaScript и родной части Cordova синхронизированы на той же версии (так как они соединены через частной API, которые могут изменяться), в надежности удаленного контента, вызов собственных функций местных и потенциальный отказ магазина app.
+
+Отображение удаленного загрузки HTML-содержимое в webview должно быть сделано с помощью Кордова в InAppBrowser. InAppBrowser разработан таким образом, что JavaScript, работает там не имеют доступа к API JavaScript Кордова по причинам, перечисленным выше. Пожалуйста, обратитесь к разделу "Руководство по безопасности".
+
+# Ногу
+
+Вот несколько способов, чтобы держать в курсе Кордова.
+
+* Подписаться на [блог Кордова][25].
+* Подписаться на [список разработчиков][26]. Обратите внимание - это не группа поддержки! Скорее это место, где обсуждается развитие Кордова.
+
+ [25]: http://cordova.apache.org/#news
+ [26]: http://cordova.apache.org/#mailing-list
+
+# Получение справки
+
+Следующие ссылки являются лучшими местами, чтобы получить помощь для Кордова:
+
+* StackOverflow: <http://stackoverflow.com/questions/tagged/cordova> с помощью тега Cordova, можно просматривать и просматривать все вопросы Кордова. Обратите внимание, что StackOverflow автоматически преобразует тег «Phonegap», чтобы «Кордова», так что таким образом вы будете иметь доступ к исторических вопросов, а также
+* PhoneGap группы Google: [https://groups.google.com/forum/#! форум/phonegap][27] этой группе Google был старый форум поддержки для когда Кордова по-прежнему называется PhoneGap. Хотя есть еще много Cordova пользователей, которые часто эта группа, Кордова сообщество выразило заинтересованность в упор меньше на этой группы и вместо этого с помощью StackOverflow для поддержки
+* Встреча: <http://phonegap.meetup.com> - рассмотреть возможность найти местных Кордова/PhoneGap встреча группы
+
+ [27]: https://groups.google.com/forum/#!forum/phonegap
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/overview/index.md b/docs/ru/5.1.1/guide/overview/index.md
new file mode 100644
index 0000000..6302297
--- /dev/null
+++ b/docs/ru/5.1.1/guide/overview/index.md
@@ -0,0 +1,74 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Введение
+
+Apache Cordova — это платформа разработки мобильных приложений с открытым исходным кодом. Она позволяет использовать стандартные веб-технологии, такие как HTML5, CSS3 и JavaScript для кросс платформенной разработки, избегая родного языка разработки для каждой из мобильных платформ. Приложения выполняются внутри обертки нацеленной на каждую платформу и полагаются на стандартные API для доступа к датчикам устройства, данным и состоянию сети.
+
+Apache Cordova закончил инкубационный период в октябре 2012 года как основной проект в рамках Apache Software Foundation (ASF). Через участие в ASF, будущее развитие Cordova, обеспечит открытое руководство проектом. Он всегда будет оставаться бесплатным и с открытым исходным кодом под лицензией Apache версии 2.0. Посетите [cordova.apache.org][1] для получения дополнительной информации.
+
+ [1]: http://cordova.apache.org
+
+Используйте Apache Cordova, если вы:
+
+* Мобильный разработчик и хотите расширить приложение на более чем одну платформу, без необходимости повторно реализовать его для каждого языка разработки платформ и набора инструментов.
+
+* веб-разработчик и хотите, чтобы развернуть веб-приложение, который упаковано для распространения в различных магазинах приложений.
+
+* Мобильный разработчик, заинтересованный в смешивания компонентов собственного приложения с *WebView* (Специальный браузер окно), можно получить доступ к API уровне устройства, или если вы хотите разработать плагин интерфейс между родной и WebView компонентами.
+
+## Основные компоненты
+
+Пиложения Cordova полагаются на общий файл `config.xml`, который содержит информацию о приложении и определяет параметры, влияющие на то как приложенеи работает, такие как, реагирует ли оно на изменение ориентации устройства. Этот файл соответствует спецификации W3C [Упакованные веб-приложения][2], или *widget*, .
+
+ [2]: http://www.w3.org/TR/widgets/
+
+Само приложение реализована как веб-страницы, по умолчанию локальный файл под названием *index.html*, который ссылается на любой CSS, JavaScript, изображения, файлы мультимедиа или другие ресурсы необходимы для его запуска. Приложение выполняет как *WebView* в пределах оболочки приложения, которую вы распространяете в магазины приложений.
+
+WebView с поддержкой Cordova может представлять приложения и полностью его пользовательский интерфейс. На некоторых платформах она также может быть компонентом в больших, гибридные приложения, который объединяют WebView с другими компонентами приложения. (Подробную информацию см. в разделе "Интеграция WebViews".)
+
+Интерфейс *плагина* доступен для Cordova и других компоненты, для взаимодействия друг с другом. Это позволяет вызывать код на языке платформы из JavaScript. В идеале на нескольких платформах устройств согласуются JavaScript API, чтобы этот машинный код. Начиная с версии 3.0 плагины предоставляют привязки к стандартным API интерфейсам устройства. Сторонние плагины предоставляют дополнительные привязки для функции не обязательно доступных на всех платформах. Можно найти эти сторонние плагины в [реестре плагинов][3] и использовать их в своем приложении. Вы можете также разработать свои собственные плагины, как описано в разделе "Руководство по разработке плагинов". Плагины могут оказаться необходимыми, например, для связи между Cordova и собственными компонентами.
+
+ [3]: http://plugins.cordova.io
+
+**Примечание**: начиная с версии 3.0, при создании проекта Cordova, она не имеет каких-либо плагинов настоящей. Это новое поведение по умолчанию. Какие плагины вы хотите, даже основные плагины, должен быть явно добавлен.
+
+Cordova не предоставляет каких-либо виджетов пользовательского интерфейса или MV *фреймворков. Cordova предоставляет только во время выполнения, в которой те могут выполнять. Если вы хотите использовать UI-виджеты и/или MV* фреймворк, вам нужно будет выбрать их и включить их в приложение самостоятельно, как ресурсы третьей стороны.
+
+## Пути разработки
+
+Начиная с версии 3.0 можно использовать два основных рабочих процесса для создания мобильных приложений. Хотя вы можете использовать любой рабочий процесс для выполнения одной и той же задачи, каждый из этих путей имеет свои преимущества:
+
+* **Кросс платформенный рабочий процесс**: Используйте этот рабочий процесс если вы хотите, чтобы ваше приложение запускалось на максимально возможном количестве мобильных платформ, с минимальными нуждами для платформо-специфической разработки. Этот рабочий процесс формируется возле утилиты `cordova`, также известном как Cordova *CLI*, который был введен начиная с Cordova 3.0. CLI это высоко уровневый инструмент который позволяет построить проекты для как можно большего количества платформа одновременно, абстрагируя как можно больше функциональности низко-уровневых скриптов. CLI копирует общий набор web ресурсво в подкаталоги для каждой мобильной платформы, делает любые необходимые изменения в конфигурацию для каждой платформы, запускает сценарии сборки для создания исполняемых файлов приложения. CLI также предоставляет общий интерфейс для применения плагинов для вашего приложения. CLI также предоставляет общий интерфейс для применения плагинов для вашего приложения. Для более подробной информации о CLI см. раздел "Интерфейс командной строки". Если у вас есть необходимость по центру платформы рабочего процесса, Рабочий процесс кросс платформенный рекомендуется.
+
+* **Платформо-ориентированный процесс разработки**: Используйте этот процесс если вы хотите сфокусироваться на построении приложения для одной платформы и вам будет необходимо вносить модификации на низком уровне. Вы должны использовать этот подход, к примеру, если вы хотите чтобы ваше приложение совмещало собственные компоненты с веб-ориентированными компонентами Cordova, как описано в разделе "Интеграция WebViews". Как правило этот рабочий процесс используется, если необходимо изменить проект с помощью SDK. Этот рабочий процесс опирается на набор скриптов более низкого уровня, которые приспособлены для каждой поддерживаемой платформы и отдельную утилита Plugman, которая позволяет применять плагины индивидуально к выбранной платформе. Хотя вы можете использовать этот рабочий процесс для создания кросс платформенных приложений, это как правило сложнее, потому что отсутствие утилит более высокого уровня означает, отдельные циклов сборки и модификации плагинов для каждой платформы. Тем не менее этот рабочий процесс позволяет вам более широкий доступ к вариантам разработки, предоставляемые каждым SDK и важно для сложных гибридных приложений. См. различные разделы в "Руководство по поддерживаемым платформам" для подробной информации по утилитам доступных на каждой платформе.
+
+Изначально, может быть легче всего использовать кросс платформенный рабочий процесс для создания приложения, как описано в разделе "Интерфейс командной строки". Затем у вас есть возможность перейти к платформо-ориентированному процессу разработки, если требуется большая степень контроля, предоставляемую SDK. Низкоуровневые утилиты доступны на [cordova.apache.org][1] в отдельной рассылке чем CLI. Для проектов, первоначально созданные CLI, эти инструменты доступны также в различных каталогах `platforms/*/cordova` проекта.
+
+**Примечание**: после того, как вы перейти от рабочего процесса на основе CLI к платформо-ориентированному процессу и инструментам командной строки, вы не сможете вернуться назад. CLI поддерживает общий набор кросс платформенный исходного кода, который при каждом построении он использует чтобы изменить платформо-зависимый исходный код. Чтобы сохранить любые изменения, внесенные вами в платформо-зависимые ресурсы, вам нужно перейти к платформо-ориентированным инструментам, которые игнорируют кросс платформенный исходный код и вместо этого полагаются на платформо-зависимый исходный код.
+
+## Установка Кордова
+
+Установка Cordova будет отличаться в зависимости от рабочего процесса выше, вы выбираете:
+
+* Кросс платформенный рабочий процесс: смотрите раздел "Интерфейс командной строки".
+
+* По центру платформы рабочего процесса: смотрите раздел "Руководство по поддерживаемым платформам".
+
+После установки Cordova, рекомендуется, что вы прочитали раздел "Руководство по поддерживаемым платформам" для мобильных платформ, для которых вы будете разрабатывать. Мы также рекомендуем также просмотреть разделы "Руководство по конфиденциальности", "Руководство по безопасности" и "Последующие шаги". Для настройки Cordova, смотрите раздел "Файл config.xml". Для доступа к функциям платформы на устройстве из JavaScript, обращайтесь к "API плагинов". И обращайтесь к другим включеным руководствам при необходимости.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/amazonfireos/config.md b/docs/ru/5.1.1/guide/platforms/amazonfireos/config.md
new file mode 100644
index 0000000..bce4224
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/amazonfireos/config.md
@@ -0,0 +1,60 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Настройка Amazon Fire OS
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел детализирует параметры, которые применяются только к продуктам построенным на платформе Amazon Fire ОС. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning` (логическое значение, по умолчанию `true` ): определяет, остается ли приложение работает в фоновом режиме после вызова события `pause`. Установка значения в `false` не завершает приложение после события `pause`, но просто останавливает выполнение кода в Cordova WebView в то время пока приложение находится в фоновом режиме.
+
+ <preference name="KeepRunning" value="false"/>
+
+* `ErrorUrl` (URL-адрес, По умолчанию используется `null`): Если установлено, будет отображаться странице ссылки на ошибку в приложении вместо диалоговое окно с заголовком «Ошибка приложения».
+
+ <preference name="ErrorUrl" value="error.html"/>
+
+* `LoadingDialog` (строка, по умолчанию `null`): Если указано, отображает диалоговое окно с заданным заголовком и сообщение и индикатор загрузки, при загрузке первой странице приложения. Заголовок и сообщение разделяются запятой в этой строке значение, и что запятая удаляется перед отображением диалогового окна.
+
+ <preference name="LoadingDialog" value="Please wait, the app is loading"/>
+
+* `LoadingPageDialog` (строки, по умолчанию `null`): так же, как `LoadingDialog`, но для загрузки каждой страницы следующей за первой страницей в приложении.
+
+ <preference name="LoadingPageDialog" value="Please wait, the data is loading"/>
+
+* `LoadUrlTimeoutValue` (число, значение по умолчанию — `20000`): при загрузке страницы, указывает продолжительность времени ожидания в миллисекундах, перед тем как произойдет ошибка ожидания. Этот пример определяет 10 секунд, а не 20:
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+* `SplashScreen`: Имя файла, минус его расширение в каталоге `res/drawable`. Различные ресурсы должны использовать это общее название в разных подкаталогах.
+
+ <preference name="SplashScreen" value="splash"/>
+
+* `SplashScreenDelay`(число, значение по умолчанию `5000` ): определяет количество времени в течение которого отображается заставка.
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+* `ShowTitle` (логическое значение, по умолчанию `false`): Показать заголовок в верхней части экрана.
+
+ <preference name="ShowTitle" value="true"/>
+
+* `LogLevel` (строка, по умолчанию `ERROR` ): устанавливает минимальный уровень протоколирования, через который будет фильтроваться протоколируемые сообщения из вашего приложения. Допустимыми значениями являются `ERROR`, `WARN`, `INFO`, `DEBUG`, и `VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/amazonfireos/index.md b/docs/ru/5.1.1/guide/platforms/amazonfireos/index.md
new file mode 100644
index 0000000..c186684
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/amazonfireos/index.md
@@ -0,0 +1,188 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Amazon Fire OS
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova на устройства Amazon Fire ОС, такие как Kindle Fire HDX.
+
+Смотрите ниже для более подробной информации конкретной платформы:
+
+* Настройка Amazon Fire OS
+* WebView в Amazon Fire OS
+* Плагины для Amazon Fire OS
+
+## Введение
+
+По ориентации платформы Amazon Fire OS, Кордова разработчики могут создавать гибридные веб-приложения, использующие преимущества передовых веб двигателя интегрированы устройства Kindle Fire. Amazon WebView API (AWV) является средой выполнения производных хрома веб эксклюзивные огонь ОС. Дроп-ин замены WebView, который поставляется с Android-устройств, AWV делает возможным для создания лучшего выполнения и более мощные гибридных веб-приложений, предоставляя поддержку для более быстрый движок JavaScript (V8), удаленной отладки и оптимизации аппаратного обеспечения для устройств Kindle Fire, включая ускоренной 2D холст, и доступ к HTML5 функций, не поддерживаемых Android построен в WebView, такие как: Calc CSS, формы проверки, getUserMedia, IndexedDB, рабочих веб-процессов, WebSockets и WebGL.
+
+Дополнительные сведения об интерфейсе API WebView Амазонки смотрите Амазонки портал разработчика [страницы HTML5 гибридных приложений][1]. Для вопросов о получении работы и другие вопросы поддержки, пожалуйста, смотрите на портал разработчика Амазонки [форумы - гибридных приложений HTML5][2].
+
+ [1]: https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app
+ [2]: http://forums.developer.amazon.com/forums/category.jspa?categoryID=41
+
+## Требования и поддержка
+
+Разработка приложений Cordova для Amazon Fire ОС требует установки различных файлов поддержки, включая все необходимое для разработки Android, а также Amazon WebView SDK. Проверьте список ниже для требуемых установок:
+
+* Интерфейс командной строки
+* [Android SDK][3]
+* [Apache Ant][4]
+* [Amazon WebView SDK][1]
+
+ [3]: http://developer.android.com/sdk/
+ [4]: http://ant.apache.org
+
+## Установка
+
+### Android SDK и Apache Ant
+
+Установите Android SDK с сайта [developer.android.com/sdk][3]. Вам может быть представлен выбор куда установить SDK, в противном случае переместить загруженный каталог `adt-bundle`, туда где вы храните средства разработки.
+
+Вам нужно запустить Android SDK Manager ( `android` из командной строки) по крайней мере один раз перед началом проекта Кордова. Убедитесь в том установить самую последнюю версию Android SDK инструменты и SDK платформы **специально API уровня 19**. Пожалуйста, смотрите [настройки вашей среды разработки][5] на портале разработчика Амазонки для получения дополнительных сведений о настройке среды разработки для устройств Kindle Fire OS.
+
+ [5]: https://developer.amazon.com/public/resources/development-tools/ide-tools/tech-docs/01-setting-up-your-development-environment
+
+Установка Apache Ant построить инструмент [загрузки бинарного дистрибутива муравей][6], распаковки в директорию, в которую можно обратиться позднее. Смотрите [муравей руководство][7] для получения дополнительной информации.
+
+ [6]: http://ant.apache.org/bindownload.cgi
+ [7]: http://ant.apache.org/manual/index.html
+
+Для Кордова средства командной строки для работы, вам необходимо включить Android SDK `tools` , `platform-tools` и `apache-ant/bin` каталогов в среде PATH.
+
+#### Путь Mac/Linux
+
+На Mac, Linux или других Unix подобных платформах, вы можете использовать текстовый редактор для создания или изменения `~/.bash_profile` файл, добавив строку, например, в зависимости от того, где установлен пакет SDK и муравей:
+
+ экспорт путь = ${путь}: / развития/АТД Комплект/sdk/платформы tools: / развития/АТД Комплект/sdk/инструменты: / развитие/apache муравей/bin
+
+
+Это предоставляет доступ к средствам SDK во вновь открытом терминале Windows. В противном случае выполните нижеуказанную команду, чтобы сделать изменения доступными в текущем сеансе:
+
+ $ source ~/.bash_profile
+
+
+#### Путь к каталогу Windows
+
+Чтобы изменить путь среды на Windows:
+
+* Нажмите на меню " **Пуск** " в левом нижнем углу рабочего стола, щелкните правой кнопкой мыши на **Мой комьютер**, а затем нажмите кнопку **Свойства**.
+
+* Нажмите кнопку **Дополнительные параметры системы** в столбце слева.
+
+* В открывшемся диалоговом нажмите **Переменные среды**.
+
+* Выберите переменную **PATH** и нажмите **редактировать**.
+
+* Добавьте следующее в путь, основанный на где вы установили SDK и муравей, например:
+
+ ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools;C:\Development\apache-ant\bin
+
+* Сохраните значение и закройте оба диалоговые окна.
+
+* Вам также нужно будет включить Java. Откройте командную строку и введите `java` , если она не запущена, добавить местоположение двоичных файлов Java в ваш путь также. Убедитесь, что JAVA_HOME % указывает установленный каталог JDK. Возможно, вам придется добавить среды JAVA_HOME переменной отдельно.
+
+ ; %JAVA_HOME%\bin
+
+
+### Amazon WebView SDK
+
+Для создания приложений Cordova целевой платформы Amazon Fire ОС, вам нужно скачать, распаковать и установить файлы поддержки Amazon WebView SDK. Этот шаг нужно будет только сделать для вашего первого проекта Amazon Fire OS.
+
+* Скачать Амазонка WebView SDK от [Amazon разработчик портала][1].
+
+* Копия `awv_interface.jar` из загруженного пакета SDK Кордова в рабочий каталог. Создайте папку commonlibs(shown below), если он не существует:
+
+ **Mac/Linux:** `~/.cordova/lib/commonlibs/`
+
+ **Windows:** `%USERPROFILE%\.cordova\lib\commonlibs`
+
+## Создайте новый проект для Amazon Fire ОС
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add amazon-fireos
+ $ cordova build
+
+
+***Примечание:*** В первый раз Амазонки fireos платформа установлена на вашей системе, он загрузит соответствующие файлы в рабочий каталог Cordova, но будет потом не как не хватает файлов поддержки AWV SDK (см. выше). Следуйте приведенным выше инструкциям, чтобы установить `awv_interface.jar` , затем удалить и повторно добавить Амазонки fireos платформа для вашего проекта. Этот шаг нужно будет только сделать для первого проекта Amazon Fire OS.
+
+## Развертывание на устройство
+
+Для публикации приложение непосредственно на устройство, убедитесь, что включена отладка USB на вашем устройстве, как описано на [сайте разработчика Android][8] и используя кабель мини-USB, подключите устройство к вашей системе.
+
+ [8]: http://developer.android.com/tools/device.html
+
+Вы можете опубликовать приложение на устройство из командной строки:
+
+ $ cordova запускать Амазонки fireos
+
+
+Альтернативно в Eclipse, щелкните правой кнопкой мыши проект и выберите **выполнить как → приложения для Android**.
+
+**Примечание**: в настоящее время тестирование через эмулятор не поддерживается для Amazon WebView на основе приложения, дополнительно Амазонки WebView API доступна только на огонь OS устройств. Для получения дополнительной информации смотрите в документации [SDK API WebView Амазонки][1] .
+
+### Запуск флаги
+
+Команда run принимает необязательные параметры, как указано в документе Cordova интерфейс командной строки, огонь OS также принимает дополнительные `--debug` флаг, который позволит хрома в инструменты разработчика для отладки удаленного веб.
+
+Чтобы использовать средства разработчика, введите:
+
+ $ cordova run --debug amazon-fireos
+
+
+Это даст возможность средства на запуск клиента. Вы можете подключиться к клиенту по переадресации портов с помощью Android Debug Bridge (АБР) ссылаясь на имя пакета приложения.
+
+Например:
+
+ АБР вперед tcp:9222 localabstract:com.example.helloworld.devtools
+
+
+Затем можно использовать DevTools через браузер на основе Chromium, перейдя на:`http://localhost:9222`.
+
+### Опциональная поддержка Eclipse
+
+После создания, можно использовать Eclipse, которая приходит вместе с Android SDK, чтобы изменить проект. Помните, что изменения, сделанные через Eclipse будут перезаписаны, если вы продолжаете использовать инструменты командной строки Кордова.
+
+* Запустите приложение **Eclipse** .
+
+* Выберите пункт меню **Создать проект** .
+
+* Выберите **Android-проект из существующего кода** из диалогового окна полученный и нажмите **Далее**: ![][9]
+
+* Перейдите к `hello` , или какой был создан каталог для проекта, затем в подкаталог `platforms/amazon-fireos`.
+
+* Затмение покажет вам привет и Привет CorddovaLib - 2 проектов для добавления. Добавьте оба.
+
+* Нажмите кнопку **Готово**.
+
+ [9]: img/guide/platforms/android/eclipse_new_project.png
+
+После того, как откроется окно Eclipse, красный **X** может показаться, указывая на нерешенные проблемы. Если это так, выполните следующие дополнительные действия:
+
+* Щелкните правой кнопкой мыши на папке проекта.
+
+* В результате диалоговом окне **Свойства** выберите **Android** из области переходов.
+
+* Для целевого объекта build проекта выберите самый высокий уровень Android API (в настоящее время API уровня 19) у вас установлена.
+
+* Нажмите **кнопку ОК**.
+
+* Выберите **Очистить** из меню **Проект** . Это должно исправить все ошибки в проекте.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/amazonfireos/plugin.md b/docs/ru/5.1.1/guide/platforms/amazonfireos/plugin.md
new file mode 100644
index 0000000..340ec0f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/amazonfireos/plugin.md
@@ -0,0 +1,103 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины для Amazon Fire OS
+
+Следуйте инструкциям, приведенным в разделе "Плагины для Android" для информации о разработке пользовательских плагинов.
+
+## Пример плагина Amazon Fire OS Эхо
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ </platform>
+
+
+Затем добавить следующий файл `src/org/apache/cordova/plugin/Echo.java`:
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.CordovaPlugin;
+ import org.apache.cordova.CallbackContext;
+
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * This class echoes a string called from JavaScript.
+ */
+ public class Echo extends CordovaPlugin {
+
+ @Override
+ public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+ if (action.equals("echo")) {
+ String message = args.getString(0);
+ this.echo(message, callbackContext);
+ return true;
+ }
+ return false;
+ }
+
+ private void echo(String message, CallbackContext callbackContext) {
+ if (message != null && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+ }
+
+
+Если вы хотите повторно использовать код плагина Android для платформы Amazon Fire OS, измените plugin.xml так чтобы он указывал на исходный файл в папке `android`. Например,
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+Если вы хотите написать плагин, специализироавнный для платформы Amazon Fire OS, создайте папку с именем `amazon` под ваш плагин src/ папку и изменить plugin.xml на исходный файл в каталоге `amazon`. Например,
+
+ <platform name="amazon-fireos">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ <source-file src="src/amazon/Echo.java" target-dir="src/org/apache/cordova/plugin" />
+ </platform>
+
+
+## Использование Amazon WebView в вашем плагине
+
+Cordova для Amazon Fire OS использует пользовательские Amazon WebView, который построен на открытым исходным кодом проекта Chromium. Он обеспечивает GPU ускорение и оптимизирован для плавной производительности на Kindle Fire.
+
+Чтобы понять, как наилучшим образом использовать Amazon WebView в вашем проекте, посетите [Портал разработчиков Amazon][1].
+
+ [1]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/amazonfireos/webview.md b/docs/ru/5.1.1/guide/platforms/amazonfireos/webview.md
new file mode 100644
index 0000000..fb00596
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/amazonfireos/webview.md
@@ -0,0 +1,125 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# WebView в Amazon Fire OS
+
+Начиная с 3.3.0, Cordova можно использовать в качестве компонента приложений Amazon Fire OS. Amazon Fire ОС ссылается на этот компонент как `CordovaWebView` . `CordovaWebView` расширяет Amazon WebView, который построен на открытом исходном коде проекта Chromium. Используя эту функцию, веб-приложений можно использовать последние веб-стандарты HTML5, работающие в современной веб среде.
+
+Если вы не знакомы с Amazon Fire ОС, необходимо сначала ознакомиться с разделом "Руководство для платформы Amazon Fire OS" и установить последнюю SDK, прежде чем пытаться использовать такой более необычный вариант как встраивания WebView.
+
+## Необходимые условия
+
+* Кордова 3.3.0 или больше
+
+* Android SDK, последней версии
+
+* Amazon WebView SDK
+
+## Руководство по использованию CordovaWebView в проекте OS Amazon Fire
+
+1. Следовать этим инструкциям, убедитесь, что у вас есть дистрибутив последней Кордова. Скачать его с [cordova.apache.org][1] и распакуйте его пакет Amazon Fire OS.
+
+2. Скачать и распаковать [Amazon WebView SDK][2], затем скопируйте awv_interface.jar в каталог `/framework/libs`. Создайте каталог libs/, если он не существует.
+
+3. Перейдите к пакету `/framework` директорию и запустить `ant jar` . Он создаёт Кордова `.jar` файл, как`/framework/cordova-x.x.x.jar`.
+
+4. Скопируйте файл `.jar` в каталог `/libs` Android-проекта.
+
+5. Добавьте в приложение следующий файл `/res/xml/main.xml`, с `layout_height`, `layout_width` и `id` модицифированными в соответствии с нуждами приложения:
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+6. Измените вашу деятельность так, чтобы этот класс реализовал `CordovaInterface` . Вы должны реализовать описанные методы этого интерфейса. Вы можете скопировать их из `/framework/src/org/apache/cordova/CordovaActivity.java`, или реализовать их самостоятельно. Нижеуказанный фрагмент кода показывает простое приложение , которое использует интерфейс. Обратите внимание, что id упоминаемого окна соответствует `id` атрибут, указанный в XML-фрагменте показаном выше:
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+
+ [1]: http://cordova.apache.org
+ [2]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html#installawv
+
+Если вы используете камеру, следует также реализовать следующее:
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+
+Наконец, не забудьте добавить пул потоков, в противном случае у плагинов не будет потоков где можно будет выполняться:
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+
+1. Скопировать HTML и JavaScript файлы приложения в каталог `/assets/www` проекта Amazon Fire OS.
+
+2. Скопируйте `config.xml` из `/framework/res/xml` для в каталог `/res/xml` вашего проекта.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/config.md b/docs/ru/5.1.1/guide/platforms/android/config.md
new file mode 100644
index 0000000..a82b3f7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/config.md
@@ -0,0 +1,80 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Конфигурация Android
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к построениям для Android. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `KeepRunning` (логическое значение, по умолчанию `true` ): определяет, остается ли приложение работает в фоновом режиме после вызова события `pause`. Установка значения в `false` не завершает приложение после события `pause`, но просто останавливает выполнение кода в Cordova WebView в то время пока приложение находится в фоновом режиме.
+
+ <preference name="KeepRunning" value="false"/>
+
+* `LoadUrlTimeoutValue` (число, значение по умолчанию — `20000`): при загрузке страницы, указывает продолжительность времени ожидания в миллисекундах, перед тем как произойдет ошибка ожидания. Этот пример определяет 10 секунд, а не 20:
+
+ <preference name="LoadUrlTimeoutValue" value="10000"/>
+
+* `SplashScreen`(строка, по умолчанию `splash`): Имя файла, минус его расширение в каталоге `res/drawable`. Различные ресурсы должны использовать это общее название в разных подкаталогах.
+
+ <preference name="SplashScreen" value="mySplash"/>
+
+* `SplashScreenDelay` (число, значение по умолчанию `3000`): определяет количество времени в течение которого отображается заставка.
+
+ <preference name="SplashScreenDelay" value="10000"/>
+
+* `InAppBrowserStorageEnabled` (логическое значение, по умолчанию `true`): Контролирует имеют ли страницы открытые в InAppBrowser возможность получить доступ к тому же хранилищу localStorage и WebSQL, что и страницы открытые с помощью браузера по умолчанию.
+
+ <preference name="InAppBrowserStorageEnabled" value="true"/>
+
+* `LoadingDialog` (строка, по умолчанию `null`): Если указано, отображает диалоговое окно с заданным заголовком и сообщение и индикатор загрузки, при загрузке первой странице приложения. Заголовок и сообщение разделяются запятой в этой строке значение, и что запятая удаляется перед отображением диалогового окна.
+
+ <preference name="LoadingDialog" value="My Title,My Message"/>
+
+* `LoadingPageDialog` (строки, по умолчанию `null`): так же, как `LoadingDialog`, но для загрузки каждой страницы следующей за первой страницей в приложении.
+
+ <preference name="LoadingPageDialog" value="My Title,My Message"/>
+
+* `ErrorUrl` (URL-адрес, По умолчанию используется `null`): Если установлено, будет отображаться странице ссылки на ошибку в приложении вместо диалоговое окно с заголовком «Ошибка приложения».
+
+ <preference name="ErrorUrl" value="myErrorPage.html"/>
+
+* `ShowTitle` (логическое значение, по умолчанию `false`): Показать заголовок в верхней части экрана.
+
+ <preference name="ShowTitle" value="true"/>
+
+* `LogLevel` (строка, по умолчанию `ERROR` ): устанавливает минимальный уровень протоколирования, через который будет фильтроваться протоколируемые сообщения из вашего приложения. Допустимыми значениями являются `ERROR`, `WARN`, `INFO`, `DEBUG`, и `VERBOSE`.
+
+ <preference name="LogLevel" value="VERBOSE"/>
+
+* `SetFullscreen` (логическое значение, по умолчанию `false`): то же, что параметр `Fullscreen` в глобальной конфигурации этого XML-файла. Этот элемент специфический для Android элемент считается устаревшим и замененным глобальным элементом `Fullscreen` и будет удален в будущей версии.
+
+* `AndroidLaunchMode`(строки, по умолчанию `singleTop` ): задает действие `android:launchMode` атрибут. Это меняет то, что происходит, когда приложение запускается из приложения значок или намерения и уже работает. Допустимыми значениями являются `standard` , `singleTop` , `singleTask` ,`singleInstance`.
+
+ <preference name="AndroidLaunchMode" value="singleTop"/>
+
+* `DefaultVolumeStream`(строки, по умолчанию `default` , добавил в Кордова android 3.7.0): устанавливает объем которых объем аппаратные кнопки ссылка на. По умолчанию это «вызов» для «СМИ» для планшетов и телефонов. Установите это для «медиа», чтобы иметь всегда изменить громкость медиа кнопки громкости вашего приложения. Обратите внимание, что при использовании плагина Кордова в СМИ, кнопки громкости будет динамически изменить для контроля объема средств массовой информации, когда любые мультимедийные объекты являются активными.
+
+* `OverrideUserAgent` (строка, не определен по умолчанию): Если параметр установлен, значение заменит старое значение UserAgent для webview. Это полезно для идентификации запроса из приложения/браузера при запросе удаленных страниц. Используйте с осторожностью, в мае этого года вызывает проблемы совместимости с веб-серверами. В большинстве случаев вместо этого параметра используйте AppendUserAgent.
+
+ <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
+
+* `AppendUserAgent` (строка, не задан по умолчанию): Если параметр установлен, значение будет добавляться в конец старого значения UserAgent для webview. При использовании с OverrideUserAgent, это значение будет игнорироваться.
+
+ <preference name="OverrideUserAgent" value="My Browser" />
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/index.md b/docs/ru/5.1.1/guide/platforms/android/index.md
new file mode 100644
index 0000000..4b14855
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/index.md
@@ -0,0 +1,269 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Android
+
+В этом руководстве показано, как настроить среду SDK для развертывания приложений Cordova для устройств на базе Android и как при необходимости использовать специфические для Android средства командной строки в вашем рабочем процессе построения приложений. Вам нужно установить Android SDK независимо от того, хотите ли вы использовать эти инструменты или использовать кросс-платформенный Cordova CLI для построения приложения. Для сравнения двух вариантов разработки см. Введение. Дополнительные сведения о CLI, см. "Интерфейс командной строки".
+
+## Требования и поддержка
+
+Cordova для Android необходим Android SDK, который может быть установлен на операционных системах OS X, Linux или Windows. Смотрите [системные требования][1] Android SDK.
+
+ [1]: http://developer.android.com/sdk/index.html#Requirements
+
+Cordova поддерживает Android 4.0.x (начиная с уровня Android API 14) и выше. Как правило версии Android перестают поддерживается Cordova после того как они опустится ниже 5% на [панель распространения][2] Google . Версии Android менее чем API уровня 10, и версии 3.x (Honeycomb, уровни API 11-13) упали значительно ниже этого 5%-го порога.
+
+ [2]: http://developer.android.com/about/dashboards/index.html
+
+## Установка инструментов Cordova
+
+Если вы хотите использовать Android-ориентированные инструменты Cordova совместно с SDK, скачайте Cordova с [cordova.apache.org][3]. В противном случае этот раздел можно проигнорировать, если вы планируете использовать кросс-платформенное средство CLI, описанное в разделе "Интерфейс командной строки".
+
+ [3]: http://cordova.apache.org
+
+Страница для скачивания Cordova содержит различные архивы для каждой платформы. Убедитесь в том распаковываете соответствующий архив, `android` в данном случае, в пустой каталог. Соотвествующие выполняемые утилиты будут доступны в каталоге `bin` верхнего уровня. (Обратитесь при необходимости к **README** файлу за более подробными инструкциями.)
+
+Эти инструменты командной строки позволят вам создавать, собирать и запускать приложения для Android. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Установите Java Development Kit (JDK)
+
+Установить [Java Development Kit (JDK) 7][4] или более поздней версии.
+
+ [4]: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
+
+При установке на Windows, необходимо также задать переменную окружающей среды `JAVA_HOME` в соотвествии с каталогом установки JDK (например, C:\Program Files\Java\jdk1.7.0_75).
+
+## Установить Android SDK
+
+Установите [SDK Android Stand-alone SDK Tools][5] или [Android Studio][6]. Продолжите с `Android Studio` если планируется разработка новых плагинов Cordova для Android или использовать встроенных средств для запуска и отладки на Android платформе. В противном случае `Android Stand-alone SDK Tools` вполне достаточно для построения и развертывания приложения на Android.
+
+ [5]: http://developer.android.com/sdk/installing/index.html?pkg=tools
+ [6]: http://developer.android.com/sdk/installing/index.html?pkg=studio
+
+Подробные инструкции по установке доступны как часть установки.
+
+Чтобы инструменты командной строки Cordova работали, или другое CLI которое основано на них, вам необходимо включить каталоги SDK `tools` и `platform-tools` в вашу переменную окружения `PATH`. На Mac, вы можете использовать текстовый редактор для создания или изменения файла `~/.bash_profile`, добавив линию, наподобие нижеуказанной, в зависимости от того где установлен SDK:
+
+ export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools
+
+
+Эта строка в `~/.bash_profile` добавляет эти инструменты во вновь открытых окнах терминала. Если ваше окно терминала уже открыт в OSX, или чтобы избежать процедуры выхода/входа на Linux, выполните ниже указанную команду, чтобы сделать эти инструменты доступными в текущем окне терминала:
+
+ $ источника ~/.bash_profile
+
+
+Чтобы изменить переменную окружения `PATH` на Windows 7:
+
+1. Нажмите на меню " **Пуск** " в левом нижнем углу рабочего стола, щелкните правой кнопкой мыши на **Мой комьютер**, а затем нажмите кнопку **Свойства**.
+
+2. Нажмите кнопку **Дополнительные параметры системы** в столбце слева.
+
+3. В открывшемся диалоговом нажмите **Переменные среды**.
+
+4. Выберите переменную **PATH** и нажмите **редактировать**.
+
+5. Добавьте следующее в `PATH`, в зависимости от того куда был установлен пакет SDK, например:
+
+ ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools
+
+6. Сохраните значение и закройте оба диалоговые окна.
+
+## Установить пакеты SDK
+
+Откройте Android SDK Manager (например, через терминал: `android`) и установить:
+
+1. Android 5.1.1 (API 22) platform SDK
+2. Android SDK Build-tools version 19.1.0 или выше
+3. Android Support Repository (Extras)
+
+Смотрите [Установка пакетов SDK][7] для получения более подробной информации.
+
+ [7]: http://developer.android.com/sdk/installing/adding-packages.html
+
+## Настройка эмулятора
+
+По умолчанию Android sdk не предоставляет никаких эмуляторов. Вы можете создать новый, запустив `android` в командной строке. Выбрать **Tools → Manage AVDs** (Android Virtual Devices), затем выберите любой элемент из **Device Definitions** в появившемся диалоговом окне:
+
+![][8]
+
+ [8]: img/guide/platforms/android/asdk_device.png
+
+Нажмите **Create AVD**, при необходимости изменяя имя, затем нажмите **ОК**, чтобы принять изменения:
+
+![][9]
+
+ [9]: img/guide/platforms/android/asdk_newAVD.png
+
+После этого AVD появляется в списке **Android Virtual Devices**:
+
+![][10]
+
+ [10]: img/guide/platforms/android/asdk_avds.png
+
+Чтобы открыть эмулятор как отдельное приложение, выберите AVD и нажать кнопку **Start**. Android запускается, также как он запускается на устройстве, с дополнительные элементы управления, доступными для аппаратных кнопок:
+
+![][11]
+
+ [11]: img/guide/platforms/android/asdk_emulator.png
+
+Для более быстрый восприятия можно использовать `Ускорение виртуальной машины` для повышения скорости выполнения. Многие современные процессоры предоставляют расширения для выполнения виртуальных машин более эффективно. Прежде чем пытаться использовать этот тип ускорения, необходимо определить, поддерживает ли процессор вашей текущей системы развития, одну из следующих технологий виртуализации:
+
+* **Технология Виртуализации Intel** (VT-x, vmx) → [Список процессоров поддерживающих Intel VT-x][12]
+* **Виртуализация AMD** (AMD-V, SVM), поддерживается только Linux (начиная с May 2006, все процессоры AMD включают AMD-V, за исключением Sempron).
+
+ [12]: http://ark.intel.com/products/virtualizationtechnology
+
+Еще один способ узнать, если ваш процессор поддерживает технологию VT-x, это путем выполнения `Утилита идентификации процессора Intel`, для `Windows` вы можете скачать ее с сайта [Центр загрузки Intel ][13], или можно использовать [утилиту booteable][14], который является `ОС-независимой`.
+
+ [13]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838
+ [14]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng
+
+После установки и выполнения `Утилита идентификации процессора Intel` в Windows, вы получите следующее окно, чтобы проверить, поддерживает ли ваш процессор технологии виртуализации:
+
+![][15]
+
+ [15]: img/guide/platforms/android/intel_pid_util_620px.png
+
+Для того, чтобы ускорить эмулятор, вам нужно скачать и установить один или несколько образов системы `Intel x86 Atom`, а также `Менеджер выполнения аппаратного ускорения Intel (HAXM)`.
+
+Откройте ваш Android SDK Manager и выберите образ системы `Intel x86 Atom`, для той версии, которую вы хотите проверить. Затем перейдите в раздел `Extras` и выберите `Intel x86 Emulator Accelerator (HAXM)` и установить эти пакеты:
+
+![][16]
+
+ [16]: img/guide/platforms/android/asdk_man_intel_image_haxm.png
+
+После загрузки, запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`. **Примечание**: `Если у вас есть проблемы с установкой пакета, вы можете найти более подробную информацию и пошаговое руководство в этой` [статье Intel][17].
+
+ [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture
+
+1. Установить одно или несколько образов системы `Intel x86 Atom`, а также `Intel Hardware Accelerated Execution Manager`, доступных в разделе **Extras**.
+
+2. Запустите инсталлятор Intel, который доступен в вашем Android SDK в каталоге `extras/intel/Hardware_Accelerated_Execution_Manager`.
+
+3. Создайте новый AVD с выбрав в качестве цели образ Intel.
+
+4. При запуске эмулятора, удостоверьтесь что нет сообщений об ошибке, указывающих на сбой загрузки модулей HAX.
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор Android-ориентированных инструментов. Из каталога с исходным кодом, вот подход CLI:
+
+ $ cordova create hello com.example.hello HelloWorld
+ $ cd hello
+ $ cordova platform add android
+ $ ccordova prepare # or "cordova build"
+
+
+Вот соотвествующий низкоуровневый подход для Unix и Windows:
+
+ $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
+ C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ $ cordova build # build all platforms that were added
+ $ cordova build android # build debug for only Android
+ $ cordova build android --debug # build debug for only Android
+ $ cordova build android --release # build release for only Android
+
+
+Если вы используете Android-ориентированные инструментыв разработке, используйте другой подход. После того как вы создали проект, исходный код приложения по умолчанию доступен в подкаталоге `assets/www`. Последующие команды доступны в подкаталоге `cordova` проекта.
+
+Команда `build` очищает файлы проекта и перестраивает приложение. Вот синтаксис для Mac и Windows. Первая пара примеров создает отладочную информацию, и второй подписывает приложения для релиза:
+
+ $ /path/to/project/cordova/build --debug
+ C:\path\to\project\cordova\build.bat --debug
+
+ $ /path/to/project/cordova/build --release
+ C:\path\to\project\cordova\build.bat --release
+
+
+## Развертывание приложения
+
+Чтобы развернуть приложение на эмуляторе или устройстве из командной строки можно использовать утилиту CLI `cordova` :
+
+ $ cordova emulate android #to deploy the app on a default android emulator
+ $ cordova run android --device #to deploy the app on a connected device
+
+В противном случае используйте интерфейс альтернативной оболочки:
+
+ $ /path/to/project/cordova/run --emulator
+ $ /path/to/project/cordova/run --device
+
+
+Можно использовать **cordova run android --list** чтобы увидеть все доступные цели и **cordova run android --target=имя_устройства** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+Эта команда установаливает приложение на главной странице и запускает его:
+
+![][18]
+
+ [18]: img/guide/platforms/android/emulator2x.png
+
+Когда вы запускаете приложение с помощью `run`, вы также собираете его с помощью `build` автоматически. Вы можете добавить дополнительные флаги `--debug`, `--release`, и `--nobuild` для управления как приложение будет построен, или даже когда перепостроение необходимо:
+
+ $ /path/to/project/cordova/run --emulator --nobuild
+
+
+## Другие команды
+
+Следующие команды задают детальное протоколирование приложения, во время его работы:
+
+ $ /path/to/project/cordova/log
+ C:\path\to\project\cordova\log.bat
+
+Следующие команды очищают файлы проекта:
+
+ $ /path/to/project/cordova/clean
+ C:\path\to\project\cordova\clean.bat
+
+
+## Откройте новый проект в SDK
+
+После того, как платформа android добавлена в ваш проект, вы можете открыть проект в [Android Studio][6]:
+
+1. Запустите приложение **Android Studio** .
+
+2. Выберите пункт **Import Project (Eclipse ADT, Gradle, etc)**.
+
+ ![][19]
+
+3. Выберите местоположение, где платформа android сохраняется (`ваш/каталог/проекта/platforms/android`).
+
+ ![][20]
+
+4. Для вопроса `Gradle Sync` можно просто ответить **Yes**.
+
+ [19]: img/guide/platforms/android/asdk_import_project.png
+ [20]: img/guide/platforms/android/asdk_import_select_location.png
+
+Все готово теперь и можно построить и запустить приложение непосредственно из `Android студии`.
+
+![][21]
+
+ [21]: img/guide/platforms/android/asdk_import_done.png
+
+Смотрите [Введение в Android Studio][22] и [Построение и запуск из Android студии][23] для более подробной информации.
+
+ [22]: http://developer.android.com/tools/studio/index.html
+ [23]: http://developer.android.com/tools/building/building-studio.html
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/plugin.md b/docs/ru/5.1.1/guide/platforms/android/plugin.md
new file mode 100644
index 0000000..d68018d
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/plugin.md
@@ -0,0 +1,179 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины для Android
+
+Этот раздел содержит сведения о том, как реализовать плагин в коде на платформе Android. Прежде чем читать этот раздел, изучите раздел "Расширения приложения" для обзора структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать пример *echo* плагина, который соообщается из WebView Cordova с кодом платформы и в обратную строну. Еще один пример см. также комментарии в файле [CordovaPlugin.java][1].
+
+ [1]: https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java
+
+Android плагины основаны на проекте Cordova-Android, который состоит из Android WebView с хуками, прилагаемыми к нему. Плагины представляются как сопоставления классов в файле `config.xml`. Модуль состоит из по крайней мере из одного Java-класса, который расширяет класс `CordovaPlugin`, и переопределяющий один из его методов - `execute`. Как лучшая практика, плагин также должен обрабатывать `pause` и `resume` события, наряду с любой передачи сообщений между плагинами. Плагины с длительные запросы, фоновой активностью такие как воспроизведение мультимедиа, слушатели или внутреннее состояние следует также реализовать метод `onReset()`. Он выполняется, когда `WebView` переходит на новую страницу или обновляется, что приводит к перезагрузке JavaScript.
+
+## Сопоставление классов плагина
+
+Интерфейс JavaScript плагин использует метод `cordova.exec` следующим образом:
+
+ Exec (< successFunction >, < failFunction >, < служба >, < действия > [< args >]);
+
+
+Это маршалирует запрос от WebView к коду Android, вызывая метод `action` класса `service`, с дополнительными аргументами, передаваемые в массиве `args`.
+
+Распространяете ли вы плагин как Java-файл или файл *jar*, плагин должен быть указан в вашем файле `res/xml/config.xml` Cordova-Android приложения. См. "Расширения приложения" для получения дополнительной информации о том, как использовать файл `plugin.xml` для вставки следующего элемента `feature`:
+
+ <feature name="<service_name>">
+ <param name="android-package" value="<full_name_including_namespace>" />
+ </feature>
+
+
+Имя службы должен соответствовать той службе, которая используется в JavaScript вызове `exec`. Значение является идентификатором класса Java включая полное пространство имен. В противном случае плагин может компилировать, но по-прежнему будет недоступным для Cordova.
+
+## Инициализация плагин его жизненный цикл
+
+Один экземпляр объекта плагин создается для каждого `WebView` . Плагины не создаются до тех пор, пока они первый раз не ссылается из JavaScript вызова, за исключением если `<param>` с атрибутом с атрибутом `name` тега `onload` имеющим значение `"true"` в `config.xml` . Например:
+
+ <feature name="Echo">
+ <param name="android-package" value="<full_name_including_namespace>" />
+ <param name="onload" value="true" />
+ </feature>
+
+
+Следует использовать метод плагина `initialize` для логики инициализации плагина.
+
+ @Override
+ public void initialize(CordovaInterface cordova, CordovaWebView webView) {
+ super.initialize(cordova, webView);
+ // your init code here
+ }
+
+
+## Написание Java плагин Android
+
+Вызов из JavaScript выполняет запрос к стороне платформы, и соответствующий Java плагин привязан корректно в файле `config.xml`, но как выглядит окончательный Java-класс плагина для Android? Все, что отправляется в плагин с JavaScript функцией `exec` передается в метод класса `execute`. Большинство реализаций `execute` выглядят следующим образом:
+
+ @Override общественного boolean выполнение (строка действия, JSONArray args, CallbackContext callbackContext) бросает JSONException {если («beep".equals(action)) {this.beep(args.getLong(0));
+ callbackContext.success();
+ Возвращает значение true;
+ } Возвращает значение false; / / Возвращения ложные результаты в сообщение об ошибке «MethodNotFound».
+ }
+
+
+Параметр `action` функции JavaScript `exec` соответствует закрытому методу класса куда диспетчиризуются необязательные параметры.
+
+При перехвате исключений и возвращении ошибки, важно для ясности, чтобы ошибки возвращены в JavaScript соотвествовали именам исключений Java как можно больше.
+
+## Работа с потоками
+
+JavaScript плагине *не* выполняются в основном потоке интерфейса `WebView`, вместо этого, он работает в потоке `WebCore`, как это делает метод `execute`. Если вам нужно взаимодействовать с интерфейсом пользователя, следует использовать следующие изменения:
+
+ @Override
+ public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+ if ("beep".equals(action)) {
+ final long duration = args.getLong(0);
+ cordova.getActivity().runOnUiThread(new Runnable() {
+ public void run() {
+ ...
+ callbackContext.success(); // Thread-safe.
+ }
+ });
+ return true;
+ }
+ return false;
+ }
+
+
+Используйте следующее, если вам не нужно запускать в главном потоке интерфейсе, но не хотите также блокировать поток `WebCore`:
+
+ @Override
+ public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+ if ("beep".equals(action)) {
+ final long duration = args.getLong(0);
+ cordova.getThreadPool().execute(new Runnable() {
+ public void run() {
+ ...
+ callbackContext.success(); // Thread-safe.
+ }
+ });
+ return true;
+ }
+ return false;
+ }
+
+
+## Пример плагина Echo Android
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="android">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
+ </feature>
+ </config-file>
+ </platform>
+
+
+Затем добавить следующий файл `src/org/apache/cordova/plugin/Echo.java`:
+
+ package org.apache.cordova.plugin;
+
+ import org.apache.cordova.CordovaPlugin;
+ import org.apache.cordova.CallbackContext;
+
+ import org.json.JSONArray;
+ import org.json.JSONException;
+ import org.json.JSONObject;
+
+ /**
+ * This class echoes a string called from JavaScript.
+ */
+ public class Echo extends CordovaPlugin {
+
+ @Override
+ public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+ if (action.equals("echo")) {
+ String message = args.getString(0);
+ this.echo(message, callbackContext);
+ return true;
+ }
+ return false;
+ }
+
+ private void echo(String message, CallbackContext callbackContext) {
+ if (message != null && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+ }
+
+
+Необходимые импорты в верхней части файла наследуют класс от `CordovaPlugin`, чей метод `execute()` переопределяется для получения сообщений от `exec()` . Метод `execute()` сначала проверяет значение `action` , для которого в этом случае есть только одно действительное значение - `echo`. Любое другое значение параметра action возвращает `false` и приводит к ошибке `INVALID_ACTION`, которая передается интерфейсу обратного вызова об ошибке на стороне JavaScript.
+
+Далее, этот метод извлекает эхо-строку, используя метод `getString` объекта `args`, определяя первый параметр передаваемый методу. После того, как значение передается в закрытый метод `echo`, это параметр проверяется, чтобы убедиться, что это не `null` и не является пустой строкой, в этом случае `callbackContext.error()` вызывает ошибку на стороне JavaScript. Если различные проверки проходят успешно, `callbackContext.success()` передает исходное значение строки `message` обратно в JavaScript в качестве параметре функции успешного вызова.
+
+## Интеграция с Android
+
+Android предоставляет систему `Intent`, которая позволяет процессам взаимодействовать друг с другом. Плагины имеют доступ к объекту `CordovaInterface`, который можно получить доступ к Android `Activity` которая запустила приложение. Это `Context` необходимые для запуска нового `Intent` Android. `CordovaInterface` позволяет плагинам запускать `Activity` для получения результата и установить функцию обратного вызова которая выполнится когда `Intent` вернутся приложению.
+
+По состоянию на Cordova 2.0, плагины больше не имеют прямого доступа к `Context` и член класса `ctx` член является устаревшим. Все `ctx` методы существуют в `Context` , так что оба `getContext()` и `getActivity()` могут возвращать требуемый объект.
+
+## Отладка Android плагинов
+
+Eclipse позволяет отлаживать плагины как исходный код Java, включенный в проект. Только последняя версия Android Developer Tools позволяет вам прикрепить исходный код к *JAR* зависимостям, так что эта функция пока не поддерживается полностью.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/tools.md b/docs/ru/5.1.1/guide/platforms/android/tools.md
new file mode 100644
index 0000000..fb28e01
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/tools.md
@@ -0,0 +1,201 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по инструментам командной строки Android
+
+В этом руководстве показано, как использовать набор платформо-ориентированных инструментов Cordova для разработки приложений на Android. Этот путь разработки, описанный в разделе "Введение", может предложить вам больший спектр вариантов разработки чем кросс платформенный инструмент CLI, описанные в разделе "Интерфейс командной строки". Например вам нужно использовать инструменты командной строки при развертывании настраиваемого Cordova WebView наряду с собственными компонентами. Перед использованием любой путь разработки, сначала необходимо настроить среду Android SDK, как описано в разделе "Руководство для платформы Android".
+
+Чтобы включить инструменты оболочки для Android, скачайте Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните каждый, для которого вы хотите разрабатывать который, `android` в данном случае. Соответствующие инструменты обычно доступны в папке верхнего уровня `bin`, в противном случае проконсультируйтесь в файле **README** для более подробные инструкции.
+
+ [1]: http://cordova.apache.org
+
+Эти инструменты командной строки позволят вам создавать, собирать и запускать приложения для Android. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями".Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Создание проекта
+
+Запуск `create` команду, указав существующий путь к проекту, реверс домен стиль пакета идентификатор и отображаемое имя приложения. Вот синтаксис для Mac/Linux и Windows:
+
+ $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+
+ C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName
+
+
+## Сборка
+
+Это удаляет, затем выполняет построение проекта.
+
+Отладка, на Windows или Mac/Linux:
+
+ $ /path/to/project/cordova/build --debug
+
+ C:\>\path\to\project\cordova\build.bat --debug
+
+
+Релиз, на Windows или Mac/Linux:
+
+ $ /path/to/project/cordova/build --release
+
+ C:\>\path\to\project\cordova\build.bat --release
+
+
+## Запуск приложения
+
+Команда `run` принимает следующие *необязательные* параметры:
+
+* Целевая спецификация. Это включает в себя `--emulator` , `--device`, или`--target=<targetID>`.
+
+* Спецификация сборки. Это включает в себя `--debug` , `--release` , или`--nobuild`.
+
+ $ /path/to/project/cordova/run [Target] [Build]
+
+ C:\>\path\to\project\cordova\run.bat [Target] [Build]
+
+
+Убедитесь, что вы создали по крайней мере одно виртуальное устройство Android, в противном случае вам будет предложено сделать это с помощью команды `android`. Если несколько AVD доступны как цель, вам будет предложено выбрать одно из них. По умолчанию команда `run` определяет подключенное устройство, или в настоящее время работающий эмулятор, если устройство не найдено.
+
+## Подпись приложения
+
+Вы можете просмотреть требования для подписанния Android приложений: http://developer.android.com/tools/publishing/app-signing.html
+
+Чтобы подписать приложение, необходимо следующие параметры:
+
+* Keystore (`--keystore`): путь к двоичному файлу, который может содержать набор ключей.
+
+* Keystore password (`--storePassword`): пароль для хранилища ключей
+
+* Alias (`--alias`): id определеяющий закрытый ключ, используемый для подписания.
+
+* Password (`--password`): пароль для указанного закрытого ключа.
+
+* Type of the keystore (`--keystoreType`): pkcs12, jks (по умолчанию: автоматическое определение на основе расширения файла)
+
+Эти параметры могут быть заданы с помощью аргументов командной строки выше для скриптов `build` или `run`.
+
+Кроме того их можно указать в файле конфигурации сборки (build.json) с помощью аргумента (`--buildConfig`). Ниже приведен пример файла конфигурации построения:
+
+ {
+ "android": {
+ "debug": {
+ "keystore": "..\android.keystore",
+ "storePassword": "android",
+ "alias": "mykey1",
+ "password" : "password",
+ "keystoreType": ""
+ },
+ "release": {
+ "keystore": "..\android.keystore",
+ "storePassword": "",
+ "alias": "mykey2",
+ "password" : "password",
+ "keystoreType": ""
+ }
+ }
+ }
+
+
+Для подписи релизной версии, пароли могут быть исключены и система построения будет выдавать запрос на пароль.
+
+Существует также поддержка смешивать аргументы командной строки и параметры в файле build.json. Приоритет будут получать значения из аргументов командной строки. Это может быть полезно для задания паролей в командной строке.
+
+## Ведение журнала
+
+ $ /path/to/project/cordova/log
+
+ C:\>\path\to\project\cordova\log.bat
+
+
+## Очистка
+
+ $ /path/to/project/cordova/clean
+
+ C:\>\path\to\project\cordova\clean.bat
+
+
+## Сборка с Gradle
+
+Начиная с cordova-android@4.0.0, сборка проекта использует [Gradle][2]. Для инструкций по построению с помощью ANT, используйте более старую версию документации.
+
+ [2]: http://www.gradle.org/
+
+### Свойства Gradle
+
+Эти [свойства][3] могут быть установлены для настройки процесса сборки:
+
+ [3]: http://www.gradle.org/docs/current/userguide/tutorial_this_and_that.html
+
+* **cdvBuildMultipleApks** (по умолчанию: false)
+
+ Если этот параметр установлен, то будут создаваться несколько APK файлов: один для каждой платформы, поддерживаемой библиотеками проектов (x86, ARM, и т.д.). Это может быть важно, если ваш проект использует большие бинарные библиотеки, которые могут резко увеличить размер создаваемого APK.
+
+ Если не задано, то будет создаваться один APK, который может использоваться на всех устройствах.
+
+* **cdvVersionCode**
+
+ Переопределяет versionCode установленный в `AndroidManifest.xml`
+
+* **cdvReleaseSigningPropertiesFile** (по умолчанию: release-signing.properties)
+
+ Путь к файлу .properties, содержащую информацию о подписях для релизных сборок. Этот файл должен выглядеть:
+
+ storeFile=relative/path/to/keystore.p12
+ storePassword=SECRET1
+ storeType=pkcs12
+ keyAlias=DebugSigningKey
+ keyPassword=SECRET2
+
+ `storePassword` и `keyPassword` являются необязательными и будет запрашиваться, если пропущены.
+
+* **cdvDebugSigningPropertiesFile** (по умолчанию: debug-signing.properties)
+
+ Так же, как cdvReleaseSigningPropertiesFile, но для отладочного построения. Полезно, когда вам нужно использовать ключ подписи совместно с другими разработчиками.
+
+* **cdvMinSdkVersion**
+
+ Переопределяет значение `minSdkVersion` в `AndroidManifest.xml`. Полезно при создании нескольких APK на основе версии SDK.
+
+* **cdvBuildToolsVersion**
+
+ Переопределяет автоматически обнаруженное значение `android.buildToolsVersion` .
+
+* **cdvCompileSdkVersion**
+
+ Переопределяет автоматически обнаруженное значение `android.compileSdkVersion` .
+
+### Расширение build.gradle
+
+Если вам нужно настроить `build.gradle`, вместо того, чтобы редактировать его напрямую, следует создать одноуровневый файл с именем `build-extras.gradle`. Этот файл будет включен основным `build.gradle` если он существует. Вот пример:
+
+ # Example build-extras.gradle
+ # This file is included at the beginning of `build.gradle`
+ ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties'
+ # When set, this function allows code to run at the end of `build.gradle`
+ ext.postBuildExtras = {
+ android.buildTypes.debug.applicationIdSuffix = '.debug'
+ }
+
+
+Обратите внимание, что плагины могут также включать файлы `build-extras.gradle` через:
+
+ <framework src="some.gradle" custom="true" type="gradleReference" />
+
+
+### Пример сборки
+
+ export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
+ cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/upgrade.md b/docs/ru/5.1.1/guide/platforms/android/upgrade.md
new file mode 100644
index 0000000..ab022cb
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/upgrade.md
@@ -0,0 +1,498 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление для Android
+
+В этом руководстве показано, как изменить Android проекты при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление до 4.0.0
+
+Это конкретные шаги обновления которые необходимо выполнить чтобы использовать существенные изменения в 4.0.0. Во-первых необходимы общие шаги обновления, как показано ниже.
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update android` в ваших проектах.
+
+### Обновление списка разрешенных ресурсов
+
+Теперь вся функциональность списка разрешенных ресурсов реализована через плагин. Без плагина ваше приложение более не защищен списком разрешенных ресурсов после обновления до 4.0.0. Cordova имеет два плагина для списка разрешенных ресурсов, которые обеспечивают различные уровни защиты.
+
+1. Плагин `cordova-plugin-whitelist` *(рекомендуемый)*
+
+ * Настоятельно рекомендуется этот плагин, так как лг более безопасный и более настраиваемый, чем список разрешенных ресурсов в предыдущих версиях
+ * Смотрите [cordova-plugin-whitelist][1] для подробностей по необходимым изменения конфигурации
+ * Run: `cordova plugin add cordova-plugin-crosswalk-webview`
+
+2. Плагин `cordova-plugin-legacy-whitelist`
+
+ * Этот плагин обеспечивает такое же поведение списка разрешенных ресурсов, как и предыдущие версии. Смотрите [cordova-plugin-legacy-whitelist][2]
+ * Изменения конфигурации не требуются, но она обеспечивает меньшую защиту, чем рекомендованный плагин
+ * Run: `cordova plugin add cordova-plugin-legacy-whitelist`
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+ [2]: https://github.com/apache/cordova-plugin-legacy-whitelist
+
+### Использование Crosswalk WebView
+
+По умолчанию ваше приложение будет продолжать использовать системный WebView, предоставляемый устройством. Если вы хотите вместо этого использовать WebView CrossWalk, просто добавьте плагин CrossWalk:
+
+ cordova plugin add cordova-plugin-crosswalk-webview
+
+
+После добавления плагина, ваше приложение получит WebView Crosswalk установленным и правильно настроеным.
+
+### Плагин SplashScreen - Обновление
+
+Если ваше приложение использовала экрана-заставку, то эта функциональность была перемещена в плагин. Параметры конфигурации для экрана-заставки остались неизменными. Единственный требуемый шаг для обновления это добавление плагина:
+
+ cordova plugin add cordova-plugin-splashscreen
+
+
+## Обновление до 3.7.1 с 3.6.0
+
+Для проектов-CLI выполните:
+
+ bin/обновить путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update android` в ваших проектах.
+
+## Обновление до 3.3.0 с 3.2.0
+
+Следуйте тем же инструкциям что и для `3.2.0`.
+
+Начиная с 3.3.0, среда выполнения Cordova теперь компилируется как Android библиотека вместо Jar. Это не должно иметь никакого эффекта при использовании из командной строки, но пользователям IDE нужно будет импортировать новые проекты `MyProject-CordovaLib` в их рабочее пространство.
+
+## Обновление до 3.2.0 с 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Run `cordova platform update android`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+**Предупреждение:** На Android 4.4 - Android 4.4.3, создание элемента ввода input type="file" не открывает диалоговое окно выбора файла. Это регрессия из Chromium на Android, и проблемы могут быть воспроизведены в автономном браузер Chrome на Android (см. http://code.google.com/p/android/issues/detail?id=62220) предложенное решение заключается в использовании плагинов FileTransfer и File для Android 4.4. Можно прослушивать событие onClick для input type="file" и затем показывать пользовательский интерфейс средства выбора файлов. Для того, чтобы связать данные формы с загрузки, можно использовать JavaScript для присоединения значений формы к составному запросу POST, что делает FileTransfer.
+
+## Обновление до 3.1.0 с 3.0.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Run `cordova platform update android`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваши платформы в проект Cordova, например: `cordova
+platform add ios`.
+
+3. Скопируйте содержимое каталога `www` в каталог `www` проекта Cordova который вы только что создали.
+
+4. Скопируйте любые платформенные ресурсы из старого проекта в соответствующие каталоги в `platforms/android`: это директория где расположен проект cordova-android.
+
+5. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+## Обновление до 3.0.0 с 2.9.0
+
+1. Создайте новый проект Apache Cordova Android.
+
+2. Скопируйте содержимое каталога `www` в новый проект.
+
+3. Скопируйте любые ресурсы платформы Android из каталога `res` в новый проект.
+
+4. Скопируйте любые плагины, которые вы установили из подкаталогов `src` в новый проект.
+
+5. Убедитесь что вы обновили любые устаревшие ссылки `<plugin>` из вашего старого файла `config.xml` в новое определение в `<feature>`.
+
+6. Обновите ссылки с пакета `org.apache.cordova.api` на `org.apache.cordova`.
+
+ **Примечание**: все основные API были удалены и должны быть установлены как плагины. Для подробной информации смотрите раздел "Использование Plugman для управления расширениями".
+
+## Обновление до 2.9.0 с 2.8.0
+
+1. Run `bin/update <project_path>`.
+
+## Обновление до 2.8.0 с 2.7.0
+
+1. Удалить `cordova-2.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+<!-- SS Eclipse -->
+
+1. Скопируйте новый `cordova.js` в ваш проект.
+
+2. Обновите ваш HTML, чтобы использовать новый `cordova.js` файл.
+
+3. Скопируйте `res/xml/config.xml` файл в соответствии с `framework/res/xml/config.xml`.
+
+4. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+5. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.7.0 с 2.6.0
+
+1. Удалить `cordova-2.6.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.7.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.7.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-2.7.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+1. Удалить `cordova-2.5.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.6.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+Запустите `bin/update <project>` из пути проекта, перечисленным в исходном каталоге Cordova.
+
+## Обновление до 2.5.0 с 2.4.0
+
+1. Удалить `cordova-2.4.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.5.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Обновите `framework/res/xml/config.xml` чтобы иметь одинаковые параметры, как это было ранее.
+
+8. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.4.0 от 2.3.0
+
+1. Удалить `cordova-2.3.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.4.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+1. Удалить `cordova-2.2.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.3.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+1. Удалить `cordova-2.1.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.2.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+1. Удалить `cordova-2.0.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.1.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+7. Скопируйте файлы из `bin/templates/cordova` в каталог проекта `cordova`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+1. Удалить `cordova-1.9.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-2.0.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Копия `res/xml/config.xml` соответствовать`framework/res/xml/config.xml`.
+
+В релизе 2.0.0, файл `config.xml` сочетает в себе и заменяет `cordova.xml` и `plugins.xml`. Старые файлы являются устаревшими и хотя они по-прежнему работают в 2.0.0, перестанут работать в будущих выпусках.
+
+## Обновление с 1.8.1 до 1.9.0
+
+1. Удалить `cordova-1.8.1.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.9.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.9.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-1.9.0.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+Из-за введения `CordovaWebView` в релизе 1.9.0, плагины третьих лиц могут не работать. Эти плагины должны получать контекст из `CordovaInterface` с помощью `getContext()` или `getActivity()`. Если вы не являетесь опытным разработчиком Android, пожалуйста, свяжитесь с сопровождающим плагин лицом и добавьте эту задачу в их баг трекер.
+
+## Обновление с 1.8.0 до 1.8.1
+
+1. Удалить `cordova-1.8.1.jar` из проекта `libs` каталог.
+
+2. Добавить `cordova-1.8.1.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.8.1.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-1.8.1.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление до 1.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление до 1.8.0 от 1.7.0
+
+1. Удалить `cordova-1.7.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.8.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление с 1.6.1 до 1.7.0
+
+1. Удалить `cordova-1.6.1.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.7.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.7.0.js` в ваш проект.
+
+5. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление с 1.6.0 до 1.6.1
+
+1. Удалить `cordova-1.6.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.6.1.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.6.1.js` в ваш проект.
+
+5. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление с 1.5.0 до 1.6.0
+
+1. Удалить `cordova-1.5.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.6.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.6.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-1.6.0.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Замените `res/xml/phonegap.xml` на `res/xml/cordova.xml` для соотвествия файлу `framework/res/xml/cordova.xml`.
+
+## Обновление с 1.4.0 до 1.5.0
+
+1. Удалить `phonegap-1.4.0.jar` из каталога проекта `libs`.
+
+2. Добавить `cordova-1.5.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `cordova-1.5.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый `cordova-1.5.0.js` файл.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Замените `res/xml/phonegap.xml` на `res/xml/cordova.xml` для соотвествия файлу `framework/res/xml/cordova.xml`.
+
+## Обновление с 1.3.0 до 1.4.0
+
+1. Удалить `phonegap-1.3.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.4.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.4.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.4.0.js` .
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Обновление `res/xml/phonegap.xml` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление с 1.2.0 до 1.3.0
+
+1. Удалить `phonegap-1.2.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.3.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.3.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.2.0.js`.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Обновление `res/xml/phonegap.xml` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление до 1.2.0 с 1.1.0
+
+1. Удалить `phonegap-1.1.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.2.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.2.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.2.0.js`.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+7. Обновление `res/xml/phonegap.xml` в соответствии c `framework/res/xml/phonegap.xml`.
+
+## Обновление до 1.1.0 с 1.0.0
+
+1. Удалить `phonegap-1.0.0.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.1.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.1.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.1.0.js`.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
+
+## Обновление до 1.0.0 с 0.9.6
+
+1. Удалить `phonegap-0.9.6.jar` из каталога проекта `libs`.
+
+2. Добавить `phonegap-1.0.0.jar` в каталог проекта `libs`.
+
+3. Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
+
+4. Скопируйте новый `phonegap-1.0.0.js` в ваш проект.
+
+5. Обновите ваш HTML, чтобы использовать новый файл `phonegap-1.0.0.js`.
+
+6. Обновите `res/xml/plugins.xml` в соответствии с `framework/res/xml/plugins.xml`.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/android/webview.md b/docs/ru/5.1.1/guide/platforms/android/webview.md
new file mode 100644
index 0000000..92bccbf
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/android/webview.md
@@ -0,0 +1,109 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# WebViews в Android
+
+В этом руководстве показано, как встраивать компонент Cordova WebView в рамках более крупных приложений Android. Дополнительные сведения о том, как эти компоненты могут взаимодействовать друг с другом смотрите раздел "Расширения приложения".
+
+Если вы не знакомы с Android, следует сначала ознакомиться с "Руководство для платформы Android" и установить последнюю версию Android перед тем как пробовать делать не обычное встраивание WebView в ваше приложение. Начиная с Cordova 1.9, платформа Android опирается на компонент `CordovaWebView`, который построен на устаревшем компоненте `CordovaActivity`, который был до версии 1.9.
+
+1. Следуя этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачайте его с [cordova.apache.org][1] и распакуйте пакет для Android.
+
+2. Перейдите в каталог `/framework` пакета Android и запустить `ant jar` . Это создаёт `.jar` файл Cordova, вида `/framework/cordova-x.x.x.jar`.
+
+3. Скопируйте файл `.jar` в каталог `/libs` Android-проекта.
+
+4. Добавьте в приложение следующий файл `/res/xml/main.xml`, с `layout_height`, `layout_width` и `id` модицифированными в соответствии с нуждами приложения:
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+5. Измените вашу деятельность так, чтобы этот класс реализовал `CordovaInterface`. Вы должны реализовать описанные методы этого интерфейса. Вы можете скопировать их из `/framework/src/org/apache/cordova/CordovaActivity.java`, или реализовать их самостоятельно. В следующем фрагменте кода показано простое приложение, которое опирается на интерфейс. Обратите внимание, что id упоминаемого окна соответствует `id` атрибут, указанный в XML-фрагменте показаном выше:
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+6. Если приложение должно использовать камеру, реализуйте следующее:
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+7. Наконец, не забудьте добавить пул потоков, иначе у плагинов не будет потоков, на которых они будет выполняться:
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+8. Скопируйте файлы HTML и JavaScript приложения в каталог `/assets/www` проекта Android.
+
+9. Скопируйте `config.xml` файл из `/framework/res/xml` в каталог `/res/xml` проекта.
+
+ [1]: http://cordova.apache.org
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry/upgrade.md b/docs/ru/5.1.1/guide/platforms/blackberry/upgrade.md
new file mode 100644
index 0000000..a8dc9d6
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry/upgrade.md
@@ -0,0 +1,425 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление BlackBerry
+
+В этом руководстве показано, как изменить проекты BlackBerry при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+BlackBerry 10:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+### BlackBerryOS/Playbook
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+BlackBerry 10:
+
+BlackBerry 10 использует новый инструмент CLI и управляет основными API как плагинами. Инструкции по миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что cordova js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление каталога `example/` или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление до 2.4.0 от 2.3.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.4.0.js`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.3.0.js`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только каталог www:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.2.0.js`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.1.0.js`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.0.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+* Чтобы обновить до 1.8.0, перейдите от 1.7.0
+
+## Обновление до 1.8.0 от 1.7.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+Обновление каталога sample (т.е., обновления с использованием инструментов ant):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-1.8.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry10/config.md b/docs/ru/5.1.1/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..e980596
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry10/config.md
@@ -0,0 +1,36 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Конфигурация BlackBerry 10
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к BlackBerry 10. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `ChildBrowser` (`disable` или значение по умолчанию `enable` ): отключает дочерние окна браузера. По умолчанию приложения запускает окно вторичного браузера для отображения ресурсов, через `window.open()` или указав `_blank` в качестве целевого объекта привязки. Укажите `disable` чтобы переопределить это поведение по умолчанию.
+
+ <preference name="ChildBrowser" value="disable"/>
+
+* `PopupBlocker` (`enable` или значение по умолчанию `disable` ): Включает блокировщик всплывающих окон, который предотвращает вызовы `window.open()` . По умолчанию всплывающие окна отображаются во второстепенном окне браузера. Установка предпочтение `enable` предотвращает отображение на всех.
+
+ <preference name="PopupBlocker" value="enable"/>
+
+* `WebSecurity` (`disable` или значение по умолчанию `enable` ): значение `disable` для переопределения параметров веб-безопасности, позволяя доступ к удаленному содержимому из неизвестных источников. Эта настройка предназначена только для удобства разработки только, так что удалите его перед упаковкой приложения для распространения. Для опубликованных приложений, все URI должен быть известны и разрешены с использованием `<access>` элемента, описанный в разделе "Инструкция по доступу к внешним ресурсам".
+
+ <preference name="WebSecurity" value="disable"/>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry10/index.md b/docs/ru/5.1.1/guide/platforms/blackberry10/index.md
new file mode 100644
index 0000000..e0efc17
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry10/index.md
@@ -0,0 +1,246 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы BlackBerry 10
+
+В этом руководстве показано, как настроить среду SDK для развертывания приложений Cordova на устройствах BlackBerry 10. Для предыдущих версий BlackBerry вы должны использовать другую версию SDK и другой набор средств командной строки, описанные в руководстве платформы BlackBerry. Для BlackBerry 10 вам необходимо установить SDK независимо от того, хотите ли вы использовать кросс платформенное CLI Cordova для разработки или более узкий набор платформо-ориентированных средств командной строки. Для сравнения двух вариантов разработки см. Введение. Подробную информацию о каждом способе смотрите в разделе "Интерфейс командной строки" и "Руководство по инструментам командной строки BlackBerry 10".
+
+## Требования
+
+Среда разработки доступна на Windows, Mac и Linux.
+
+Разработчикам следует использовать утилиту `cordova` в сочетании с BlackBerry WebWorks SDK или BlackBerry Native SDK. Смотрите раздел "Интерфейс командной строки" для получения информации как установить `cordova`, добавлять проекты, построить и развернуть их для каждой платформы.
+
+Симулятор BlackBerry 10:
+
+* Процессор: Intel dual core 2.0 ГГц/AMD Athlon 4200 + или выше
+* Место на диске: 10 ГБ
+* Оперативной памяти: 4 ГБ
+* Виртуализация: одно из следующих действий:
+ * **Технология виртуализации Intel** (VT, VT-x, vmx) → [Intel VT-x список поддерживаемых процессоров][1]
+ * **AMD виртуализации** (AMD-V, SVM) (С мая 2006 года все процессоры AMD включают AMD-V за исключением Sempron).
+
+ [1]: http://ark.intel.com/products/virtualizationtechnology
+
+Дополнительные сведения о требованиях: [Требования к симулятору BB10][2].
+
+ [2]: http://developer.blackberry.com/devzone/develop/simulator/simulator_systemrequirements.html
+
+## Установите BlackBerry WebWorks SDK
+
+Скачать и установить BlackBerry WebWorks SDK с [developer.blackberry.com][3]
+
+ [3]: https://developer.blackberry.com/html5/download/
+
+Программа установки добавит инструменты командной строки к вашем пути. В зависимости от вашей ОС может потребоваться открыть новое окно терминала или повторно войти в систему.
+
+## Установите BlackBerry Native SDK
+
+Если вам нужно скомпилировать в машинный код, например, при разработке собственного плагина, будет необходимо установить BlackBerry Native SDK.
+
+Чтобы получить BlackBerry Native SDK, скачать и установить IDE для BlackBerry с [developer.blackberry.com][4], а затем используя IDE, установить BlackBerry Native SDK. После установки вам нужно добавить свои средства командной строки к системному пути.
+
+ [4]: http://developer.blackberry.com/native/download/
+
+В Windows:
+
+* Перейти к **мой компьютер → Свойства → Дополнительно → Переменные среды**.
+
+* Добавьте каталог установки Native SDK к пути, например:
+
+ ;C:\bbndk\host_10_1_0_132\win32\x86\usr\bin\
+
+
+На Mac и Linux:
+
+* Отредактируйте файл `~/.bash_profile`, добавив строку, наподобие нижеуказанной, изменив ее в зависимости от того, где был установлен Native SDK:
+
+ $ export PATH=${PATH}:/Applications/bbndk/host_10_1_0_132/darwin/x86/usr/bin/
+
+ или для Native SDK 10.2:
+
+ $ export PATH=${PATH}:/Applications/Momentics.app/host_10_2_0_15/darwin/x86/usr/bin/
+
+* Выполните следующие действия, чтобы применить изменения в текущем сеансе:
+
+ $ источника ~/.bash_profile
+
+
+Если у вас есть любые проблемы со средой, используя Native SDK выполните из командной строки, соответствующий для вашей платформы файл, расположенный в пути установки:
+
+* На Windows → оболочку MS-DOS:
+
+ C:\> \bbndk\bbndk-env_xx_xx_xx_xxxx.bat
+
+* На Windows → оболочка bash git:
+
+ $ `\bbndk\bbndk-env_xx_xx_xx_xxxx.bat`
+
+* На Linux → установлен в качестве пользователя root:
+
+ $ `./opt/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+* На Linux → установлен как не root пользователя:
+
+ $ `./home/username/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+* На Mac:
+
+ $ `/Developer/SDKs/bbndk/bbndk-env_xx_xx_xx_xxxx.sh`
+
+
+## Настройка для подписывания
+
+Если вы хотите проверить на устройстве или распространять приложения через BlackBerry World, ваша система должна быть сконфигурирована для подписи кода.
+
+Для получения ключа подписи, перейдите к \[Форма покупки ключей BlackBerry\] (https://www.blackberry.com/SignedKeys/codesigning.html).
+
+Выберите первый флажок: «для BlackBerry10 приложений, разработанных с использованием BlackBerry NDK» и затем войти на сайт или создайте новый BBID.
+
+Введите пароль и нажмите кнопку «Get Token», чтобы загрузить bbidtoken.csk. Сохраните этот файл в расположение по умолчанию для вашей ОС, которая будет отображаться на странице загрузки.
+
+Последним шагом является создания сертификата подписи:
+
+ $ blackberry-keytool -genkeypair -storepass <password> -author 'Your Name’
+
+
+## Создание проекта
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello
+ $ cd hello
+ $ cordova platform add blackberry10
+ $ cordova build
+
+
+## Развертывание на эмулятор
+
+Если вы хотите запустить эмулятор устройства, загрузите и установите симулятор BlackBerry 10.
+
+* [Скачать][4]
+* [Приступая к работе][5]
+
+ [5]: http://developer.blackberry.com/devzone/develop/simulator/blackberry_10_simulator_start.html
+
+Перед тестированием приложения на эмуляторе или устройстве, необходимо включить режим разработки.
+
+Запустить образ эмулятора, затем выберите **Настройки** на главном экране:
+
+![][6]
+
+ [6]: img/guide/platforms/blackberry10/bb_home.png
+
+Перейдите к разделу **Безопасности и конфиденциальность → Режим разработки** и включить опцию:
+
+![][7]
+
+ [7]: img/guide/platforms/blackberry10/bb_devel.png
+
+Дополнительный набор утилит командной строки включаются при установке платформы BlackBerry 10 для вашего проекта. Следующая команда, в данном случае вызваная из каталога проекта верхнего уровня, связывает целевой объект с именем *emu* с IP-адресом указанным выше.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\target.bat add emu 169.254.0.1 -t simulator
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/target add emu 169.254.0.1 -t simulator
+
+
+Затем выполните команду `emulate` для просмотра приложения:
+
+ $ cordova emulate blackberry10
+
+
+## Развертывание на устройство
+
+Чтобы развернуть на устройстве, убедитесь, что оно подключено к компьютеру. Включить режим разработки и получить IP-адрес как описано в разделе по эмулятору выше. Вам также нужно будет получить ПИН-код из приложения **Настройки** в разделе **Об устройстве → Оборудование**:
+
+![][8]
+
+ [8]: img/guide/platforms/blackberry10/bb_pin.png
+
+Запустите утилиту командной строки чтобы связать имя с IP адресом, паролем устройства и ПИН-кодом.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\target.bat add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/target add mydevice 169.254.0.1 -t device --password 123456 --pin FFFF972E
+
+
+где:
+
+* `--password` указывает на пароль, необходимый чтобы разблокировать устройство.
+
+* `--pin` относится к PIN устройства, полученный из приложения **Настройки**.
+
+Затем выполните команду `run` для просмотра приложений:
+
+ $ cordova run blackberry10
+
+
+Если маркер отладки еще не настроен для устройства, сообщение об ошибке предложит вам использовать скрипт платформы run, c паролем который вы указали при регистрации для ключей подписи.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\run.bat --device --keystorepass mysecret
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/run --device --keystorepass mysecret
+
+
+## Отладка с WebInspector
+
+При отладке на устройстве или эмуляторе, вы можете запустить WebInspector удаленно для просмотра внутреннего состояния приложения. Запрос отображает URL-адрес, который позволяет вам подключиться к приложению через стандартный веб-браузер. Для получения дополнительной информации см. [Отладка с помощью WebInspector][9].
+
+ [9]: http://developer.blackberry.com/html5/documentation/web_inspector_overview_1553586_11.html
+
+## Создание релиз версии
+
+По умолчанию команда `cordova build` создает файл неподписанный файл пакета *.bar* который подходит для тестирования на устройстве или симуляторе.
+
+Используйте `--release` для создания релиз версии подходящей для распространения через BlackBerry World.
+
+ $ cordova build --release --keystorepass <signing password>
+
+
+Параметр `--keystorepass` определяет пароль, заданные при настройке вашего компьютера для подписи приложений.
+
+## Развертывание в других местах
+
+В инструкциях выше предполагается что устройство подключено через USB или симулятор выполняется на локальном компьютере. Также можно развернуть приложение в других местах.
+
+Дополнительный набор утилит командной строки включаются при установке платформы BlackBerry 10 для вашего проекта. Следующая команда, в данном случае вызваная из каталога проекта верхнего уровня, связывает целевой объект с именем *emu* с IP-адресом.
+
+* В Windows:
+
+ $ platforms\blackberry10\cordova\build.bat --release --keystorepass mysecret
+
+* На Mac/Linux:
+
+ $ platforms/blackberry10/cordova/build --release --keystorepass mysecret
+
+После того, как цель определена, вы можете передавать ее команде run с помощью `--target`:
+
+ $ cordova run blackberry10 --target=emu
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry10/plugin.md b/docs/ru/5.1.1/guide/platforms/blackberry10/plugin.md
new file mode 100644
index 0000000..bd54179
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry10/plugin.md
@@ -0,0 +1,199 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины для BlackBerry 10
+
+Этот раздел содержит сведения о том, как реализовать код родной плагин на платформе BlackBerry 10. Прежде чем читать это, прочтите секции "Архитектура плагинов" для обзор структуры плагина и его общего JavaScript интерфейса. Этот раздел продолжает демонстрировать образец плагина *echo*, который взаимодействует с WebView Cordova на стороне платформы и наоборот.
+
+Плагин Echo просто возвращает любую строку, которую функция `window.echo` отправляет из JavaScript:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+Cordova плагин для BlackBerry 10 содержит как JavaScript так и код платформы, которые общаются друг с другом через фреймворк, предоставляемый JNEXT. Каждый плагин должен также включать файл `plugin.xml`.
+
+## Создание класса плагина
+
+Для создания основной части вашего плагина, откройте BlackBerry 10 NDK IDE и выберите **File → New → BlackBerry Project → Native Extension → BlackBerry 10**. Введите нужное имя и расположение проекта, затем нажмите кнопку **Finish**.
+
+Проект, созданный в среде IDE содержит примеры кода для плагина памяти. Вы можете перезаписать или изменить эти файлы для реализации собственного функционала:
+
+* `*name*_js.hpp`: Заголовок C++ для кода JNEXT.
+
+* `*name*_js.cpp`: Код C++ для JNEXT.
+
+Родной интерфейс для модуля JNEXT может быть просмотрен в файле заголовка плагина, расположенном в каталоге public проекта. К вашим услугам также константы и сервисных функций, доступных из кода платформы. Плагин должен быть производным от класса `JSExt`, который определен в `plugin.h` . То есть необходимо реализовать следующий класс:
+
+ class JSExt
+ {
+ public:
+ virtual ~JSExt() {};
+ virtual string InvokeMethod( const string& strCommand ) = 0;
+ virtual bool CanDelete( void ) = 0;
+ private:
+ std::string m_id;
+ };
+
+
+Плаин должн включать заголовочный файл `plugin.h`. В примере `Echo`, вы используете `JSExt` как указано в следующем `echo_js.hpp` файле:
+
+ #include "../public/plugin.h"
+ #include <string>
+
+ #ifndef ECHO_JS_H_
+ #define ECHO_JS_H_
+
+ class Echo : public JSExt
+ {
+ public:
+ explicit Echo(const std::string& id);
+ virtual ~Echo();
+ virtual std::string InvokeMethod(const std::string& command);
+ virtual bool CanDelete();
+ private:
+ std::string m_id;
+ };
+
+ #endif // ECHO_JS_H_
+
+
+`m_id` атрибут содержит `JNEXT` id для объекта, который передается в класс в качестве аргумента конструктора. Он необходим для стороны платформы чтобы вызывать события на стороне JavaScript. Метод `CanDelete` определяет, может ли быть удален объект определенный на строне платформы. Функция `InvokeMethod` вызывается в результате запроса со стороны JavaScript для вызова метода из данного конкретного объекта. Единственный аргумент этой функции является строка, передаваемая из JavaScript, который анализируется этим методом для определения, какой из методов собственного объекта должен быть выполнен. Эти методы реализуются в `echo_js.cpp` . Вот функция `InvokeMethod` для `Echo`:
+
+ string Echo::InvokeMethod(const string& command) {
+
+ //parse command and args from string
+ int index = command.find_first_of(" ");
+ string strCommand = command.substr(0, index);
+ string strValue = command.substr(index + 1, command.length());
+
+ // Determine which function should be executed
+ if (strCommand == "echo") {
+ return strValue;
+ } else {
+ return "Unsupported Method";
+ }
+ }
+
+
+Плагин платформы должен также реализовывать следующие функции обратного вызова:
+
+* `extern char* onGetObjList( void );`
+
+* `extern JSExt* onCreateObject( const string& strClassName, const string& strObjId );`
+
+Функция `onGetObjList` возвращает разделенный запятыми список классов, поддерживаемых JNEXT. JNEXT использует эту функцию для определения набора классов, которые могут быть созданы JNEXT. Плагин `Echo` реализует следующе в `echo_js.cpp`:
+
+ char* onGetObjList() {
+ static char name[] = "Echo";
+ return name;
+ }
+
+Функция `onCreateObject` принимает два параметра. Первый, это имя запрашиваемого класса который должен быть создан для стороны JavaScript, с допустимыми именами как те которые были возвращены из `onGetObjList` . Вторым параметром является уникальный идентификатор объекта класса. Этот метод возвращает указатель на созданный объект плагина. Плагин `Echo` реализует следующе в `echo_js.cpp`:
+
+ JSExt* onCreateObject(const string& className, const string& id) {
+ if (className == "Echo") {
+ return new Echo(id);
+ }
+ return NULL;
+ }
+
+
+## Создание плагина JavaScript
+
+Плагин должен содержать следующие файлы JavaScript:
+
+* `client.js`: Это файл считается клиентской стороной и содержит API для Cordova-приложения. API в вызовах `client.js` делает вызовы к `index.js` . API в `client.js` также связывает функции обратного вызова с событиями, которые вызывают эти функции.
+
+* `index.js`: Cordova загружает `index.js` и делает его доступным через шлюз cordova.exec. Файл `client.js` делает вызовы к API в файле `index.js`, который в свою очередь делает вызов к JNEXT для взаимодействия со стороной платформы.
+
+Стороне клиента и сервера (`client.js` и `index.js`) взаимодействует через функцию `cordova.exec`. Файлу `client.js` нужно вызывать функцию `exec` и предоставить необходимые аргументы. Плагин `Echo` реализует следующее в файле `client.js`:
+
+ var service = "org.apache.cordova.blackberry.echo",
+ exec = cordova.require("cordova/exec");
+
+ module.exports = {
+ echo: function (data, success, fail) {
+ exec(success, fail, service, "echo", { data: data });
+ }
+ };
+
+
+Компонент `index.js` использует JNEXT для взаимодействия со стороной платформы. Присоединение функции конструктора с именем `Echo` к JNEXT позволяет выполнять следующие основные операции с помощью функции `init`:
+
+* Укажите необходимый модуль, экспортируемые со стороны платформы. Имя необходимого модуля должно соответствовать имени файла общей библиотеки (`.so` файл):
+
+ JNEXT.require("libecho")
+
+* Создайте объект используя полученный модуль и сохраните идентификатор, который был возвращен:
+
+ self.m_id = JNEXT.createObject("libecho.Echo");
+
+ Когда приложение вызывает функцию `echo` из `client.js` , которая в свою очередь, вызывает функцию `echo` из `index.js`, откуда объект `PluginResult` отправляет данные как ответ обратно в `client.js` . Так как аргумент `args`, передаваемый в функции был преобразован с помощью `JSON.stringfy()` и закодирован как `URIcomponent`, вам необходимо вызвать следующее:
+
+ data = JSON.parse(decodeURIComponent(args.data));
+
+Теперь вы можете отправить данные обратно, как показано ниже:
+
+ module.exports = {
+ echo: function (success, fail, args, env) {
+ var result = new PluginResult(args, env),
+ data = JSON.parse(decodeURIComponent(args.data)),
+ response = echo.getInstance().echo(data);
+ result.ok(response, false);
+ }
+ };
+
+
+## Архитектура плагинов
+
+Вы можете разместить артефакты плагина, включая файл `plugin.xml`, исходные файлы JavaScript и C++ и двоичные файлы `.so` в любой структуре каталогов, до тех пор, пока вы правильно указываете расположение файлов в файле `plugin.xml`. Вот типичная структура:
+
+***project_directory*** (раздел настроек plugin.xml)
+
+* **www** (>client.js)
+* **src**
+ * **blackberry10** (>index.js, **native** >*.cpp, *.hpp)
+ * **device** (>*двоичный файл* * .so)
+ * **simulator** (>*двоичный файл* * .so)
+
+В списке отображаются иерархические отношения между каталогами верхнего уровня. Скобки показывает содержимое данного каталога. Все имена каталогов отображаются полужирным шрифтом. Именам файлов предшествует знак `>`.
+
+## Файл *plugin.xml*
+
+Файл `plugin.xml` содержит пространства имен расширения и другие метаданные. Настройте плагин `Echo` следующим образом:
+
+ <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
+ id="org.apache.cordova.blackberry.echo"
+ version="1.0.0">
+ <js-module src="www/client.js">
+ <merges target="navigator" />
+ </js-module>
+ <platform name="blackberry10">
+ <source-file src="src/blackberry10/index.js" />
+ <lib-file src="src/blackberry10/native/device/libecho.so" arch="device" />
+ <lib-file src="src/blackberry10/native/simulator/libecho.so" arch="simulator" />
+ <config-file target="www/config.xml" parent="/widget">
+ <feature name="org.apache.cordova.blackberry.echo" value="org.apache.cordova.blackberry.echo" />
+ </config-file>
+ </platform>
+ </plugin>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry10/tools.md b/docs/ru/5.1.1/guide/platforms/blackberry10/tools.md
new file mode 100644
index 0000000..2d382f3
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry10/tools.md
@@ -0,0 +1,141 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по инструментам командной строки BlackBerry 10
+
+Утилита командной строки `cordova` является инструментом высокого уровня, который позволяет вам создавать приложения сразу на нескольких платформах. Более старые версии фреймворка Cordova предоставляли наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Распакуйте платформу, для которой вы хотите разрабатывать. Инструменты, описанные здесь обычно доступны в каталоге верхнего уровня `bin`, в противном случае проконсультируйтесь с файлом **README** для получения более подробных указаний.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневом интерфейсе командной строки, который управляет плагинами смотрите в разделе "Использование Plugman для управления расширениями". Смотрите раздел "Расширения приложения" для подробной информации о том, как разрабатывать плагины.
+
+Если вам нужна помощь по любой команды, перечисленной ниже, введите команду вместе с аргументами `-h` или `-help`, которые поддерживаются всеми командами и которые предоставляют описания для каждого из имеющихся аргументов.
+
+## Создание приложения
+
+Команда `create` создает новый проект:
+
+ bin/create <path-to-project> <project-package> <project-name>
+
+
+где
+
+* `<path-to-project>` Указывает каталог, где вы хотите чтобы проект был создан
+
+* `<project-package>` Указывает идентификатор в стиле обратного именования доменов
+
+* `<project-name>` Задает отображаемое имя приложения
+
+**Примечание**: команда `create` загружает зависимости установки через команду `npm install`. В зависимости от разрешения системы и каталога установки может потребоваться права администратора. Если есть проблемы на OSX/Linux, запустите `sudo npm install` перед использованием команды `create`. На Windows, запустите `npm install` в командной строке, открытой с правами администратора.
+
+## Задать целевое устройство
+
+Команда `target` позволяет управлять эмулятором или устройствами BlackBerry, которые используются для тестирования приложения. Можно добавить или удалить целевое устройство или задать целевое устройство как цель для развертывания по умолчанию.
+
+### Добавьте целевой объект
+
+ <path-to-project>/cordova/target add <name> <ip-address> [-t | --type <device | simulator>] [-p | --password <password>] [--pin <device-pin>]
+
+
+где
+
+* `<name>` Указывает уникальное имя для целевого устройства.
+
+* `<ip-address>` Указывает IP-адрес устройства BlackBerry или симулятора.
+
+* `-p | --password <password>` Указывает пароль для устройства или эмулятора. Это необходимо, только если устройство или эмулятор защищен паролем.
+
+* `--pin <device-pin>` Указывает PIN устройства BlackBerry, который идентифицирует устройство как допустимый хост для маркера отладки. Этот аргумент является обязательным только при создании маркера отладки.
+
+### Удаление целевого устройства
+
+ <path-to-project>/cordova/target remove <name>
+
+
+### Задать целевое устройство по умолчанию
+
+ <path-to-project>/cordova/target default <name>
+
+
+## Построение приложения
+
+Команда `build` строит проект как файл .bar. Вы можете создавать приложения в режиме релиза, (который создает подписанный .bar файл) или в режиме отладки (который создает неподписанный .bar файл).
+
+### Построение приложения в режиме релиза
+
+ <path-to-project>/cordova/build release [-k | --keystorepass <password>] [-b | --buildId <number>] [-p | --params <params-JSON-file>]
+
+
+где
+
+* `-k | --keystorepass <password>` Указывает пароль, который вы определили, когда вы настроили ваш компьютер для подписи приложений.
+
+* `-b | --buildId <number>` Задает номер версии сборки приложения. Как правило это число должно увеличивается от предыдущей версии по мере создания новых подписанных версий. Этот аргумент является необязательным.
+
+* `-p | --params <params-JSON-file>` Определяет JSON файл, содержащий дополнительные параметры для передачи вызываемым инструменты. Этот аргумент является необязательным.
+
+### ППостроение приложения в режиме отладки
+
+ <path-to-project>/cordova/build debug [<target>] [-k | --keystorepass <password>] [-p | --params <params-JSON-file>] [-ll | --loglevel <error|warn|verbose>]
+
+
+где
+
+* `<target>` Указывает имя ранее добавленного целевого устройства. Если `<target>` не указан, используется устройство по умолчанию, если оно было задано. Этот аргумент необходим только если если вы хотите чтобы скрипт развернул приложение на устройстве BlackBerry, или эмуляторе и вы еще не создали целевое устройство по умолчанию. Кроме того если `<target>` – это устройство, то это устройство должно быть подключено к компьютеру через USB-соединение или должно быть подключено к той же сети Wi-Fi, что и ваш компьютер.
+
+* `-k | --keystorepass <password>` Указывает пароль, который вы определили, когда вы настроили ваш компьютер для подписи приложений. Этот пароль используется также для создания маркера отладки. Этот аргумент является требуется только если вы хотите чтобы скрипт создал и установил маркер отладки для вас.
+
+* `-p | --params <params-JSON-file>` Определяет JSON файл, содержащий дополнительные параметры передаваемые вызываемым инструментам.
+
+* `-ll | --loglevel <level>` Задает уровень ведения журнала. Уровень ведения журнала может быть одним из значений `error`, `warn`, или `verbose`.
+
+Если вы ранее задали целевое устройство по умолчанию (и ранее установили маркер отладки, если эта цель является устройством BlackBerry), вы можете запустить сценарий без аргументов и скрипт создат пакет вашего прилоежния и развернет его на целевое устройство по умолчанию. Например:
+
+ <path-to-project>/cordova/build debug
+
+
+## Запуск приложения
+
+Команда `run` развертывает последнее построение приложения на указанное устройство BlackBerry или эмулятор. Для развертывания приложения, необходимо задать целевое устройство:
+
+ <path-to-project>/cordova/run <target>
+
+
+...`<target>` Указывает имя ранее добавленного целевого устройства. Если `<target>` является устройством, то оно должен быть подключен к компьютеру через кабель USB, или же быть в той же сети Wi-Fi, что и ваш компьютер.
+
+## Управление плагинами
+
+Команда `target` позволяет добавлять и удалять плагины. Для выбора локально расположенного плагина:
+
+ <path-to-project>/cordova/plugin fetch <path-to-plugin>
+
+
+Просмотреть список установленных плагинов:
+
+ <path-to-project>/cordova/plugin ls
+
+
+Добавление плагина:
+
+ <path-to-project>/cordova/plugin add <name>
+
+
+Удаление плагина:
+
+ <path-to-project>/cordova/plugin rm <name>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/blackberry10/upgrade.md b/docs/ru/5.1.1/guide/platforms/blackberry10/upgrade.md
new file mode 100644
index 0000000..b1a27cf
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/blackberry10/upgrade.md
@@ -0,0 +1,485 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление для BlackBerry 10
+
+В этом руководстве показано, как изменить проекты BlackBerry при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Выполните команду `cordova platform update blackberry` в существующих проектах.
+
+## Обновление до 3.2.0 с 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update blackberry`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+1. Создайте новый проект Apache Cordova 3.1.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте вашу платформ в проект Cordova, например: `cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые ресурсы платформы из вашего первоначального проекта ( `Resources`, и т.д.)
+
+5. Скопируйте файл `config.xml` в каталог `www` и удалить любые определения плагинов. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте средство CLI cordova для установки любых плагинов, которые вам нужны. Обратите внимание, что CLI обрабатывает все основные API как плагины, так что они могут и должны быть добавлены. Только плагины отмеченые 3.0.0 и выше, совместимы с CLI.
+
+7. Построение и тестирование.
+
+Пожалуйста, обратите внимание, что CLI поддерживает платформу BlackBerry10 исключительно. Для поддержки PlayBook и BBOS, смотрите Cordova версии 2.9.0 см и ниже.
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте вашу платформ в проект Cordova, например: `cordova
+platform add blackberry10`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые ресурсы платформы из вашего первоначального проекта ( `Resources`, и т.д.)
+
+5. Скопируйте файл `config.xml` в каталог `www` и удалить любые определения плагинов. Вам нужно изменить настройки здесь, а не в каталоге платформы.
+
+6. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+7. Построение и тестирование.
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+Для BlackBerry 10:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+Для BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+BlackBerry 10 использует новый инструмент CLI и управляет основными API как плагинами. Инструкции по миграции проекта в новый проект, а не обновление существующего проекта, в связи со сложностью обновления старого проекта. Также обратите внимание, что cordova js скрипт файл теперь называется «cordova.js» и больше не содержит строку версии.
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в "Руководство по инструментам BlackBerry". Это станет домашним каталогом вашего обновленного проекта.
+
+5. Скопировать исходный код вашего проекта из каталога `/www` старого проекта в каталог `/www` нового проекта.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+Для BlackBerryOS/Playbook:
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` из нового проекта в папке `www` и удалите файл `www/cordova.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Закройте все запущенные инструменты SDK: Eclipse, Momentics и тому подобное.
+
+3. Перейдите в каталог, где вы положили загруженный выше исходный код, используя unix-терминал: Terminal.app, Bash, Cygwin и т.д.
+
+4. Создайте новый проект, как описано в разделе "Руководство инструментов BlackBerry". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Скопируйте каталог `native` из нового проекта в существующий проект, перезаписывая старый каталог `native`.
+
+8. Скопируйте каталог `lib` из нового проекта в существующий проект, перезаписывая старый каталог `lib`.
+
+9. Скопируйте каталог `cordova` из нового проекта в существующий проект, перезаписывая старый каталог `cordova`.
+
+## Обновление до 2.6.0 от 2.5.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.6.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.6.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.6.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.6.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.6.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.6.0.js` файл.
+
+## Обновление до 2.5.0 с 2.4.0
+
+Обновление в каталог загрузки PhoneGap:
+
+Рекомендуется, что вы скачать свежую копию всего каталога.
+
+Однако здесь новые детали, необходимые для частичного обновления:
+
+1. Обновить файл cordova.blackberry.js в `Phonegap-2.5.0/lib/blackberry/javascript` каталог.
+
+2. Обновление `ext` , `ext-air` , и `ext-qnx` в `Phonegap-2.5.0/lib/blackberry/framework` каталог.
+
+3. Обновление `build.xml` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+4. Обновление `Phonegap-2.5.0/lib/blackberry/bin` каталог.
+
+5. Обновление `VERSION` файл в `Phonegap-2.5.0/lib/blackberry` каталог.
+
+Обновление в примере / каталог или перенос существующего проекта:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Обновить содержимое `ext-qnx/` каталог.
+
+5. Скопируйте новый `cordova-2.5.0.js` в ваш проект.
+
+6. Обновить ваш HTML, чтобы использовать новый `cordova-2.5.0.js` файл.
+
+## Обновление до 2.4.0 от 2.3.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.4.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.4.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.3.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.3.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.3.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.3.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.3.0/` Каталог`cordova.2.4.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.4.0.js`.
+
+## Обновление до 2.3.0 от 2.2.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.3.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.3.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.2.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.2.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.2.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.2.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.2.0/` Каталог`cordova.2.3.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.3.0.js`.
+
+## Обновление до 2.2.0 из 2.1.0
+
+Обновление только каталог www:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.2.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+ * Если BlackBerry 10, затем обновить файл JS в `qnx/` каталог.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.2.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.1.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.1.0/ext-air/` каталог.
+
+4. Обновить содержимое `cordova.2.1.0/ext-qnx/` каталог.
+
+5. Обновить файл .js в `cordova.2.1.0/javascript/` каталог.
+
+6. Открытые `sample/lib/` каталог и переименовать `cordova.2.1.0/` Каталог`cordova.2.2.0/`.
+
+7. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+8. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.2.0.js`.
+
+## Обновление до 2.1.0 с 2.0.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.1.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.1.0.js` файл.
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.2.0.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.2.0.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.2.0.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.2.0.0/` Каталог`cordova.2.1.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.1.0.js`.
+
+## Обновление до 2.0.0 от 1.9.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-2.0.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-2.0.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.9.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.9.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.9.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.9.0/` Каталог`cordova.2.0.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-2.0.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+* Чтобы обновить до 1.8.0, перейдите от 1.7.0
+
+## Обновление до 1.8.0 от 1.7.0
+
+Обновление только `www` Каталог:
+
+1. Откройте каталог `www`, который содержит приложение.
+
+2. Удалить и обновить файл .jar в `ext/` каталог.
+
+3. Обновить содержимое `ext-air/` каталог.
+
+4. Скопируйте новый `cordova-1.8.0.js` в ваш проект.
+
+ * Если playbook, тогда обновите .js файл в каталоге `playbook/`.
+
+5. Обновить ваш HTML, чтобы использовать новый `cordova-1.8.0.js` файл.
+
+6. Обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
+
+
+Обновление каталога образцов (например, обновления через ant tools):
+
+1. Открытые `sample/lib/` каталог.
+
+2. Обновить файл .jar в `cordova.1.7.0/ext/` каталог.
+
+3. Обновить содержимое `cordova.1.7.0/ext-air/` каталог.
+
+4. Обновить файл .js в `cordova.1.7.0/javascript/` каталог.
+
+5. Открытые `sample/lib/` каталог и переименовать `cordova.1.7.0/` Каталог`cordova.1.8.0/`.
+
+6. Наберите `ant blackberry build` или `ant playbook build` чтобы обновить каталог `www` с обновленной версией Cordova.
+
+7. Откройте каталог `www` и обновить ваш HTML, чтобы использовать новый файл `cordova-1.8.0.js`.
+
+8. Откройте каталог `www` и обновите файл `www/plugins.xml`. Два плагины изменили свои имена служб/пространства имен. Измените старые записи для плагинов Захвата и Контакты:
+
+ <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact"/>
+
+ На:
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/firefoxos/config.md b/docs/ru/5.1.1/guide/platforms/firefoxos/config.md
new file mode 100644
index 0000000..5c69d50
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/firefoxos/config.md
@@ -0,0 +1,20 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# FirefoxOS конфигурация
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/firefoxos/index.md b/docs/ru/5.1.1/guide/platforms/firefoxos/index.md
new file mode 100644
index 0000000..3683fbf
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/firefoxos/index.md
@@ -0,0 +1,92 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Firefox OS
+
+В этом руководстве показано, как настроить вашу среду разработки для развертывания приложений Cordova на устройствах Firefox OS, а также тестировать и опубликовывать эти приложения.
+
+## Требования и поддержка
+
+Firefox OS приложения являются просто веб-приложениями, с добавлением файла manifest.webapp, который определяет метаданные о приложении и позволяет ему быть установленым на устройстве Firefox OS. Любая платформа которую поддерживает Cordova может быть использована.Чтобы узнать больше о создании веб-приложений, обратитесь в [App Center][1] на [MDN][2].
+
+ [1]: https://developer.mozilla.org/en-US/Apps
+ [2]: https://developer.mozilla.org/en-US/
+
+## Установка и настройка среды
+
+Сначала установить [Node.js][3], а затем установить пакет Cordova следующим образом:
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g cordova
+
+
+Далее создайте тестовое приложения Cordova, а затем перейдите в созданную директорию:
+
+ $ cordova create test-app
+ $ cd test-app
+
+
+Добавьте Firefox OS как поддерживаемую платформа в приложение следующим образом:
+
+ $ cordova platform add firefoxos
+
+
+Это создает приложение Firefox OS в каталоге platforms/firefoxos/www, который в настоящее время выглядит так же как и каталог www, за исключением того, что он содержит файл манифеста Firefox (manifest.webapp) внутри директории www.
+
+## Разработка вашего приложения
+
+На данный момент вы готовы к работе — изменить код внутри test-app/www на все, что вы хотите. Вы можете добавить [поддерживаемые плагины]() в приложение, с помощью «cordova plugin add», например:
+
+ cordova plugin add cordova-plugin-device
+ cordova plugin add cordova-plugin-vibration
+
+
+Когда написан код приложения, развертывайте ваши изменений в Firefox OS приложении, которые вы добавили в в проект с помощью
+
+ $ cordova prepare firefoxos
+
+
+Для создания упакованного приложения можно архивировать каталог platforms/firefoxos/www. Вы можете также просто построить его с помощью
+
+ $ cordova build firefoxos
+
+
+Упаковонное приложение Firefox OS будет собрано в platforms/firefoxos/build/package.zip
+
+## Тестирование и отладка
+
+Приложение может быть протестировано с помощью Firefox OS [Web IDE][4].
+
+ [4]: https://developer.mozilla.org/en-US/docs/Tools/WebIDE
+
+Когда вы подключените App Manager к вашему тестовому устройству/симулятору, выберите параметр «Add Packaged App», то убедитесь, что вы указываете на каталог test-app/platforms/firefoxos/www/ для включения приложения в интерфейсе App Manager.
+
+Здесь можно установить приложение на ваше тестовое устройство/симулятор (с кнопкой «Update»). С помощью кнопки «Debug» можно выполнить отладку приложения и отредактировать его код по живому.
+
+Примечание: Прежде чем публиковать приложение вы должны проверить его с помощью [App validator][5].
+
+ [5]: https://marketplace.firefox.com/developers/validator
+
+## Публикация приложения в Firefox Marketplace
+
+Можно отправить ваше приложение в Firefox Marketplace или опубликовать его самостоятельно. Посетите [Зону Firefox Marketplace][6] на MDN, чтобы узнать больше о том, как сделать это; [Параметры публикации App][7] является лучшим местом для начала.
+
+ [6]: https://developer.mozilla.org/en-US/Marketplace
+ [7]: https://developer.mozilla.org/en-US/Marketplace/Publishing/Publish_options
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/index.md b/docs/ru/5.1.1/guide/platforms/index.md
new file mode 100644
index 0000000..bc6cd65
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/index.md
@@ -0,0 +1,84 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по поддерживаемым платформам
+
+Прежде чем приступить к разработка для любой из платформ перечисленных ниже, вам потребуется установить командный интефейс Cordova (CLI). (см. Интерфейс командной строки.)
+
+Для разработки приложений Cordova, необходимо установить пакет SDK для каждой мобильной платформы, которую вы выбрали. Эта установка необходима независимо вне зависимости от того, собираетесь ли вы делать большую часть работы в SDK или использовать CLI для вашего цикла сборки.
+
+Каждое *Руководство по работе с платформой* перечисленные ниже говорит вам, что нужно знать для настройки среды разработки каждой платформы: где получить SDK, как настроить эмуляторы устройств, как подключить устройства для тестирования и как управлять ключами подписывания. Дополнительные руководства представляют информацию для каждой платформы уникальный набор параметров настройки, инструкции для добавления плагинов, как обновить платформы и специфические параметры командной строки, которые служат в качестве нижнего уровня альтернативой `cordova` утилиты командной строки.
+
+## Amazon Fire OS
+
+* Руководство для платформы Amazon Fire OS
+* Настройка Amazon Fire OS
+* WebView в Amazon Fire OS
+* Плагины для Amazon Fire OS
+
+## Android
+
+* Руководство для платформы Android
+* Руководство по инструментам командной строки Android
+* Конфигурация Android
+* Плагины для Android
+* WebViews в Android
+* Обновление для Android
+
+## BlackBerry 10
+
+* Руководство для платформы BlackBerry 10
+* Руководство по инструментам командной строки BlackBerry 10
+* Конфигурация BlackBerry 10
+* Плагины для BlackBerry 10
+* Обновление для BlackBerry 10
+
+## Firefox OS
+
+* Руководство для платформы Firefox OS
+
+## iOS
+
+* Руководство для платформы iOS
+* Руководство по инструментам командной строки iOS
+* Конфигурация iOS
+* Плагины для iOS
+* WebViews в iOS
+* Обновление для iOS
+
+## Ubuntu
+
+* Руководство для платформы Ubuntu
+
+## Windows Phone 8
+
+* Руководство для платформы Windows Phone 8
+* Плагины Windows Phone 8
+* Обновление Windows Phone 8
+
+## Windows
+
+* Руководство по платформе Windows
+* Плагины Windows
+* Упаковка приложений Windows
+* Обновление для Windows 8
+
+## Tizen
+
+* Руководство для платформы Tizen
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/config.md b/docs/ru/5.1.1/guide/platforms/ios/config.md
new file mode 100644
index 0000000..744b12e
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/config.md
@@ -0,0 +1,88 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Конфигурация iOS
+
+Файл `config.xml` управляет основные параметрами приложения, которые применяются к каждому приложению и экземпляру CordovaWebView. Этот раздел описывает настройки, которые применяются только к платформе iOS. Смотрите [Файл config.xml][1] для получения информации о глобальных параметрах конфигурации.
+
+ [1]: config_ref_index.md.html#The%20config.xml%20File
+
+* `EnableViewportScale` (логическое значение, по умолчанию `false`): Установите `true` чтобы разрешить тегу meta viewport либо отключить или ограничить диапазон масштабирования экрана пользователем, который включен по умолчанию.
+
+ <preference name="EnableViewportScale" value="true"/>
+
+ Установите viewport следующим образом в HTML, чтобы отключить масштабирование и гибко подстраивать содержимое в WebView во время отрисовывания:
+
+ <meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' />
+
+* `MediaPlaybackRequiresUserAction` (логическое значение, по умолчанию `false` ): Установите `true` чтобы запретить автоматическое воспроизведение HTML5 видео или аудио с использованием атрибуте `autoplay` или через JavaScript.
+
+ <preference name="MediaPlaybackRequiresUserAction" value="true"/>
+
+* `AllowInlineMediaPlayback` (логическое значение, по умолчанию `false` ): Установите `true` чтобы разрешить воспроизведение мультимедиа HTML5 появляться *встроено* в пределах экрана, с помощью стандартных элементов управления браузера, а не элементы управления платформы. Чтобы это работало, добавьте атрибут `webkit-playsinline` к любому элементу `<video>`.
+
+ <preference name="AllowInlineMediaPlayback" value="true"/>
+
+* `BackupWebStorage` (строка, либо `none`, `local`, или значение по умолчанию `cloud`): Установите `cloud` чтобы разрешить сохранение веб-данных при резервном копировании через iCloud. Установите `local` для того чтобы разрешить только в локальных резервных копия при синхронизации через iTunes. Установите `none` чтобы предотвратить создание резервных копий веб-данных.
+
+ <preference name="BackupWebStorage" value="local"/>
+
+* `TopActivityIndicator` (строка, по умолчанию `gray` ): контролирует появление небольшого вращающийся значка в строке состояния, указывающее значительную активность процессора. Допустимыми значениями являются `whiteLarge`, `white`, и `gray`.
+
+ <preference name="TopActivityIndicator" value="white"/>
+
+* `KeyboardDisplayRequiresUserAction` (логическое значение, по умолчанию `true`): Установите `false` чтобы разрешить клавиатуре появляются при вызове `focus()` на формах ввода.
+
+ <preference name="KeyboardDisplayRequiresUserAction" value="false"/>
+
+* `SuppressesIncrementalRendering` (логическое значение, по умолчанию `false` ): Установите `true` чтобы ожидать, пока все содержимое будет получено до того, как оно будет отображаться на экране.
+
+ <preference name="SuppressesIncrementalRendering" value="true"/>
+
+* `GapBetweenPages` (float, значение по умолчанию `0` ): размер разрыва, в точках, между страницами.
+
+ <preference name="GapBetweenPages" value="0"/>
+
+* `PageLength` (float, значение по умолчанию `0`): размер каждой страницы, в точках, в направление протяженности страницы. Когда PaginationMode — справа налево или слева направо, это свойство представляет ширину каждой страницы. Когда PaginationMode сверху вниз или снизу вверх, это свойство представляет высоту каждой страницы. Значение по умолчанию равно 0, что означает, что макет использует размер viewport-а, чтобы определить размеры страницы.
+
+ <preference name="PageLength" value="0"/>
+
+* `PaginationBreakingMode` (строки, по умолчанию `page`): допустимые значения `page` и `column`. Порядок, в котором происходит разрыв столбца или страницы. Это свойство определяет, будут ли определенные CSS свойства относительно разрыва столбца и страницы применяться или игнорироваться. Когда это свойство имеет значение `column`, содержимое страницы обрабатывает CSS свойства, относящиеся к разрыву колонки в месте разрыва страницы.
+
+ <preference name="PaginationBreakingMode" value="page"/>
+
+* `PaginationMode` (строка, по умолчанию `unpaginated`): допустимые значения `unpaginated`, `leftToRight`, `topToBottom`, `bottomToTop`, и `rightToLeft`. Это свойство определяет является ли содержимое в WebView разбитым на страницы, которые заполняют один экран одновременно, или как представлены один длинный прокручиваемый список. Если установить paginated, это свойство переключает страничный макет содержимого, заставляя WebView использовать значения использования значения PageLength и GapBetweenPages для перерисовки его содержимого.
+
+ <preference name="PaginationMode" value="unpaginated"/>
+
+* `UIWebViewDecelerationSpeed` (строка, по умолчанию `normal` ): допустимые значения `normal`, `fast`. Это свойство контролирует скорость замедления импульса прокрутки. `normal` это скорость по умолчанию для большиства приложений платформы, и `fast` является значением по умолчанию для Mobile Safari.
+
+ <preference name="UIWebViewDecelerationSpeed" value="fast" />
+
+* `ErrorUrl` (строка, не установлено по умолчанию): Если установлено, будет отображать указанную локальную страницу, при ошибке в приложении.
+
+ <preference name="ErrorUrl" value="myErrorPage.html"/>
+
+* `OverrideUserAgent` (строка, не определен по умолчанию): Если параметр установлен, значение заменит старое значение UserAgent для webview. Это полезно для идентификации запроса из приложения/браузера при запросе удаленных страниц. Используйте с осторожностью, в мае этого года вызывает проблемы совместимости с веб-серверами. В большинстве случаев вместо этого параметра используйте AppendUserAgent.
+
+ <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
+
+* `AppendUserAgent` (строка, не задан по умолчанию): Если параметр установлен, значение будет добавляться в конец старого значения UserAgent для webview. При использовании с OverrideUserAgent, это значение будет игнорироваться.
+
+ <preference name="OverrideUserAgent" value="My Browser" />
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/index.md b/docs/ru/5.1.1/guide/platforms/ios/index.md
new file mode 100644
index 0000000..b69c5b7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/index.md
@@ -0,0 +1,212 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы iOS
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova для iOS-устройств, таких как iPhone и iPad. Смотрите ниже для более подробной информации конкретной платформы:
+
+* Конфигурация iOS
+* Обновление для iOS
+* WebViews в iOS
+* Плагины для iOS
+* Руководство по инструментам командной строки iOS
+
+Средства командной строки относятся к версии Cordova до 3.0. Смотрите раздел "Интерфейс командной строки" для информации о текущем интерфейсе интерфейс командной строки.
+
+## Требования и поддержка
+
+Инструменты Apple ®, необходимые для создания приложений iOS, выполняются только в операционной системе OS X на компьютерах Mac на базе Intel. Xcode ® 6.0 (минимальная требуемая версия) работает только на OS X версии 10.9 (Mavericks) или выше и включает в себя iOS 8 SDK (Software Development Kit). Чтобы отправить приложений в Apple App Store℠ требует последние версии инструментария Apple.
+
+Вы можете проверить многие из функций Cordova, используя эмулятор iOS установленный с iOS SDK и Xcode, но вам нужно реальное устройство чтобы полностью проверить все функции приложения перед отправкой его в App Store. Устройство должно иметь установленным по крайней мере iOS 6.x , минимальная версия iOS поддерживаемая начиная с Cordova 3.0. Подерживаемые устройства включают все модели iPad ®, iPhone ® 3GS и выше и iPod ® Touch 3-го поколения или позднее. Для установки приложений на устройство, необходимо также быть членом компании Apple [iOS разработчик программы][1], которая стоит $99 в год. В этом руководстве показано, как развернуть приложения в эмуляторе iOS, для которого не нужно зарегистрироваться в программе developer.
+
+ [1]: https://developer.apple.com/programs/ios/
+
+Инструменты [Ios-sim][2] и [ios-deploy][3] позволяют вам запустить приложение iOS на iOS симуляторе или iOS устройстве из командной строки.
+
+ [2]: https://www.npmjs.org/package/ios-sim
+ [3]: https://www.npmjs.org/package/ios-deploy
+
+## Установите SDK
+
+Существует два способа для загрузки Xcode:
+
+* из [App Store][4], доступных путем поиска «Xcode» в приложении **App Store** .
+
+* от [Apple Developer Downloads][5], который требует регистрации в качестве разработчиков Apple.
+
+ [4]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12
+ [5]: https://developer.apple.com/downloads/index.action
+
+После установки Xcode, некоторые инструменты командной строки должны быть доступны чтобы инструменты Cordova запускались. В меню **Xcode** выберите **Preferences**, а затем вкладку **Downloads** . На панели **Components** нажмите кнопку **Install** рядом с списком **Command Line Tools**.
+
+## Установить средства развертывания
+
+Запустите из терминала командной строки:
+
+ $ npm install -g ios-sim
+ $ npm install -g ios-deploy
+
+
+## Создание нового проекта
+
+Используйте утилиту `cordova` для настройки нового проекта, как описано в разделе "Интерфейс командной строки Cordova". Например выполните в каталоге исходного кода:
+
+ $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add ios
+ $ cordova prepare # or "cordova build"
+
+
+## Развертывание приложения
+
+Для развертывания приложения на подключенном iOS устройстве:
+
+ $ cordova run ios --device
+
+
+Для развертывания приложения на iOS эмуляторе по умолчанию:
+
+ $ cordova emulate ios
+
+
+Можно использовать **cordova run android --list** чтобы увидеть все доступные цели и **cordova run android --target=имя_устройства** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run android --target="Nexus4_emulator"`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+## Откройте проект в SDK
+
+Как только платформа ios добавлена в проект, вы можете открыть его из в Xcode. Дважды щелкните, чтобы открыть файл `hello/platforms/ios/hello.xcodeproj`. Экран должен выглядеть следующим образом:
+
+![][6]
+
+ [6]: img/guide/platforms/ios/helloworld_project.png
+
+## Развертывание на эмулятор
+
+Для предварительного просмотра приложения в эмуляторе iOS:
+
+1. Убедитесь, что на левой панели выбран файл *.xcodeproj* .
+
+2. Выберите приложение **hello** на панели справа.
+
+3. Выберите предполагаемый устройство из меню **схема** панели инструментов, таких как iPhone 6.0 симулятор как подчеркнул здесь:
+
+ ![][7]
+
+4. Нажмите кнопку **Run** , который появляется в панели же для левой части **схемы**. Это строит, развертывает и запускает приложение в эмуляторе. Отдельный эмулятор приложение открывает для отображения приложения:
+
+ ![][8]
+
+ Только один эмулятор может выполняться одновременно, так что если вы хотите протестировать приложение в эмуляторе другой, вам нужно выйти из эмулятора приложения и запускать различные цели в пределах Xcode.
+
+ [7]: img/guide/platforms/ios/select_xcode_scheme.png
+ [8]: img/guide/platforms/ios/HelloWorldStandard.png
+
+Xcode идет с встроенным эмулятором для последних версий iPhone и iPad. Более старые версии могут быть доступны из панели **→ Preferences → Downloads → Components**.
+
+## Развертывание на устройство
+
+Подробные сведения о различных требований для развертывания на устройстве обратитесь к разделу *Настройка развития и распределения ресурсов* документа [Рабочий процесс при использовании инструментов для iOS][9] компании Apple. Вкратце вам нужно выполнить следующие действия перед развертыванием:
+
+ [9]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959
+
+1. Присоединяйтесь к компании Apple iOS разработчик программы.
+
+2. Создайте *профиль подготовки* в [iOS Provisioning портал][10]. Вы можете использовать его *Развития провизионирования помощник* для создания и установки профиля и сертификат Xcode требует.
+
+3. Убедитесь, что раздел *Подписи кода* *Удостоверения подписи кода* в параметры проекта для провизионирования имя профиля.
+
+ [10]: https://developer.apple.com/ios/manage/overview/index.action
+
+Чтобы развернуть на устройстве:
+
+1. Используйте кабель USB, подключите устройство к ваш Mac.
+
+2. Выберите имя проекта в окне Xcode **схема** раскрывающемся списке.
+
+3. Выберите устройство из списка **устройств** . Если он подключен через USB, но по-прежнему не отображается, нажмите кнопку **Организатор** для устранения любых ошибок.
+
+4. Нажмите на кнопку **Run** для построения, развертывания и запуска приложения на вашем устройстве.
+
+## Общие проблемы
+
+**Предупреждение об устаревании**: когда интерфейс программирования приложения (API) изменяется или заменяется другим API, он помечается как *deprecated*. API по-прежнему работает в ближайшем будущем, но со временем удаляется. Некоторые из этих устаревших интерфейсов отражаются в Apache Cordova, и Xcode выдает предупреждения о них, когда вы собираете и развертываете приложение.
+
+Xcode предупреждение о методе `invokeString`, касается функциональности, которая запускает приложение по пользовательскому URL-адресу. В то время как механизм для загрузки из пользовательских URL-адресов изменился, этот код по-прежнему присутствует и предоставлять функциональность обратной совместимости для приложений, созданные с более старыми версиями Cordova. Пример приложения не использует эту функциональность, поэтому эти предупреждения можно игнорировать. Чтобы избежать отображения этих предупреждений, удалите код, который ссылается на устаревшие invokeString API:
+
+* Отредактируйте файл *Classes/MainViewController.m* , окружают следующий блок кода с `/*` и `*/` комментарии, как показано ниже, затем введите **Command-s** , чтобы сохранить файл:
+
+ (void)webViewDidFinishLoad:(UIWebView*)theWebView
+ {
+ // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
+ /*
+ if (self.invokeString) {
+ // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready
+ NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
+ NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
+ [theWebView stringByEvaluatingJavaScriptFromString:jsString];
+ }
+ */
+ // Black base color for background matches the native apps
+ theWebView.backgroundColor = [UIColor blackColor];
+
+ return [super webViewDidFinishLoad:theWebView];
+ }
+
+* Отредактируйте файл *Classes/AppViewDelegate.m* , закомментируйте следующую строку, вставляя двойной косой черты, как показано ниже, а затем введите **Command-s** , чтобы сохранить файл:
+
+ //self.viewController.invokeString = invokeString;
+
+* Нажмите **Command-b** , перестройте проект и устранить эти предупреждения.
+
+<!-- Does this fix only last until the next "cordova prepare"? -->
+
+**Отсутсвующие заголовки**: ошибки компиляции, связанные с недостающими заголовками в результате проблем с расположение сборки и может быть исправлено через настройки Xcode:
+
+1. Выберите **Xcode → настройки → места**.
+
+2. В разделе **Данные** нажмите кнопку **Дополнительно** и выберите **уникальный** как **Расположение сборки** , как показано здесь:
+
+ ![][11]
+
+ [11]: img/guide/platforms/ios/xcode_build_location.png
+
+Это параметр по умолчанию для новой установки Xcode, но он может быть установлен по-другому после обновления старой версии Xcode.
+
+Для получения дополнительной информации обратитесь к документации компании Apple:
+
+* [Начало разработки iOS приложений сегодня][12] предоставляет быстрый обзор шагов для разработки iOS приложения.
+
+* [Член центра Домашняя страница][13] содержит ссылки на несколько iOS технических ресурсов, включая технические ресурсы, подготовки портала, распространения руководств и форумы сообщества.
+
+* [Инструменты рабочего процесса руководства для iOS][9]
+
+* [Руководство пользователя Xcode][14]
+
+* [Видеосессии][15] от Всемирной Конференции Разработчиков Apple 2012 (WWDC2012)
+
+* [Команда xcode-select][16], которая помогает указать правильную версию Xcode, если более чем одна версия установлена.
+
+ [12]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343
+ [13]: https://developer.apple.com/membercenter/index.action
+ [14]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215
+ [15]: https://developer.apple.com/videos/wwdc/2012/
+ [16]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html
+
+(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® и Finder® являются товарными знаками Apple Inc.)
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/plugin.md b/docs/ru/5.1.1/guide/platforms/ios/plugin.md
new file mode 100644
index 0000000..c09cac1
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/plugin.md
@@ -0,0 +1,181 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины для iOS
+
+Этот раздел содержит сведения о том, как реализовать код родной плагин на платформе iOS. Прежде чем читать это, увидеть приложения плагины обзор структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать пример *echo* плагина, который соообщается из WebView Cordova с кодом платформы и в обратную строну.
+
+IOS плагин реализован как Objective-C класс, который расширяет `CDVPlugin` класс. Для JavaScript `exec` метода `service` параметр для сопоставления с Objective-C класс, каждый плагин должен быть зарегистрирован как `<feature>` в каталоге именованного приложения тег `config.xml` файл.
+
+## Сопоставление классов плагина
+
+Часть JavaScript плагин использует `cordova.exec` метод следующим образом:
+
+ Exec (< successFunction >, < failFunction >, < служба >, < действия > [< args >]);
+
+
+Это маршалирует запрос от `UIWebView` в сторону родной iOS эффективно вызова `action` метод `service` класса, с аргументами, переданными в `args` массив.
+
+Укажите плагин как `<feature>` тег в Кордова iOS приложения проекта `config.xml` файл, используя `plugin.xml` файл, чтобы придать этой разметки автоматически, как описано в приложении плагины:
+
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
+
+
+Функция `name` атрибут должен соответствовать указан как JavaScript `exec` вызова `service` параметр. `value`Атрибут должен соответствовать имени плагина Objective-C класса. `<param>`Элемента `name` всегда должно быть `ios-package` . Если не следовать этим рекомендациям, может скомпилировать плагин, но Cordova до сих пор не может быть возможность доступа к ней.
+
+## Инициализация плагин его жизненный цикл
+
+Для жизни каждого из них создается один экземпляр объекта плагин `UIWebView` . Плагины создаются обычно при первом обращении путем вызова из JavaScript. В противном случае они могут быть созданы путем установки `param` с именем `onload` для `true` в `config.xml` файл:
+
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
+
+
+Существует *нет* места для инициализатора для плагинов. Вместо этого следует использовать плагины `pluginInitialize` метод для их запуска логики.
+
+Плагины с долго выполняющихся запросов, фон деятельности, такие как воспроизведение мультимедиа, слушателей или что поддерживать внутреннее состояние следует осуществлять `onReset` метод для очистки этих мероприятий. Метод работает, когда `UIWebView` переходит на новую страницу или обновления, которая перезагружает JavaScript.
+
+## Написание iOS Cordova плагин
+
+Вызов JavaScript запускает запрос плагин к родной стороне, и соответствующие iOS плагин Objective-C отображается правильно в `config.xml` файл, но как окончательный iOS Objective-C модуль класса взгляд? Все, что отправляется в плагин с JavaScript в `exec` функция передается в соответствующий класс плагин `action` метод. Метод плагин имеет подпись:
+
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+
+Для более подробной информации, см. `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)` , `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)` , и`[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)`.
+
+## iOS CDVPluginResult типы сообщений
+
+Вы можете использовать `CDVPluginResult` для возвращения различных результата типа обратно в обратных вызовов JavaScript, с помощью методов класса, следовать этой схеме:
+
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
+
+
+Вы можете создать `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` , и `Multipart` типов. Вы можете также оставить вне каких-либо аргументов, чтобы отправить статус, или возвращает ошибку, или даже не решили отправить любой плагин результат, в этом случае срабатывает ни обратного вызова.
+
+Обратите внимание на следующие для сложных возвращаемых значений:
+
+* `messageAsArrayBuffer`ожидает `NSData*` и преобразует `ArrayBuffer` в обратного вызова JavaScript. Кроме того, любой `ArrayBuffer` отправляет плагин JavaScript преобразуются в`NSData*`.
+
+* `messageAsMultipart`ожидает `NSArray*` содержащие любые другие поддерживаемые типы и отправляет весь массив как `arguments` для обратного вызова JavaScript. Таким образом, все аргументы сериализуются и десериализуются как необходимости, так что это безопасно вернуться `NSData*` как составной, а не как `Array` /`Dictionary`.
+
+## Эхо iOS плагин пример
+
+Для сопоставления интерфейса JavaScript функция *echo*, описанная в разделе "Плагины приложения", используйте `plugin.xml` для вставки спецификации `feature` в файл `config.xml` платформы:
+
+ <platform name="ios">
+ <config-file target="config.xml" parent="/*">
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
+ </config-file>
+ </platform>
+
+
+Тогда мы хотели бы добавить следующие `Echo.h` и `Echo.m` файлы в `Plugins` папку в каталоге приложений Cordova-iOS:
+
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDV.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
+
+
+Необходимого импорта в верхней части файла расширяет класс от `CDVPlugin` . В этом случае плагин поддерживает только один `echo` действий. Он получает эхо строку путем вызова `objectAtIndex` метод получить первый параметр `arguments` массив, который соответствует аргументам, принятому JavaScript в `exec()` функции.
+
+Он проверяет параметр, чтобы убедиться, что это не `nil` или является пустой строкой, возвращая `PluginResult` с `ERROR` статус, если это так. Если параметр проходит проверку, он возвращает `PluginResult` с `OK` статус, проходя в оригинале `echo` строка. Наконец, он отправляет результат `self.commandDelegate` , которая выполняет `exec` метода успех или неудача обратные вызовы на стороне JavaScript. Если успех обратного вызова вызывается, он проходит в `echo` параметр.
+
+## iOS интеграции
+
+`CDVPlugin`Класса есть другие методы, которые можно переопределить ваш плагин. Например, вы можете захватить `pause` , `resume` , прервать app и `handleOpenURL` события. См [CDVPlugin.h][1] и [CDVPlugin.m][2] для руководства.
+
+ [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h
+ [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m
+
+## Работа с потоками
+
+Плагин методы обычно выполняются в том же потоке, что основной интерфейс. Если ваш плагин требует большой обработки или требует блокирующий вызов, вам следует использовать фоновый поток. Например:
+
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }];
+ }
+
+
+## Отладка iOS плагины
+
+Для отладки на стороне Objective-C, требуется встроенный отладчик Xcode's. Для JavaScript на iOS 5.0 или позднее можно использовать [Weinre, проект Apache Cordova][3], или [iWebInspector, сторонняя утилита][4]. Для iOS 8 вы можете подключиться через Safari 8.0 к приложению которое работает в симуляторе iOS 8.
+
+ [3]: https://github.com/apache/cordova-weinre
+ [4]: http://www.iwebinspector.com/
+
+## Наиболее распространенные ошибки
+
+* Не забудьте добавить ваш плагин сопоставление `config.xml` . Если вы забыли, ошибка регистрируется в консоли Xcode.
+
+* Не забудьте добавить любые узлы, при подключении к в белый список, как описано в "Инструкция по доступу к внешним ресурсам". Если вы забыли, ошибка регистрируется в консоли Xcode.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/tools.md b/docs/ru/5.1.1/guide/platforms/ios/tools.md
new file mode 100644
index 0000000..6d3864f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/tools.md
@@ -0,0 +1,93 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по инструментам командной строки iOS
+
+В этом руководстве показано, как использовать Кордова в набор инструментов по центру платформы shell для разработки приложений для iOS. Этот путь разработки, описанный в разделе "Введение", может предложить вам больший спектр вариантов разработки чем кросс платформенный инструмент CLI, описанные в разделе "Интерфейс командной строки". Например вам нужно использовать инструменты оболочки при развертывании настраиваемого Cordova WebView наряду с собственными компонентами. Перед тем как использовать какой то путь разработки, сначала необходимо настроить среду SDK, как описано в разделе "Руководство для платформы iOS". Эти инструменты полагаются на командной строки средства Xcode таких как `xcode-select` и`xcodebuild`.
+
+Чтобы включить инструменты оболочки для iOS, скачайте Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните каждый вы хотите настроить таргетинг, `ios` в данном случае. Соответствующие инструменты обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться файл **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Эти инструменты позволяют создавать, строить и запускать приложения для iOS. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.
+
+## Создание проекта
+
+Запустите команду `create`, указав существующий путь к проекту, идентификатор пакета в стиле обратного формата доменных имен и отображаемое имя приложения.
+
+ $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
+
+
+## Построение проекта
+
+ $ /path/to/my_new_project/cordova/build
+
+
+## Запустить приложение на эмуляторе
+
+ $ /path/to/my_new_project/cordova/run --emulator
+
+
+## Запуск приложения на устройстве
+
+ $ /path/to/my_new_project/cordova/run --device
+
+
+## Подпись приложения
+
+Вы можете узнать больше о подписании, распространение приложений для iOS, создание сертификата и подготовке профиля на сайте [Библиотека разработчика iOS][2].
+
+ [2]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/ConfiguringYourApp/ConfiguringYourApp.html
+
+Чтобы подписать приложение в Cordova, вам необходимо следующее:
+
+* Подпись кода (`--codeSignIdentity`): [С помощью XCode](https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html#//apple_ref/doc/uid/TP40012582-CH31-SW6) можно создать новую подпись iOS, и добавить ее в Вашу связку ключей. Тип подписи кода - как правило распространение или разработка, должны быть определены здесь.
+
+* Профиль подготовки (`--provisioningProfile`): [Используя Apple Member Center][4] вы можете создать профиль подготовки. Скачать профиль подготовки на компьютер и запустить его в XCode чтобы его зарегистрировать. Он копируется в это расположение на вашем Mac: ~/Library/MobileDevice/Provisioning\ Profiles/. При его открытии в текстовом редакторе, вы можете найти идентификатор UUID, который должен быть указан здесь.
+
+* Правила ресурсов для подписывания кода (`--codeSignResourceRules`) (необязательно): позволяет указать пользовательские правила подписания ресурсов.
+
+ [4]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW61
+
+Эти параметры могут быть заданы с помощью аргументов командной строки указанных выше для `построения` или `запуска` скриптов:
+
+ $ /path/to/my_new_project/cordova/build --codeSignIdentitiy="iPhone Distribtion" --provisioningProfile="926c2bd6-8de9-4c2f-8407-1016d2d12954"
+
+
+Кроме того их можно указать в файле конфигурации сборки (build.json) с помощью аргумента (`--buildConfig`). Ниже приведен пример файла конфигурации построения:
+
+ {
+ "ios": {
+ "debug": {
+ "codeSignIdentitiy": "iPhone Development",
+ "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
+ },
+ "release": {
+ "codeSignIdentitiy": "iPhone Distribution"
+ "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
+ }
+ }
+ }
+
+
+Существует также поддержка смешивания и комбинирования аргументов командной строки и параметров в файле build.json. Значения из аргументов командной строки будет получить приоритет.
+
+## Ведение журнала
+
+ $ /path/to/my_new_project/cordova/log
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/upgrade.md b/docs/ru/5.1.1/guide/platforms/ios/upgrade.md
new file mode 100644
index 0000000..5b851da
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/upgrade.md
@@ -0,0 +1,797 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление для iOS
+
+В этом руководстве показано, как изменить проекты iOS для обновления старых версий Кордова. Большинство из этих инструкций применяются для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+**Примечание**: требуется Xcode 6. В настоящее время чтобы опубликовать приложение в Apple App Store, вы должны использовать последнюю версию iOS SDK, на данный момент iOS 8 которая включается только с Xcode 6.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запустите `cordova platform update ios` в ваших проектах.
+
+## Обновление проектов с 3.3.0 до 3.4.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.2.0 до 3.3.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.1.0 до 3.2.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+## Обновление проектов с 3.0.0 до 3.1.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекта
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update ios`
+
+Проблемы iOS 7:
+
+1. Удалите `width=device-width, height=device-height` из содержащегося в файле `index.html` `viewport` `meta` тега. (См. [соответствующую ошибку][1].)
+
+2. Обновите ваши media, media-capture и splashscreen плагины для поддержки iOS 7.
+
+ [1]: https://issues.apache.org/jira/browse/CB-4323
+
+Проблемы Xcode 5:
+
+1. Обновите параметры проекта, если Xcode 5 предлагает вам сделать это (в Issues Navigator).
+
+2. Обновите настройки **Compiler for C/C++/Objective-C**, в вкладке **Build Settings**, раздел **Build Options**. Выберите **Default compiler (Apple LLVM 5.0)**.
+
+## Обновление до CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваши платформы в проект Cordova, например: `cordova
+platform add ios`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или перезапишите любые платформо-специфичные ресурсы из вашего оригинального проекта (`Resources`, и т.д.), убедитесь что любые новые файлы добавлены в `.xcodeproj` проект. Проект iOS собирается в каталоге `platforms\ios`.
+
+5. Скопируйте файл `config.xml` в папку `www` и удалите определения любых плагинов. Измените настройки здесь, а не в каталоге платформы.
+
+6. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+7. Построение и тестирование.
+
+## Обновление проектов с 2.9.0 до 3.0.0
+
+1. Загрузите и распакуйте исходный код Cordova 3.0.0 в постоянное место на вашем жестком диске, например в `~/Cordova-3.0.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в `www` каталог и удалить `www/cordova.js` файл.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+**Примечание**: начиная с Cordova 3.0.0, плагины изначально не установлены плагины, и вам нужно использовать утилиту командной строки `plugman` для их установки. Смотрите раздел "Использование Plugman для управления расширениями".
+
+## Обновление проектов 2.8.0 до 2.9.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.9.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Копия `www/cordova.js` (Обратите внимание, что он не имеет суффикса версии больше, версия в сам файл в заголовке) файл из нового проекта в `www` каталог и удалить `www/cordova.js` файл.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+## Обновление проектов 2.7.0 до 2.8.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.8.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova.js` (Обратите внимание, что он больше не имеет суффикса версии, версия в самом заголовке файла) из нового проекта в папку `www` и удалить файл `www/cordova-2.7.0.js` .
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Обновите любые теги `<plugin>` в файле `config.xml` на теги `<feature>`. Обратите внимание, что существующие теги `<plugin>` по-прежнему будут работать, но являются устаревшими. Вы можете скопировать эту информацию в файл `config.xml` для нового проекта. Например:
+
+ <plugins>
+ <plugin name="LocalStorage" value="CDVLocalStorage" />
+ <!-- other plugins -->
+ </plugins>
+
+ <!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
+ <!-- other <feature> tags -->
+
+8. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+9. Добавьте эти два фреймворка в проект:
+
+ OpenAL
+ ImageIO
+
+10. Обновите для цели построения вашего проекта **Build Settings**. В разделе **Linking → Other Linker Flags**, измените **"-Obj-C"** на **"-ObjC"**.
+
+11. Обновите для цели построения вашего проекта **Build Settings**. В разделе **Linking → Other Linker Flags**, измените **"-all_load"** на `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a`. Вам только нужно будет это сделать, если у вас есть проблемы, определенные в [этом запросе.][2].
+
+ [2]: https://issues.apache.org/jira/browse/CB-3458
+
+## Обновление проектов 2.6.0 до 2.7.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.7.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.6.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][3]).
+
+8. В файле `config.xml`, [удалите эту строку][4].
+
+9. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [3]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=5c05ac80e056753c0e8736f887ba9f28d5b0774c;hp=623ad8ec3c46f656ea18c6c3a190d650dd64e479;hb=c6e71147386d4ad94b07428952d1aae0a9cbf3f5;hpb=c017fda8af00375a453cf27cfc488647972e9a23
+ [4]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=537705d76a5ef6bc5e57a8ebfcab78c02bb4110b;hp=8889726d9a8f8c530fe1371c56d858c34552992a;hb=064239b7b5fa9a867144cf1ee8b2fb798ce1f988;hpb=c9f233250d4b800f3412eeded811daaafb17b2cc
+
+## Обновление проектов 2.5.0 до 2.6.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.6.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.6.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.6.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.5.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.6.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][5]).
+
+8. В файле `config.xml`, [добавьте эту новую строку][6].
+
+9. В файле `config.xml`, [добавьте эту новую строку][7].
+
+10. В файле `config.xml`, [UIWebViewBounce был изменен на DisallowOverscroll, и значения по умолчанию отличаются][8].
+
+11. В файле `config.xml` параметр `EnableLocation` является устаревшим.
+
+12. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [5]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=124a56bb4f361e95616f44d6d6f5a96ffa439b60;hp=318f79326176be8f16ebc93bad85dd745f4205b6;hb=a28c7712810a63396e9f32fa4eb94fe3f8b93985;hpb=36acdf55e4cab52802d73764c8a4b5b42cf18ef9
+ [6]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=1555b5e81de326a07efe0bccaa5f5e2326b07a9a;hp=0652d60f8d35ac13c825c572dca6ed01fea4a540;hb=95f16a6dc252db0299b8e2bb53797995b1e39aa1;hpb=a2de90b8f5f5f68bd9520bcbbb9afa3ac409b96d
+ [7]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=d307827b7e67301171a913417fb10003d43ce39d;hp=04260aa9786d6d74ab20a07c86d7e8b34e31968c;hb=97b89edfae3527828c0ca6bb2f6d58d9ded95188;hpb=942d33c8e7174a5766029ea1232ba2e0df745c3f
+ [8]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=8889726d9a8f8c530fe1371c56d858c34552992a;hp=d307827b7e67301171a913417fb10003d43ce39d;hb=57982de638a4dce6ae130a26662591741b065f00;hpb=ec411f18309d577b4debefd9a2f085ba719701d5
+
+## Обновление проектов 2.4.0 до 2.5.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.5.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.5.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.5.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.4.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.5.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][9]).
+
+8. В файле `config.xml`, [добавьте эту строки][10].
+
+9. В файле `config.xml` , [измените корневой элемент, изменить его с cordova на widget][11].
+
+10. В файле `config.xml`, [удалите параметры OpenAllWhitelistURLsInWebView][12].
+
+11. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.5.0 это обновит скрипты.
+
+12. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+ [9]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=318f79326176be8f16ebc93bad85dd745f4205b6;hp=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hb=4001ae13fcb1fcbe73168327630fbc0ce44703d0;hpb=299a324e8c30065fc4511c1fe59c6515d4842f09
+ [10]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=903944c4b1e58575295c820e154be2f5f09e6314;hp=721c734120b13004a4a543ee25f4287e541f34be;hb=ae467249b4a256bd31ee89aea7a06f4f2316b8ac;hpb=9e39f7ef8096fb15b38121ab0e245a3a958d9cbb
+ [11]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=64e71636f5dd79fa0978a97b9ff5aa3860a493f5;hp=d8579352dfb21c14e5748e09b2cf3f4396450163;hb=0e711f8d09377a7ac10ff6be4ec17d22cdbee88d;hpb=57c3c082ed9be41c0588d0d63a1d2bfcd2ed878c
+ [12]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=721c734120b13004a4a543ee25f4287e541f34be;hp=7d67508b70914aa921a16e79f79c00512502a8b6;hb=187bf21b308551bfb4b98b1a5e11edf04f699791;hpb=03b8854bdf039bcefbe0212db937abd81ac675e4
+
+## Обновление проектов 2.3.0 до 2.4.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.4.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.4.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.4.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.3.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.4.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][13]).
+
+8. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта (см. [этот diff][14]).
+
+9. В файле `config.xml`, [добавьте эту новую строку][15].
+
+10. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.4.0 это обновит скрипты.
+
+11. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+12. Добавьте AssetsLibrary.framework как ресурс в ваш проект. (См. [документацию Apple][16] для получения инструкций о том, как это сделать.).
+
+ [13]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/MainViewController.m;h=5f9eeac15c2437cd02a6eb5835b48374e9b94100;hp=89da1082d06ba5e5d0dffc5b2e75a3a06d5c2aa6;hb=b4a2e4ae0445ba7aec788090dce9b822d67edfd8;hpb=a484850f4610e73c7b20cd429a7794ba829ec997
+ [14]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hp=1ca3dafeb354c4442b7e149da4f281675aa6b740;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [15]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=7d67508b70914aa921a16e79f79c00512502a8b6;hp=337d38da6f40c7432b0bce05aa3281d797eec40a;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d
+ [16]: https://developer.apple.com/library/ios/#recipes/xcode_help-project_editor/Articles/AddingaLibrarytoaTarget.html
+
+## Обновление проектов 2.2.0 до 2.3.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.3.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.3.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.3.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.2.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.3.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта.
+
+8. Удалить каталог `cordova` и скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта. В 2.3.0 это обновит скрипты.
+
+9. Удалить `CordovaLib` каталог и копию `CordovaLib` каталог из нового проекта в корневой директории вашего проекта.
+
+10. Преобразуйте файл `Cordova.plist` в файл `config.xml`, запустив сценарий `bin/cordova\_plist\_to\_config\_xml` на вашем файле проекта.
+
+11. Добавьте плагин InAppBrowser в `config.xml`, путем добавления этого тега в `cordova>< plugins><`:
+
+ <plugin name="InAppBrowser" value="CDVInAppBrowser" />
+
+12. Обратите внимание, что плагины Objective-C, более *не* whitelisted. Чтобы разрешить ваши соединения с помощью списка разрешенных ресурсов приложение, вам нужно задать заголовок `User-Agent` для соединения таким же как пользовательский агент у основного Cordova WebView. Вы можете получить это, обратившись к свойство `userAgent` основного контроллера представления. Основной контроллер представления (`CDVViewController`) также имеет метод `URLisAllowed` который позволяет вам проверить, прошел ли URL-адрес ограничения списка разрешенных ресурсов.
+
+13. Изменения API устройства:
+
+ * Для iOS, device.platform использовалась для возвращения `iPhone`, `iPad` или `iPod Touch`; Теперь она возвращает (правильно) `iOS`.
+ * Для iOS, device.name (являющееся устаревшим для всех платформ) используется для возвращения имени устройства пользователя (например, ‘Shazron’s iPhone 5′); сейчас это свойство возвращает тоже что должен возвращать device.platform: `iPhone`, `iPad` или `iPod Touch`.
+ * Для всех платформ, существует новое свойство под названием device.model; оно возвращает определенную модель устройства , например `iPad2,5` (для других платформ, это свойство возвращает то что должно возвращать свойство device.name).
+
+## Обновление проектов 2.1.0 до 2.2.0
+
+1. Загрузите и распакуйте исходный код Cordova 2.2.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.2.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.2.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.1.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.2.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта:
+
+ * Updated → viewWillAppear
+
+8. Скопируйте каталог `cordova` из нового проекта в корневую папку вашего проекта. В 2.2.0 она имеет обновленный сценарий 'emulate'.
+
+9. Далее обновите ссылку проекта `CordovaLib` . Начиная с Cordova 2.1.0, мы не используем больше переменную Xcode CORDOVALIB для указания где находится `CordovaLib` , ссылка теперь является абсолютной ссылкой.
+
+ 1. Запустите Terminal.app
+ 2. Перейдите к папке, где установлена Cordova (см. шаг 1), в подкаталог `bin`
+ 3. Запустите сценарий указанный ниже, где первым параметром является путь к файлу проекта `.xcodeproj` :
+
+ `update_cordova_subproject path/to/your/project/xcodeproj`
+
+**Примечание**: В 2.2.0, сценарий `bin/create` копирует в подпапку `CordovaLib` проекта. Чтобы иметь тот же тип установки, просто скопируйте корректный `CordovaLib` в каталог проекта и обновить местоположение проекта `CordovaLib` (относительно проекта) в инспекторе файлов Xcode.
+
+## Обновление проектов 2.0.0 до 2.1.0
+
+С Cordova 2.1.0 проект `CordovaLib` был обновлен для использования **Автоматического подсчета ссылок (ARC)**. Вам не нужно обновление до **ARC** для использования CordovaLib, но если вы хотите обновить проект для использования **ARC**, пожалуйста используйте мастер миграции Xcode из меню: **Edit → Refactor → Convert to Objective-C ARC...**, снимите флажок libCordova.a, а затем запустите мастер для завершения.
+
+1. Загрузите и распакуйте исходный код Cordova 2.1.0 в постоянное место на вашем жестком диске, например в `~/Cordova-2.1.0`.
+
+2. Если оно выполняется, закройте Xcode.
+
+3. С помощью Terminal.app, перейдите в каталог, где вы положили загруженных исходных выше.
+
+4. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+5. Скопируйте файл `www/cordova-2.1.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-2.0.0.js`.
+
+6. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.1.0.js`.
+
+7. Обновите (или замените, если вы никогда не изменяли файл) файл `AppDelegate.m` в соотвествии такому же файлу из нового проекта:
+
+ * Edited → application:didFinishLaunchingWithOptions:
+ * Added → application:supportedInterfaceOrientationsForWindow:
+
+8. Обновите (или замените, если вы никогда не изменяли файл) файл `MainViewController.m` в соотвествии такому же файлу из нового проекта:
+
+ * Added → viewWillAppear
+
+9. Скопируйте каталог `cordova` из нового проекта в корневой директории вашего проекта. В 2.1.0 этот каталог содержит обновленные скрипты для поддержки пути с пробелами.
+
+10. Удалите ссылки на файл `VERSION` файл из проекта (*не* тот который расположен в `CordovaLib`).
+
+11. Далее обновите ссылку проекта `CordovaLib` . Начиная с Cordova 2.1.0, мы не используем больше переменную Xcode CORDOVALIB для указания где находится `CordovaLib` , ссылка теперь является абсолютной ссылкой.
+
+ 1. Запустите Terminal.app
+ 2. Перейдите к папке, где установлена Cordova (см. шаг 1), в подкаталог `bin`
+ 3. Запустите сценарий указанный ниже, где первым параметром является путь к файлу проекта `.xcodeproj` :
+
+ `update_cordova_subproject path/to/your/project/xcodeproj`
+
+## Обновление проектов с 1.9.0 до 2.0.0
+
+1. Установите Cordova 2.0.0.
+
+2. Создайте новый проект, как описано в разделе "Руководство по инструментам командной строки iOS". Вам нужны будут ресурсы из нового проекта.
+
+3. Скопируйте файл `www/cordova-2.0.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.9.0.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-2.0.0.js`.
+
+5. Скопируйте каталог `cordova` из нового проекта в корневой каталог вашего проекта (если вы хотите средства командной строки для проекта).
+
+6. Добавьте новую запись в разделе `Plugins` в файле `Cordova.plist` , в группе **Supporting Files** . Ключ `Device` и значение `CDVDevice`.
+
+7. Удалите `Cordova.framework`.
+
+8. Удалите `verify.sh` из группы **Supporting Files** .
+
+9. Выберите значок проекта в Project Navigator, выберите **Target** для проекта, а затем выберите вкладку **Build Settings** .
+
+10. Найдите **Preprocessor Macros**, затем удалите все значения **CORDOVA_FRAMEWORK=1**.
+
+11. Найдите каталог `CordovaLib`, который был установлен на ваш жесткий диск, в поддиректории `Documents` в вашей домашней папке.
+
+12. Найдите файл `CordovaLib.xcodeproj` в папке `CordovaLib` , а затем перетащите этот файл в ваш проект. Он должен отображаться как подпроект.
+
+13. Постройте ваш проект, вы должны получить некоторые ошибки, связанные с директивой `#import` .
+
+14. Для ошибок `#import` измените любой импорт в двойных кавычках в следующем стиле:
+
+ #import "CDV.h"
+
+ в стиль, основанный на скобках:
+
+ #import <Cordova/CDV.h>
+
+ и удалите любые `#ifdef` обертки вокруг любого импорта Cordova, они больше не нужны (импорты теперь унифицированы)
+
+15. Снова соберите свой проект, и он более не должен иметь каких-либо ошибок `#import` .
+
+16. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases** .
+
+17. Разверните фазу **Target Dependencies**, а затем выберите **+** кнопку.
+
+18. Выберите цель `CordovaLib` , а затем выберите кнопку **Add** .
+
+19. Разверните первый этап **Link Binary with Libraries** (он уже должен содержать кучу фреймворков), а затем выберите кнопку **+**.
+
+20. Выберите статическую библиотеку `libCordova.a` , а затем выберите кнопку **Add** .
+
+21. Удалите фазу **Run Script** .
+
+22. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+23. Найдите **Other Linker Flags** и добавьте значения **-force_load** **-Obj-С**.
+
+24. Разверните `CordovaLib` под-проект.
+
+25. Найдите файл `VERSION`, перетащите ее в ваш основной проект (мы хотим создать ссылку на него, не копию).
+
+26. Выберите переключатель **Create groups for any added folders**, а затем выберите кнопку **Finish**.
+
+27. Выберите файл `VERSION`, который вы только что перетащили на предыдущем шаге.
+
+28. Нажмите сочетание клавиш **Option-Command-1**, чтобы показать **File Inspector** (или пункт меню **View → Utilities → Show File Inspector**).
+
+29. Выбрать **Relative to CORDOVALIB** в **File Inspector** для раскрывающегося меню для **Location**.
+
+30. Xcode предпочтения **Xcode Preferences → Locations → Derived Data → Advanced...** можно присвоить **Unique**, так что унифицированные заголовки можно будет найти.
+
+31. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+32. Найдите **Header Search Paths**. Для этого параметра, добавьте эти три значения, включая кавычки:
+
+ "$(TARGET_BUILD_DIR)/usr/local/lib/include"
+
+ "$(OBJROOT)/UninstalledProducts/include"
+
+ "$(BUILT_PRODUCTS_DIR)"
+
+33. Найдите **Other Linker Flags**. Для этого параметра, добавьте это значение:
+
+ -weak_framework CoreFoundation
+
+34. Постройте свой проект, это должно скомпилировать и связать **без** вопросов.
+
+35. Выберите проект в раскрывающемся списке **Scheme** , а затем выберите **iPhone 5.1 Simulator**.
+
+36. Выберите кнопку **Run** .
+
+**Примечание**: Если ваш проект не работает как ожидалось в симуляторе, пожалуйста обратите внимание на любые ошибки в журнале консоли Xcode для подсказки.
+
+## Обновление проектов 1.8.x до 1.9.0
+
+1. Установите Cordova 1.9.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.9.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.8.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.9.0.js`.
+
+**Примечание**: 1.9.0 поддерживает новый boolean параметр `Cordova.plist` `BackupWebStorage` . Он включен по умолчанию, поэтому установите его в `значение false,` чтобы отключить его, особенно на iOS 6. Смотреть [Release Notes: Safari and UIKit Section][17]
+
+ [17]: https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html
+
+## Обновление проектов 1.7.0 до 1.8.x
+
+1. Установите Cordova 1.8.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.8.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.7.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.8.0.js`.
+
+Если вы собираетесь использовать Capture API, вам понадобится новые ресурсы для **iPad с retina дисплеем**:
+
+1. Скопируйте элемент `Resources/Capture.bundle` из нового проекта в каталог проекта, перезапишите ваш существующий элемент `Resources/Capture.bundle` .
+
+2. В вашем проекте выберите пункт `Capture.bundle` в навигаторе проекта в Xcode, нажмите клавишу **Delete**, а затем выберите **Remove Reference** в появившемся диалоговом окне.
+
+3. Перетащите новый `Capture.bundle` из шага 1 выше, в навигаторе проекта в Xcode, а затем выберите переключатель **Create groups for any added folders** .
+
+## Обновление проектов 1.6.x до 1.7.0
+
+1. Установите Cordova 1.7.0.
+
+2. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.7.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.6.0.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.7.0.js`.
+
+## Обновление проектов 1.5.0 до 1.6.x
+
+1. Установите Cordova 1.6.1.
+
+2. Сделайте резервную копию файлов `AppDelegate.m`, `AppDelegate.h`, `MainViewController.m`, `MainViewController.h` и `Cordova.plist` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.5.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ Cordova.plist
+
+5. Добавьте в свой проект Xcode все новые файлы `MainViewController` и `AppDelegate` .
+
+6. Скопируйте файл `www/cordova-1.6.0.js` из нового проекта в папке `www` и удалите файл `www/cordova-1.5.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.6.1.js`.
+
+8. Добавьте в проект новый файл `Cordova.plist` . Это необходимо потому, что имена основных служб плагинов должны измениться, чтобы соответствовать тем же службам в Android и BlackBerry, для единого файла Cordova JavaScript (`cordova-js`).
+
+9. Интегрируйте любые настройки, записи **Plugins** и **ExternalHosts**, которые вы имели в вашем **резервном Cordova.plist** в новый `Cordova.plist`.
+
+10. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `AppDelegate.h` и `AppDelegate.m` в новые файлы `AppDelegate` . Любой код `UIWebViewDelegate` или `CDVCommandDelegate` в `AppDelegate.m` должен уйти в `MainViewController.m` (см. закомментированные разделы в этом файле).
+
+11. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `MainViewController.h` и `MainViewController.m` в новые файлы MainViewController.
+
+12. Нажмите на значок проекта в диспетчере структуры проекта, выберите **Project**, а затем выберите вкладку **Build Settings** .
+
+13. Введите **Compiler for C/C++/Objective-C** в поле поиска.
+
+14. Выберите значение **Apple LLVM Compiler 3.1** .
+
+## Обновление проектов 1.4.x до 1.5.0
+
+1. Установите Cordova 1.5.0.
+
+2. Создайте новый проект и запустите его один раз. Вам понадобится некоторые из активов от этого нового проекта.
+
+3. Скопируйте файл `www/cordova-1.5.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.4.x.js`.
+
+4. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `cordova-1.5.0.js`.
+
+5. Найти `PhoneGap.framework` в вашем навигаторе проекта, выберите его.
+
+6. Нажмите кнопку **Delete** и удалить ссылку на `PhoneGap.framework` в диспетчере структуры проекта.
+
+7. Введите сочетание клавиш **Option-Command-A**, это должно открыть выпадающий список для добавления файлов в проект (лист **Add Files...** ). Убедитесь, что выбран переключатель **Created groups for any added folders** .
+
+8. Введите сочетание клавиш **Command-Shift-G** , которая должна открыть другой выпадающий список для вас, чтобы перейти к папке (**Go to the folder:** лист).
+
+9. Введите `/Users/Shared/Cordova/Frameworks/Cordova.framework` в **Go to the folder:** лист, а затем нажмите кнопку **Go** .
+
+10. Нажмите на кнопку **Add** в окне **Add Files...** .
+
+11. Выберите `Cordova.framework` в диспетчере структуры проекта.
+
+12. Введите сочетание клавиш **Option-Command-1** , чтобы открыть **File Inspector**.
+
+13. Выберите **Absolute Path** в **File Inspector** для раскрывающегося меню в **Location**.
+
+14. Введите сочетание клавиш **Option-Command-A**, это должно открыть выпадающий список для добавления файлов в проект (лист **Add Files...** ). Убедитесь, что выбран переключатель **Created groups for any added folders** .
+
+15. Введите сочетание клавиш **Command-Shift-G** , которая должна открыть другой выпадающий список для вас, чтобы перейти к папке (**Go to the folder:** лист).
+
+16. Введите `~/Documents/CordovaLib/Classes/deprecated` в окне **Go to the folder:**, а затем нажмите кнопку **Go** .
+
+17. Нажмите на кнопку **Add** в окне **Add Files...**.
+
+18. В файлах `AppDelegate.h`, `AppDelegate.m`и `MainViewController.h` замените весь блок `#ifdef PHONEGAP_FRAMEWORK` на:
+
+ #import "CDVDeprecated.h"
+
+19. Выберите **значок проекта** в Project Navigator, выберите **Target** проекта, а затем выберите вкладку **Build Phases**.
+
+20. Найдите **Framework Search Paths**.
+
+21. Замените существующее значение на `/Users/Shared/Cordova/Frameworks`.
+
+22. Найдите **Preprocessor Macros**.
+
+23. Для первого (комбинированного) значения, замените значение на **CORDOVA_FRAMEWORK=YES**.
+
+24. Выберите вкладку **Build Phases** .
+
+25. Разверните узел **Run Script**.
+
+26. Замените все вхождения **PhoneGap** на **Cordova**.
+
+27. Найдите файл `PhoneGap.plist` в диспетчере структуры проекта и щелкните на имени файла, для того, чтобы войти в режим редактирования имени.
+
+28. Переименуйте `PhoneGap.plist` в `Cordova.plist`.
+
+29. Щелкните правой кнопкой мыши `Cordova.plist` и выберите **Open As → Source Code**.
+
+30. Нажмите **Option-Command-F**, выберите **Replace** из раскрывающегося списка в верхней левой части окна исходного кода.
+
+31. Введите `com.phonegap` для строки поиска и `org.apache.cordova` для строки замены, а затем нажмите кнопку **Replace All** .
+
+32. Введите **PG** для строки поиска и **CDV** для строки замены, а затем нажмите кнопку **Replace All** .
+
+33. Нажмите **Command-B**, для построения. У вас до сих пор остались устаревшие коды от которых вы можете избавиться в будущем (см. `CDVDeprecated.h`. К примеру, заменить классы в коде, использующие PG* на CDV*).
+
+## Обновление проектов 1.4.0 до 1.4.1
+
+1. Установите Cordova 1.4.1.
+
+2. Сделайте резервную копию `MainViewController.m`.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте файл `MainViewController.m` из нового проекта в каталог проекта 1.4.0на диске, заменив старый файл (сперва сделайте резервное копирования ваших файлов из шага 2 указанного выше).
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Интегрируйте любой код уникальный для конкретного проекта, который вы сохранили в резервной копии `MainViewController.m` в новый файл.
+
+7. Обновление файла `phonegap-1.4.0.js` является необязательным, в JavaScript между 1.4.0 и 1.4.1 ничего не изменилось.
+
+## Обновление проектов с 1.3.0 до 1.4.0
+
+1. Установите Cordova 1.4.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.3.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.4.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.3.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.4.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.2.0 до 1.3.0
+
+1. Установите Cordova 1.3.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.2.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.3.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.2.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.3.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.1.0 до 1.2.0
+
+1. Установите Cordova 1.2.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.1.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.2.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.1.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.2.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 1.0.0 до 1.1.0
+
+1. Установите Cordova 1.1.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 1.0.0 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.1.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-1.0.0.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.1.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
+
+## Обновление проектов с 0.9.6 до 1.0.0
+
+1. Установите Cordova 1.0.0.
+
+2. Сделайте резервную копию `AppDelegate.m` и `AppDelegate.h` в вашем проекте.
+
+3. Создайте новый проект. Вам понадобится некоторые из активов от этого нового проекта.
+
+4. Скопируйте эти файлы из нового проекта в папке проекта 0.9.6 на диске, заменив старые файлы (сперва сделайте резервное копирование файлов из шага 2 указанного выше):
+
+ AppDelegate.h
+ AppDelegate.m
+ MainViewController.h
+ MainViewController.m
+ MainViewController.xib
+
+5. Добавьте файл `MainViewController.m` в ваш проект Xcode.
+
+6. Скопируйте файл `www/phonegap-1.0.0.js` из нового проекта в папке `www` и удалите файл `www/phonegap-0.9.6.js`.
+
+7. Обновите ссылку на скрипт Cordova в `www/index.html` (и любом другом файле который содержит элемент script) чтобы он указывал на новую версию файла `phonegap-1.0.0.js`.
+
+8. Добавьте новую запись под `Plugins` в `PhoneGap.plist` файл. Ключ `com.phonegap.battery` и значение`PGBattery`.
+
+9. Интегрировать любой код конкретного проекта, у вас есть в вашей резервной копии `AppDelegate.h` и `AppDelegate.m` в новой AppDelegate файлы.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ios/webview.md b/docs/ru/5.1.1/guide/platforms/ios/webview.md
new file mode 100644
index 0000000..1b3a13b
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ios/webview.md
@@ -0,0 +1,139 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# WebViews в iOS
+
+В этом руководстве показано, как внедрить компонент WebView Cordova поддержкой в рамках более крупных приложений iOS. Дополнительные сведения о том, как эти компоненты могут взаимодействовать друг с другом смотрите приложение плагины.
+
+Поддержка WebViews для iOS началась с Cordova версии 1.4, с помощью компонента`Cleaver`, для которого шаблон Xcode выступает в качестве эталонной реализации.Кордова 2.0 и более поздних версий поддерживают только реализация на основе подпроекта Кливер.
+
+Эти инструкции требуют по крайней мере Cordova 3.x и Xcode 6.0, совместно с файлом `config.xml` из только что созданного проекта iOS. Вы можете использовать процедуру в разделе "Интерфейс командной строки" можно использовать для создания нового проекта, а затем получить файл `config.xml` в подкаталоге именованного приложения в `platforms/ios`.
+
+Следуя этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачайте его с [cordova.apache.org][1] и распакуйте пакет для iOS.
+
+ [1]: http://cordova.apache.org
+
+## Добавление Cleaver в Xcode проект (подпроект CordovaLib)
+
+1. Если оно выполняется, закройте Xcode.
+
+2. Откройте терминал и перейдите в исходный каталог для iOS Кордова.
+
+3. Копия `config.xml` файла, описанного выше в каталог проекта.
+
+4. Откройте Xcode и использовать Finder для копирования `config.xml` файл в окно своей **Структуры проекта** .
+
+5. Выберите **создать группы для любой дополнительной папки** и нажмите кнопку **Готово**.
+
+6. Используйте Finder для копирования `CordovaLib/CordovaLib.xcodeproj` файл в Xcode в **Диспетчере структуры проекта**
+
+7. Выберите `CordovaLib.xcodeproj` в рамках **проекта навигатор**.
+
+8. Введите сочетание клавиш **Option-Command-1** , чтобы показать **Файл инспектор**.
+
+9. Выберите **относительный группу** в **Инспектора файлов** в раскрывающемся меню для **местоположения**.
+
+10. Выберите **значок проекта** в **Диспетчере структуры проекта**, выберите **Цель**, а затем выберите вкладку **Параметры построения** .
+
+11. Добавить `-force_load` и `-Obj-C` для значения **Другие флаги компоновщика** .
+
+12. Нажмите на **значок проекта** в диспетчере структуры проекта, выберите **Цель**, а затем выберите вкладку **Построение этапов** .
+
+13. Расширять **связь двоичные файлы с библиотеками**.
+
+14. Выберите **+** кнопку и добавьте следующие **рамки**. При необходимости в **Диспетчере структуры проекта**, переместите их в группе **рамки** :
+
+ AssetsLibrary.framework
+ CoreLocation.framework
+ CoreGraphics.framework
+ MobileCoreServices.framework
+
+15. Разверните узел **Целевого объекта зависимостей**, приставки с этим ярлыком, если существует более одного окна.
+
+16. Выберите **+** кнопку и добавить `CordovaLib` создания продукта.
+
+17. Разверните **Двоичные файлы связь с библиотеками**, приставки с этим ярлыком, если существует более одного окна.
+
+18. Выберите **+** кнопку и добавить`libCordova.a`.
+
+19. Задать **Xcode предпочтения → места → полученных данных → передовые...** **уникальным**.
+
+20. Выберите **значок проекта** в диспетчере структуры проекта, выберите ваши **цели**, а затем выберите вкладку **Параметры построения** .
+
+21. Поиск **путей поиска заголовка**. Для этого параметра, добавьте эти три значения ниже, включая котировки:
+
+ "$(TARGET_BUILD_DIR)/usr/local/lib/include"
+ "$(OBJROOT)/UninstalledProducts/include"
+ "$(BUILT_PRODUCTS_DIR)"
+
+ По состоянию на Cordova 2.1.0 `CordovaLib` был обновлен для использования **Автоматического подсчета ссылок (ARC)**. Вам не нужно обновить до **дуги** для использования `CordovaLib` , но если вы хотите обновить проект для использования **дуги**, следует использовать мастер миграции Xcode от **Правка → переделать → преобразовать в Objective-C ARC...** меню, **снимите флажок libCordova.a**, затем запустите мастер до завершения.
+
+## С помощью CDVViewController
+
+1. Добавьте следующий заголовок:
+
+ #import <Cordova/CDVViewController.h>
+
+2. Создайте экземпляр нового `CDVViewController` и сохраните его где-нибудь, например, для свойства класса:
+
+ CDVViewController* viewController = [CDVViewController new];
+
+3. При необходимости задайте `wwwFolderName` свойства, которое по умолчанию равно `www` :
+
+ viewController.wwwFolderName = @"myfolder";
+
+4. При необходимости задайте начальную страницу `config.xml` файла `<content>` тег, либо локальный файл:
+
+ <content src="index.html" />
+
+ .. или удаленный веб-узел:
+
+ <content src="http://apache.org" />
+
+5. При необходимости задайте `useSplashScreen` свойства, которое по умолчанию равно `NO` :
+
+ viewController.useSplashScreen = YES;
+
+6. Задайте **кадр представления**. Всегда установите это как Последнее свойство:
+
+ viewController.view.frame = CGRectMake(0, 0, 320, 480);
+
+7. Добавьте в представление Кливер:
+
+ [myView addSubview:viewController.view];
+
+## Добавление HTML, CSS и JavaScript активы
+
+1. Создайте новый каталог в рамках проекта, `www` например.
+
+2. Поместите HTML, CSS и JavaScript активов в этот каталог.
+
+3. Чтобы скопировать каталог в окне **Навигатора проекта** Xcode используйте Finder.
+
+4. Выберите пункт **создать папку ссылки для любых папок, добавлен**.
+
+5. Установите соответствующие `wwwFolderName` и `startPage` свойства для каталога, вы первоначально создали, или использовать значения по умолчанию (указанный в предыдущем разделе) при создании экземпляра`CDVViewController`.
+
+ /*
+ if you created a folder called 'myfolder' and
+ you want the file 'mypage.html' in it to be
+ the startPage
+ */
+ viewController.wwwFolderName = @"myfolder";
+ viewController.startPage = @"mypage.html"
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/tizen/index.md b/docs/ru/5.1.1/guide/platforms/tizen/index.md
new file mode 100644
index 0000000..6dd945b
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/tizen/index.md
@@ -0,0 +1,115 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Tizen
+
+В этом руководстве описывается, как настроить среду разработки SDK для развертывания приложений Cordova для устройств под управлением операционной системы Tizen.
+
+## Требования и поддержка
+
+Tizen SDK требует Linux Ubuntu 10.04/10.10/11.04/11.10 (32-бит) или Windows XP SP3/7 (32-бит).
+
+Разработчики должны использовать `cordova` утилита в сочетании с Tizen SDK. Смотрите "Интерфейс командной строки" для получения информации, как установить утилиту, добавить проекты, а затем построить и развернуть проект.
+
+## Установите SDK
+
+Скачать Tizen SDK от [tizen.org][1].
+
+ [1]: https://developer.tizen.org/sdk
+
+<!--
+
+- (optional) Install Tizen Cordova template projects: copy the
+ `/templates` directory content into the Tizen Eclipse IDE web
+ templates directory (e.g.:
+ `/home/my_username/tizen-sdk/IDE/Templates/web`).
+
+- __Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates__
+ - Launch Tizen Eclipse IDE
+ - Select __File → New → Tizen Web Project__
+ - Select __User Template__ and __User defined__ items
+ - Select one of the Tizen Cordova template (e.g.: __CordovaBasicTemplate__)
+ - Fill the __Project name__ and its target __Location__
+
+ 
+
+ - Click __Finish__
+
+ 
+
+ - Your project should now appear in the __Project Explorer__ view
+
+-->
+
+## Откройте проект в SDK
+
+1. Запуск Tizen Eclipse IDE.
+
+2. Выберите **файл → импорт → Tizen веб-проекта**:
+
+ ![][2]
+
+3. Нажмите **Далее**.
+
+4. Убедитесь, что **выберите корневой каталог** установлен.
+
+5. Убедитесь, что установлен **копирования проектов в рабочую область** .
+
+6. Нажмите **Обзор** и выберите Cordova Tizen `samples` каталог проекта (такие как `/cordova-basic` ):
+
+ ![][3]
+
+7. Нажмите кнопку **Готово**. Теперь ваш проект должен быть импортированы и появляются в представлении **Обозреватель проектов** :
+
+ ![][4]
+
+ [2]: img/guide/platforms/tizen/import_project.png
+ [3]: img/guide/platforms/tizen/import_widget.png
+ [4]: img/guide/platforms/tizen/project_explorer.png
+
+Чтобы перестроить проект, щелкните правой кнопкой мыши в представлении **Обозреватель проектов** и выберите **Построить проект**:
+
+![][5]
+
+ [5]: img/guide/platforms/tizen/build_project.png
+
+В корневом каталоге проекта должен создать файл пакета виджета, например *hello.wgt* .
+
+## Развертывание на эмулятор
+
+Щелкните правой кнопкой мыши проект в представлении **Project Explorer** и выберите **Запуск как → Tizen симулятор веб-приложения**:
+
+![][6]
+
+ [6]: img/guide/platforms/tizen/runas_web_sim_app.png
+
+## Развертывание на устройство
+
+* Убедитесь, что целевое устройство должным образом начали, подключено и настроено. Необходимо правильно задать его параметры **даты и времени** .
+
+* Выберите цель развертывания приложения с помощью **Connection Explorer** представления: **окна → Показать вид → Connection Explorer**.
+
+ ![][7]
+
+* Щелкните правой кнопкой мыши проект в представлении **Обозреватель проектов** , а затем выберите **запустить → Tizen веб-приложения**:
+
+ ![][8]
+
+ [7]: img/guide/platforms/tizen/connection_explorer.png
+ [8]: img/guide/platforms/tizen/runas_web_app.png
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/ubuntu/index.md b/docs/ru/5.1.1/guide/platforms/ubuntu/index.md
new file mode 100644
index 0000000..c54f61b
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/ubuntu/index.md
@@ -0,0 +1,94 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Ubuntu
+
+## Первоначальный релиз
+
+Добро пожаловать на первоначального выпуска Ubuntu платформы поддержки в Кордове. С этого выпуска основное внимание уделяется разработке на системе Ubuntu и использование кросс-платформенного рабочего процесса, описанного в разделе "Введение". Это включает в себя добавление платформы Ubuntu для вашего проекта, добавив стандартные плагины Cordova и построение и запуск приложения для платформы Ubuntu.
+
+### Ubuntu SDK
+
+Вы также можете установить среду разработки Ubuntu QtCreator. Смотрите [developer.ubuntu.com][1] для получения дополнительной информации. (QtCreator SDK не требуется для добавления поддержки платформы Ubuntu в приложение Cordova).
+
+ [1]: http://developer.ubuntu.com
+
+### Ubuntu среды выполнения платформы
+
+Ubuntu является хорошо известна своей среды рабочего стола (для ноутбуков, ПК и т.п.). Ubuntu Touch расширяет ОС Ubuntu на телефоны и планшеты. Ubuntu среды выполнения платформы имеют различных Процессорных архитектур (x 86, armhf, и т.д.). Приложения и плагин код должен быть скомпилирован соответствующим образом. Поддержка этой широкой области стремительно развивается в Ubuntu.
+
+### Последняя информация
+
+Для получения последней информации о поддержке приложение Cordova для платформ среды выполнения Ubuntu см [wiki.ubuntu.com/Cordova][2].
+
+ [2]: http://wiki.ubuntu.com/Cordova
+
+## Требования к платформе разработки
+
+Для этого первоначального выпуска платформы разработки должна быть Ubuntu Desktop. Ubuntu 13.10 (кодовое имя 'дерзкий') или более поздней версии требуется для полного набора поддерживаемых возможностей.
+
+Вы можете установить Кордова на не Ubuntu системы (с помощью НПМ), но важных возможностей предоставляются только через Ubuntu debian пакетов на данный момент.
+
+## Установка Кордова
+
+Добавьте в Ubuntu Cordova [Личный архив пакетов][3] Ubuntu системы:
+
+ [3]: https://launchpad.net/~cordova-ubuntu/+archive/ppa
+
+ $ sudo add-apt-repository ppa:cordova-ubuntu/ppa
+ $ sudo apt-get update
+
+
+Установите пакет cordova-cli (и его зависимости):
+
+ $ sudo apt-get install cordova-cli
+
+
+## Проект рабочего процесса
+
+### Создание проекта
+
+Создает приложение в `hello` каталог, чье отображаемое имя `HelloWorld` :
+
+ $ cordova create hello com.example.hello HelloWorld
+
+
+### Перейти в каталог проекта
+
+ $ cd hello
+
+
+### Добавьте платформа Ubuntu
+
+ $ cordova platform add ubuntu
+
+
+### Построить для Ubuntu
+
+ $ cordova build ubuntu
+
+
+### Запуск приложения
+
+ $ cordova run ubuntu
+
+
+### Добавление плагина камеры
+
+ $ cordova plugin add cordova-plugin-camera
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/index.md b/docs/ru/5.1.1/guide/platforms/win8/index.md
new file mode 100644
index 0000000..49fef0a
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/index.md
@@ -0,0 +1,231 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство по платформе Windows
+
+В этом руководстве показано, как настроить среду разработки SDK для создания и развертывания приложений Cordova для Windows 8, Windows 8.1, Windows Phone 8.1 и Платформы универсальных приложений Windows 10. Оно показывает, как использовать либо инструменты командной строки для создания и построения приложения, или кросс платформенный Cordova CLI обсуждаемые в разделе "Интерфейс командной строки". (См. Введение для сравнения этих вариантов развития). В этом разделе также показано, как изменять Cordova приложения в среде Visual Studio. Независимо от того, какой подход вы будете использовать необходимо установить SDK для Visual Studio, как описано ниже.
+
+Смотрите "Обновление для Windows 8" для информации о том, как обновить существующие проекты Windows 8 Cordova.
+
+Window Phone 8 (wp8) остается в качестве отдельной платформы, подробности в "Руководство для платформы Windows Phone 8".
+
+Cordova WebView под управлением ОС Windows полагаются на Internet Explorer 10 (Windows 8.0) и Internet Explorer 11 (Windows 8.1 и Windows Phone 8.1) как их движок рендеринга, так что с практической точки зрения мощный отладчик в IE можно использовать для тестирования любого веб-контента, который не вызвает API Cordova. Блог разработчиков Windows Phone предоставляет [полезные рекомендации][1] о том, как поддержка IE наряду с сопоставимыми WebKit-браузерами.
+
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+## Требования и поддержка
+
+Для разработки приложений для платформы Windows необходимо:
+
+* Windows 8.1, 32 или 64-разрядная машина (*Домашняя*, *Профессиональная*или *Корпортативное* издание) с как минимум 4 ГБ ОЗУ.
+
+* Windows 8.0, 8.1 или 10, 32 или 64-разрядные выпуски версии *Домашней*, *Профессиональной* или *Корпоративной*, вместе с [Visual Studio 2012 Express][2] или Visual Studio 2013. Visual Studio 2015 не позволяет создавать приложений Windows 8.0.
+
+ [2]: http://www.visualstudio.com/downloads
+
+Для разработки приложений для Windows 8.0 и 8.1 (включая Windows Phone 8.1):
+
+* Windows 8.1 или 10, 32 или 64-разрядные выпуски версии *Домашней*, *Профессиональной* или *Корпоративной*, вместе с [Visual Studio 2013][2] или выше. Ознакомительная версия Windows 8.1 Enterprise доступна из [Microsoft Developer Network][3].
+
+* Для эмуляторов Windows Phone, Профессиональная версия Windows 8.1 (x64) или выше и процессор, который поддерживает [клиент Hyper-V и перевода адресов второго уровня (SLAT)][4]. Ознакомительная версия Windows 8.1 Enterprise доступна из [Microsoft Developer Network][3].
+
+* [Visual Studio 2013 для Windows][5] (Экспресс или выше).
+
+ [3]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
+ [4]: https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv
+ [5]: http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8
+
+Для разработки приложений для Windows 10:
+
+* Windows 8.1 или Windows 10 Technical Preview 2, 32 - или 64-бит, вместе с [Visual Studio 2015 RC][6] или выше.
+
+ [6]: http://www.visualstudio.com/preview
+
+Совместимость приложения определяется ОС, на которую направлены приложения. Приложения являются совместимы с новыми версиями, но не обратно совместимы, поэтому приложение нацеленные на Windows 8.1 нельзя запустить на 8.0, но построеные для 8.0 приложения могут выполняться на 8.1.
+
+Следуйте инструкциям на [windowsstore.com][7] для отправки приложения в магазин Windows.
+
+ [7]: http://www.windowsstore.com/
+
+Для разработки Cordova приложения для Windows, вы можете использовать ПК под управлением Windows, но может также разрабатывать на Mac, либо путем запуска в среде виртуальной машины, либо с помощью Boot Camp для двойной загрузки Windows 8.1 раздела. Проконсультируйтесь с этими ресурсами для настройки среды разработки Windows на Mac:
+
+* [VMWare Fusion][8]
+
+* [Parallels Desktop][9]
+
+* [Boot Camp][10]
+
+ [8]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [9]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+ [10]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+## С помощью инструментов Cordova оболочки
+
+Если вы хотите использовать инструменты оболочки Windows в центре Кордовы в сочетании с SDK, у вас есть два основных варианта:
+
+* Доступ к ним локально из кода проекта, созданного CLI. Они доступны в каталоге `platforms/windows/` после добавления платформы `windows` , как описано ниже.
+
+* Скачайте их из отдельного дистрибутива на [cordova.apache.org][11]. Дистрибутив Cordova содержит отдельные архивы для каждой платформы. Убедитесь в том что распаковываете соответствующий архив, `cordova-windows` в этом случае, в пустой каталог. Соответствующие утилиты командной строки доступны в каталоге `package/bin`. (Обратитесь при необходимости к **README** файлу за более подробными инструкциями.)
+
+ [11]: https://www.apache.org/dist/cordova/platforms/
+
+Эти оболочки инструменты позволяют создавать, строить и запускать приложения Windows. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями".
+
+## Установите SDK
+
+Установите любой выпуск [Visual Studio][2] соответствующие требованиям к версии, перечисленным выше.
+
+![][12]
+
+ [12]: img/guide/platforms/win8/win8_installSDK.png
+
+Для 10 Windows установщик Visual Studio имеет возможность установить инструменты для создания универсальных приложений Windows. Необходимо убедиться, что этот параметр выбран при установке чтобы установить требуемый пакет SDK.
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набором инструментов для Windows. Ниже CLI подход создает приложение с именем *HelloWorld* в каталог нового проекта `hello`:
+
+ > cordova create hello com.example.hello HelloWorld
+ > cd hello
+ > cordova platform add windows
+
+
+Вот соответствующий подход используя инструменты командной строки более низкого уровня:
+
+ C:\path\to\cordova-windows\package\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+Этот проект нацелен на Windows 8.1 как целевую ОС по умолчанию. Вы можете выбрать целевой 8.0 или 10.0 (см. "Настройка целевой версии Windows" ниже) для всех сборок, или вы можете ориантироваться на конкретную версию при каждом построении.
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ > cordova build
+ > cordova build windows # do not rebuild other platforms
+ > cordova build windows --debug # generates debugging information
+ > cordova build windows --release # signs the apps for release
+
+
+Вот соответствующий подход используя инструменты командной строки более низкого уровня:
+
+ C:\path\to\project\cordova\build.bat --debug
+ C:\path\to\project\cordova\build.bat --release
+
+
+Команда `clean` помогает очищать каталоги в рамках подготовки к следующей команде `build` :
+
+ C:\path\to\project\cordova\clean.bat
+
+
+## Настройка целевой версии Windows
+
+По умолчанию, команда `build` производит два пакета: Windows 8.0 и 8.1 Windows Phone. Чтобы обновить пакет Windows до версии 8.1 следующие параметры конфигурации должны быть добавлены в файл конфигурации (`config.xml`).
+
+ <preference name="windows-target-version" value="8.1" />
+
+
+После того, как вы добавите этот параметр, команда `build` начнет создавать пакеты Windows 8.1 и 8.1 Windows Phone.
+
+### Параметр --appx
+
+Вы можете решить, что вы хотите построить конкретную версию приложения, ориентированную на конкретную ОС (например, вы могли бы задать что вы хотите ориентироваться на Windows 10, но вы хотите построить для Windows Phone 8.1). Для этого можно использовать параметр `--appx` :
+
+ > cordova build windows -- --appx=8.1-phone
+
+
+Система построения будет игнорировать набор предпочтений в файле config.xml для целевой версии Windows и строго построит пакет для Windows Phone 8.1.
+
+Допустимые значения для флага `--appx` являются `8.1-win`, `8.1-phone`и `uap` (для 10 универсальных приложений Windows). Эти параметры также применяются к команде `cordova run` .
+
+### Соображения по целевой версии Windows
+
+Windows 10 поддерживает новый «Удаленный» режим для приложений Cordova (и приложений HTML в целом). Этот режим позволяет приложениям гораздо больше свободы в использовании DOM манипуляций и общих шаблонов web таких как использование встроенных сценариев, но делает это путем сокращения набора возможностей которых ваше приложение может использовать, когда оно будет опублоковано в Windows Store. Дополнительные сведения о Windows 10 и Удаленном режиме посмотрите в документации [Cordova для Windows 10][13].
+
+ [13]: win10-support.md.html
+
+При использовании удаленного режима, разработчики могут применять политики безопасности содержания (CSP) в своих приложениях для предотвращения атак путем внедрения скриптов.
+
+## Развертывание приложения
+
+Развертывание пакета Windows:
+
+ > cordova run windows -- --win # explicitly specify Windows as deployment target
+ > cordova run windows # `run` uses Windows package by default
+
+
+Развертывание пакета Windows Phone:
+
+ > cordova run windows -- --phone # deploy app to Windows Phone 8.1 emulator
+ > cordova run windows --device -- --phone # deploy app to connected device
+
+
+Можно использовать **cordova run windows --list** чтобы увидеть все доступные цели и **cordova run windows --target=target_name \-- -|-phone** для запуска приложения на конкретном устройстве или эмуляторе (например, `cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone`).
+
+Чтобы увидеть дополнительные параметры построения и запуска также можно использовать **cordova run --help**.
+
+## Откройте проект в SDK и развертывание приложения
+
+После того, как вы построите Cordova-приложение, как описано выше, вы можете открыть его в Visual Studio. Различные команды `build` создют файл решения Visual Studio (*.sln*). Откройте файл в Проводнике, чтобы изменить проект в Visual Studio:
+
+![][14]
+
+ [14]: img/guide/platforms/win8/win8_sdk_openSLN.png
+
+Компонент `CordovaApp` отображается внутри решения, и его каталог `www` содержит исходный код, включая домашнюю страницу `index.html`:
+
+![][15]
+
+ [15]: img/guide/platforms/win8/win8_sdk.png
+
+Элементы управления ниже главного меню Visual Studio позволяют вам тестировать или развертывать приложения:
+
+![][16]
+
+ [16]: img/guide/platforms/win8/win8_sdk_deploy.png
+
+При выбранном пункте **Локальный компьютер** нажмите зеленую стрелку, чтобы установить приложение на том же компьютере где работает Visual Studio. Как только вы сделаете это, приложение появляется в списках приложений Windows 8:
+
+![][17]
+
+ [17]: img/guide/platforms/win8/win8_sdk_runApp.png
+
+Каждый раз, когда вы перестроить приложение, версия доступная в интерфейсе обновляется.
+
+После появления в списке приложений, удерживайте нажатой клавишу **CTRL** это позволяет закрепить приложение на главный экран:
+
+![][18]
+
+ [18]: img/guide/platforms/win8/win8_sdk_runHome.png
+
+Обратите внимание, что если вы открываете приложение в среде виртуальной машины, вам может понадобиться нажать в углах или по бокам окна переключения приложений или получить доступ к дополнительным функциям:
+
+![][19]
+
+ [19]: img/guide/platforms/win8/win8_sdk_run.png
+
+Альтернативно выберите параметр развертывания **Симулятор** для просмотра приложения, как если бы она была установлена на планшетном устройстве:
+
+![][20]
+
+ [20]: img/guide/platforms/win8/win8_sdk_sim.png
+
+В отличие от развертывания на настольные системы этот параметр позволяет имитировать ориентацию планшета, его местоположение и изменять его параметры сети.
+
+**Примечание**: Сверяйтесь с разделом "Введение" для понимания когда использовать инструменты командной строки Cordova а когда инструменты SDK в вашем рабочем процессе. Cordova CLI опирается на кросс платформенной исходный код, который постоянно перезаписывает файлы платформы, используемые SDK. Если вы хотите использовать SDK для изменения проекта, используйте низкоуровневые инструменты командной строки как альтернативу CLI.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/packaging.md b/docs/ru/5.1.1/guide/platforms/win8/packaging.md
new file mode 100644
index 0000000..01e699e
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/packaging.md
@@ -0,0 +1,119 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Упаковка приложений Windows
+
+Вы можете узнать больше о подписании и упаковке приложений для Магазина Windows на [MSDN][1].
+
+Чтобы иметь возможность правильно упаковать и подписать Windows приложения несколько вещей требуется:
+
+ * Сертификат подписи
+ * Параметры идентичности соотвествующие предоставленному сертификату подписи
+
+В проекте Windows данные идентичности хранятся в файле с именем package.appxmanifest. Этот файл автоматически заполняется каждый раз, когда приложение Cordova собирается. Идентичность имеет 3 важных поля.
+
+ * Name
+ * Publisher
+ * Version
+
+*Имя* и *версия* могут быть установлены из **файла config.xml**. *Издатель* может быть предоставлен как параметр построения или может быть установлен на основании **build.json** файла.
+
+
+
+Сертификат подписи может быть предоставлен либо CLI или через файл build.json. Флаги относящиеся к сертификату:
+
+ * `--packageCertificateKeyFile` : после того, как создан сертификат подписи пакета, этот параметр может использоваться для связывания сертификата с приложением. Этот флаг принимает путь к файлу в качестве аргумента. Т.е. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx"`
+ * `--packageThumbprint` : Цифровой отпечаток пакета используется для проверки подлинности файла ключа для сертификата пакета. При создании файла ключа сертификата, это значение будет представляться конечному пользователю. Т.е. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx" --packageThumbprint="ABCABCABCABC123123123123"`
+
+Кроме того, эти значения могут быть указаны, используя файл конфигурации сборки (build.json) с использованием интерфейса CLI (--buildConfig). Пример файла конфигурации построения:
+
+ {
+ "windows": {
+ "debug": {
+ "packageCertificateKeyFile": "platforms\\windows\\CordovaApp_TemporaryKey.pfx"
+ },
+ "release": {
+ "packageCertificateKeyFile": "c:\\path-to-key\\keycert.pfx",
+ "packageThumbprint": "ABCABCABCABC123123123123",
+ "publisherId": "CN=FakeCorp.com, L=Redmond, S=Washington, C=US"
+ }
+ }
+ }
+
+
+Существует также поддержка смешивания и комбинирования аргументов командной строки и параметров в файле build.json. Значения из аргументов командной строки будет получить приоритет.
+
+# Как создать сертификат ключа и подписать Windows приложение Cordova
+
+Для распространения и установки приложений из Магазина Windows требуется подпись. Этот процесс обычно обрабатывается средой Visual Studio при развертывании пакета для выпуска. Сделать это без Visual Studio, нам нужно создать наши собственные сертификаты.
+
+Для создания сертификатов необходимо использовать [makecert.exe][2] утилиту. Этот инструмент поставляется с Windows SDK и могут быть найдены в папке `%ProgramFiles(x86)%\Windows Kits\8.1\bin\x64` или `%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86`.
+
+Первое, что нам нужно сделать, это создать корневой ключ для подписи приложения.
+
+`makecert.exe -n "CN=FakeCorp.com" -r -eku "1.3.6.1.5.5.7.3.3,1.3.6.1.4.1.311.10.3.13" -e "01/01/2020" –h 0 -sv FakeCorp.com.pvk FakeCorp.com.cer`
+
+Чтобы понять, что makecert делает, вот краткое объяснение того, что параметры делать:
+
+ * -n "CN=FakeCorp.com": это [X.509](http://en.wikipedia.org/wiki/X.509) имя субъекта сертификата. В этом примере его **C**ommon**N**ame=FakeCorp.com.
+ * -r: создает [самоподписывающий сертификат](http://en.wikipedia.org/wiki/Self-signed_certificate).
+ * -eku #EKU_VAL #: Разделенный запятыми список OID использующих улучшенный ключ .
+ * 1.3.6.1.5.5.7.3.3 указывает, что сертификат действителен для подписи кода. Всегда указывайте это значение, чтобы ограничить предполагаемое использование сертификата.
+ * 1.3.6.1.4.1.311.10.3.13 указывает, что сертификат уважает время действительности подписания. Как правило если подпись содержит время, если сертификат действовал в момент, когда его время было зафикированно, подпись будет действительна, даже если срок действия сертификата истек. Этот EKU принуждает подпись завершать время действия независимо от того, содержит ли подпись временную метку или нет.
+ * -e "01/01/2020": устанавливает дату окончания срока действия сертификата.
+ * -h 0: устанавливает Макс. высоту дерева ниже этого сертификата до 0, чтобы запретить использование его как Организации сертификации (CA) который может выдавать другие сертификаты.
+ * -sv FakeCorp.com.pvk: Результирующий PVK файл. Windows использует PVK файлы для хранения закрытых ключей для подписи кода.
+ * FakeCorp.com.cer: Выходной файл сертификата. CER-файл используется для хранения сертификата X.509.
+
+После запуска программы makecert в первый раз, появляется экран ввода закрытого пароль:
+
+
+
+После создания файлов pvk и cer, нам нужно создать файл pfx из этих сертификатов. Файл pfx (формат личного обмена) содержит целый ряд криптографической информации, такие как сертификаты, корневые сертификаты удостоверяющей организации, цепочки сертификатов и закрытые ключи. Чтобы упаковать сертификаты, мы будем использовать инструмент под названием [pvk2pfx][3]. Этот инструмент поставляется с Windows SDK и могут быть найдены в папке `%ProgramFiles(x86)%\Windows Kits\8.1\bin\x64` или `%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86`.
+
+`pvk2pfx -pvk FakeCorp.com.pvk -pi pvkPassword -spc FakeCorp.com.cer -pfx FakeCorp.com.pfx -po pfxPassword`
+
+Где:
+
+ * pvk: имя входящего файла pvk
+ * pi: Пароль pvk
+ * spc : Имя входящего файла сертификата
+ * pfx: имя результирующего файла pfx
+ * pо: пароль pfx; такой же, как pvk пароль, если не указан
+
+Если мы предоставляем этот файл pfx файл в build.json, мы получим следующую ошибку: "файл ключа может быть защищен паролем. Чтобы исправить эту проблему, попробуйте вручную импортировать сертификат в хранилище личных сертификатов текущего пользователя.". Для того, чтобы импортировать его мы должны использовать [certutil][4] в командной строке с правами администратора:
+
+`certutil -user -p PASSWORD -importPFX FakeCorp.com.pfx`
+
+Где:
+
+ * user : определяет личное хранилище "текущего пользователя"
+ * p: пароль для PFX-файла
+ * importPfx: имя pfx-файла
+
+После установки, следующим шагом является добавление в build.json packageThumbprint и packageCertificateKeyFile. Для того чтобы найти packageThumbprint, Найдите CommonName которое мы сопоставили с сертификатом:
+
+`powershell -Command " & {dir -path cert:\LocalMachine\My | where { $_.Subject -like \"*FakeCorp.com*\" }}"`
+
+После того, как эти окончательные значения предоставляются. Cordova должна успешно упаковать и подписать приложение.
+
+[1]: https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx
+[2]: https://msdn.microsoft.com/en-us/library/ff548309(v=vs.85).aspx
+[3]: https://msdn.microsoft.com/en-us/library/ff550672(v=vs.85).aspx
+[4]: https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/plugin.md b/docs/ru/5.1.1/guide/platforms/win8/plugin.md
new file mode 100644
index 0000000..15c30d6
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/plugin.md
@@ -0,0 +1,208 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины Windows
+
+Этот раздел содержит сведения о том, как реализовать плагин для использования в приложении Магазин Windows. Прежде чем читать это, увидеть приложения плагины обзор структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать образец *эхо* плагин, который общается с webview Кордова на родной платформе и обратно.
+
+Важно отметить, что Windows поддерживает разработку непосредственно в Javascript, что означает «родной» части в только в особых случаях.
+
+## Создание плагина Windows в JavaScript
+
+Эти инструкции предназначены для создания чистой плагин JavaScript. Понимая это имеет решающее значение для понимания того, как для добавления управляемого/машинного биты.
+
+Кордова Windows плагины являются по существу тонкой оболочкой вокруг существующих WinJS предоставляет функции, но предполагая, что вы хотите определить ваш JS общий интерфейс для нескольких устройств, вы обычно будет иметь 1 JS файл, предоставляющий API.
+
+ // inside file echoplugin.js
+ var EchoPlugin = {
+ // the echo function calls successCallback with the provided text in strInput
+ // if strInput is empty, it will call the errorCallback
+ echo:function(successCallback, errorCallback, strInput) {
+ cordova.exec(successCallback,errorCallback,"EchoPlugin","echo",[strInput]);
+ }
+ }
+
+
+## Внутри Кордова исп на Windows
+
+Функция cordova.exec определена по-разному на каждой платформе, это потому, что каждая платформа имеет его собственный способ общения между js код приложения и код родной оболочки. Но в случае Windows, нет никаких собственную оболочку, поэтому вызов exec существует для обеспечения согласованности. Вашу работу только плагин js непосредственно в EchoPlugin.echo, можно сделать что-то вроде:
+
+ // inside file echoplugin.js ( this is what NOT to do if you want to reuse the JS API cross platform )
+ var EchoPlugin = {
+ echo:function(successCallback,errorCallback,strInput) {
+ if(!strInput || !strInput.length) {
+ errorCallback("Error, something was wrong with the input string. =>" + strInput);
+ }
+ else {
+ successCallback(strInput + "echo");
+ }
+ }
+ }
+
+
+Это будет может работать нормально, однако это означает, что вам понадобится echoPlugin.js разные версии для разных платформ, и возможно вы могли бы проблемы несоответствия в вашей реализации. Как правило мы решили имитировать native API внутри cordova.exec на Windows, так что мы могли бы запустить тот же код JS и не требуется переписывать его на платформе и также воспользоваться любой проверки параметров, или другой общий код, предоставляемых разработчиками, которые работали на других платформах.
+
+## Кордова исп прокси
+
+В Windows cordova предоставляет прокси-сервер, который можно использовать для регистрации объекта, который будет обрабатывать все cordova.exec вызовы API.
+
+Например если вы хотели предоставить реализацию для акселерометра API, вы могли бы сделать это:
+
+cordova.commandProxy.add («Акселерометр», {начало: function() {/ / ваш код здесь...} / /... и на остальной части API здесь});
+
+Так что в нашем случае, мы будем считать что код в echoplugin.js обработки кросс-платформенный соответствующих JavaScript и мы можем просто написать прокси для Windows
+
+ // in file echopluginProxy.js
+ cordova.commandProxy.add("EchoPlugin",{
+ echo:function(successCallback,errorCallback,strInput) {
+ if(!strInput || !strInput.length) {
+ errorCallback("Error, something was wrong with the input string. =>" + strInput);
+ }
+ else {
+ successCallback(strInput + "echo");
+ }
+ }
+ });
+
+
+Определение плагин
+
+Если мы хотим, чтобы пользователи нашего плагина, чтобы иметь возможность легко установить наш плагин, нам нужно будет определить ее согласно как PlugMan определяет плагины. Подробнее об этом в [Спец плагин][1]
+
+ [1]: plugin_ref_spec.md.html#Plugin%20Specification
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="com.risingj.echoplugin"
+ version="0.1.0">
+
+ <js-module src="www/echoplugin.js" name="echoplugin">
+ <clobbers target="window.echoplugin" />
+ </js-module>
+
+ <!-- windows -->
+ <platform name="windows">
+ <js-module src="src/windows/echopluginProxy.js" name="EchoProxy">
+ <merges target="" />
+ </js-module>
+ </platform>
+
+ <!-- other platforms -->
+
+ </plugin>
+
+
+Это дает нам рабочую Windows JavaScript плагин, который использует общий файл (echoplugin.js) и использует прокси-сервер для обеспечения Windows только часть осуществления (echopluginProxy.js). Так как мы добавим управляемого/машинного кода к этому? Ну, мы собираемся начать то же самое, только разница будет, что мы делаем внутри в echopluginProxy методы.
+
+# Как WinJS получает доступ управляемого/машинного кода
+
+В Windows, WinJS, авторские приложения способны взаимодействовать с машинным кодом, это между ОП доступен для компонентов Среда выполнения Windows. Детали, многочисленны, и это руководство будет охватывать только основы. Корпорация Майкрософт предоставляет гораздо больше информации [здесь][2].
+
+ [2]: http://msdn.microsoft.com/en-us/library/windows/apps/hh441569.aspx
+
+Когда вы создаете ваш компонент Среда выполнения Windows, любой класс, который определяется как «общественного ссылочного класса sealed» считается «активируемого класса» и будет можно вызывать из JavaScript.
+
+ // in your header file .h
+ namespace EchoRuntimeComponent
+ {
+ public ref class EchoPluginRT sealed
+ {
+ public:
+ static Platform::String^ Echo(Platform::String^ input);
+ }
+ }
+
+ // in the implementation file .cpp
+ using namespace EchoRuntimeComponent;
+ using namespace Platform;
+
+ Platform::String^ EchoPluginRT::Echo(Platform::String^ input)
+ {
+ if(input->IsEmpty())
+ {
+ return "Error: input string is empty.";
+ }
+ else
+ {
+ return input->ToString() + "echo";
+ }
+ }
+
+
+Теперь, чтобы для нас, чтобы вызывать машинный код, мы используем пространство имен, имя класса и lowerCamelCase метод, который мы называем.
+
+var res = EchoRuntimeComponent.EchoPluginRT.echo("boom"); Переезд это наш файл echopluginProxy.js, мы получаем это:
+
+ // in file echopluginProxy.js
+ cordova.commandProxy.add("EchoPlugin",{
+ echo:function(successCallback,errorCallback,strInput) {
+ var res = EchoRuntimeComponent.EchoPluginRT.echo(strInput);
+ if(res.indexOf("Error") == 0) {
+ errorCallback(res);
+ }
+ else {
+ successCallback(res);
+ }
+ }
+ });
+
+
+И вот это, у нас есть конец в конец при поддержке C++ js вызываемой плагин для использования в Apache Cordova Windows!
+
+# Некоторые технические примечания:
+
+* обратный вызов обычно является асинхронной, так вызовом обратного вызова сразу ожидается, вероятно, не вызывающим. На практике если вызов не async, следует по крайней мере использовать javascript таймаут заставить называться асинхронного обратного вызова.
+* Активируемых классов можно сделать все виды awesome, как событие, диспетчеризации, асинхронных обратных вызовов, передавая собственные типы объектов, массивы, коллекции, перегруженные методы и многое другое. Я рекомендую, что вы делаете вашу домашнюю работу.
+* Если вы будете придерживаться общих Windows Phone 8.0 и вызовы Windows SDK API, вы будете способны использовать один и тот же компонент среды выполнения (машинный или управляемый бит) в Windows Phone 8.0 Apache Cordova плагин. ~ Следите за этот пост.
+
+# Определение ваш плагин
+
+Теперь у нас есть плагин рабочих, нам необходимо пересмотреть определение плагин от ранее, так что мы можем опубликовать его. Теперь мы можем добавить компонент выполнения как основы. Обратите внимание, что тип выходных данных WindowsRuntimeComponent может быть .winmd или DLL
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ id="com.risingj.echoplugin"
+ version="0.2.0">
+
+ <js-module src="www/echoplugin.js" name="echoplugin">
+ <clobbers target="window.echoplugin" />
+ </js-module>
+
+ <!-- windows -->
+ <platform name="windows">
+ <js-module src="src/windows/echopluginProxy.js" name="EchoProxy">
+ <merges target="" />
+ </js-module>
+ <framework src="src/windows/EchoRuntimeComponent.winmd" custom="true"/>
+ </platform>
+
+ <!-- other platforms -->
+
+ </plugin>
+
+
+Вот это, теперь у вас есть распространяемый плагин, что вы можете поделиться со всем миром! Одна вещь к примечанию, лишь недавно была добавлена поддержка для добавления рамок в проект Windows Cordova, так что вам будет нужно убедиться, что ваше cordova инструментов текущем. Кордова cli и Кордова plugman поддерживает добавление, удаление собственных резервных плагины.
+
+\> cordova plugin add com.risingj.echoplugin
+
+или
+
+\> plugman install --platform windows --plugin com.risingj.echoplugin --project .
+
+https://github.com/purplecabbage/cordova-runtimecomp-echoplug
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/tools.md b/docs/ru/5.1.1/guide/platforms/win8/tools.md
new file mode 100644
index 0000000..f98b26a
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/tools.md
@@ -0,0 +1,37 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+
+
+ under the License.
+---
+
+# Средства командной строки Windows 8
+
+`cordova`Утилиты командной строки является высокого уровня инструмент, который позволяет вам создавать приложения сразу на нескольких платформах. Старые версии структуры Cordova предоставляет наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните узел платформы, которую вы хотите цели. Инструменты, описанные здесь обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться с файлом **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневый интерфейс командной строки, который позволяет плагины см с помощью Plugman для управления плагинами. Смотрите приложение плагины обзор.
+
+## ОС Windows 8
+
+Средства командной строки Windows 8 поддерживают только создание новых проектов. Команды должны быть запущены из строки cmd или powershell.
+
+## Создание проекта
+
+Запуск `create` команды со следующими параметрами:
+
+* Путь к вашему новому проекту Cordova Windows 8
+
+* Имя пакета, после обратного домена стиль Конвенции. Это становится по умолчанию пространство имен.
+
+* Название проекта
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/upgrade.md b/docs/ru/5.1.1/guide/platforms/win8/upgrade.md
new file mode 100644
index 0000000..832fa7f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/upgrade.md
@@ -0,0 +1,59 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление для Windows 8
+
+В этом руководстве показано, как изменить проекты Windows 8 для обновления старых версий Кордова. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI.
+
+## Обновление до 4.0.0 с 3.1.0 или позднее
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update windows8`.
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до 3.1.0
+
+Кордова CLI поддержка для Windows 8 была введена в Кордове 3.1.0. Для обновления, мы предлагаем создание новой CLI Cordova проекта и движущихся над всеми необходимыми активами.
+
+## Обновление до 2.9.0 с 2.8.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.8.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
+
+## Обновление до 2.8.0 с 2.7.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.7.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/upgrading.md b/docs/ru/5.1.1/guide/platforms/win8/upgrading.md
new file mode 100644
index 0000000..59a5ba7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/upgrading.md
@@ -0,0 +1,56 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+
+
+ under the License.
+---
+
+# Обновление для Windows 8
+
+В этом руководстве показано, как изменять проекты Windows 8 для обновления старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных с старого набора средств командной строки, которые предшествуют `cordova` утилиты CLI. Увидеть интерфейс командной строки для получения информации как обновить версию инфраструктуры CLI.
+
+## Обновление до 3.2.0 от 3.1.0
+
+Для проектов, которые были созданы с Кордова CLI:
+
+1. Обновление `cordova` CLI-версия. Увидеть интерфейс командной строки.
+
+2. Запуск`cordova platform update windows8`.
+
+Для проектов, не созданных с Кордова CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление до 3.1.0
+
+Кордова CLI поддержка для Windows 8 была введена в Кордове 3.1.0. Для обновления, мы предлагаем создание новой CLI Cordova проекта и движущихся над всеми необходимыми активами.
+
+## Обновление до 2.9.0 с 2.8.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.8.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что этот файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
+
+## Обновление до 2.8.0 с 2.7.0
+
+Следующие команды должно быть сделано из среды Visual Studio чтобы убедиться что обновление/удаляются все ссылки на проект.
+
+1. Удалить `cordova-2.7.0.js` из проекта `www` каталог.
+
+2. Добавить `cordova.js` файл из источника в проект `www` каталог. (Обратите внимание, что файл больше не содержит номер версии в имени файла).
+
+3. Построение и тестирование!
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/win8/win10-support.md b/docs/ru/5.1.1/guide/platforms/win8/win10-support.md
new file mode 100644
index 0000000..5230d83
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/win8/win10-support.md
@@ -0,0 +1,101 @@
+# Cordova для Windows 10
+
+Возможно вы вместо этого названия могли бы назвать продукт «Windows 10 для Cordova». У Windows 10 платформа разработки приложений HTML и JavaScript была переработана чтобы принести поддержку Cordova в Интернет и убрать ограничения безопасности платформы с вашего пути.
+
+## Начало работы с Windows 10
+
+Добавление поддержки Windows 10 в ваше приложение настолько же просто, насколько установка вашего целевой платформы Windows значению 10.0:
+
+ <preference name="windows-target-version" value="10.0" />
+ <preference name="windows-phone-target-version" value="10.0" />
+
+
+Когда вы собираете с обоими этими параметрами, будет построен только один .appx (и .appxupload). Они потребуют как минимум Windows 10.
+
+### Различия между удаленным режимом и локальным режимом
+
+Удаленный режим — Новая возможность платформы HTML приложений для Windows в Windows 10. В Windows 8 и 8.1 HTML-приложения работали способом, что сейчас называется «Локальный режим» в Windows 10. В локальном режиме HTML приложения имеют полный доступ к Windows API и возможностям платформы. Для того, чтобы предотвратить атаки путем внедрения скриптов, которые могут привести к утечки персональной информации благодаря вредоносному коду, локальный режим запрещает встроенные скрипты и требует от разработчиков, которые выполняют манипуляции над DOM, делать это в контексте (`MSApp.execUnsafeLocalFunction`).
+
+Удаленный режим устраняет эти требования, что делает возможным использовать неизмененные библиотеки такие как jQuery или AngularJS непосредственно в вашем коде, без каких-либо изменений. Для этого, он удаляет вашу способность объявлять определенные возможности при сертификации вашего приложения в магазине Windows. Удаление этих возможностей обычно не мешает получать определенные функции, но может потребоваться использовать сочетание различных API или тактик.
+
+### Влияние удаленного режима на возможности
+
+При развертывании удаленного режима приложения в магазин Windows недоступны следующие возможности:
+
+ * Корпоративная аутентификация (`enterpriseAuthentication`)
+ * Общие сертификаты пользователей (`sharedUserCertificates`)
+ * Библиотека документов (`documentsLibrary`)
+ * Музыкальная библиотека (`musicLibrary`)
+ * Библиотека изображений (`picturesLibrary`)
+ * Видео библиотека (`videosLibrary`)
+ * Съемные ЗУ (`removableStorage`)
+ * Интернет клиент/сервер (`internetClientClientServer`) - Обратите внимание, что `internetClient` все еще разрешено
+ * Частная сеть клиент/сервер (`privateNetworkClientServer`)
+
+Ограничения на доступ к библиотеке может быть обойдено если пользователь будет взаимодействовать с файловой системой через средство [Выбора файлов](https://msdn.microsoft.com/en-us/library/windows/apps/windows.storage.pickers.fileopenpicker.aspx). Это предотвращает внедренный вредоносный кода от произвольного доступа к файловой системе.
+
+Ограничения, связанные с работой сети могут быть обойдены, используя интерфейс API, который не использует возможность проверки или промежуточного соединения через стандартные каналы связи Интернет, таких как `XMLHttpRequest` или веб-сокеты.
+
+Возможности корпоративной аутентификации и Общие сертификаты пользователей специально ориентированы на корпоративных сценариях. Эти возможности поддерживаются для частных предприятий с поддержкой магазинов приложений, так что если вы создаете приложения, которые будут развертываться с помощью механизм внутреннего развертывания, вы все еще можете поддержать этот функционал. Однако они не поддерживаются для приложений удаленного режима в общедоступном магазине Windows. Когда вы собираете проект ориентируюясь на Windows 10, если одна из этих возможностей будет обнаружена в манифесте вашего приложения, будет отображаться предупреждение.
+
+## Справка
+
+### Параметры config.xml
+
+#### windows-target-version, windows-phone-target-version
+
+ <preference name="windows-target-version" value="10.0" />
+ <preference name="windows-phone-target-version" value="10.0" />
+
+
+*По крайней мере один параметр требуется.*
+
+Эти параметры определяют версию Windows или Windows Phone которые вы хотели бы использовать как цель для пакета приложения.
+
+**Допустимые значения**
+
+ * `10.0`, `UAP`: собирает для универсальной платформы приложений Windows 10
+ * `8.1`: собирает для Windows 8.1 или Windows Phone 8.1
+ * `8.0`: собирает для Windows 8.0. Не действительно для Windows Phone (используйте платформу Cordova **wp8**)
+
+**Сценарии**
+
+Если вы используете только Windows 10, вам только нужно иметь единственный параметр `windows-target-version` в вашем файле config.xml.
+
+#### WindowsDefaultUriPrefix
+
+ <preference name="WindowsDefaultUriPrefix" value="ms-appx://|ms-appx-web://" />
+
+
+Этот параметр определяет, будет ли ваше приложение работать в **локаьльном контексте** или **удаленном** при запуска его стартового URI. При построении для Windows 10, по умолчанию используется удаленный контекст (`ms-appx-web://`).
+
+Для того, чтобы у создать приложение локального режима, которое не затронуто ограничениями удаленного режима, необходимо установить этому параметру значение `ms-appx://` и не объявлять любые элементы `<access>` с удаленным URI.
+
+**Допустимые значения**
+
+ * `ms-appx://` (По умолчанию для Windows 8.0, 8.1): Начальная страница выполняется в локальном контексте
+ * `ms-appx-web://` (По умолчанию для Windows 10): Начальная страница выполняется в удаленном контексте
+
+#### {SDK}-MinVersion, {SDK}-MaxVersionTested
+
+*Необязательный*
+
+ <preference name="Windows.Universal-MinVersion" value="10.0.0.0" />
+ <preference name="Windows.Mobile-MinVersion" value="10.0.9927.0" />
+ <preference name="Windows.Mobile-MaxVersionTested" value="10.0.10031.0" />
+ <preference name="Microsoft.Band-MinVersion" value="10.0.11.0" />
+
+
+Эти предпочтения определить с какими экосистемами (включая но не ограничиваясь универсальным Windows, Windows Mobile или Xbox) и с какими их минимальные и максимальные версии обеспечивается совместимость. Все еще требуются, чтобы платформы обладали поддержкой платформы универсальных приложений (таким образом Windows 10 в качестве базовой ОС). Однако это может указывать, что приложение осознает особую функциональность, которая может быть доступна только на некоторых устройствах (например, потоковые игры на Xbox).
+
+**Допустимые значения**
+
+Есть три части для каждого значения: **SDK**, **ограничение версии**и **значение версии**. Эти параметры определяются по значениям начинающимся с `Windows` или `Microsoft` и заканчивающимся ан `-MinVersion` или `-MaxVersionTested`:
+
+ * **SDK** определяет на какие специализированные платформы, вы хотите ориентироваться. Значение по умолчанию — `Windows.Universal`. Допустимые значения для них определены в схеме AppxManifest в элементах `Package/Depednencies/TargetPlatform` .
+ * В **ограничении версии** определяются правила совместимости приложений. Например если `-MinVersion` установлено в 10.1.0.0, то те версий ОС, которые не поддерживают по крайней мере версию 10.1.0.0 соответствующего SDK не сможет загрузить его.
+ * `-MinVersion` Указывает минимальную требуемую версию SDK
+ * `-MaxVersionTested` указывает наибольшую версию SDK в которой проводилось тестирование. Если выпущена новая версия соответствующего пакета SDK, он будет работать в режиме совместимости для заданной версии.
+ * **Значение версии** — кортеж из 4-целых чисел в виде *major.minor.build.qfe*.
+
+Если никаких параметров данного типа не указано в файле config.xml, то Windows.Universal версии 10.0.0.0 будет выбрано по умолчанию.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp7/index.md b/docs/ru/5.1.1/guide/platforms/wp7/index.md
new file mode 100644
index 0000000..edc158f
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp7/index.md
@@ -0,0 +1,104 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+
+
+ under the License.
+---
+
+# Руководство по платформы Windows Phone 7
+
+Данное руководство демонстрирует как настроить среду разработки для развертывания приложений на устройствах Windows Phone 7. Приложения также работают на устройствах Windows Phone 8, с помощью интерфейса API, но версия 7 не хватает некоторых IE10 дополнительных функций, доступных в Windows Phone 8. Приложения Windows Phone 8 делать *не* запускаются на устройствах Windows Phone 7.
+
+Смотрите ниже для более подробной информации конкретной платформы, которая применяется для обеих версий:
+
+* Обновление Windows Phone
+* Windows Phone плагины
+* Windows Phone средств командной строки
+
+Средства командной строки относятся к версии до 3.0 Кордова. Смотрите информацию о текущем интерфейсе интерфейс командной строки.
+
+## Системные требования
+
+Использовать Windows 7 или Windows 8 (Pro) или Windows Vista с пакетом обновления 2. 64-Разрядная версия (x 64) Windows требуется для SDK. Pro версия рекомендуется для запуска эмулятора устройства.
+
+Зарегистрироваться и оплатить счет [Центр разработчиков Windows Phone][1] если вы хотите установить приложения на реальном устройстве или представить его на рынке.
+
+ [1]: http://dev.windowsphone.com/en-us/publish
+
+**Примечание**: выполнение пакета SDK в виртуальной машине могут представлять вызовы. Читайте [Windows Phone на Mac][2] для идеи о разработке решений.
+
+ [2]: http://aka.ms/BuildaWP8apponaMac
+
+## Установить SDK и Кордова
+
+Скачать и установить [Windows Phone SDK][3].
+
+ [3]: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/
+
+Загрузите и распакуйте последнюю копию [Кордова][4]. Вам нужно работать `lib\windows-phone-8\wp7` подкаталога, `lib\windows-phone-8\wp8` содержит 8 телефон Windwos версия Кордова.
+
+ [4]: http://phonegap.com/download
+
+Копия `CordovaWP7_x_x_x.zip` файл `\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\` каталог.
+
+## Создание шаблона
+
+**Примечание**: этот шаг пропустить, если `lib\windows-phone` уже содержит каталог `CordovaWP7_x_x_x.zip` файлов.
+
+Для упрощения разработки Cordova расслоения сценарий для создания шаблонов Visual Studio. Они позволяют вам быстро создавать Cordova apps, и при необходимости их можно изменить. Ниже шаги показывают, как создать его.
+
+### Запустите пакетный файл для создания и установки шаблонов
+
+Содержит корень репо `createTemplates.bat` файл. Дважды щелкните этот файл создает два `.zip` файлы: `CordovaWP7_x_x_x.zip` и `CordovaWP8_x_x_x.zip` , где *ххх* — номер текущей версии. Чтобы использовать эти файлы в Visual Studio, скопируйте их в `My Documents\Visual Studio
+2012\Templates\ProjectTemplates\` подкаталога. Вы могл после этого создать новое меню **приложений Apache Cordova Windows Phone_ из Visual Studio __File → новый проект** .
+
+Если вы запустите пакетный файл из командной строки, можно также вызвать с параметром для автоматической установки:
+
+ >createTemplates.bat -install
+
+
+## Создание нового проекта
+
+* Откройте Visual Studio Express для Windows Phone и выберите **Новый проект**.
+
+* Выберите **CordovaWP7**. Версия номер отображается в описании шаблона.
+
+* Присвойте проекту имя и нажмите **OK**.
+
+## Обзор структуры проекта
+
+`www`Каталог функции `html` , `js` , и `css` подкаталоги и любые другие ресурсы требует вашего приложения. Любое дополнительное содержимое должно быть частью проекта Visual Studio, и он должен быть задан как содержание.
+
+Следующий пример структуры представляет собой 2.3.0 проекта, но могут варьироваться в зависимости от установленной версии:
+
+![][5]
+
+ [5]: img/guide/platforms/wp8/projectStructure.png
+
+## Постройте проект для устройства
+
+Перед тестированием приложения на устройстве, устройство должно быть зарегистрировано. Документации [корпорации Майкрософт][6] сведения о том, как развернуть и протестировать на Windows Phone 7. Таковы основные шаги:
+
+ [6]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx
+
+* Убедитесь, что ваш телефон подключен, и экран разблокирован.
+
+* В Visual Studio выберите **устройство** в раскрывающемся меню в верхней.
+
+* Нажмите кнопку зеленый **играть** рядом с главного меню раскрывающегося списка для запуска отладки, или же введите **F5**.
+
+![][7]
+
+ [7]: img/guide/platforms/wp7/wpd.png
+
+На данный момент вы сделали.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/index.md b/docs/ru/5.1.1/guide/platforms/wp8/index.md
new file mode 100644
index 0000000..c059a9e
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/index.md
@@ -0,0 +1,195 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Руководство для платформы Windows Phone 8
+
+В этом руководстве показано, как настроить среду разработки SDK для развертывания приложений Cordova для устройств Windows Phone. Он фокусируется на Windows Phone 8, но дополнительные сведения о том, как поддержка Windows Phone 7.
+
+Оно показывает, как использовать либо инструменты командной строки, специфические для Windows Phone для создания и построения приложения, или кросс платформенный Cordova CLI описываемый в "Интерфейс командной строки". (См. Введение для сравнения этих процессов разработки.) В этом разделе также показано, как открыть приложений Cordova, так что вы можете изменять их в среде Visual Studio. Независимо от того, какой подход вы принимаете вам нужно установить Windows Phone SDK, как описано ниже.
+
+Смотрите следующие детали, характерные для платформы Windows Phone:
+
+* Плагины Windows Phone 8
+* Обновление Windows Phone 8
+
+Для платформы Windows Phone 8 Cordova WebView опирается на Internet Explorer 10 как ее движок, так что с практической точки зрения IE10 мощный отладчик можно использовать для тестирования любого веб-контента, который не вызвать API Cordova. Блог разработчиков Windows Phone предоставляет [полезные рекомендации][1] о том, как поддержать IE10 наряду с сопоставимыми WebKit-браузерами.
+
+ [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx
+
+## Требования и поддержка
+
+Вам потребуется следующее:
+
+* 64-разрядная версия Windows 8 Pro, установочного диска или файла образа диска *ISO* . Ознакомительная версия доступна в [Microsoft Developer Network][2]. Версия Pro является необходимым для запуска эмулятора устройства.
+
+* [Windows Phone SDK][3].
+
+* Чтобы развернуть через командную строку c Windows Phone SDK 8.0, необходимо установить [Visual Studio 2012 Обновление 2][4] .
+
+ [2]: http://msdn.microsoft.com/en-US/evalcenter/jj554510
+ [3]: http://www.microsoft.com/en-us/download/details.aspx?id=35471
+ [4]: https://support.microsoft.com/en-us/kb/2797912
+
+Для разработки приложений Cordova под устройства Windows Phone, вы можете использовать ПК под управлением Windows, или вы также можете разрабатывать на Mac, путем запуска всего в виртуальной машине, либо с помощью Boot Camp для загрузки из Windows раздела. Проконсультируйтесь с этими ресурсами для настройки среды разработки Windows на Mac:
+
+* **VMWare Fusion**: для установки виртуальной машины Windows 8, выполните инструкции, предоставляемые [Microsoft Developer Network][5], затем смотрите "Настройка VMWare Fusion" для получения информации о подготовке виртуальной среды для запуска эмулятора, поставляемого в комплекте с SDK.
+
+* **Parallels Desktop**: для установки виртуальной машины Windows 8, выполните инструкции, предоставляемые [Microsoft Developer Network][6], затем смотрите "Настройка Parallels Desktop" для получения информации о подготовке виртуальной среды для запуска эмулятора, поставляемого в комплекте с SDK.
+
+ [5]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+ [6]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+<!--
+- __VirtualBox__: To set up the Windows 8 virtual machine, follow the
+ installation instructions provided by the [Microsoft Developer
+ Network](http://msdn.microsoft.com/en-US/library/windows/apps/jj945425).
+
+ 2DO: virtualBox doesn't work yet; any extra config info?
+-->
+
+* **Boot Camp**: чтобы настроить раздел Windows 8, следуйте инструкциям по установке, представленной в [Microsoft Developer Network][7].
+
+ [7]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423
+
+Если вы разрабатываете на ПК, его процессор должен поддерживать Виртуализация (*VT-x* на Intel) и [Перевода адресов второго уровня (SLAT)][8]. Обратитесь к [Intel список процессоров][9]. Виртуализация обычно отключена по умолчанию, поэтому необходимо включить в настройках BIOS. ПК должен иметь по крайней мере 6,5 ГБ свободного дискового пространства и 4 ГБ оперативной памяти.
+
+ [8]: http://en.wikipedia.org/wiki/Second_Level_Address_Translation
+ [9]: http://ark.intel.com/Products/VirtualizationTechnology
+
+## С помощью инструментов Cordova оболочки
+
+Если вы хотите использовать инструменты Windows Phone-центру оболочки Cordova вместе с SDK, у вас есть два основных варианта:
+
+* Доступ к ним локально из проекта кода, созданного CLI. Они доступны в `platforms/wp8/cordova` Каталог после добавления `wp8` платформа, как описано ниже.
+
+* Скачайте их из отдельных распределения на [cordova.apache.org][10]. Кордова дистрибутив содержит отдельные архивы для каждой платформы. Будьте уверены, чтобы расширить в соответствующий архив, `cordova-wp8\wp8` в данном случае, в пустой каталог. Соответствующие пакетных утилит доступны в верхнего уровня `bin` каталог. (Обратитесь к **README** файл при необходимости для более подробные инструкции.)
+
+ [10]: http://cordova.apache.org
+
+Эти оболочки инструменты позволяют создавать, строить и запускать приложения Windows Phone. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями". Смотрите Плагины приложения для руководства по разработке плагинов и Плагины Windows Phone 8 для получения сведений, специфичных для платформы Windows Phone.
+
+## Установите SDK
+
+Установите последнюю версию пакета SDK Windows Phone от **Скачиваний** области [dev.windowsphone.com][11]. Вы можете также установить последние пакеты обновления эмулятора.
+
+ [11]: https://dev.windowsphone.com/en-us/downloadsdk
+
+![][12]
+
+ [12]: img/guide/platforms/wp8/wp8_downloadSDK.png
+
+## Создание нового проекта
+
+На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе "Интерфейс командной строки", или набор инструментов для Windows Phone. С в каталоге исходного кода, а вот подход CLI:
+
+ > cordova create hello com.example.hello HelloWorld
+ > cd hello
+ > cordova platform add wp8
+
+
+Вот соответствующий подход shell инструмент более низкого уровня:
+
+ C:\path\to\cordova-wp8\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld
+
+
+## Построение проекта
+
+Если вы используете CLI для разработки, каталога `www` проекта содержит исходные файлы. Запустите любой из нижеследующего в каталоге проекта для перепостроения приложения:
+
+ > cordova build
+ > cordova build wp8 # do not rebuild other platforms
+
+
+Если вы используете инструменты Windows Phone специфические оболочки в процессе развития, существует другой подход. После создания проекта приложения по умолчанию источник доступен в `projects\wp8\www` подкаталога. Последующие команды доступны в `cordova` подкаталога на том же уровне.
+
+`build`Команда очищает файлы проекта и перестраивает app. Первый пример генерирует отладочную информацию, и второй подписывает apps для выпуска:
+
+ C:\path\to\project\cordova\build.bat --debug
+ C:\path\to\project\cordova\build.bat --release
+
+
+`clean`Команда помогает вымывать каталогов в рамках подготовки к следующей `build` :
+
+ C:\path\to\project\cordova\clean.bat
+
+
+## Развертывание на эмулятор
+
+К этому моменту можно использовать утилиту CLI `cordova` для развертывания приложения на эмулятор из командной строки:
+
+ > cordova emulate wp8
+
+
+В противном случае используйте интерфейс альтернативной оболочки:
+
+ C:\path\to\project\cordova\run
+
+
+По умолчанию `run` сценарий вызывает эмулятор флаг и принимает дополнительные построения флаги, для которого `--debug` предоставляет значение по умолчанию:
+
+ C:\path\to\project\cordova\run --emulator --debug
+ C:\path\to\project\cordova\run --emulator --release
+ C:\path\to\project\cordova\run --emulator --nobuild
+
+
+Эмулятор запускает образа устройства с установленным приложением. От домашнего экрана перейдите на панель приложения для запуска приложения **HelloWorld** . Это показывает запуск с его заставка, после чего его основной интерфейс приложения:
+
+![][13]
+
+ [13]: img/guide/platforms/wp8/wp8_emulator.png
+
+Основные элементы эмулятора на правом верхнем углу экрана устройства позволяют переключаться между книжной и альбомной ориентации. **>** Кнопка открывает больше элементов управления, которые позволяют протестировать более сложных установок и жесты:
+
+![][14]
+
+ [14]: img/guide/platforms/wp8/wp8_emulator_orient.png
+
+Эти дополнительные элементы управления также позволяют изменять местоположение устройства или для моделирования последовательностей движений:
+
+![][15]
+
+ [15]: img/guide/platforms/wp8/wp8_emulator_loc.png
+
+## Развертывание на устройство
+
+Перед тестированием приложения на устройстве, устройство должно быть зарегистрировано. Документации [корпорации Майкрософт][16] сведения о том, как развернуть и протестировать на Windows Phone 8. Кроме того убедитесь, что телефон подключен к компьютеру, и экран разблокируется.
+
+ [16]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565.aspx
+
+Затем запустите следующую команду CLI для запуска приложения на устройстве:
+
+ > cordova run wp8
+
+
+Он соответствует этой команды оболочки более низкого уровня:
+
+ C:\path\to\project\cordova\run --device
+
+
+Кроме того если вы работаете в Visual Studio, выберите **Устройство Windows Phone** из раскрывающегося меню в верхней, а затем нажмите зеленый **играть** кнопку рядом, или же введите **F5**.
+
+## Изменить проект в SDK
+
+После того, как вы строите Cordova-приложение, как описано выше, вы можете открыть его с SDK. Различные `build` команды создается файл Visual Studio решения (*.sln*). Откройте файл, чтобы изменить проект в Visual Studio. Веб-исходный код доступен в рамках проекта `www` каталог. А также другие средства SDK предоставляет, управления ниже меню позволяет запустить приложение в эмуляторе Windows Phone:
+
+![][17]
+
+ [17]: img/guide/platforms/wp8/wp8_vs.png
+
+Сверяйтесь с разделом "Введение" о том как использовать интерфейс командной строки Cordova командной или SDK в вашем рабочем процессе. Кордова CLI опирается на кросс платформенной исходный код, который постоянно перезаписывает файлы платформы, используемые в SDK. Если вы хотите работать в рамках SDK, используйте инструменты низкого уровня оболочки как альтернатива CLI.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/parallels.md b/docs/ru/5.1.1/guide/platforms/wp8/parallels.md
new file mode 100644
index 0000000..b4c5600
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/parallels.md
@@ -0,0 +1,41 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Настройка Parallels Desktop
+
+В этом разделе показано, как настроить Parallels Desktop на Mac, так что вы можете использовать Cordova для создания приложений Windows Phone.
+
+[Microsoft Developer Network][1] содержит общие инструкции для запуска Windows в Parallels Desktop. После установки Windows, выполните следующие действия:
+
+ [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424
+
+1. В Parallels Desktop выберите образ диска Windows 8, вы подготовили и выберите **Параметры**.
+
+2. Выберите параметры **Общие → процессоры** . Укажите *два* ЦП. Укажите по крайней мере 2 ГБ памяти, даже если он выходит за пределы рекомендуемого диапазона:
+
+ ![][2]
+
+3. Чтобы иметь возможность запускать образ эмулятора устройства в виртуальной машине Windows 8, выберите настройки, **оптимизации** и включение **Вложенных виртуализации**.
+
+ ![][3]
+
+ [2]: img/guide/platforms/wp8/parallel_cpu_opts.png
+ [3]: img/guide/platforms/wp8/parallel_optimize_opts.png
+
+После выполнения этих шагов, вы будете готовы к установке Windows Phone SDK. Смотрите Руководство для платформы Windows Phone 8 для подробностей.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/plugin.md b/docs/ru/5.1.1/guide/platforms/wp8/plugin.md
new file mode 100644
index 0000000..fa89f4d
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/plugin.md
@@ -0,0 +1,201 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Плагины Windows Phone 8
+
+Этот раздел содержит сведения о том, как реализовать собственный плагин на платформе Windows Phone. Прежде чем читать этот раздел, смотрите "Руководство по разработке плагинов" для понимания структуры плагина и его общий интерфейс JavaScript. Этот раздел продолжает демонстрировать образец плагина *echo*, который взаимодействует с WebView Cordova на стороне платформы и наоборот.
+
+Писать плагин для Кордова на Windows Phone требуется базовое понимание архитектуры в Кордове. Кордова-WP8 состоит из `WebBrowser` , содержит код JavaScript приложения и управляет родной вызовы API. Вы можете расширить C# `BaseCommand` класса ( `WPCordovaClassLib.Cordova.Commands.BaseCommand` ), которая поставляется с большинство функциональных возможностей, вам необходимо:
+
+1. Выберите ваш проект и щелкните правой кнопкой мыши выбрать **Добавить → новый элемент...** Если вы хотите, вы можете добавить его в `Plugins` папку.
+
+2. Выберите **класс** и назовите его `Echo.cs` . Этот класс имя должно *точно* соответствовать что вы называете указать в качестве службы в `cordova.exec()` вызов на стороне JavaScript.
+
+3. Включить осуществление базовых классов:
+
+ using WPCordovaClassLib.Cordova;
+ using WPCordovaClassLib.Cordova.Commands;
+ using WPCordovaClassLib.Cordova.JSON;
+
+4. Расширить свой класс от `BaseCommand` :
+
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+
+5. Добавить `echo` метод, который можно вызывать из JavaScript:
+
+ public class Echo : BaseCommand
+ {
+ public void echo(string options)
+ {
+ // all JS callable plugin methods MUST have this signature!
+ // public, returning void, 1 argument that is a string
+ }
+ }
+
+
+Смотреть [BaseCommand.cs][1] класс для методов, доступных для плагина для переопределения. Например плагин может перехватывать события «pause» и «resume».
+
+ [1]: https://github.com/apache/cordova-wp8/blob/master/wp8/template/cordovalib/Commands/BaseCommand.cs
+
+## Пространства имён
+
+Пространство имен по умолчанию для неквалифицированных команды является:
+
+ namespace Cordova.Extension.Commands
+ {
+ // ...
+ }
+
+
+Если вы хотите задать собственных имен, вам нужно позвонить в полное `cordova.exec` . Например, если вы хотите определить класс C# следующим образом:
+
+ namespace com.mydomain.cordovaExtensions
+ {
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
+ }
+
+
+JavaScript необходимо будет вызвать `exec` , как это:
+
+ cordova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...);
+
+
+## Интерпретации аргументов в C
+
+В примере, рассмотренном в плагины приложения данные, которые получает ваш плагин является строкой, но что, если вы хотите передать массив строк? Предположим, что JavaScript `cordova.exec` вызова задается следующим образом:
+
+ cordova.exec(win, fail, "Echo", "echo", ["input string"]);
+
+
+Значение `options` строка, передаваемая в `Echo.echo` метод является JSON:
+
+ "[\"input string\"]"
+
+
+Все JavaScript `exec` аргументы JSON кодируются перед передачей в C# и поэтому нужно декодировать:
+
+ string optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ // optVal now has the value of "input string"
+
+
+## Результаты тестирования из C# в JavaScript
+
+`BaseCommand`Класс предоставляет методы для передачи данных обратного вызова обработчиков JavaScript. Если вы хотите просто сигнал успеха без сопровождающих результата, вы можете просто позвонить:
+
+ DispatchCommandResult();
+ // calls back with an empty plugin result, considered a success callback
+
+
+Чтобы передать данные обратно, вам нужно позвонить `DispatchCommandResult` по-разному:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Everything went as planned, this is a result that is passed to the success handler."));
+
+
+Используйте зашифрованную строку JSON для передачи данных структурированных объектов обратно в JavaScript:
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"super awesome!\"}"));
+
+
+Чтобы сигнал об ошибке, вызовите `DispatchCommandResult` с `PluginResult` объект, состояние которого является `ERROR` :
+
+ DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo signaled an error"));
+
+
+## Обработка ошибок сериализации
+
+При интерпретации аргументов, `try` / `catch` блоки помогают отсеивать плохие ввода. Эта модель появляется на протяжении код Cordova C#:
+
+ string optVal = null;
+
+ try
+ {
+ optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ }
+ catch(Exception)
+ {
+ // simply catch the exception, we handle null values and exceptions together
+ }
+
+ if (optVal == null)
+ {
+ DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));
+ }
+ else
+ {
+ // ... continue on to do our work
+ }
+
+
+## Плагин жизни
+
+Плагины с долго выполняющихся запросов, фон деятельности, такие как воспроизведение мультимедиа, слушателей или что поддерживать внутреннее состояние следует осуществлять `onReset` метод для очистки этих мероприятий. Метод выполняется, когда CordovaView WebBrowser переходит на новую страницу или обновления, которая перезагружает JavaScript.
+
+ // defined in WPCordovaClassLib.Cordova.Commands.BaseCommand
+ public virtual void OnReset() { }
+
+
+## Плагин XML
+
+Ниже показано, как использовать `plugin.xml` файла для указания плагин исходных файлов на платформе Windows Phone. См приложение плагины обзор, и "Спецификация расширений" для подробной информации об имеющихся вариантах.
+
+* `<source-file>`Элемент определяет все ресурсы плагин, например *.cs*, *.xaml*, *. xaml.cs*и *DLL-* файлов и графических ресурсов.
+
+* `<config-file>`Элемент определяет элементы для вставки в файл конфигурации. Этот пример добавляет плагин на платформу `config.xml` файл:
+
+ <config-file target="config.xml" parent="/*">
+ <feature name="PluginName">
+ <param name="wp-package" value="PluginName"/>
+ </feature>
+ </config-file>
+
+ Этот пример добавляет возможность контактов `WMAppManifest.xml` файл:
+
+ <config-file target="Properties/WMAppManifest.xml" parent="/Deployment/App/Capabilities">
+ <Capability Name="ID_CAP_CONTACTS" />
+ </config-file>
+
+
+## Отладка плагины
+
+Использование отладчика Visual Studio для отладки работы плагина C# компонент. Точку останова можно установить в любой из методов, предоставляемых в вашем классе.
+
+JavaScript является более сложным для отладки на Windows Phone. Вам нужно использовать `console.log` для вывода плагин государство, или сообщить себя от ошибок.
+
+## Наиболее распространенные ошибки
+
+* Будьте осторожны, чтобы не передавать аргументы из JavaScript к родной стороне, которые трудно десериализовать формат JSON. Большинство платформ устройств ожидать аргумент, передаваемый `cordova.exec()` быть массива, например следующие:
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", 54, {literal:'trouble'}]);
+
+ Это может привести к чрезмерно сложным строковое значение для C# для декодирования:
+
+ "[\"this is a string\", 54, { literal:'trouble' }]"
+
+ Вместо этого, рассмотреть вопрос о преобразовании *всех* параметров в строки перед вызовом `exec()` и декодирования каждой отдельно:
+
+ cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", "54", "{literal:'trouble'}"]);
+ string[] optValues = JsonHelper.Deserialize<string[]>(options);
+
+* Как правило, лучше проверить параметры в JavaScript перед вызовом `exec()` . Это позволяет повторно использовать код и вытащить ненужные функции из плагина различных встроенных реализаций.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/tools.md b/docs/ru/5.1.1/guide/platforms/wp8/tools.md
new file mode 100644
index 0000000..40f1a27
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/tools.md
@@ -0,0 +1,91 @@
+---
+
+license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+
+
+ under the License.
+---
+
+# Windows Phone средств командной строки
+
+`cordova`Утилиты командной строки является высокого уровня инструмент, который позволяет вам создавать приложения сразу на нескольких платформах. Старые версии структуры Cordova предоставляет наборы средств командной строки для каждой платформы. Чтобы использовать их в качестве альтернативы для CLI, вам нужно скачать эту версию Cordova с [cordova.apache.org][1]. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните узел платформы, которую вы хотите цели. Инструменты, описанные здесь обычно доступны в профиле верхнего уровня `bin` каталог, в противном случае консультироваться с файлом **README** для получения более подробной направлениях.
+
+ [1]: http://cordova.apache.org
+
+Сведения о низкоуровневый интерфейс командной строки, который позволяет плагины см с помощью Plugman для управления плагинами. Смотрите приложение плагины обзор.
+
+## Windows Phone
+
+Средства командной строки Windows Phone поддерживает создание, строительство и запуск новых проектов. Команды должны быть запущены из строки cmd или powershell.
+
+Репо WP8 теперь включает в себя код для построения WP7 + WP8 apps. Repo есть подкаталоги для каждого: `wp7/` и`wp8/`.
+
+## Создание проекта
+
+Есть 2 способа идти о создании нового приложения Apache Cordova WP7 или WP8.
+
+### Запустите пакетный файл для создания и установки шаблонов
+
+* Содержит корень репо `createTemplates.bat` файл. Дважды она генерирует два `.zip` файлы: `CordovaWP7_x_x_x.zip` и `CordovaWP8_x_x_x.zip` , где *ххх* — номер текущей версии. Чтобы легко использовать эти файлы в Visual Studio, скопируйте их в `My Documents\Visual Studio
+2012\Templates\ProjectTemplates\` . Затем вы могл создать Apache Cordova Windows Phone приложения из Visual Studio **файл → новый проект** меню.
+
+* Если вы запустите пакетный файл из командной строки, вы также можете позвонить с параметром для автоматической установки
+
+Запустите сценарий:
+
+ >createTemplates.bat -install
+
+
+### Использовать скрипты Create в командной строке
+
+Запуск `create` команду, указав существующий путь к проекту, реверс домен стиль пакета идентификатор и отображаемое имя приложения. Вот синтаксис для Windows Phone 7 и 8:
+
+ >.\wp7\bin\create PathToNewProject [ PackageName ] [ AppName ]
+ >.\wp8\bin\create PathToNewProject [ PackageName ] [ AppName ]
+
+ >PathToNewProject : The path to where you wish to create the project
+ >PackageName : The namespace for the project (default is Cordova.Example)
+ >AppName : The name of the application (default is CordovaWP8AppProj or CordovaWP7AppProj)
+
+ >examples:
+ >.\wp7\bin\create C:\path\to\my_new_project
+ >.\wp8\bin\create C:\path\to\my_new_project io.cordova.example CordovaWP8App
+
+
+Запустите Visual Studio и откройте файл решения (SLN) в (C:\path\to\my\_new\_project)
+
+Построить и запустить его
+
+## Построение проекта (чистой, а затем построить)
+
+* Отладка
+
+ $ C:\path\to\my\_new\_project\cordova\build --debug
+
+* Релиз
+
+ $ C:\path\to\my\_new\_project\cordova\build --release
+
+## Запуск приложения
+
+Выполните команду «run» со следующими *необязательными* параметрами
+
+* Целевая спецификация. Это включает в себя `--emulator` , `--device` , или`--target=<targetID>`.
+
+* Создание спецификации. Это включает в себя `--debug` , `--release` , или`--nobuild`.
+
+ $ C:\path\to\my\_new\_project\cordova\run \[Target\] \[Build\]
+
+По умолчанию `run` команда вызывается с `--emulator --debug` если флаги не предоставляются.
+
+## Очистка
+
+ $ C:\path\to\my_new_project\cordova\clean
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/upgrade.md b/docs/ru/5.1.1/guide/platforms/wp8/upgrade.md
new file mode 100644
index 0000000..eeb3cf7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/upgrade.md
@@ -0,0 +1,92 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Обновление Windows Phone 8
+
+В этом руководстве показано, как изменить проекты Windows Phone 8, для обновления от более старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI `cordova`. Смотрите раздел "Интерфейс командной строки" для получения информации как обновить версию CLI. В следующем разделе показано, как обновить не-CLI и CLI проекты.
+
+## Обновление проектов с 3.6.0 до 4.0.0
+
+Для проектов-CLI выполните:
+
+ bin/update путь/к/проекту
+
+
+Для проектов CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск `cordova platform update wp8` в существующих проектах.
+
+## Обновление до 3.2.0 от 3.1.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Выполните `cordova platform update wp8`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin/update <project_path>
+
+
+## Обновление до 3.1.0 с 3.0.0
+
+Для проектов, которые были созданы с помощью cordova CLI:
+
+1. Обновите версию `cordova` CLI. Смотрите "Интерфейс командной строки".
+
+2. Запуск`cordova platform update wp8`
+
+Для проектов, не созданных с помощью cordova CLI выполните:
+
+ bin\update <project_path>
+
+
+## Обновление к CLI (3.0.0) с 2.9.0
+
+1. Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе "Интерфейс командной строки".
+
+2. Добавьте ваш платформ в Кордове проект, например:`cordova
+platform add wp8`.
+
+3. Скопируйте содержимое каталога `www` исходного проекта в каталог `www` в корне проекта cordova, который вы только что создали.
+
+4. Скопируйте или замените любые ресурсы платформы из вашего исходного проекта (`SplashScreen`, `ApplicationIcon`, и т.д.), удостовертесь что добавили все новые файлы в `.csproj` файл. Проект Windows phone собирается внутри каталога `platforms\wp8`.
+
+5. Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
+
+6. Построение и тестирование.
+
+## Обновление до 3.0.0 (не CLI) с 2.x
+
+В окне Обозреватель решений Visual Studio:
+
+1. Создайте новый проект Apache Cordova WP8 3.0.0.
+
+2. Скопируйте содержимое каталога `www` в новый проект и убедитесь что эти элементы добавлены в проект VS.
+
+3. Скопируйте и перезапишите любую заставку, или иконку.
+
+4. Скопируйте любые плагины из каталога `plugins` в новый проект и убедитесь, что они также добавлены в проект VS.
+
+5. Постройте и протестируйте.
+
+**Примечание**: все основные API удалены из Cordova версии 3.0 и должен быть установлены отдельно как плагины. Дополнительные сведения о том, как повторно включить эти функции в рабочем процессе без использования CLI см. "Использование Plugman для управления расширениями".
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/vmware.md b/docs/ru/5.1.1/guide/platforms/wp8/vmware.md
new file mode 100644
index 0000000..66338e7
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/vmware.md
@@ -0,0 +1,48 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Настройка VMWare Fusion
+
+В этом разделе показано, как настроить VMWare Fusion на Mac, так чтобы вы смогли использовать Cordova для создания приложений для Windows Phone.
+
+[Microsoft Developer Network][1] предоставляет общие инструкции для запуска Windows под VMWare Fusion. После установки Windows, выполните следующие действия:
+
+ [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426
+
+1. В VMWare Fusion выберите образ диска Windows 8 который вы подготовили и выберите **Параметры**.
+
+2. Выберите параметры конфигурации **Процессоры и память** . Не забудьте указать *два* процессорных ядра и выберите **Позволить приложения гипервизора в этой виртуальной машины**:
+
+ ![][2]
+
+ Один только эмулятор Windows Phone использует половину гигабайта памяти, поэтому в целом вы должны зарезервировать минимум 2 ГБ для VMWare.
+
+3. Выберите **Дополнительные** параметры. Выберите вариант **Предпочитаемая технология виртуализации : Intel VT-x с EPT**:
+
+ ![][3]
+
+4. Измените файл *.vmx* , чтобы добавить или изменить следующие настройки:
+
+ Hypervisor.CPUID.v0 = «FALSE» mce.enable = «TRUE» vhv.enable = «TRUE»
+
+
+ [2]: img/guide/platforms/wp8/vmware_memory_opts.png
+ [3]: img/guide/platforms/wp8/vmware_advanced_opts.png
+
+После выполнения этих шагов, вы будете готовы к установке Windows Phone SDK. Смотрите Руководство для платформы Windows Phone 8 для подробностей.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/platforms/wp8/webview.md b/docs/ru/5.1.1/guide/platforms/wp8/webview.md
new file mode 100644
index 0000000..a2f234d
--- /dev/null
+++ b/docs/ru/5.1.1/guide/platforms/wp8/webview.md
@@ -0,0 +1,41 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Windows Phone 8.0 WebViews
+
+В этом руководстве показано, как внедрить компонент Cordova с поддержкой WebView в другое, большее, приложение Windows Phone 8.0.
+
+Следовать этим инструкциям, убедитесь, что у вас есть дистрибутив последней версии Cordova. Скачать его с [cordova.apache.org](http://cordova.apache.org) и разархивируйте пакет для Windows Phone 8.0 (cordova-wp8-*.zip).
+
+ 1. Перейдите к директории `wp8/framework` пакета и соберите решение `WPCordovaClassLib.sln` . Это создаст `Bin\Debug[Release]\WPCordovaClassLib.dll`.
+
+ 2. Скопируйте файл `WPCordovaClassLib.dll` в каталог `/libs` проект Windows Phone 8 и подключите `WPCordovaClassLib.dll` к вашему проекту через `Project->References->Add Reference` . Кроме того, можно напрямую ссылаться на файл `wp8/framework/WPCordovaClassLib.csproj`.
+
+ 3. Добавьте компонент `CordovaView` на страницу (например,`MainPage.xaml`).
+
+ xmlns:my="clr-namespace:WPCordovaClassLib;assembly=WPCordovaClassLib">
+ ...
+ <my:CordovaView HorizontalAlignment="Stretch" Margin="0,0,0,0"
+ StartPageUri="html/index.html" x:Name="CordovaView" VerticalAlignment="Stretch" />
+
+ 4. Скопируйте `common/www/cordova.js` и разметите его вместе с HTML и JavaScript файлами приложения в каталоге `html` проекта Windows Phone 8 и добавьте новые файлы в ваш проект.
+
+ 5. Скопируйте `wp8/template/config.xml` в корневой каталог проекта и
+
+Инструкции выше подключат только основные компоненты Cordova, см Использование Plugman для управления расширениями для того, чтобы подключить плагины Cordova.
\ No newline at end of file
diff --git a/docs/ru/5.1.1/guide/support/index.md b/docs/ru/5.1.1/guide/support/index.md
new file mode 100644
index 0000000..6fa5968
--- /dev/null
+++ b/docs/ru/5.1.1/guide/support/index.md
@@ -0,0 +1,864 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Поддерживаемые Платформы
+
+Ниже приведен набор инструментов разработки и устройства интерфейсы API, доступные для каждой мобильной платформы. Устройство API-интерфейсы, перечисленные здесь предоставляются основные плагины, дополнительные интерфейсы API доступны через [сторонних плагинов][1]. Заголовки столбцов отображаются имена стенографию CLI.
+
+ [1]: http://plugins.cordova.io
+
+<!-- START HTML -->
+
+<table class="compat" width="100%">
+<thead>
+ <tr>
+ <th>
+ </td> <th>
+ <tt>amazon-fireos</tt>
+ </th>
+
+ <th>
+ <tt>android</tt>
+ </th>
+
+ <th>
+ <tt>blackberry10</tt>
+ </th>
+
+ <th>
+ <tt>Firefox OS</tt>
+ </th>
+
+ <th>
+ <tt>iOS</tt>
+ </th>
+
+ <th>
+ <tt>Ubuntu</tt>
+ </th>
+
+ <th>
+ <tt>WP8</tt><br />(Windows Phone 8)
+ </th>
+
+ <th>
+ <tt>Windows</tt><br />(8.0, 8.1,<br />Телефон 8.1)
+ </th>
+
+ <th>
+ <tt>Tizen</tt>
+ </th></tr> </thead>
+<tbody>
+ <tr>
+ <th>
+ <a href="guide_cli_index.md.html">Cordova <br />CLI</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="android" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ Mac, Windows
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ Mac, Windows, Linux
+ </td>
+
+ <td data-col="ios" class="y">
+ Mac
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ Ubuntu
+ </td>
+
+ <td data-col="winphone8" class="y">
+ Windows
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="guide_hybrid_webviews_index.md.html">Встроенный<br />WebView</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ <a href="guide_platforms_amazonfireos_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="android" class="y">
+ <a href="guide_platforms_android_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="blackberry10" class="n">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ <a href="guide_platforms_ios_webview.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="n">
+ </td>
+
+ <td data-col="win8" class="n">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="guide_hybrid_plugins_index.md.html">Подключаемый модуль<br />Интерфейс</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ <a href="guide_platforms_amazonfireos_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="android" class="y">
+ <a href="guide_platforms_android_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ <a href="guide_platforms_blackberry10_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ <a href="guide_platforms_ios_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ <a href="guide_platforms_wp8_plugin.md.html">(см. подробности)</a>
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ </th>
+
+ <th colspan="20">
+ API платформы
+ </th>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device-motion">Accelerometer</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-battery-status">BatteryStatus</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ * только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-camera">Камера</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-media-capture">Съемка</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device-orientation">Компас</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ (3GS+)
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-network-information">Подключение</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-contacts">Контакты</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="p">
+ частично
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-device">Устройство</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="cordova_events_events.md.html">События</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-file">Файл</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-file-transfer">Передача файлов</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="win8" class="y">
+ * Не поддерживает onprogress не прервать
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-geolocation">Географическое положение</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-globalization">Глобализация</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-inappbrowser">Внутренний браузер</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="p">
+ использует iframe
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-media">Аудио и видео</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-dialogs">Уведомление</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-splashscreen">Заставка</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-statusbar">Строка состояния</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="n">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="n">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="cordova_storage_storage.md.html">Хранилище</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="n">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="y">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ localStorage & indexedDB
+ </td>
+
+ <td data-col="win8" class="y">
+ localStorage & indexedDB
+ </td>
+
+ <td data-col="tizen" class="y">
+ </td>
+ </tr>
+
+ <tr>
+ <th>
+ <a href="https://www.npmjs.com/package/cordova-plugin-vibration">Вибрация</a>
+ </th>
+
+ <td data-col="amazon-fireos" class="y">
+ </td>
+
+ <td data-col="android" class="y">
+ </td>
+
+ <td data-col="blackberry10" class="y">
+ </td>
+
+ <td data-col="firefoxos" class="y">
+ </td>
+
+ <td data-col="ios" class="y">
+ </td>
+
+ <td data-col="ubuntu" class="n">
+ </td>
+
+ <td data-col="winphone8" class="y">
+ </td>
+
+ <td data-col="win8" class="y">
+ * только Windows Phone 8.1
+ </td>
+
+ <td data-col="tizen" class="n">
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<!-- END HTML -->
\ No newline at end of file
diff --git a/docs/ru/5.1.1/index.md b/docs/ru/5.1.1/index.md
new file mode 100644
index 0000000..481637a
--- /dev/null
+++ b/docs/ru/5.1.1/index.md
@@ -0,0 +1,167 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+<div id="home">
+ <h1>
+ Инструкции
+ </h1>
+
+ <ul>
+ <li>
+ <h2>
+ Введение
+ </h2>
+
+ <span>Начните здесь, если вы новичок в Кордове. Включает в себя установку и последующие шаги.</span>
+ </li>
+ <li>
+ <h2>
+ Поддерживаемые Платформы
+ </h2>
+
+ <span>Таблица совместимости для всех основных функций.</span>
+ </li>
+ <li>
+ <h2>
+ Интерфейс командной строки
+ </h2>
+
+ <span>Создание, сборка и развертывание из командной строки.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по поддерживаемым платформам
+ </h2>
+
+ <span>Настройка SDK каждой платформы и обновление проектов.</span>
+ </li>
+ <li>
+ <h2>
+ Использование Plugman для управления расширениями
+ </h2>
+
+ <span>Управление плагинами без CLI при использовании рабочего процесса по центру платформы.</span>
+ </li>
+ <li>
+ <h2>
+ Файл config.xml
+ </h2>
+
+ <span>Настройте функции вашего приложения.</span>
+ </li>
+ <li>
+ <h2>
+ Иконки и заставки
+ </h2>
+
+ <span>Настройка отображения изображений вашего приложения.</span>
+ </li>
+ <li>
+ <h2>
+ Интеграция WebViews
+ </h2>
+
+ <span>Добавление Cordova WebView в ваш проект.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по разработке плагинов
+ </h2>
+
+ <span>Создайте свой первый плагин.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по конфиденциальности
+ </h2>
+
+ <span>Узнайте о важных проблемах конфиденциальности при работе с мобильными устройствами.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по безопасности
+ </h2>
+
+ <span>Информация и советы по созданию безопасных приложений.</span>
+ </li>
+ <li>
+ <h2>
+ Управление версиями платформ и плагинов
+ </h2>
+
+ <span>Сохраняйте и восстанавливайте ваши проекты CLI в предсказуемое состояние без нервотрепки.</span>
+ </li>
+ <li>
+ <h2>
+ Инструкция по доступу к внешним ресурсам
+ </h2>
+
+ <span>Разрешите приложению доступ к внешним ресурсам.</span>
+ </li>
+ <li>
+ <h2>
+ Хранилище
+ </h2>
+
+ <span>Обзор возможностей хранения данных, предоставляемых различными платформами.</span>
+ </li>
+ <li>
+ <h2>
+ Руководство по хукам
+ </h2>
+
+ <span>Расширьте функционал по умолчанию Cordova путем добавления пользовательских скпритов.</span>
+ </li>
+ <li>
+ <h2>
+ Последующие шаги
+ </h2>
+
+ <span>Посмотрите на темы, которые интересуют новых разработчиков Cordova.</span>
+ </li>
+ <li>
+ <h2>
+ <a href="_index.html">Алфавитный указатель</a>
+ </h2>
+
+ <span>Полный список документации.</span>
+ </li>
+ </ul>
+
+ <h1>
+ Справочник по API
+ </h1>
+
+ <ul>
+ <li>
+ <h2>
+ События
+ </h2>
+
+ <span>Подключение к событиям платформы с использованием JavaScript.</span>
+ </li>
+ <li>
+ <h2>
+ API плагинов
+ </h2>
+
+ <span>Узнайте, какие плагины Cordova доступны для использования в вашем проекте.</span>
+ </li>
+ </ul>
+</div>
\ No newline at end of file
diff --git a/docs/ru/5.1.1/platform_plugin_versioning_ref/index.md b/docs/ru/5.1.1/platform_plugin_versioning_ref/index.md
new file mode 100644
index 0000000..3ad8651
--- /dev/null
+++ b/docs/ru/5.1.1/platform_plugin_versioning_ref/index.md
@@ -0,0 +1,152 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Управление версиями платформ и плагинов
+
+Начиная с версии Cordova 4.3.0 и далее предоставляет возможность сохранять и восстанавливать платформ и плагины.
+
+Эта функция позволяет разработчикам сохранять и восстанавливать их приложения в предсказуемое состояние без необходимости размещения всех исходных кодов платформы и плагинов в систему контроля версий.
+
+Команда 'save' сохраняет информацию о платформе приложения и версии плагина в файле config.xml. Шаг 'restore' шаг происходит автоматически, когда запускается **'cordova prepare'** , используя информацию, ранее сохраненную в файле config.xml.
+
+Один сценарий, где возможность сохранить/восстановить очень сподручна это в больших группах, которые работают над приложение, где каждый член команды, концентирует внимание на платформе или плагине. Эта функция позволяет легче поделиться проектом и уменьшить количество избыточного кода, который добавляется в репозиторий.
+
+## Управление версиями платформы
+
+### Сохранение платформы
+
+Чтобы сохранить платформу, выполните следующую команду:
+
+ $ cordova platform add <platform[@<version>] | directory | git_url> --save
+
+
+После выполнения команды выше, результирующий файл config.xml выглядит так :
+
+ <?xml version='1.0' encoding='utf-8'?>
+ ...
+ <engine name="android" spec="^4.0.0" />
+ ...
+ </xml>
+
+
+Некоторые примеры:
+
+* **'cordova platform add android --save'** => извлекает закрепленную версию платформы android, добавляет ее в проект и затем обновляет файл config.xml.
+* **'cordova platform add android@3.7.0 --save'** => извлекает платформу android, версии 3.7.0 из NPM, добавляет ее в проект и затем обновляет файл config.xml.
+* **'cordova platform add android@https://github.com/apache/cordova-android.git --save'** => клонирует заданный git-репозиторий cordova-android, добавляет платформу android в проект, затем обновляет файл config.xml и указывает версию как переданный выше git-адрес.
+* **'cordova platform add C:/path/to/android/platform --save'** => получает платформу android из указанного каталога, добавляет ее в проект, а затем обновляет файл config.xml и указывает на каталог.
+
+### Массовое сохранение платформ в существующем проекте
+
+Флаг '--save ', описанные выше полезен только когда вы помните о том что нужно его использовать при добавлении платформы. Если у вас есть существующий проект и вы хотите сохранить все, в настоящее время добавленые, платформы в вашем проекте, можно использовать:
+
+ $ cordova platform save
+
+
+### Обновление / удаление платформ
+
+Также возможно указывать этот параметр для обновления или удаления из config.xml во время команды 'cordova platform update' и 'cordova platform remove':
+
+ $ cordova platform update <platform[@<version>] | directory | git_url> --save
+ $ cordova platform remove <platform> --save
+
+
+Некоторые примеры:
+
+* **'cordova platform update android --save'** => помимо обновления платформы android до закрепленной версии, обновление записи в файле config.xml
+* **'cordova platform update android@3.8.0 --save'** => помимо обновления платформы android до версии 3.8.0, обновление записи в файле config.xml
+* **'cordova platform update /path/to/android/platform --save'** => помимо обновления платформы android версии из папке, обновление записи в файле config.xml
+* **'cordova platform remove android --save'** => удаляет платформу android из проекта и ее запись из файла config.xml.
+
+### Восстановление платформы
+
+ * Платформы автоматически восстанавливаются из config.xml при запуске команды **'cordova prepare'** .
+ * Если вы добавите платформу без указания версии/папка/git_url, версия для установки берется из файла config.xml, **если значение присутсвует**.
+ * Пример: Предположим, ваш файл config.xml содержит следующую запись:
+
+ <?xml version='1.0' encoding='utf-8'?>
+ ...
+ <engine name="android" spec="3.7.0" />
+ ...
+ </xml>
+
+ Если вы запустите команду **'cordova platform add android'** (без указания версии/папки/git_url), будут установлена платформы 'android@3.7.0' (как получено из файла config.xml).
+
+* * *
+
+## Управление версиями плагинов
+
+*(Команды plugin являются зеркалом команды plugin)*
+
+### Сохранение плагинов
+
+Чтобы сохранить плагин, выполните следующую команду:
+
+ $ cordova plugin add <plugin[@<version>] | directory | git_url> --save
+
+
+После выполнения команды выше, результирующий файл config.xml выглядит так :
+
+ <?xml version='1.0' encoding='utf-8'?>
+ ...
+ <plugin name="cordova-plugin-console" spec="^1.0.0" />
+ ...
+ </xml>
+
+
+Некоторые примеры:
+
+* **«cordova plugin add cordova-plugin-console --save'»** => извлекает закрепленную версию плагина консоли, добавляет его в проект и затем обновляет файл config.xml.
+* **'cordova plugin add cordova-plugin-console@0.2.13 --save'** => извлекает android плагин, версия 0.2.13 из NPM, добавляет его в проект и затем обновляет файл config.xml.
+* **'cordova plugin add https://github.com/apache/cordova-plugin-console.git --save'** => клонирует указанный git-репозиторий плагина консоли, добавляет плагин консоли в проект, а затем обновляет файл config.xml и указывают указаный git-адрес как версию.
+* **'cordova plugin add C:/path/to/console/plugin --save'** => извлекает плагин консоли из указанного каталога, добавляет его в проект, а затем обновляет файл config.xml и указывает на каталог.
+
+### Массовое сохранение плагинов в существующем проекте
+
+Флаг '--save ', описанные выше полезен только когда вы помните о том что нужно его использовать при добавлении плагина. Если у вас есть существующий проект и вы хотите сохранить все, в настоящее время добавленые, плагины в проекте, вы можете использовать:
+
+ $ cordova plugin save
+
+
+### Обновление / удаление плагинов
+
+Также возможно указывать этот параметр для обновления или удаления из config.xml во время команды 'cordova plugin update' и 'cordova plugin remove' :
+
+ $ cordova plugin update <plugin[@<version>] | directory | git_url> --save
+ $ cordova plugin remove <plugin> --save
+
+
+Некоторые примеры:
+
+* **'cordova plugin update cordova-plugin-console --save'** => помимо обновления плагина консоли до закрепленного версии, обновление записи в файле config.xml
+* **'cordova plugin update cordova-plugin-console@0.2.13 --save'** => помимо обновления android плагина до версии 3.8.0, обновление записи в файле config.xml
+* **'cordova plugin update /path/to/console/plugin --save'** => помимо обновления плагина консоли до версии в папке, обновление записи в файле config.xml
+* **'cordova plugin remove cordova-plugin-console --save'** => удаляет плагин консоли из проекта и его запись в файле config.xml.
+
+### Восстановление плагинов
+
+ * Плагины автоматически восстанавливаются из config.xml при запуске команды **'cordova prepare'**.
+ * Если вы добавите плагин без указания версии/папка/git_url, версия для установки берется из файла config.xml, **если значение присутсвует**.
+ * Пример: Предположим, ваш файл config.xml содержит следующую запись:
+ <?xml version='1.0' encoding='utf-8'?>
+ ...
+ <plugin name="cordova-plugin-console" spec="0.2.11" />
+ ...
+ </xml>
+ если запустить команду **'cordova plugin add cordova-plugin-console'** (без указания версия/папка/git_url), будет устанавливаться плагин 'cordova-plugin-console@0.2.11' (значение полученное из файла config.xml).
\ No newline at end of file
diff --git a/docs/ru/5.1.1/plugin_ref/plugman.md b/docs/ru/5.1.1/plugin_ref/plugman.md
new file mode 100644
index 0000000..8ea940b
--- /dev/null
+++ b/docs/ru/5.1.1/plugin_ref/plugman.md
@@ -0,0 +1,173 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Использование Plugman для управления расширениями
+
+Начиная с версии 3.0 Cordova реализует все API устройства как плагины и оставляет их по умолчанию отключенными. Она также поддерживает два различных способа добавления и удаления плагинов, в зависимости от вашего выбора рабочего процесса, как описано в разделе "Введение":
+
+* Если вы используете кросс платформенный рабочий процесс, используйте утилиту CLI `cordova` для добавления плагинов, как описано в разделе "Интерфейс командной строки". CLI изменяет плагины для всех платформ одновременно.
+
+* Если вы используете платформо-ориентированный процесс разработки, вы используете низкоуровневый инструмент командной строки [Plugman][1], индивидуально для каждой целевой платформы.
+
+ [1]: https://github.com/apache/cordova-plugman/
+
+В этом разделе описывается утилита Plugman. Для более детальной информации об использовании Plugman как node модуля или изменения исходного кода см. [README файл в его репозитории][2].
+
+ [2]: https://github.com/apache/cordova-plugman/blob/master/README.md
+
+## Установка Plugman
+
+Чтобы установить plugman, вам потребуется установить [node.js][3] на свою машину. Затем можно запустить следующую команду в вашем окружении, чтобы установить plugman глобально, так чтобы он был доступен из любого каталога:
+
+ [3]: http://nodejs.org/
+
+ $ npm install -g plugman
+
+
+Вы также должны иметь `git` добавленный в переменную окружения `PATH`, для того чтобы иметь возможность устанавливать плагины непосредственно из удаленных репозитариев Git.
+
+**Подсказка**: Если вы обнаружили что после установки plugman с помощью `npm` вы по прежнему не можете запустить никакую из команд `plugman`,удостоверьтесь что вы добавили каталог `/npm/` в вашу переменную `PATH`.
+
+**Примечание**: этот шаг можно пропустить, если вы не хотите загрязнять глобальное пространство имен `npm`, устанавливая Plugman глобально. Если это ваш случай, то когда вы создаете проект Cordova с использованием командной строки, создастся каталог `node_modules` внутри вашего проекта, которая содержит Plugman. Посколько вы не установили глобально, вам необходимо вызывать `node` для каждой команды Plugman, к примеру `node
+./node_modules/plugman/main.js -version`. Остальная часть этой инструкции предполагает что вы установили Plugman глобально, что означает что вы можете вызывать его с использованием просто `plugman`.
+
+## Создайте проект Cordova
+
+Перед тем как использовать Plugman, вы должны создать проект Cordova. Вы можете сделать это либо с использование Интерфейса командной строки или с использованием низкоуровневых утилит командной строки. Инструкции по использованию утилит командной строки для создания вашего проекта, расположены в различных разделах "Инструменты командной строки" указанных на странице "Руководство по поддерживаемым платформам".
+
+## Добавление плагина
+
+После того как вы установили Plugman и создали проект Cordova, вы можете начать добавлять плагины к платформе с помощью:
+
+ $ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
+
+
+Используя минимальные параметры эта команда установит плагин в проект Cordova. Вы должны указать платформу и расположение проекта Cordоva для этой платформы. Также вы должны указать добавляемый плагин, с использованием различных форм параметра `--plugin`:
+
+* `name`: Имя каталога где расположено содержимое плагина. Имя должно соответствовать существующему каталогу расположенному по пути, указанному в параметре `--plugins_dir` (смотрите ниже за подробной информацией) или имени плагина в реестре плагинов Cordova.
+* `url`: URL начинающийся с https:// или git://, и указывающий на существующий репозиторий Git который можно клонировать, и который содержит файл `plugin.xml`. Содержимое этого репозитория будет скопировано в `--plugins_dir`.
+* `path`: Путь к каталогу, содержащему плагин, который включает в себя файл `plugin.xml`. Содержимое расположенное по этому пути будет скопировано в `--plugins_dir`.
+
+Другие параметры:
+
+* `--plugins_dir` по умолчанию, `<project>/cordova/plugins`, но может быть любым каталогом, котобый содержит подкаталог для каждого загруженного плагина.
+* `--www` поумолчанию каталог `www`, но может быть любой директорией которая будет использоваться проектом Cordova как каталог содержащий веб ресурсы приложения.
+* `--variable` позволяет указывать определенные переменные во время установки, для некоторых плагинов необходимо указывать ключи API или другие настраиваемые параметры. Обратитесь к [спецификации плагинов][4] для получения дополнительной информации.
+
+ [4]: plugin_ref_spec.md.html#Plugin%20Specification
+
+## Удаление плагина
+
+Для удаления плагина, вы должны просто указать флаг `--uninstall` и указать код плагина (ID плагина).
+
+ $ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
+
+
+## Команды справки
+
+Plugman поддерживает общую команду help которая может помочь вам если вы в тупике или испытываете проблемы. Она отобразит список доступных команд Plugman и их синтаксис:
+
+ plugman -help
+ plugman # same as above
+
+
+**Примечание**: `plugman -help` может показывать некоторые дополнительные команды по работе с реестром плагинов. Эти команды предназначены для разработчиков плагинов и могут быть не реализованы в реестрах плагинов третьих сторон.
+
+Вы также можете добавить флаг `--debug|-d` к любой команде Plugman для того чтобы запустить эту команду в диагностическом режиме, который будет отображать внутренние отладочные сообщения, по мере их формирования, что может помочь вам отследить проблемы, как например отсутствующие файлы в плагине.
+
+ # Adding Android battery-status plugin to "myProject":
+ plugman -d --platform android --project myProject --plugin cordova-plugin-battery-status
+
+
+Наконец, вы можете использовать флаг `--version|-v` для того чтобы узнать какую версию Plugman вы используете.
+
+ plugman -v
+
+
+## Действия с реестром плагинов
+
+Существует несколько команд plugman которые могут быть использованы для взаимодействия с [Реестром плагинов][5]. Пожалуйста обратите внимание что эти команды реестра специфичны для реестра плагинов *plugins.cordova.io* и могут не быть реализованы реестрами плагинов от посторонних поставщиков.
+
+ [5]: http://plugins.cordova.io
+
+### Поиск плагина
+
+Вы можете использовать Plugman для поиска в [Реестре плагинов][5] плагинов, которые соответствуют указанному списку ключевых слов, разделенных между собой запятыми.
+
+ plugman search <plugin keywords>
+
+
+### Смена реестра плагинов
+
+Вы можете получить или установить URL текущего реестра плагинов который использует plugman. Большей частью вы должны оставить это значение установленным в http://registry.cordova.io за исключением если вы хотите использовать реестр плагинов постороннего поставщика.
+
+ plugman config set registry <url-to-registry>
+ plugman config get registry
+
+
+### Получение информации о плагине
+
+Вы можете получить информацию о определенном плагине, сохраненном в реестре с помощью:
+
+ plugman info <id>
+
+
+Эта команда свяжется с реестром плагинов и получит информацию, такую как номер версии плагина.
+
+## Установка базовых плагинов
+
+Приведенные ниже примеры показывают, как добавлять плагины по мере необходимости, так чтобы любая часть Cordova API, которую вы используете в вашем проекте, по-прежнему продолжала работать после обновления до версии 3.0. Для каждой команды, необходимо выбрать целевую платформы, и ссылаться на каталог проекта платформы.
+
+* cordova-plugin-battery-status
+
+ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-battery-status
+
+* cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-camera
+
+* cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-console
+
+* cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-contacts
+
+* cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device
+
+* cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-motion
+
+* cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-orientation
+
+* cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-dialogs
+
+* cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file
+
+* cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file-transfer
+
+* cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-geolocation
+
+* cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-globalization
+
+* cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-inappbrowser
+
+* cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media
+
+* cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media-capture
+
+* cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-network-information
+
+* cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-splashscreen
+
+* cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-vibration
\ No newline at end of file
diff --git a/docs/ru/5.1.1/plugin_ref/spec.md b/docs/ru/5.1.1/plugin_ref/spec.md
new file mode 100644
index 0000000..355340b
--- /dev/null
+++ b/docs/ru/5.1.1/plugin_ref/spec.md
@@ -0,0 +1,538 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Спецификация расширений
+
+Файл `plugin.xml` представляет собой документ XML c пространством имен `plugins`: `http://apache.org/cordova/ns/plugins/1.0`. Он содержит узел верхнего уровня `plugin`, который определяет сам плагин, и дочерние узлы, которые определяют структуру плагина.
+
+Простой пример элемента plugin:
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+ xmlns:android="http://schemas.android.com/apk/res/android"
+ id="com.alunny.foo"
+ version="1.0.2">
+
+
+## Элемент *plugin*
+
+Элементом `plugin` является элементом верхнего уровня в файле манифеста плагина. Он имеет следующие атрибуты:
+
+* `xmlns` (обязательно): пространство имен, `http://apache.org/cordova/ns/plugins/1.0`. Если документ содержит XML из других пространств имен, таких как теги, которые будут добавлены к `AndroidManifest.xml` файл, эти пространства имен также должны быть включены в элемент верхнего уровня.
+
+* `id` (обязательный): уникальный идентификатор плагина, записывается в обратном формате доменных имен, например `com.alunny.foo`
+
+* `version` (обязательно): номер версии плагина, который соответствует условиям следующего регулярного выражения:
+
+ ^\d+[.]\d+[.]\d+$
+
+
+## Элементы *engines* и *engine*
+
+Дочерние элементы для элемента `<engines>` определяют основанный на Apache Cordova фреймоворк, который поддерживается данным плагином. Пример:
+
+ <engines>
+ <engine name="cordova" version="1.7.0" />
+ <engine name="cordova" version="1.8.1" />
+ <engine name="worklight" version="1.0.0" platform="android" scriptSrc="worklight_version"/>
+ </engines>
+
+
+Аналогично атрибуту `version` элемента `<plugin>`, указанная версия должна соответствовать регулярному выражению:
+
+ ^\d+[.]\d+[.]\d+$
+
+
+Элементы engine также могут указывать нечеткие параметры совпадения версий, чтобы избежать повторений или по упрощению поддержки, во время обновления платформы. Инструментарий проверяющий совместимость должен поддерживать как минимум определения содержащие `>`, `>=`, `<` и `<=` , например:
+
+ <engines>
+ <engine name="cordova" version=">=1.7.0" />
+ <engine name="cordova" version="<1.8.1" />
+ </engines>
+
+
+Теги `<engine>` также поддерживаются на всех платформах, на которых работает Cordova. Указание имени `cordova` для тега engine означает, что все версии Cordova на любой платформе должны соответствовать версии указанной в атрибуте version. Для того, чтобы переопределить включающий в себя все платформы тег engine со значением `cordova`, вы можете указывать индивидуальные платформы и их версии:
+
+ <engines>
+ <engine name="cordova" version=">=1.7.0" />
+ <engine name="cordova-android" version=">=1.8.0" />
+ <engine name="cordova-ios" version=">=1.7.1" />
+ </engines>
+
+
+Вот список платформ, который тег '<engine>' поддерживает:
+
+* 'cordova'
+* 'cordova-plugman'
+* 'cordova-amazon-fireos'
+* 'cordova-android'
+* 'cordova-ios'
+* 'cordova-blackberry10'
+* 'cordova-wp8'
+* 'cordova-windows8'
+* 'android-sdk' // возвращает наивысший установленный уровень Android API
+* 'apple-xcode' // возвращает версию xcode
+* 'apple-ios' // возвращает наивысшую, установленную версию iOS
+* 'apple-osx' // возвращает версию OSX
+* 'blackberry-ndk' // возвращает версию нативную BlackBerry SDK
+
+Указание пользовательских фреймвёрков на основе Apache Cordova должны быть перечислены с использованием тега engine следующим образом:
+
+ <engines>
+ <engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/>
+ <engine name="another_framework" version=">0.2.0" platform="ios|android" scriptSrc="path_to_another_framework_version"/>
+ <engine name="even_more_framework" version=">=2.2.0" platform="*" scriptSrc="path_to_even_more_framework_version"/>
+ </engines>
+
+
+При указании пользовательского фреймвёрка основанного на Apache Cordova обязательно, чтобы элемент engine включал в себя следующие атрибуты: `name`, `version`, `scriptSrc` и `platform`.
+
+* `name` (обязательно): Отображаемое пользователю имя вашего фреймвёрка.
+
+* `version` (обязательно): минимальная версия вашего фреймвёрка, которая требуется для установки плагина.
+
+* `scriptSrc` (обязательно): файл сценария, который говорит plugman, какая версия пользовательского фреймвёрка установлена. В идеале этот файл должен быть в каталоге верхнего уровня каталога plugin.
+
+* `platform` (обязательно): какие платформы, поддерживает ваш фреймвёрк. Вы можете использовать подстановочный знак `*` для указания того что поддерживаются все платформы, или укажите имена платформ разделенные символом |, например `android|ios|blackberry10` или просто одну платформу, например: `android`.
+
+plugman завершает выполнение с ненулевым кодом ошибки для любого плагина, который будет добавляться в проект, параметры которого не соответствует ограничениям необходимого фреймвёрка для данного плагина.
+
+Если теги `<engine>` не указаны, plugman пытается установить плагин в каталог проекта Cordova без проверки ограничений.
+
+## Элемент *name*
+
+Текст содержащий название плагина, в том виде как оно будет отображаться пользователям. Например:
+
+ <name>Foo</name>
+
+
+Этот элемент (пока) не поддерживает локализацию.
+
+## Элемент *description*
+
+Текст содержащий описание плагина, в том виде как оно будет отображаться пользователям. Например:
+
+ <description>Foo plugin description</description>
+
+
+Этот элемент (пока) не поддерживает локализацию.
+
+## Элемент *author*
+
+Имя автора плагина. Текстовое содержимое элемента содержит имя автора плагина. Например:
+
+ <author>Foo plugin description</author>
+
+
+## Элемент *keywords*
+
+Ключевые слова для плагина. Текстовое содержимое элемента содержит разделенные запятыми ключевые слова характеризующие плагин. Например:
+
+ <keywords>foo,bar</keywords>
+
+
+## Элемент *license*
+
+Лицензия на использование плагина. Текстовое содержимое элемента содержит лицензию для плагина. Например:
+
+ <license>Apache 2.0 License</license>
+
+
+## Элемент *asset*
+
+Один или несколько элементов указывающие файлы или каталоги, которые будут копироваться в каталог `www` приложения Cordova. Примеры:
+
+ <!-- a single file, to be copied in the root directory -->
+ <asset src="www/foo.js" target="foo.js" />
+ <!-- a directory, also to be copied in the root directory -->
+ <asset src="www/foo" target="foo" />
+
+
+Все теги `<asset>` должны содержать атрибуты `src` и `target`. Веб-плагины состоят в основном из элементов `<asset>`. Любые теги `<asset>`, вложенные в теги `<platform>` определяют ресурсы, которые специфичны для определенной платформы, как описано ниже. Атрибуты включают в себя:
+
+* `src`(обязательно): расположение файла или каталога, в пакете плагина, относительно документа `plugin.xml`. Если файл не существует в указанном в `src` расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
+
+* `target`(обязательно):
+
+ Месторасположение файла или каталога, в приложении Cordova, где должны располагаться ресурсы указанные в теге src. Месторасположение указывается относительно каталога `www`. Ресурсы могут быть перемещены в подкаталогах, например:
+
+ <asset src="www/new-foo.js" target="js/experimental/foo.js" />
+
+ создает каталог `js/experimental` в пределах каталога `www`, если только этот каталогу уже не существует, затем копирует `new-foo.js` файл и переименовывает его в `foo.js` . Если файл уже существует в целевом расположении, plugman останавливается и отменяет процесс установки, выдает уведомление о конфликте и выходит с ненулевым кодом.
+
+## Элемент *js-module*
+
+Большинство плагинов включают один или несколько файлов JavaScript. Каждый элемент `<js-module>` соответствует файлу JavaScript и устраняет необходимость в добавлении тега `<script>` для каждого файла, в файле index.html. В то время как теги `<asset>` просто копируют файл из подкаталога плагина в каталог `www`, теги `<js-module>` являются гораздо более сложными конструкциями. Они выглядят так:
+
+ <js-module src="socket.js" name="Socket">
+ <clobbers target="chrome.socket" />
+ </js-module>
+
+
+При установке плагина в примере указанном выше, `socket.js` копируется в `www/plugins/my.plugin.id/socket.js` и для этого файла добавляется запись в файле `www/cordova_plugins.js` . Во время загрузки, код в `cordova.js` использует XHR для считывания каждого файла, зарегистрированного в www/cordova_plugins.js и добавляет тег `<script>` в HTML, для каждого такого файла. Он добавляет сопоставление, описывающее необходимо добавить содержимое файла в общее пространство имен, или расширить уже существующее описание JS объекта, как описано ниже.
+
+*Не* оборачивайте файл с использованием `cordova.define`, так как это будет осуществляться автоматически. Модуль упаковывается в замыкания(closure), с параметрами `module` , `exports` , и `require` в области видимости, как это принято для AMD модулей.
+
+Подробная информация о теге `<js-module>`:
+
+* `src`: Ссылается на файл в каталоге плагина относительно файла `plugin.xml`.
+
+* `name`: Определяет последнюю часть имени модуля, определенного в данном файле. Как правило, может быть, все, что вам нравится. Это значение важно только в том случае если вы хотите использовать `cordova.require` для импорта других частей вашего плагина в коде JavaScript. Полное имя AMD модуля для `<js-module>` это `id` вашего плагин со следующим значением `name` . Из примера указанного выше, для плагина с `id` - `chrome.socket` , полное имя модуля`chrome.socket.Socket`.
+
+* Три теги разрешены внутри `<js-module>` :
+
+ * `<clobbers target="some.value"/>` Указывает, что значение `module.exports` добавляется в объект `window` таким образом, что становится доступно как `window.some.value` . Вы можете иметь столько `<clobbers>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
+
+ * `<merges target="some.value"/>` Указывает, что модуль должны быть объединены с любым уже существующим значением в `window.some.value` . Если какой либо ключ уже существует в объекте window, объект указанный в модуле переопределяет оригинал. Вы можете иметь столько `<merges>` сколько вам нравится. Любой объект, отсутствующий в объекте `window` будет создан при необходимости.
+
+ * `<runs/>`означает, что ваш код должен быть указан с `cordova.require` , но не добавлен к объекту `window`. Это полезно при инициализации модуля, присоединения обработчиков событий или в других случаях. Вы можете иметь не более одного тега `<runs/>`. Обратите внимание, что использование `<runs/>` совместно с `<clobbers/>` или `<merges/>` является излишним, так как эти директивы тоже загружают ваш модуль с помощью `cordova.require`.
+
+ * Пустой `<js-module>` также загружается и может быть доступен в других модулях с помощью `cordova.require`.
+
+Если `src` не указывает на существующий файл, plugman останавливается и отменяет установку, выдает уведомление о проблеме и выходит с ненулевым кодом.
+
+Вложение тега `<js-module>` внутри элемента `<platform>` объявляет JavaScript модуль, специфический для выбранной платформы.
+
+## Элемент *dependency*
+
+Тег `<dependency>` позволяет указать другие плагины, от которых зависит текущий плагин. В то время как будущих версий будет доступ к ним из репозиториев плагинов, в краткосрочной перспективе плагины прямо упоминается по URL в тегах `<dependency>`. Они выглядят следующим образом:
+
+ <dependency id="com.plugin.id" url="https://github.com/myuser/someplugin" commit="428931ada3891801" subdir="some/path/here" />
+
+
+* `id`: определяет идентификатор плагина. Он должен быть глобально уникальным и выраженной в обратном формате доменных имен. Хотя ни одно из этих ограничений в настоящее время не применяется, это может произойти в будущем.
+
+* `url`: URL-адрес для плагина. Этот адрес должен указывать на репозиторий git, который plugman будет пытаться клонировать.
+
+* `commit`: Это любая ссылка git, понятная для `git checkout` : имя ветки или тега (например, `master` , `0.3.1` ), или хеша коммита (например,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`).
+
+* `subdir`: Указывает, что зависимость целевого плагина существует как подкаталог git-репозитория. Это полезно, потому что она позволяет определять репозиторий содержащий несколько связанных плагинов, и указывать каждый из них индивидуально.
+
+В будущем будут введены ограничения версии, и репозиторий плагинов будет существовать для поддержки выбора плагина по имени вместо явного URL-адреса.
+
+### Относительные пути для зависимостей
+
+Если задать `url` для тега`<dependency>` как `"."` и указать `subdir`, зависимый плагин будет установлен из того же локального или удаленного репозитория что и основной плагин, который определил тег `<dependency>`.
+
+Обратите внимание, что `subdir` всегда указывает путь относительно *корня* git-репозитория, а не папки основного плагина. Это верно, даже если вы установили плагин с указанием локального пути к нему. Plugman находит корень репозитория git, а затем находит там же другой плагин.
+
+## Элемент *platform*
+
+`<platform>` Тег определяет платформы, которые имеют связанные исходные файлы или требуют изменения в их конфигурационных файлах. Инструменты, с помощью этой спецификации могут определить поддерживаемые платформы и установить код в проекты Cordova.
+
+Плагины без тегов `<platform>` считаются содержащими только JavaScript и поэтому устанавливаются на любых платформах.
+
+Образец тега platform:
+
+ <platform name="android">
+ <!-- android-specific elements -->
+ </platform>
+ <platform name="ios">
+ <!-- ios-specific elements -->
+ </platform>
+
+
+Обязательный атрибут `name` поддерживаемую платформу, связывая дочерние элементы с этой платформой.
+
+Имена платформ должны быть в нижнем регистре. Перечислены имена платформ, в произвольном порядке:
+
+* amazon-fireos
+* android
+* blackberry10
+* ios
+* wp8
+* Windows8
+
+## Элемент *source-file*
+
+Элемент `<source-file>` определяет исполняемый файл исходного кода, который должен быть установлен в проект. Примеры:
+
+ <!-- android -->
+ <source-file src="src/android/Foo.java"
+ target-dir="src/com/alunny/foo" />
+ <!-- ios -->
+ <source-file src="src/ios/CDVFoo.m" />
+ <source-file src="src/ios/someLib.a" framework="true" />
+ <source-file src="src/ios/someLib.a" compiler-flags="-fno-objc-arc" />
+
+
+Он поддерживает следующие атрибуты:
+
+* `src`(обязательно): расположение файла относительно `plugin.xml` . Если `src` файл не найден, plugman останавливается и отменяет установку, выдает уведомление об этой проблеме и выходит с ненулевым кодом.
+
+* `target-dir`: Каталог, в который должны быть скопированы файлы, относительно корня проекта Cordova. На практике это наиболее важно для платформ на базе Java, где файл в пакете `com.alunny.foo` должен быть расположен в каталоге `com/alunny/foo`. Для платформ, где исходный каталог не имеет значения этот атрибут должен быть опущен.
+
+ Как и в случае с ресурсами, если `target` из `source-file` будет перезаписывать существующий файл, plugman остановится и отменит установку. После чего выдаст уведомление об этой проблеме и выйдет с ненулевым кодом.
+
+* `framework`(только для iOS-устройств): Если значение `true` , также добавляет указанный файл в качестве фреймвёрка в проект.
+
+* `compiler-flags`(только для iOS-устройств): Если установлено, присваивает указанный флаги компилятора для конкретного исходного файла.
+
+## Элемент *config-file*
+
+Идентифицирует XML файл конфигурации который будет изменен, где в этом документе необходимо произвести изменения, и что следует изменить.
+
+Два типа файлов, которые были протестированы на модификацию с использованием этого элемента, `xml` и `plist` файлы.
+
+Элемент `config-file` позволяет только добавить новые дочерние элементы в XML-дерево документа. Дочерние элементы это XML-литералы которые должны быть вставлены в целевой документ.
+
+Пример для XML:
+
+ <config-file target="AndroidManifest.xml" parent="/manifest/application">
+ <activity android:name="com.foo.Foo" android:label="@string/app_name">
+ <intent-filter>
+ </intent-filter>
+ </activity>
+ </config-file>
+
+
+Пример для `plist` :
+
+ <config-file target="*-Info.plist" parent="CFBundleURLTypes">
+ <array>
+ <dict>
+ <key>PackageName</key>
+ <string>$PACKAGE_NAME</string>
+ </dict>
+ </array>
+ </config-file>
+
+
+Элемент поддерживает следующие атрибуты:
+
+* `target`:
+
+ Файл который будет изменен и путь к нему относительно корня проекта Cordova.
+
+ Целевой объект может включать подстановочный знак (`*`) для элементов. В этом случае plugman рекурсивно просматривает структуру каталогов проекта и использует первое совпадение.
+
+ На iOS, расположение файлов конфигурации относительно корневого каталога проекта не известно, поэтому указание приёмника для `config.xml` определяется как `cordova-ios-project/MyAppName/config.xml`.
+
+ Если указанный файл не существует, инструмент игнорирует изменения конфигурации и продолжает установку.
+
+* `parent`: Селектор XPath, ссылающийся на на родительский элемент, для добавляемых в конфигурационный файл элементов. Если вы используете абсолютные селекторы, можно использовать подстановочный знак (`*`) для указания корневого элемента, например,`/*/plugins`.
+
+ Для `plist` файлов, `parent` определяет, в каком родительском ключе следует добавить указанные XML-данные.
+
+ Если селектор не находит элемент в указанном документе, инструмент останавливается и процесс установки отменяется, после чего выдает предупреждение и выходит с ненулевым кодом.
+
+* `after`: Приоритетный список принятых братьев и сестер, после которого нужно добавить XML-фрагмент. Полезно для задания изменения в файлах, которые требуют строгий порядок элементов XML как [http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK _EXTENSIONSelement][1]
+
+ [1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK_EXTENSIONSelement
+
+Платформа Windows поддерживает два дополнительных атрибута (оба необязательных) затрагивающих meta-name `package.appxmanifest`:
+
+Атрибут `device-target` указывает, что следует включить только при построении для указанного типа целевого устройства. Поддерживаемыми значениями являются `win`, `phone`или `all`.
+
+Атрибут `versions` указывает, что манифесты приложений для определенных версий Windows следует изменить только для версий, которые соответствуют указанной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры использования этих атрибутов Windows:
+
+ <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions="<8.1.0">
+ <Capability Name="picturesLibrary" />
+ <DeviceCapability Name="webcam" />
+ </config-file>
+ <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions=">=8.1.0" device-target="phone">
+ <DeviceCapability Name="webcam" />
+ </config-file>
+
+
+Приведенный выше пример установит pre-8.1 платформы (Windows 8, в частности) и запросит общие возможности устройства `webcam` и `picturesLibrary`, затем применит возможности устройства `webcam` только для проектов Windows 8.1 которые собираются для Windows Phone. Настольные системы Windows 8.1 остаются неизмененными.
+
+## Элемент *plugins-plist*
+
+Это *устаревший* элемент, как он применяется только к cordova-ios 2.2.0 и ниже. Используйте тег `<config-file>` для новых версий Cordova.
+
+Пример:
+
+ <config-file target="config.xml" parent="/widget/plugins">
+ <feature name="ChildBrowser">
+ <param name="ios-package" value="ChildBrowserCommand"/>
+ </feature>
+ </config-file>
+
+
+Указывает ключ и значение для добавления в корректный файл `AppInfo.plist` в проекте Cordova iOS. Например:
+
+ <plugins-plist key="Foo" string="CDVFoo" />
+
+
+## Элементы *resource-file* и *header-file*
+
+Как и исходные файлы (source-file), но специально для платформ, таких как iOS, которые делают различия между исходными файлами, заголовками и ресурсами. Например:
+
+ <resource-file src="CDVFoo.bundle" />
+ <resource-file src="CDVFooViewController.xib" />
+ <header-file src="CDVFoo.h" />
+
+
+Пример для Android:
+
+ <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" />
+
+
+## Элемент *lib-file*
+
+Также как исходные файлы, файлы ресурсов и заголовков, но специально для платформ, таких как BlackBerry 10 которые использут созданные пользователем библиотеки. Например:
+
+ <lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" />
+ <lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" />
+
+
+Поддерживаемые атрибуты:
+
+* `src`(обязательно): расположение файла относительно `plugin.xml`. Если `src` не удается найти, plugman останавливается и отменяет установку, выдает предупреждение о проблеме и выходит с ненулевым кодом.
+
+* `arch`: Архитектура для которой `.so` файл был построен, либо `device` или`simulator`.
+
+Для платформы Windows элемент `<lib-file>` позволяет включение `<SDKReference>` в создаваемых файлах проекта Windows.
+
+Поддерживаемые атрибуты:
+
+* `src` (обязательно): имя пакета SDK для включения (который будет использоваться как значение атрибута `Include` создаваемого элемента `<SDKReference>` ).
+
+* `arch`: указывает, что `<SDKReference>` следует включить только при построении для заданной архитектуры. Поддерживаются следующие значения `x86`, `x64` или `ARM`.
+
+* `device-target`: указывает, что `<SDKReference>` следует включить только при построении для указанного типа целевого устройства. Поддерживаются следующие значения `win` (или `windows`), `phone` или `all`.
+
+* `versions`: указывает, что `<SDKReference>` следует включить только при построении версий, которые соответствуют заданной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры:
+
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" arch="x86" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" versions=">=8.1" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="phone" />
+ <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="win" versions="8.0" arch="x86" />
+
+
+## Элемент *framework*
+
+Определяет фреймвёрк (обычно часть OS/платформы) от которого зависит плагин.
+
+Необязательный атрибут `custom` – это логическое значение, указывающее, входит ли фреймворк в состав файлов плагина (таким образом это не системный фреймворк).
+
+### *framework* для iOS
+
+ <framework src="libsqlite3.dylib" />
+ <framework src="social.framework" weak="true" />
+ <framework src="relative/path/to/my.framework" custom="true" />
+
+
+Необязательный атрибут `weak` – это логическое значение, указывающее, должен ли фреймвёрк быть слабо связан с результирующим исполняемым файлом проекта. Значение по умолчанию`false`.
+
+### *framework* для Android
+
+На Android (начиная с cordova-android@4.0.0) теги *framework* используются для включения зависимостей Maven, или включения встроеных проектов библиотек.
+
+Примеры:
+
+ <!-- В зависимости от GCM из play services -->
+ <framework src="com.google.android.gms:play-services-gcm:+" />
+ <!-- Зависит на v21 библиотеки поддержки appcompat-v7 -->
+ <framework src="com.android.support:appcompat-v7:21+" />
+ <!-- Зависит от проекта библиотеки включенной в плагин -->
+ <framework src="relative/path/FeedbackLib" custom="true" />
+
+
+*framework* также может быть использован для добавления пользовательских файлов .gradle, включенных в главный файл .gradle проекта:
+
+ <framework src="relative/path/rules.gradle" custom="true" type="gradleReference" />
+
+
+Для android до android@4.0.0 (проекты на основе ANT):
+
+Необязательный атрибут `type` является строкой, указывающая тип фреймворка для добавления. В настоящее время только `projectReference` поддерживается и только для Windows. Использование `custom='true'` и `type='projectReference'` будет добавлять ссылку на проект, который будет добавляться к этапам компиляции + линковки проекта Cordova. По сути, это единственный способ в настоящее время указать что что «custom» фреймворк может ориентироваться на нескольких архитектур, так как как явно они построены как зависимость в ссылающемся cordova-приложении.
+
+Необязательный атрибут `parent` задает относительный путь к директории, содержащей подпроект, на который необходимо добавить ссылку. Значение по умолчанию — `.`, то есть проект приложения. Она позволяет добавлять ссылки между под-проектами как в этом примере:
+
+ <framework src="extras/android/support/v7/appcompat" custom="false" parent="FeedbackLib" />
+
+
+### *framework* для Windows
+
+Платформа Windows поддерживает три дополнительные атрибуты (все необязательные) для уточнения когда фреймворк должны быть включен:
+
+ <framework src="path/to/project/LibProj.csproj" custom="true" type="projectReference"/>
+
+
+Атрибут `arch` указывает, что фреймворк следует включить только при создании для заданной архитектуры. Поддерживаются следующие значения `x86`, `x64` или `ARM`.
+
+Атрибут `device-target` указывает, что следует включить только при построении для указанного типа целевого устройства. Поддерживаются следующие значения `win` (или `windows`), `phone` или `all`.
+
+Атрибут `versions` указывает, что фреймворк следует включить только при построении для версий, которые соответствуют заданной строке версии. Значение может быть любое допустимое значение для строки семантической диапазона версий.
+
+Примеры использования этих атрибутов Windows:
+
+ <framework src="src/windows/example.dll" arch="x64" />
+ <framework src="src/windows/example.dll" versions=">=8.0" />
+ <framework src="src/windows/example.vcxproj" type="projectReference" target="win" />
+ <framework src="src/windows/example.vcxproj" type="projectReference" target="all" versions="8.1" arch="x86" />
+
+
+## Элемент *info*
+
+Дополнительная информация для пользователей. Это полезно, когда требуется дополнительные шаги, которые не могут быть легко автоматизированы или выходят за рамки работы plugman. Примеры:
+
+ <info>
+ Вам нужно установить __Google Play Services__ из раздела`Android Extras` используя Android SDK manager (выполните `android`).
+
+ Вам нужно добавить следующую строку в `local.properties`:
+
+ android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib
+ </info>
+
+
+## Элемент *hook*
+
+Представляет ваш пользовательский сценарий, который будет вызываться Cordova при возникновении определенных действий (например, после того, как плагин добавлен или логика подготовки платформы вызвана). Это полезно, когда вам нужно расширить функциональность Cordova по умолчанию. Смотрите "Руководство по хукам" для детальной информации.
+
+ <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" />
+
+
+## Переменные
+
+В некоторых случаях плагин может потребоваться внести изменения в конфигурацию в зависимости от целевого приложения. Например, чтобы зарегистрироваться для C2DM на Android, приложение чей идентификатор пакета `com.alunny.message` потребует разрешения, такие как:
+
+ <uses-permission android:name="com.alunny.message.permission.C2D_MESSAGE"/>
+
+
+В таких случаях, когда добавляемое содержание из файл `plugin.xml` не известно заранее, можно указывать переменные с использованием знака доллара, за которым следует серия заглавных букв, цифр или знаками подчеркивания. Для приведенного выше примера файл `plugin.xml` будет включать следующий тег:
+
+ <uses-permission android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/>
+
+
+plugman заменяет ссылки на переменные указанным значением, или пустая строка, если значение переменной не найдено. Значение переменной могут быть обнаружено (в данном случае, из `AndroidManifest.xml` файла) или указанно пользователем инструмента; точный процесс зависит от конкретного инструмента.
+
+plugman может запросить пользователя указать переменные необходимые плагину. Например можно указать ключи API для C2M и Карт Google как аргумент командной строки:
+
+ plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734
+
+
+Чтобы сделать переменную обязательной, тег `<platform>` должен содержать тег `<preference>`. Например:
+
+ <preference name="API_KEY" />
+
+
+plugman проверяет, переданы ли ему эти необходимые настройки. Если нет, то он должен предупредить пользователя как указать переменную и выйти с ненулевым кодом.
+
+Некоторые имена переменных должны быть зарезервированы, как указано ниже.
+
+## $PACKAGE_NAME
+
+Уникальный идентификатор в обратном стиле доменных имен, соответствующий пакету `CFBundleIdentifier` на iOS или атрибут `package` корневого элемента `manifest` в файле `AndroidManifest.xml` файл.
\ No newline at end of file
