cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From agri...@apache.org
Subject [08/31] [CB-5122] rename 'Platform' guides to 'Installation' guides
Date Mon, 31 Mar 2014 20:26:35 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/win8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/win8/index.md b/docs/en/edge/guide/platforms/win8/index.md
deleted file mode 100644
index 07aeba0..0000000
--- a/docs/en/edge/guide/platforms/win8/index.md
+++ /dev/null
@@ -1,122 +0,0 @@
----
-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 Installation Guide
-
-This section shows how to set up your SDK environment to deploy
-Cordova apps for Windows 8. You need to install Visual Studio, the
-Windows SDK, regardless of whether you want to use the cross-platform
-Cordova CLI for development, or a narrower set of platform-centered
-command-line tools.  For a comparison of the two development paths,
-see the Overview.  For details on each, see The Command-Line Interface
-and the Android Development Guide.
-
-__NOTE__:
-Microsoft deprecated the name _Metro-style apps_ in Windows 8 and
-Windows RT. MSDN now refers to this type of app as a _Windows Store_
-app, and this guide follows that convention. Also, in this guide
-_Windows 8_ signifies both Windows 8 and Windows RT.
-
-## Requirements
-
-- Windows 8
-
-- Visual Studio 2012 Professional or better, or Visual Studio 2012 Express for Windows 8
-
-Follow the instructions at
-[windowsstore.com](http://www.windowsstore.com/)
-to submit the app to Windows Store.
-
-## Install SDK and Cordova
-
-Set up your preferred variant of Visual Studio 2012. All of the
-product's paid versions (Professional, etc.) let you build Windows
-Store apps. You need __Express for Windows 8__ to build Windows Store
-apps using the
-[Express editions](http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products).
-
-Download and extract the latest copy of
-[Cordova](http://phonegap.com/download).
-These instuctions apply to the `lib\windows-8` subdirectory.
-
-## Set up a New Project
-
-You can already build Windows 8 apps using the _HTML/JavaScript track_
-available in Windows Store apps. Use Cordova in Windows Store apps to
-expose the same APIs as on other Cordova-supported platforms.
-
-- Open Visual Studio 2012 and choose __New Project__.
-
-- Select __Installed → Template → Other Languages →
-  JavaScript → Windows Store__ from the tree, and then __Blank
-  App__ from the projects list. Enter whatever project name you like,
-  such as `CordovaWin8Foo` as in this example:
-
-    ![](img/guide/platforms/win8/wsnewproject.png)
-
-- Microsoft continues to use `default.html` as the default home page,
-  but most web developers use `index.html`. It's a good idea to do so,
-  at least to match other platforms you're likely working on.  To fix
-  this, in __Solution Explorer__ rename the `default.html` file to
-  `index.html`. Then double-click the `package.appxmanifest` file and
-  change the __Start page__ value to `index.html`:
-
-        ![](img/guide/platforms/win8/wschangemanifest.png)
-
-- To include `cordova.js` in your project, right-click on the `js`
-  directory in __Solution Explorer__ and select __Add → New
-  Item__. Locate the `cordova.js` file in the `lib\windows-8`
-  directory.
-
-- Edit the code for `index.html`. Add a reference to `cordova.js`. You
-  can do this manually, or by dragging the file from __Solution
-  Explorer__. Add the following other dependencies to the app's home page:
-
-            <!-- WinJS references -->
-            <link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" />
-            <script src="//Microsoft.WinJS.1.0/js/base.js"></script>
-            <script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
-
-            <!-- Cordova -->
-            <script src="/js/cordova.js"></script>
-
-            <!-- CordovaWin8Foo references -->
-            <link href="/css/default.css" rel="stylesheet" />
-            <script src="/js/default.js"></script>
-
-- Add a `deviceready` handler to demonstrate Cordova is working:
-
-        <body>
-            <p>Content goes here</p>
-            <script type="text/javascript">
-                console.log("Subscribing...");
-                document.addEventListener("deviceready", function () {
-                    navigator.notification.alert("The device is ready!");
-                });
-            </script>
-        </body>
-
-## Test the Project
-
-Run the project from Visual Studio. You'll see the message box appear:
-
-        ![](img/guide/platforms/win8/wsalert.png)
-
-That's it. You're now ready to build Windows Store apps with Cordova.
-

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/win8/install.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/win8/install.md b/docs/en/edge/guide/platforms/win8/install.md
new file mode 100644
index 0000000..07aeba0
--- /dev/null
+++ b/docs/en/edge/guide/platforms/win8/install.md
@@ -0,0 +1,122 @@
+---
+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 Installation Guide
+
+This section shows how to set up your SDK environment to deploy
+Cordova apps for Windows 8. You need to install Visual Studio, the
+Windows SDK, regardless of whether you want to use the cross-platform
+Cordova CLI for development, or a narrower set of platform-centered
+command-line tools.  For a comparison of the two development paths,
+see the Overview.  For details on each, see The Command-Line Interface
+and the Android Development Guide.
+
+__NOTE__:
+Microsoft deprecated the name _Metro-style apps_ in Windows 8 and
+Windows RT. MSDN now refers to this type of app as a _Windows Store_
+app, and this guide follows that convention. Also, in this guide
+_Windows 8_ signifies both Windows 8 and Windows RT.
+
+## Requirements
+
+- Windows 8
+
+- Visual Studio 2012 Professional or better, or Visual Studio 2012 Express for Windows 8
+
+Follow the instructions at
+[windowsstore.com](http://www.windowsstore.com/)
+to submit the app to Windows Store.
+
+## Install SDK and Cordova
+
+Set up your preferred variant of Visual Studio 2012. All of the
+product's paid versions (Professional, etc.) let you build Windows
+Store apps. You need __Express for Windows 8__ to build Windows Store
+apps using the
+[Express editions](http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products).
+
+Download and extract the latest copy of
+[Cordova](http://phonegap.com/download).
+These instuctions apply to the `lib\windows-8` subdirectory.
+
+## Set up a New Project
+
+You can already build Windows 8 apps using the _HTML/JavaScript track_
+available in Windows Store apps. Use Cordova in Windows Store apps to
+expose the same APIs as on other Cordova-supported platforms.
+
+- Open Visual Studio 2012 and choose __New Project__.
+
+- Select __Installed &rarr; Template &rarr; Other Languages &rarr;
+  JavaScript &rarr; Windows Store__ from the tree, and then __Blank
+  App__ from the projects list. Enter whatever project name you like,
+  such as `CordovaWin8Foo` as in this example:
+
+    ![](img/guide/platforms/win8/wsnewproject.png)
+
+- Microsoft continues to use `default.html` as the default home page,
+  but most web developers use `index.html`. It's a good idea to do so,
+  at least to match other platforms you're likely working on.  To fix
+  this, in __Solution Explorer__ rename the `default.html` file to
+  `index.html`. Then double-click the `package.appxmanifest` file and
+  change the __Start page__ value to `index.html`:
+
+        ![](img/guide/platforms/win8/wschangemanifest.png)
+
+- To include `cordova.js` in your project, right-click on the `js`
+  directory in __Solution Explorer__ and select __Add &rarr; New
+  Item__. Locate the `cordova.js` file in the `lib\windows-8`
+  directory.
+
+- Edit the code for `index.html`. Add a reference to `cordova.js`. You
+  can do this manually, or by dragging the file from __Solution
+  Explorer__. Add the following other dependencies to the app's home page:
+
+            <!-- WinJS references -->
+            <link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" />
+            <script src="//Microsoft.WinJS.1.0/js/base.js"></script>
+            <script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
+
+            <!-- Cordova -->
+            <script src="/js/cordova.js"></script>
+
+            <!-- CordovaWin8Foo references -->
+            <link href="/css/default.css" rel="stylesheet" />
+            <script src="/js/default.js"></script>
+
+- Add a `deviceready` handler to demonstrate Cordova is working:
+
+        <body>
+            <p>Content goes here</p>
+            <script type="text/javascript">
+                console.log("Subscribing...");
+                document.addEventListener("deviceready", function () {
+                    navigator.notification.alert("The device is ready!");
+                });
+            </script>
+        </body>
+
+## Test the Project
+
+Run the project from Visual Studio. You'll see the message box appear:
+
+        ![](img/guide/platforms/win8/wsalert.png)
+
+That's it. You're now ready to build Windows Store apps with Cordova.
+

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/wp7/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp7/index.md b/docs/en/edge/guide/platforms/wp7/index.md
deleted file mode 100644
index f91e455..0000000
--- a/docs/en/edge/guide/platforms/wp7/index.md
+++ /dev/null
@@ -1,131 +0,0 @@
----
-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 Installation Guide
-
-This guide shows how to set up your SDK development environment to
-deploy Cordova apps for Windows Phone 7 devices.  Apps also run on
-Windows Phone 8 devices using the same APIs, but version 7 lacks some
-of IE10's advanced features available on Windows Phone 8. Windows
-Phone 8 apps do _not_ run on Windows Phone 7 devices.
-
-See the following for more detailed platform-specific information that
-applies to both versions:
-
-* Upgrading Windows Phone
-* Windows Phone Plugins
-* Windows Phone Development Guide
-
-The command-line tools above refer to versions prior to Cordova 3.0.
-See The Command-line Interface for information about the
-current interface.
-
-## System Requirements
-
-Use Windows 7 or Windows 8 (Pro) or Windows Vista with SP2.  The
-64-bit version (x64) of Windows is required for the SDK.  The Pro
-version is recommended for running a device emulator.
-
-Register and pay for a [Windows Phone Dev
-Center](http://dev.windowsphone.com/en-us/publish) account if you want
-to install an app on a real device or submit it to Market Place.
-
-__NOTE:__ Running the SDK in Virtual Machine may present challenges.
-Read [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac) for
-insights on developing solutions.
-
-## Install SDK and Cordova
-
-Download and install the [Windows Phone
-SDK](http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=27570/).
-
-Download and extract the latest copy of
-[Cordova](http://phonegap.com/download). You will be working in the
-`lib\windows-phone-8\wp7` subdirectory, `lib\windows-phone-8\wp8`
-contains the Windwos Phone 8 version of Cordova.
-
-Copy the `CordovaWP7_x_x_x.zip` file to the `\My Documents\Visual
-Studio 2012\Templates\ProjectTemplates\` directory.
-
-## Building the Template
-
-__NOTE:__ Skip this step if the `lib\windows-phone` directory already
-contains a `CordovaWP7_x_x_x.zip` file.
-
-To simplify development, Cordova bundles a script to build Visual
-Studio templates. These allow you to rapidly generate Cordova apps,
-and you can modify them if necessary.  The steps below show how to
-generate it.
-
-### Run the Batch File to Create and Install the Templates
-
-The root of the repo contains a `createTemplates.bat` file.
-Double-clicking this file generates two `.zip` files:
-`CordovaWP7_x_x_x.zip` and `CordovaWP8_x_x_x.zip`, where _x.x.x_ is
-the current version number. To use these files easily in Visual
-Studio, copy them to the `My Documents\Visual Studio
-2012\Templates\ProjectTemplates\` subdirectory. You are then able to
-create new __Apache Cordova Windows Phone_ apps from Visual Studio's
-__File &rarr; New Project__ menu.
-
-If you run the batch file from the command line, you can also call
-with a parameter to install automatically:
-
-        >createTemplates.bat -install
-
-## Set up a New Project
-
-- Open Visual Studio Express for Windows Phone and choose __New
-  Project__.
-
-- Select __CordovaWP7__. The version number displays in the template
-  description.
-
-- Give the project a name, and select __OK__.
-
-## Review the Project Structure
-
-The `www` directory features `html`, `js`, and `css` subdirectories
-and any other resources the app requires.
-Any additional content needs to be a part of the Visual Studio
-project, and it must be set as content.
-
-The following sample structure represents a 2.3.0 project, but may
-vary depending on installed version:
-
-![](img/guide/platforms/wp8/projectStructure.png)
-
-## Build the Project for the Device
-
-Before testing your application on a device, the device must be
-registered. Consult
-[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
-for details on how to deploy and test on Windows Phone 7. These are
-the basic steps:
-
-- Make sure your phone is connected, and the screen is unlocked.
-
-- In Visual Studio, select __Device__ from the drop-down menu at the top.
-
-- Press the green __play__ button next to the main drop-down menu to
-  start debugging, or else type __F5__.
-
-![](img/guide/platforms/wp7/wpd.png)
-
-At this point, you're done.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/wp7/install.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp7/install.md b/docs/en/edge/guide/platforms/wp7/install.md
new file mode 100644
index 0000000..f91e455
--- /dev/null
+++ b/docs/en/edge/guide/platforms/wp7/install.md
@@ -0,0 +1,131 @@
+---
+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 Installation Guide
+
+This guide shows how to set up your SDK development environment to
+deploy Cordova apps for Windows Phone 7 devices.  Apps also run on
+Windows Phone 8 devices using the same APIs, but version 7 lacks some
+of IE10's advanced features available on Windows Phone 8. Windows
+Phone 8 apps do _not_ run on Windows Phone 7 devices.
+
+See the following for more detailed platform-specific information that
+applies to both versions:
+
+* Upgrading Windows Phone
+* Windows Phone Plugins
+* Windows Phone Development Guide
+
+The command-line tools above refer to versions prior to Cordova 3.0.
+See The Command-line Interface for information about the
+current interface.
+
+## System Requirements
+
+Use Windows 7 or Windows 8 (Pro) or Windows Vista with SP2.  The
+64-bit version (x64) of Windows is required for the SDK.  The Pro
+version is recommended for running a device emulator.
+
+Register and pay for a [Windows Phone Dev
+Center](http://dev.windowsphone.com/en-us/publish) account if you want
+to install an app on a real device or submit it to Market Place.
+
+__NOTE:__ Running the SDK in Virtual Machine may present challenges.
+Read [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac) for
+insights on developing solutions.
+
+## Install SDK and Cordova
+
+Download and install the [Windows Phone
+SDK](http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=27570/).
+
+Download and extract the latest copy of
+[Cordova](http://phonegap.com/download). You will be working in the
+`lib\windows-phone-8\wp7` subdirectory, `lib\windows-phone-8\wp8`
+contains the Windwos Phone 8 version of Cordova.
+
+Copy the `CordovaWP7_x_x_x.zip` file to the `\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\` directory.
+
+## Building the Template
+
+__NOTE:__ Skip this step if the `lib\windows-phone` directory already
+contains a `CordovaWP7_x_x_x.zip` file.
+
+To simplify development, Cordova bundles a script to build Visual
+Studio templates. These allow you to rapidly generate Cordova apps,
+and you can modify them if necessary.  The steps below show how to
+generate it.
+
+### Run the Batch File to Create and Install the Templates
+
+The root of the repo contains a `createTemplates.bat` file.
+Double-clicking this file generates two `.zip` files:
+`CordovaWP7_x_x_x.zip` and `CordovaWP8_x_x_x.zip`, where _x.x.x_ is
+the current version number. To use these files easily in Visual
+Studio, copy them to the `My Documents\Visual Studio
+2012\Templates\ProjectTemplates\` subdirectory. You are then able to
+create new __Apache Cordova Windows Phone_ apps from Visual Studio's
+__File &rarr; New Project__ menu.
+
+If you run the batch file from the command line, you can also call
+with a parameter to install automatically:
+
+        >createTemplates.bat -install
+
+## Set up a New Project
+
+- Open Visual Studio Express for Windows Phone and choose __New
+  Project__.
+
+- Select __CordovaWP7__. The version number displays in the template
+  description.
+
+- Give the project a name, and select __OK__.
+
+## Review the Project Structure
+
+The `www` directory features `html`, `js`, and `css` subdirectories
+and any other resources the app requires.
+Any additional content needs to be a part of the Visual Studio
+project, and it must be set as content.
+
+The following sample structure represents a 2.3.0 project, but may
+vary depending on installed version:
+
+![](img/guide/platforms/wp8/projectStructure.png)
+
+## Build the Project for the Device
+
+Before testing your application on a device, the device must be
+registered. Consult
+[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
+for details on how to deploy and test on Windows Phone 7. These are
+the basic steps:
+
+- Make sure your phone is connected, and the screen is unlocked.
+
+- In Visual Studio, select __Device__ from the drop-down menu at the top.
+
+- Press the green __play__ button next to the main drop-down menu to
+  start debugging, or else type __F5__.
+
+![](img/guide/platforms/wp7/wpd.png)
+
+At this point, you're done.

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/wp8/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/index.md b/docs/en/edge/guide/platforms/wp8/index.md
deleted file mode 100644
index 28db2c4..0000000
--- a/docs/en/edge/guide/platforms/wp8/index.md
+++ /dev/null
@@ -1,162 +0,0 @@
----
-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 Installation Guide
-
-This guide shows how to set up your SDK development environment to
-deploy Cordova apps for Windows Phone 8 devices. If you want to target
-both 7.5 and 8 devices, develop for Windows Phone 7 instead as
-detailed in the Windows Phone 7 Installation Guide.  Version 7 does not
-have all the advanced features included in Internet Explorer 10, but
-implements the same set of APIs. Windows Phone 8 apps do _not_ run on
-Windows Phone 7 devices.
-
-See the following for more detailed platform-specific information that
-applies to both versions:
-
-- Upgrading Windows Phone
-- Windows Phone Plugins
-- Windows Phone Development Guide
-
-The command-line tools above refer to versions prior to Cordova 3.0.
-See The Command-line Interface for information about the
-current interface.
-
-## System Requirements
-
-- Operating System:
-    - Windows 8 or Windows 8 Pro
-        - The 64-bit version (x64) of Windows is required for the SDK.
-        - The Pro version is recommended so you can run a device emulator.
-
-- Hardware:
-    - 6.5 GB of free hard disk space
-    - 4 GB RAM
-    - 64-bit (x64) CPU
-
-- Windows Phone 8 Emulator
-    - The phone emulator uses Hyper-V, so this list includes those pre-requisites.
-    - Windows 8 Pro 64-bit edition or greater
-    - Requires a processor that supports virtualization and [Second Level Address Translation
(SLAT)](http://en.wikipedia.org/wiki/Second_Level_Address_Translation)
-        - See the [list of Intel processors that support VT-x (virtualization) and EPT (SLAT)](http://ark.intel.com/Products/VirtualizationTechnology)
-    - Enable the virtualization capability (i.e., VT-x on Intel) in your BIOS settings, as
usually this is disabled by default.
-
-- SDK and IDE (Visual Studio)
-    - Visual Studio 2012 Professional, Premium, or Ultimate. Note that Visual Studio Express
for Windows Phone (included in the SDK) is not recommended because you can not build the template
(see below) with VS Express, as it does not have the __Export Template__ functionality, which
is only in VS Pro or higher.
-
-- Register and pay for a [Windows Phone Dev Center](http://dev.windowsphone.com/en-us/publish)
account if you want to install the app on a real device or submit it to Market Place.
-
-__NOTE:__ Running the SDK in Virtual Machine might present some challenges. You can read
this blog post that gives insight on the solutions to develop for [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac).
-
-## Install SDK and Cordova
-
-Download and install [Windows Phone
-SDK](http://www.microsoft.com/en-us/download/details.aspx?id=35471).
-
-Download and extract the latest copy of
-[Cordova](http://phonegap.com/download). The `lib\windows-phone-8\wp8`
-subdirectory is where you will do your work.
-
-Copy the `CordovaWP8_x_x_x.zip` file to the `\My Documents\Visual
-Studio 2012\Templates\ProjectTemplates\` directory.
-
-## Building the Template
-
-__NOTE:__ Skip this step if the `lib\windows-phone` directory already
-contains a `CordovaWP8_x_x_x.zip` file.
-
-To simplify development, Cordova bundles a script to build Visual
-Studio templates. These allow you to rapidly generate Cordova apps,
-and you can modify them if necessary.  The steps below show how to
-generate it.
-
-### Run the Batch File to Create and Install the Templates
-
-The repo's root directory contains a `createTemplates.bat` file.
-Double-click this to generate two `.zip` files: `CordovaWP7_x_x_x.zip`
-and `CordovaWP8_x_x_x.zip`, where _x.x.x_ is the current version
-number. To use these files easily in Visual Studio, copy them to `My
-Documents\Visual Studio 2012\Templates\ProjectTemplates\`. You are
-then able to create new Apache Cordova Windows Phone apps from the
-__Visual Studio File &rarr; New Project__ menu.
-
-If you run the batch file from the command line, you can also call it
-with a parameter to install automatically:
-
-        >createTemplates.bat -install
-
-## Set up a New Project
-
-Open Visual Studio Express for Windows Phone and choose __New
-Project__.
-
-Select __CordovaWP8__. The version number is displayed in the
-template description.
-
-Give the project a name, and select __OK__.
-
-![](img/guide/platforms/wp8/StandAloneTemplate.png)
-
-## Review the Project Structure
-
-The `www` directory features `html`, `js`, and `css` subdirectories
-and any other resources the app requires.
-Any additional content needs to be a part of the Visual Studio
-project, and it must be set as content.
-
-The following sample structure represents a 2.3.0 project, but may
-vary depending on the installed version:
-
-![](img/guide/platforms/wp8/projectStructure.png)
-
-## Build and Deploy to Emulator
-
-Make sure __Windows Phone Emulator__ is selected in the main drop-down menu.
-
-Then press the green __play__ button next to the drop-down menu to
-start debugging, or type __F5__.
-
-![](img/guide/platforms/wp8/BuildEmulator.png)
-
-## Build the Project for the Device
-
-Before testing your application on a device, the device must be
-registered. Consult
-[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
-for details on how to deploy and test on Windows Phone 8. These are
-the basic steps:
-
-- Make sure your phone is connected, and the screen is unlocked.
-
-- In Visual Studio, select __Device__ from the drop-down menu at the top.
-
-- Press the green __play__ button next to the main drop-down menu to
-  start debugging, or else type __F5__.
-
-![](img/guide/platforms/wp7/wpd.png)
-
-At this point, you're done.
-
-## Further Reading
-
-The Windows Phone Developer Blog provides
-[helpful details](http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx)
-on differences between IE10 and WebKit browsers, and how to support
-both.
-

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b731f46e/docs/en/edge/guide/platforms/wp8/install.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/wp8/install.md b/docs/en/edge/guide/platforms/wp8/install.md
new file mode 100644
index 0000000..28db2c4
--- /dev/null
+++ b/docs/en/edge/guide/platforms/wp8/install.md
@@ -0,0 +1,162 @@
+---
+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 Installation Guide
+
+This guide shows how to set up your SDK development environment to
+deploy Cordova apps for Windows Phone 8 devices. If you want to target
+both 7.5 and 8 devices, develop for Windows Phone 7 instead as
+detailed in the Windows Phone 7 Installation Guide.  Version 7 does not
+have all the advanced features included in Internet Explorer 10, but
+implements the same set of APIs. Windows Phone 8 apps do _not_ run on
+Windows Phone 7 devices.
+
+See the following for more detailed platform-specific information that
+applies to both versions:
+
+- Upgrading Windows Phone
+- Windows Phone Plugins
+- Windows Phone Development Guide
+
+The command-line tools above refer to versions prior to Cordova 3.0.
+See The Command-line Interface for information about the
+current interface.
+
+## System Requirements
+
+- Operating System:
+    - Windows 8 or Windows 8 Pro
+        - The 64-bit version (x64) of Windows is required for the SDK.
+        - The Pro version is recommended so you can run a device emulator.
+
+- Hardware:
+    - 6.5 GB of free hard disk space
+    - 4 GB RAM
+    - 64-bit (x64) CPU
+
+- Windows Phone 8 Emulator
+    - The phone emulator uses Hyper-V, so this list includes those pre-requisites.
+    - Windows 8 Pro 64-bit edition or greater
+    - Requires a processor that supports virtualization and [Second Level Address Translation
(SLAT)](http://en.wikipedia.org/wiki/Second_Level_Address_Translation)
+        - See the [list of Intel processors that support VT-x (virtualization) and EPT (SLAT)](http://ark.intel.com/Products/VirtualizationTechnology)
+    - Enable the virtualization capability (i.e., VT-x on Intel) in your BIOS settings, as
usually this is disabled by default.
+
+- SDK and IDE (Visual Studio)
+    - Visual Studio 2012 Professional, Premium, or Ultimate. Note that Visual Studio Express
for Windows Phone (included in the SDK) is not recommended because you can not build the template
(see below) with VS Express, as it does not have the __Export Template__ functionality, which
is only in VS Pro or higher.
+
+- Register and pay for a [Windows Phone Dev Center](http://dev.windowsphone.com/en-us/publish)
account if you want to install the app on a real device or submit it to Market Place.
+
+__NOTE:__ Running the SDK in Virtual Machine might present some challenges. You can read
this blog post that gives insight on the solutions to develop for [Windows Phone on a Mac](http://aka.ms/BuildaWP8apponaMac).
+
+## Install SDK and Cordova
+
+Download and install [Windows Phone
+SDK](http://www.microsoft.com/en-us/download/details.aspx?id=35471).
+
+Download and extract the latest copy of
+[Cordova](http://phonegap.com/download). The `lib\windows-phone-8\wp8`
+subdirectory is where you will do your work.
+
+Copy the `CordovaWP8_x_x_x.zip` file to the `\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\` directory.
+
+## Building the Template
+
+__NOTE:__ Skip this step if the `lib\windows-phone` directory already
+contains a `CordovaWP8_x_x_x.zip` file.
+
+To simplify development, Cordova bundles a script to build Visual
+Studio templates. These allow you to rapidly generate Cordova apps,
+and you can modify them if necessary.  The steps below show how to
+generate it.
+
+### Run the Batch File to Create and Install the Templates
+
+The repo's root directory contains a `createTemplates.bat` file.
+Double-click this to generate two `.zip` files: `CordovaWP7_x_x_x.zip`
+and `CordovaWP8_x_x_x.zip`, where _x.x.x_ is the current version
+number. To use these files easily in Visual Studio, copy them to `My
+Documents\Visual Studio 2012\Templates\ProjectTemplates\`. You are
+then able to create new Apache Cordova Windows Phone apps from the
+__Visual Studio File &rarr; New Project__ menu.
+
+If you run the batch file from the command line, you can also call it
+with a parameter to install automatically:
+
+        >createTemplates.bat -install
+
+## Set up a New Project
+
+Open Visual Studio Express for Windows Phone and choose __New
+Project__.
+
+Select __CordovaWP8__. The version number is displayed in the
+template description.
+
+Give the project a name, and select __OK__.
+
+![](img/guide/platforms/wp8/StandAloneTemplate.png)
+
+## Review the Project Structure
+
+The `www` directory features `html`, `js`, and `css` subdirectories
+and any other resources the app requires.
+Any additional content needs to be a part of the Visual Studio
+project, and it must be set as content.
+
+The following sample structure represents a 2.3.0 project, but may
+vary depending on the installed version:
+
+![](img/guide/platforms/wp8/projectStructure.png)
+
+## Build and Deploy to Emulator
+
+Make sure __Windows Phone Emulator__ is selected in the main drop-down menu.
+
+Then press the green __play__ button next to the drop-down menu to
+start debugging, or type __F5__.
+
+![](img/guide/platforms/wp8/BuildEmulator.png)
+
+## Build the Project for the Device
+
+Before testing your application on a device, the device must be
+registered. Consult
+[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
+for details on how to deploy and test on Windows Phone 8. These are
+the basic steps:
+
+- Make sure your phone is connected, and the screen is unlocked.
+
+- In Visual Studio, select __Device__ from the drop-down menu at the top.
+
+- Press the green __play__ button next to the main drop-down menu to
+  start debugging, or else type __F5__.
+
+![](img/guide/platforms/wp7/wpd.png)
+
+At this point, you're done.
+
+## Further Reading
+
+The Windows Phone Developer Blog provides
+[helpful details](http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx)
+on differences between IE10 and WebKit browsers, and how to support
+both.
+


Mime
View raw message